DocumentaciónAyuda

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

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.

  1. 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: gzip
  1. Tus aplicaciones apuntan al Collector, sin token:

OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318

AWS (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 instala opentelemetry-sdk-extension-aws y define OTEL_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-handler a 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; .NET OTEL_DOTNET_AUTO_AZURE_APP_SERVICE_RESOURCE_DETECTOR_ENABLED=true; Python pip 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; Python pip 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).

  1. Define las variables OTEL_* en el servicio de Railway.

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

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

  1. Crea un secreto con la cabecera del token:

kubectl create secret generic argunis-apm --from-literal=headers='Authorization=Bearer%20jtk_TU_TOKEN_DE_SERVIDOR'
  1. Crea el recurso Instrumentation que muestra la guía Kubernetes, con tu URL de ingesta como endpoint y el secreto en OTEL_EXPORTER_OTLP_HEADERS.

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

Relacionado

Buscar en Argunis Monitoring

Escribe al menos 2 letras para buscar en Argunis Monitoring.

↑↓ moverse · Enter abrir · Esc cerrar