DocumentaciónAide

Instrumenter dans les clouds et conteneurs

Où placer les variables OpenTelemetry sur AWS, Azure, Google Cloud, Railway, Kubernetes, Docker ou systemd, et comment utiliser le Collector comme passerelle.

Sur cette page

L'instrumentation est la même partout : les variables standard d'OpenTelemetry d'Instrumenter une application serveur. Ce qui change, c'est l'endroit où elles se définissent. Les guides se trouvent dans Paramètres → APM → Clé API et SDK, section SDK par langage et autres façons d'envoyer, onglet Clouds et plateformes.

Avant de commencer

OpenTelemetry Collector (passerelle)

Utilisez un Collector dans votre réseau quand un système ne parle que gRPC, quand il n'a pas de sortie vers Internet ou quand vous voulez ajouter des données de l'hôte, du cloud ou de Kubernetes. Le Collector reçoit l'OTLP en gRPC ou en HTTP et le relaie vers ARGUNIS en HTTPS sortant. Il convient pour AWS, Azure, Google Cloud, Railway, sur site ou derrière un VPN.

  1. Copiez la configuration du guide OpenTelemetry Collector (passerelle) (image otel/opentelemetry-collector-contrib ; fixez la version). L'exportateur pointe vers votre URL d'ingestion avec le jeton dans une variable du Collector :

exporters:
  otlphttp/argunis:
    endpoint: https://URL_DE_INGESTA
    headers: { Authorization: "Bearer ${env:ARGUNIS_APM_TOKEN}" }
    compression: gzip
  1. Vos applications pointent vers le Collector, sans jeton :

OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318

AWS (EC2, ECS, EKS, Lambda)

  • Définissez les variables OTEL_* dans la définition de tâche (ECS), le Deployment (EKS), la configuration de la fonction (Lambda) ou le service système (EC2).

  • Conservez le jeton dans Secrets Manager ou Parameter Store.

  • Détecteurs AWS : en Node OTEL_NODE_RESOURCE_DETECTORS=all ; en Java -Dotel.resource.providers.aws.enabled=true ; en Python, installez opentelemetry-sdk-extension-aws et définissez OTEL_EXPERIMENTAL_RESOURCE_DETECTORS=aws_ec2,aws_ecs,aws_eks.

  • Sur Lambda, utilisez la couche officielle d'OpenTelemetry de votre langage et ajoutez AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler aux variables.

Azure (VM, App Service, AKS, Functions)

  • Définissez les variables dans la Configuration de l'application (App Service et Functions), dans le Deployment (AKS) ou dans le service (VM).

  • Conservez le jeton dans Key Vault.

  • Détecteurs 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)

  • Définissez les variables dans le service Cloud Run, le Deployment GKE ou l'instance.

  • Conservez le jeton dans Secret Manager.

  • Détecteurs : Node OTEL_NODE_RESOURCE_DETECTORS=all ; Java -Dotel.resource.providers.gcp.enabled=true ; Python pip install opentelemetry-resourcedetector-gcp.

Railway

Si vous supervisez déjà vos services Railway dans ARGUNIS, le service APM s'associe tout seul à son service Railway quand l'attribut railway.service.id (ou railway.service.name) arrive.

  1. Définissez les variables OTEL_* dans le service Railway.

  2. Dans la commande de démarrage, ajoutez les identifiants Railway comme attributs de ressource :

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 vous définissez OTEL_RESOURCE_ATTRIBUTES comme variable Railway (et non dans la commande), écrivez ${{RAILWAY_SERVICE_ID}}. La forme $RAILWAY_SERVICE_ID n'est remplacée qu'à l'intérieur d'un shell.

Kubernetes (tout cloud ou sur site)

Avec l'OpenTelemetry Operator, les pods s'instrumentent tout seuls grâce à une annotation (Java, Node, Python, .NET et Go).

  1. Créez un secret avec l'en-tête du jeton :

kubectl create secret generic argunis-apm --from-literal=headers='Authorization=Bearer%20jtk_TU_TOKEN_DE_SERVIDOR'
  1. Créez la ressource Instrumentation présentée dans le guide Kubernetes, avec votre URL d'ingestion comme endpoint et le secret dans OTEL_EXPORTER_OTLP_HEADERS.

  2. Annotez le Deployment selon le langage :

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 et serveurs propres

Les mêmes variables vont dans docker-compose.yml (bloc environment), dans l'unité systemd (Environment="...") ou dans le service Windows. Le guide Docker / serveurs propres les présente déjà écrites dans les deux formats.

ARGUNIS associe le service au serveur de l'inventaire grâce à host.name.

Ce qui se passe ensuite

Le service apparaît dans APM → Services avec la colonne Où il s'exécute (par exemple, le cloud, le cluster ou le serveur) et, si ARGUNIS a pu l'associer, le groupe de l'inventaire dans Association.

Voir aussi

Rechercher dans Argunis Monitoring

Saisissez au moins 2 caractères pour rechercher dans Argunis Monitoring.

↑↓ naviguer · Enter ouvrir · Esc fermer