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
Un jeton serveur et l'URL d'ingestion. Voir Créer un jeton d'ingestion.
L'application déjà instrumentée selon son langage.
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.
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: gzipVos applications pointent vers le Collector, sans jeton :
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318AWS (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, installezopentelemetry-sdk-extension-awset définissezOTEL_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-handleraux 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; .NETOTEL_DOTNET_AUTO_AZURE_APP_SERVICE_RESOURCE_DETECTOR_ENABLED=true; Pythonpip 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; Pythonpip 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.
Définissez les variables
OTEL_*dans le service Railway.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.jsSi 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).
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'Créez la ressource
Instrumentationprésentée dans le guide Kubernetes, avec votre URL d'ingestion commeendpointet le secret dansOTEL_EXPORTER_OTLP_HEADERS.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.