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.

# AWS métriques vendues au format OpenTelemetry
<a name="CloudWatch-OTelEnrichment"></a>

**Astuce**  
Pour en savoir plus à ce OpenTelemetry sujet CloudWatch, consultez l'[atelier et la série d'événements consacrés à l'habilitation des opérations dans le cloud](https://aws-experience.com/amer/smb/events/series/Cloud-Operations-Enablement).

Vous pouvez activer l'enrichissement par OTel pour que les métriques vendues pour les [AWS ressources prises en charge puissent être interrogées via](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/UsingResourceTagsForTelemetry.html) ProMQL. Une fois activées, les métriques qui contiennent une dimension d'identifiant de ressource (par exemple, EC2 CPUUtilization avec une InstanceId dimension) sont enrichies d'ARN de ressource et d'étiquettes de ressource et peuvent être interrogées à l'aide de ProMQL.

La métrique enrichie préserve le nom et les CloudWatch dimensions de la métrique d'origine, et ajoute :
+ **Attributs** de ressource : ARN de la ressource (`cloud.resource_id`), fournisseur de cloud, région et ID de compte.
+ **Champ d'application de l'instrumentation** : identifie le service source et marque la métrique comme OTel-enriched.
+ **Balises de ressource** : toutes les balises de AWS ressource associées à la ressource, interrogeables sous forme d'étiquettes ProMQL.

La CloudWatch métrique classique d'origine n'est pas modifiée et reste disponible via les CloudWatch API existantes.

## Permettre OpenTelemetry l'enrichissement des métriques vendues
<a name="CloudWatch-OTelEnrichment-Enable"></a>

Avant de commencer l'enrichissement en OTel, vous devez [activer les balises de ressources sur la télémétrie](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/EnableResourceTagsOnTelemetry.html) pour votre compte.

Vous pouvez activer l'enrichissement OTel pour votre compte dans une région spécifique à l'aide de la CloudWatch console AWS CLI CloudFormation, de Terraform ou AWS du SDK.

Vous aurez besoin d'autorisations pour effectuer les opérations suivantes : `cloudwatch:StartOTelEnrichment`

**Pour activer l'enrichissement en OTel pour AWS métriques (CloudWatch console)**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le volet de navigation, choisissez **CloudWatch**, puis sélectionnez **Paramètres**.

1. Dans le volet **Activer l'enrichissement en AWS OTel pour les métriques**, activez la fonctionnalité.

**AWS CLI**

```
aws cloudwatch start-otel-enrichment
```

**CloudFormation**

**Note**  
La `AWS::CloudWatch::OTelEnrichment` ressource nécessite d'`AWS::ObservabilityAdmin::TelemetryEnrichment`abord qu'elle soit configurée. Pour plus d'informations, voir [Activer les balises de ressources en télémétrie](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/EnableResourceTagsOnTelemetry.html).

```
Resources:
  TelemetryEnrichmentExample:
    Type: AWS::ObservabilityAdmin::TelemetryEnrichment
  OTelEnrichmentExample:
    Type: AWS::CloudWatch::OTelEnrichment
    DependsOn: TelemetryEnrichmentExample
```

**Terraforme**

**Note**  
La ressource `aws_cloudwatch_otel_enrichment` Terraform nécessite que la `aws_observabilityadmin_telemetry_enrichment` ressource soit d'abord configurée.

```
resource "aws_observabilityadmin_telemetry_enrichment" "example" {
}

resource "aws_cloudwatch_otel_enrichment" "example" {
  depends_on = [aws_observabilityadmin_telemetry_enrichment.example]
}
```

Pour plus d'informations, consultez [aws\_cloudwatch\_otel\_enrichment dans le registre Terraform](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/cloudwatch_otel_enrichment).

Pour l'activer dans plusieurs régions, créez la même ressource dans chaque pile régionale ou appelez l'API dans chaque région d'intérêt.

Une fois l'enrichissement activé, vous pouvez commencer à interroger les métriques vendues via ProMQL. Voir : [Interrogation de vended AWS métriques avec ProMQL](CloudWatch-PromQL-Querying.md#CloudWatch-PromQL-Querying-Vended).