Ce document explique comment envoyer des métriques directement depuis des applications au point de terminaison OTLP à l'aide d'un SDK et de l'exportateur gRPC, qui est l'exportateur recommandé pour une utilisation avec les SDK.
Le point de terminaison OTLP est compatible avec tous les protocoles OTLP, y compris http/proto, http/json et grpc. Pour en savoir plus, consultez la section
Compatibilité avec le protocole.
Lorsque vous envoyez des métriques d'application directement au point de terminaison OTLP, l'OpenTelemetry Collector ne gère pas l'authentification ni l'enrichissement pour vous. Lorsque vous utilisez des SDK pour envoyer des métriques à partir d'applications, vous devez procéder comme suit :
- Configurez les identifiants de l'exportateur gRPC OTLP pour qu'il utilise les identifiants par défaut de l'application Google , comme décrit dans Obtenir les identifiants d'authentification.
- Détectez Google Cloud les ressources Kubernetes à partir de l'application. La procédure à suivre dépend de l'application que vous exécutez.
Avant de commencer
Pour exécuter les exemples, vous devez activer les API nécessaires et obtenir des identifiants d'authentification.
Activer les API
Activez l'API Cloud Monitoring et l'API Telemetry dans votre Google Cloud projet en exécutant la commande suivante :
gcloud services enable monitoring.googleapis.com telemetry.googleapis.com
Obtenir les identifiants d'authentification
Configurez les identifiants de l'exportateur gRPC OTLP pour qu'il utilise les identifiants par défaut de l'application Google Application en exécutant la commande suivante :
gcloud auth application-default login
Exemples spécifiques à un langage
Cette section fournit une sélection d'exemples spécifiques à un langage qui créent et écrivent une métrique de compteur. Sélectionnez un onglet pour obtenir des informations sur l'exécution de l'exemple et afficher le code.
Go
Pour savoir comment configurer et exécuter cet exemple, consultez le
README fichier de l'
exemple Go.
Java
Pour savoir comment configurer et exécuter cet exemple, consultez le
README fichier de l'
exemple Java.
NodeJS
Pour savoir comment configurer et exécuter cet exemple, consultez le
README fichier de l'
exemple NodeJS.
Python
Pour savoir comment exécuter cet exemple, consultez le README fichier de l'
README fichier de l'
exemple Python.
Utiliser l'API downward pour les applications exécutées en tant que pods
Si vous exécutez l'application en tant que pod dans Kubernetes et que vous ne l'envoyez pas via l'OpenTelemetry Collector, veillez à utiliser l' API downward pour définir les attributs de ressource Kubernetes :
env:
- name: POD_NAME
valueFrom:
fieldRef:
fieldPath: metadata.name
- name: NAMESPACE_NAME
valueFrom:
fieldRef:
fieldPath: metadata.namespace
- name: CONTAINER_NAME
value: my-container-name
- name: OTEL_RESOURCE_ATTRIBUTES
value: k8s.pod.name=$(POD_NAME),k8s.namespace.name=$(NAMESPACE_NAME),k8s.container.name=$(CONTAINER_NAME)
Étape suivante
- Pour en savoir plus sur l'utilisation d'un OpenTelemetry Collector et de l' API Telemetry avec l'instrumentation OpenTelemetry sans code, consultez Utiliser l'instrumentation OpenTelemetry sans code pour Java.
- Pour en savoir plus sur la migration vers l'exportateur
otlphttpà partir d'un autre exportateur, consultez Migrer vers l'exportateur OTLP. - Pour en savoir plus sur l'API Telemetry, consultez Présentation de l'API Telemetry (OTLP).