Instrumentar em nuvens e contêineres
Onde colocar as variáveis do OpenTelemetry na AWS, no Azure, no Google Cloud, no Railway, no Kubernetes, no Docker ou no systemd, e como usar o Collector como ponte.
Nesta página
A instrumentação é a mesma em qualquer lugar: as variáveis padrão do OpenTelemetry de Instrumentar uma aplicação de servidor. O que muda é onde elas são definidas. Os guias estão em Configurações → APM → Chave de API e SDK, seção SDK por linguagem e outras formas de enviar, aba Nuvens e plataformas.
Antes de começar
Um token de servidor e a URL de ingestão. Veja Criar um token de ingestão.
A aplicação já instrumentada conforme sua linguagem.
OpenTelemetry Collector (ponte)
Use um Collector na sua rede quando um sistema só fala gRPC, quando não tem saída para a internet ou quando você quer adicionar dados do host, da nuvem ou do Kubernetes. O Collector recebe OTLP por gRPC ou HTTP e reencaminha ao ARGUNIS por HTTPS de saída. Serve na AWS, no Azure, no Google Cloud, no Railway, on-premise ou atrás de uma VPN.
Copie a configuração do guia OpenTelemetry Collector (ponte) (imagem
otel/opentelemetry-collector-contrib; fixe a versão). O exportador aponta para sua URL de ingestão com o token em uma variável do Collector:
exporters:
otlphttp/argunis:
endpoint: https://URL_DE_INGESTA
headers: { Authorization: "Bearer ${env:ARGUNIS_APM_TOKEN}" }
compression: gzipSuas aplicações apontam para o Collector, sem token:
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318AWS (EC2, ECS, EKS, Lambda)
Defina as variáveis
OTEL_*na definição de tarefa (ECS), no Deployment (EKS), na configuração da função (Lambda) ou no serviço do sistema (EC2).Guarde o token no Secrets Manager ou no Parameter Store.
Detectores da AWS: no Node
OTEL_NODE_RESOURCE_DETECTORS=all; no Java-Dotel.resource.providers.aws.enabled=true; no Python instaleopentelemetry-sdk-extension-awse definaOTEL_EXPERIMENTAL_RESOURCE_DETECTORS=aws_ec2,aws_ecs,aws_eks.No Lambda, use a camada oficial do OpenTelemetry da sua linguagem e adicione
AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handleràs variáveis.
Azure (VM, App Service, AKS, Functions)
Defina as variáveis em Configuração do aplicativo (App Service e Functions), no Deployment (AKS) ou no serviço (VM).
Guarde o token no Key Vault.
Detectores do Azure: Node
OTEL_NODE_RESOURCE_DETECTORS=all; Java-Dotel.resource.providers.azure.enabled=true; .NETOTEL_DOTNET_AUTO_AZURE_APP_SERVICE_RESOURCE_DETECTOR_ENABLED=true; Pythonpip install opentelemetry-resource-detector-azure.
Google Cloud (GCE, GKE, Cloud Run)
Defina as variáveis no serviço do Cloud Run, no Deployment do GKE ou na instância.
Guarde o token no Secret Manager.
Detectores: Node
OTEL_NODE_RESOURCE_DETECTORS=all; Java-Dotel.resource.providers.gcp.enabled=true; Pythonpip install opentelemetry-resourcedetector-gcp.
Railway
Se você já monitora seus serviços do Railway no ARGUNIS, o serviço do APM se vincula sozinho ao seu serviço do Railway quando chega o atributo railway.service.id (ou railway.service.name).
Defina as variáveis
OTEL_*no serviço do Railway.No comando de inicialização, adicione os identificadores do Railway como atributos de recurso:
OTEL_RESOURCE_ATTRIBUTES="railway.service.id=$RAILWAY_SERVICE_ID,railway.project.id=$RAILWAY_PROJECT_ID,railway.environment.id=$RAILWAY_ENVIRONMENT_ID,railway.environment.name=$RAILWAY_ENVIRONMENT_NAME,deployment.environment.name=$RAILWAY_ENVIRONMENT_NAME" node --import @opentelemetry/auto-instrumentations-node/register dist/server.jsSe você definir OTEL_RESOURCE_ATTRIBUTES como variável do Railway (e não no comando), escreva ${{RAILWAY_SERVICE_ID}}. A forma $RAILWAY_SERVICE_ID só é substituída dentro de um shell.
Kubernetes (qualquer nuvem ou on-premise)
Com o OpenTelemetry Operator, os pods se instrumentam sozinhos com uma anotação (Java, Node, Python, .NET e Go).
Crie um secret com o cabeçalho do token:
kubectl create secret generic argunis-apm --from-literal=headers='Authorization=Bearer%20jtk_TU_TOKEN_DE_SERVIDOR'Crie o recurso
Instrumentationque o guia Kubernetes mostra, com sua URL de ingestão comoendpointe o secret emOTEL_EXPORTER_OTLP_HEADERS.Anote o Deployment conforme a linguagem:
instrumentation.opentelemetry.io/inject-java: "argunis"
instrumentation.opentelemetry.io/inject-nodejs: "argunis"
instrumentation.opentelemetry.io/inject-python: "argunis"
instrumentation.opentelemetry.io/inject-dotnet: "argunis"Docker e servidores próprios
As mesmas variáveis vão no docker-compose.yml (bloco environment), na unidade do systemd (Environment="...") ou no serviço do Windows. O guia Docker / servidores próprios as mostra já escritas nos dois formatos.
O ARGUNIS vincula o serviço ao servidor do inventário por host.name.
O que acontece depois
O serviço aparece em APM → Serviços com a coluna Onde roda (por exemplo, a nuvem, o cluster ou o servidor) e, se o ARGUNIS conseguiu vinculá-lo, o grupo do inventário em Vínculo.