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.

CloudWatch Agent Amazon

L' CloudWatch agent est construit sur le OpenTelemetry Collector, vous pouvez donc l'utiliser pour recevoir des OpenTelemetry données et les envoyer aux points de terminaison CloudWatch OTLP. Pour la plupart des clients, il s'agit de la méthode recommandée pour envoyer des données de OpenTelemetry télémétrie CloudWatch, car un seul agent peut également fournir des expériences organisées, telles que CloudWatch Application Signals et CloudWatch Enhanced Container Insights.

Pour envoyer OpenTelemetry des données via l'agent aujourd'hui, vous devez fournir une configuration de OpenTelemetry collecteur en YAML et l'ajouter à la configuration de l'agent. Démarrez l'agent avec le fichier de configuration de votre CloudWatch agent, puis ajoutez le fichier OpenTelemetry YAML :

/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -c file:/tmp/agent.json -s
/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a append-config -c file:/tmp/otel.yaml -s

L'agent fusionne les deux configurations au démarrage et enregistre la configuration résolue. Pour éviter les conflits de fusion avec les pipelines créés automatiquement par l'agent, ajoutez un suffixe personnalisé à chaque composant et à chaque nom de pipeline dans votre code OpenTelemetry YAML (par exemple,otlphttp/cwagent).

OpenTelemetry Composants pris en charge

Les OpenTelemetry composants suivants peuvent être configurés dans votre configuration YAML ajoutée. Utilisez le nom du type de composant indiqué ici comme clé dans votre YAML.

L' CloudWatch agent prend uniquement en charge l'écriture de données télémétriques vers des AWS destinations.

Exemples de configuration

Les exemples suivants envoient chaque signal au point de terminaison CloudWatch OTLP correspondant à l'aide de l'otlphttpexportateur et de l'sigv4authextension. Chaque nom de composant et de pipeline utilise un /cwagent suffixe pour éviter les conflits avec les pipelines créés automatiquement par l'agent. Remplacez region par votre AWS région.

Métriques

receivers:
  otlp/cwagent:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
processors:
  batch/cwagent: {}
exporters:
  otlphttp/cwagent:
    metrics_endpoint: https://monitoring.region.amazonaws.com/v1/metrics
    auth:
      authenticator: sigv4auth/cwagent
extensions:
  sigv4auth/cwagent:
    region: "region"
    service: "monitoring"
service:
  extensions: [sigv4auth/cwagent]
  pipelines:
    metrics/cwagent:
      receivers: [otlp/cwagent]
      processors: [batch/cwagent]
      exporters: [otlphttp/cwagent]

Journaux

receivers:
  otlp/cwagent:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
exporters:
  otlphttp/cwagent:
    logs_endpoint: https://logs.region.amazonaws.com/v1/logs
    headers:
      x-aws-log-group: my-log-group
      x-aws-log-stream: default
    auth:
      authenticator: sigv4auth/cwagent
extensions:
  sigv4auth/cwagent:
    region: "region"
    service: "logs"
service:
  extensions: [sigv4auth/cwagent]
  pipelines:
    logs/cwagent:
      receivers: [otlp/cwagent]
      exporters: [otlphttp/cwagent]

Suivis

receivers:
  otlp/cwagent:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
exporters:
  otlphttp/cwagent:
    traces_endpoint: https://xray.region.amazonaws.com/v1/traces
    auth:
      authenticator: sigv4auth/cwagent
extensions:
  sigv4auth/cwagent:
    region: "region"
    service: "xray"
service:
  extensions: [sigv4auth/cwagent]
  pipelines:
    traces/cwagent:
      receivers: [otlp/cwagent]
      exporters: [otlphttp/cwagent]