Instrumentar en nubes y contenedores
Dónde poner las variables de OpenTelemetry en AWS, Azure, Google Cloud, Railway, Kubernetes, Docker o systemd, y cómo usar el Collector como puente.
En esta página
La instrumentación es la misma en cualquier lugar: las variables estándar de OpenTelemetry de Instrumentar una aplicación de servidor. Lo que cambia es dónde se definen. Las guías están en Configuración → APM → API key y SDK, sección SDK por lenguaje y otras formas de enviar, pestaña Nubes y plataformas.
Antes de empezar
Un token de servidor y la URL de ingesta. Ver Crear un token de ingesta.
La aplicación ya instrumentada según su lenguaje.
OpenTelemetry Collector (puente)
Usa un Collector en tu red cuando un sistema solo habla gRPC, cuando no tiene salida a internet o cuando quieres agregar datos del host, la nube o Kubernetes. El Collector recibe OTLP por gRPC o HTTP y reenvía a ARGUNIS por HTTPS saliente. Sirve en AWS, Azure, Google Cloud, Railway, on-premise o detrás de una VPN.
Copia la configuración de la guía OpenTelemetry Collector (puente) (imagen
otel/opentelemetry-collector-contrib; fija la versión). El exportador apunta a tu URL de ingesta con el token en una variable del Collector:
exporters:
otlphttp/argunis:
endpoint: https://URL_DE_INGESTA
headers: { Authorization: "Bearer ${env:ARGUNIS_APM_TOKEN}" }
compression: gzipTus aplicaciones apuntan al Collector, sin token:
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318AWS (EC2, ECS, EKS, Lambda)
Define las variables
OTEL_*en la definición de tarea (ECS), el Deployment (EKS), la configuración de la función (Lambda) o el servicio del sistema (EC2).Guarda el token en Secrets Manager o Parameter Store.
Detectores de AWS: en Node
OTEL_NODE_RESOURCE_DETECTORS=all; en Java-Dotel.resource.providers.aws.enabled=true; en Python instalaopentelemetry-sdk-extension-awsy defineOTEL_EXPERIMENTAL_RESOURCE_DETECTORS=aws_ec2,aws_ecs,aws_eks.En Lambda usa la capa oficial de OpenTelemetry de tu lenguaje y agrega
AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handlera las variables.
Azure (VM, App Service, AKS, Functions)
Define las variables en Configuración de la aplicación (App Service y Functions), en el Deployment (AKS) o en el servicio (VM).
Guarda el token en Key Vault.
Detectores de 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)
Define las variables en el servicio de Cloud Run, el Deployment de GKE o la instancia.
Guarda el token en Secret Manager.
Detectores: Node
OTEL_NODE_RESOURCE_DETECTORS=all; Java-Dotel.resource.providers.gcp.enabled=true; Pythonpip install opentelemetry-resourcedetector-gcp.
Railway
Si ya monitoreas tus servicios de Railway en ARGUNIS, el servicio del APM se vincula solo con su servicio de Railway cuando llega el atributo railway.service.id (o railway.service.name).
Define las variables
OTEL_*en el servicio de Railway.En el comando de inicio, agrega los identificadores de 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.jsSi defines OTEL_RESOURCE_ATTRIBUTES como variable de Railway (no en el comando), escribe ${{RAILWAY_SERVICE_ID}}. La forma $RAILWAY_SERVICE_ID solo se reemplaza dentro de un shell.
Kubernetes (cualquier nube u on-premise)
Con el OpenTelemetry Operator los pods se instrumentan solos con una anotación (Java, Node, Python, .NET y Go).
Crea un secreto con la cabecera del token:
kubectl create secret generic argunis-apm --from-literal=headers='Authorization=Bearer%20jtk_TU_TOKEN_DE_SERVIDOR'Crea el recurso
Instrumentationque muestra la guía Kubernetes, con tu URL de ingesta comoendpointy el secreto enOTEL_EXPORTER_OTLP_HEADERS.Anota el Deployment según el lenguaje:
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 y servidores propios
Las mismas variables van en docker-compose.yml (bloque environment), en la unidad de systemd (Environment="...") o en el servicio de Windows. La guía Docker / servidores propios las muestra ya escritas en ambos formatos.
ARGUNIS vincula el servicio con el servidor del inventario por host.name.
Qué pasa después
El servicio aparece en APM → Servicios con la columna Dónde corre (por ejemplo, la nube, el clúster o el servidor) y, si ARGUNIS lo pudo vincular, el grupo del inventario en Vínculo.