DocumentaciónAjuda

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

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.

  1. 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: gzip
  1. Suas aplicações apontam para o Collector, sem token:

OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318

AWS (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 instale opentelemetry-sdk-extension-aws e defina OTEL_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; .NET OTEL_DOTNET_AUTO_AZURE_APP_SERVICE_RESOURCE_DETECTOR_ENABLED=true; Python pip 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; Python pip 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).

  1. Defina as variáveis OTEL_* no serviço do Railway.

  2. 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.js

Se 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).

  1. 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'
  1. Crie o recurso Instrumentation que o guia Kubernetes mostra, com sua URL de ingestão como endpoint e o secret em OTEL_EXPORTER_OTLP_HEADERS.

  2. 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.

Relacionado

Pesquisar em Argunis Monitoring

Digite pelo menos 2 letras para pesquisar em Argunis Monitoring.

↑↓ navegar · Enter abrir · Esc fechar