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' CloudWatch agent 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' CloudWatch agent 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 le protocole 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. Chaque otlp section nécessite un point de terminaison unique. 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 à Amazon Managed Service for Prometheus CloudWatch ou à Amazon Managed Service, 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 :

{
  "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"
      }
    }
  }
}