Collectez des métriques et des traces avec OpenTelemetry - Amazon CloudWatch

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Collectez des métriques et des traces avec OpenTelemetry

Vous pouvez collecter des métriques et des traces à partir de vos applications ou services à l'aide de l' CloudWatchagent avec le OpenTelemetry protocole (OTLP), une solution open source populaire. Vous pouvez utiliser n'importe quel OpenTelemetry SDK pour envoyer des métriques et des traces à l' CloudWatch agent. Pour plus d'informations sur les langues disponibles OpenTelemetry SDKs, consultez la section Langue OpenTelemetry prise en charge APIs et SDKs. .

Pour collecter des OpenTelemetry métriques et des traces, ajoutez une otlp section au fichier de configuration de l' CloudWatch agent. La section inclut les champs suivants :

  • grpc_endpoint : facultatif. Spécifie l'adresse que l' CloudWatchagent doit utiliser pour écouter les OpenTelemetry métriques ou les traces envoyées à l'aide des appels de procédure à distance gRPC. Le format est ip:port. Cette adresse doit correspondre à l'adresse définie pour l'exportateur gRPC dans le OpenTelemetry SDK. Si vous omettez ce champ, la valeur par défaut de 127.0.0.1:4317 est utilisée.

  • http_endpoint : facultatif. Spécifie l'adresse que l' CloudWatch agent doit utiliser pour écouter les OpenTelemetry métriques ou les traces envoyées via HTTP. Le format est ip:port. Cette adresse doit correspondre à l'adresse définie pour l'exportateur HTTP dans le OpenTelemetry SDK. Si vous omettez ce champ, la valeur par défaut de 127.0.0.1:4318 est utilisée.

  • tls : facultatif. Spécifie que le serveur doit être configuré avec TLS.

    • cert_file— Chemin d'accès au certificat TLS à utiliser pour les connexions TLS requises.

    • key_file— Chemin d'accès à la clé TLS à utiliser pour les connexions TLS requises.

La otlp section peut être placée dans plusieurs sections du fichier de configuration de l' CloudWatch agent en fonction de la manière et de l'endroit où vous souhaitez envoyer les métriques et les traces.

Important

Chaque otlp section nécessite un point de terminaison et un port uniques. Pour des informations détaillées sur la division des points de terminaison des métriques et des traces, consultez la section Configuration de l'exportateur OTLP dans la documentation du OpenTelemetry SDK.

Pour envoyer des métriques à CloudWatch Amazon Managed Service for Prometheus, ajoutez otlp la section ci-dessous dans la metrics_collected section. metrics Pour plus d'informations sur l'envoi de métriques vers différentes destinations, consultezCréation ou modification manuelle du fichier de configuration de CloudWatch l'agent. L'exemple suivant montre une configuration qui envoie des métriques à CloudWatch :

Note

Si vous exécutez l'agent dans des environnements conteneurisés et que vous envoyez des données télémétriques depuis l'extérieur du réseau du conteneur de l'agent, veillez à spécifier le point de terminaison 0.0.0.0 plutôt que le point de terminaison par défaut. 127.0.0.1

{
  "metrics": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}

Pour envoyer des métriques à Amazon CloudWatch Logs à l'aide du format de métrique intégré (EMF), ajoutez la otlp section ci-dessous metrics_collected dans la logs section. Cela envoie les journaux EMF par défaut au groupe de /aws/cwagent journaux et un flux de journaux généré. Les métriques sont extraites dans l'espace de CWAgent noms par défaut. L'exemple suivant montre une configuration qui envoie des métriques sous forme de journaux EMF à CloudWatch Logs :

{
  "logs": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}

Pour envoyer des traces à AWS X-Ray, ajoutez la otlp section ci-dessous traces_collected dans la traces section. L'exemple suivant montre une configuration qui envoie des traces à X-Ray :

{
  "traces": {
    "traces_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}