View a markdown version of this page

AWS mesures distribuées dans un format OpenTelemetry - Amazon CloudWatch
Permettre OpenTelemetry l'enrichissement pour les métriques distribuées

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 mesures distribuées dans un format OpenTelemetry

Astuce

Pour en savoir plus CloudWatch, consultez OpenTelemetry la série d'ateliers et d'événements consacrés à l'activation des opérations dans le cloud.

Vous pouvez activer l'enrichissement OTel pour que les métriques distribuées pour les AWS ressources prises en charge puissent être interrogées via ProMQL. Une fois que vous avez activé l'enrichissement OTel, les métriques qui contiennent une dimension d'identifiant de ressource (par exemple, EC2 CPUUtilization avec une InstanceId dimension) sont enrichies avec l'ARN de la ressource et des étiquettes de balise de ressource et peuvent être interrogées à l'aide de ProMQL.

La métrique enrichie conserve 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'instrumentation  : identifie le service source et marque la métrique comme OTel-enriched.

  • Balises de ressources  : toutes les balises de AWS ressources 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 pour les métriques distribuées

Avant de commencer l'enrichissement OTel, vous devez activer les balises de ressources sur la télémétrie de 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 l'opération suivante : cloudwatch:StartOTelEnrichment

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

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

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

  3. Dans le volet Activer l'enrichissement de l'OTel pour les AWS métriques, activez la fonctionnalité.

AWS CLI

aws cloudwatch start-otel-enrichment

CloudFormation

Note

La AWS::CloudWatch::OTelEnrichment ressource nécessite d'AWS::ObservabilityAdmin::TelemetryEnrichmentabord d'être configurée. Pour plus d'informations, consultez la section Activer les balises de ressources sur la télémétrie.

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

Terraforme

Note

La ressource aws_cloudwatch_otel_enrichment Terraform nécessite d'abord qu'aws_observabilityadmin_telemetry_enrichmentelle soit 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.

Pour activer cette fonctionnalité dans plusieurs régions, créez la même ressource dans chaque pile régionale ou appelez l'API dans chaque région qui vous intéresse.

Une fois l'enrichissement activé, vous pouvez commencer à interroger les métriques distribuées via ProMQL. Voir : Interroger un vendeur AWS métriques avec ProMQL.