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
<a name="CloudWatch-Agent-OpenTelemetry-metrics"></a>

 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 OpenTelemetry SDK disponibles, consultez la section [API et SDK linguistiques OpenTelemetry pris en charge](https://opentelemetry.io/docs/languages/). .

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. Indique que le serveur doit être configuré avec TLS.
  + `cert_file` : chemin d’accès au certificat TLS à utiliser pour les connexions nécessitant TLS.
  + `key_file` : chemin d’accès à la clé TLS à utiliser pour les connexions nécessitant TLS.

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 section `otlp` 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](https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/) 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 des métriques vers différentes destinations, consultez [Création ou modification manuelle du fichier de configuration de CloudWatch l'agent](CloudWatch-Agent-Configuration-File-Details.md). 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. Par défaut, les journaux EMF sont envoyés vers le groupe de journaux `/aws/cwagent` et un flux de journaux généré automatiquement. Par défaut, les métriques sont extraites dans l’espace de noms `CWAgent`. 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"
      }
    }
  }
}
```