Utiliser l'API Telemetry

Vous pouvez configurer l'agent Ops pour qu'il utilise l'API Telemetry (OTLP) afin d'envoyer des journaux, des métriques et des traces à votre projet Google Cloud . L'API Telemetry, telemetry.googleapis.com, est une implémentation du protocole OpenTelemetry Open Source. Lorsque vous configurez l'agent Ops pour qu'il utilise cette API, il envoie des données de télémétrie à l'aide de l'API Telemetry plutôt que des API propriétaires Cloud Monitoring, API Logging ou Trace.

Si vous adoptez l'utilisation de l'API Telemetry dans l'agent Ops et que vous avez des graphiques ou des règles d'alerte qui surveillent votre utilisation de l'API, vous devez mettre à jour ces artefacts pour surveiller le point de terminaison telemetry.googleapis.com plutôt que les points de terminaison monitoring.googleapis.com, logging.googleapis.com ou cloudtrace.googleapis.com.

Avant de commencer

Pour utiliser l'API Telemetry, procédez comme suit :

  1. Activez l'API Telemetry dans votre projet Google Cloud , si elle ne l'est pas déjà. Vous pouvez activer l'API en exécutant la commande suivante :

    gcloud services enable telemetry.googleapis.com

  2. Ajustez les quotas de l'API Telemetry si les valeurs par défaut ne suffisent pas. L'API Telemetry dispose de quotas distincts de ceux de l'API Cloud Monitoring et de l'API Cloud Logging. Pour en savoir plus sur les quotas et les limites de l'API Telemetry, consultez les ressources suivantes :

    Vous devrez peut-être ajuster ces quotas pour tenir compte du volume de données de télémétrie que vous ingérez.

  3. Si vous collectez des traces, attribuez le rôle Écrivain de traces de télémétrie Cloud (roles/telemetry.tracesWriter) au compte de service utilisé par l'agent Ops. Ce rôle fournit les autorisations nécessaires pour écrire des traces.

Configurer l'agent Ops pour utiliser l'API Telemetry

L'agent Ops propose une option de configuration permettant de choisir entre l'envoi de télémétrie à l'aide de l'API propriétaire (par défaut) et à l'aide de l'API Telemetry. Pour collecter des données de télémétrie à l'aide de l'agent Ops et de l'API Telemetry, vous devez effectuer les opérations suivantes, comme décrit dans les sections suivantes :

  1. Installez une version de l'agent Ops compatible avec l'API Telemetry.
  2. Mettez à jour le fichier config.yaml de l'agent Ops pour définir l'option de configuration.
  3. Redémarrez l'agent Ops pour appliquer la modification.

Utiliser la version 2.71.0 ou ultérieure de l'agent Ops

Pour utiliser l'API Telemetry avec l'agent Ops, vous devez installer l'agent Ops version 2.71.0 ou ultérieure. Pour en savoir plus sur l'installation de l'agent Ops, consultez Installer l'agent Ops sur des VM individuelles.

Définir l'option de configuration

Autorisez l'agent Ops à accéder à l'API Telemetry en définissant l'option de configuration otlp_exporter sur true dans le fichier config.yaml de l'agent :

global:
   otlp_exporter: true

Redémarrer l'agent Ops

Linux

  1. Pour redémarrer l'agent, exécutez la commande suivante sur votre instance : 
    sudo systemctl restart google-cloud-ops-agent
  2. Pour vérifier que l'agent a redémarré, exécutez la commande suivante et vérifiez que les composants "Agent de métriques" et "Agent de journalisation" ont démarré : 
    sudo systemctl status "google-cloud-ops-agent*"

Windows

  1. Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.
  2. Ouvrez un terminal PowerShell avec des droits d'administrateur en effectuant un clic droit sur l'icône PowerShell, puis en sélectionnant Exécuter en tant qu'administrateur.
  3. Pour redémarrer l'agent, exécutez la commande PowerShell suivante : 
    Restart-Service google-cloud-ops-agent -Force
  4. Pour vérifier que l'agent a redémarré, exécutez la commande suivante et vérifiez que les composants "Agent de métriques" et "Agent de journalisation" ont démarré : 
    Get-Service google-cloud-ops-agent*

Configurer l'agent Ops pour qu'il n'utilise pas l'API Telemetry

Pour empêcher l'agent Ops de collecter des données de télémétrie à l'aide de l'API Telemetry et reprendre la collecte de données de télémétrie à l'aide des API Cloud Monitoring, API Logging et Trace, procédez comme suit :

  1. Supprimez l'option otlp_exporter du fichier config.yaml. Vous pouvez également définir l'option sur false.

  2. Redémarrez l'agent Ops pour appliquer la modification.

Étapes suivantes