View a markdown version of this page

CloudWatch Agent Amazon - Amazon CloudWatch

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 basé sur le OpenTelemetry collecteur, 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 OpenTelemetry télémétriques CloudWatch, car un seul agent peut également gérer des expériences personnalisées, telles que les signaux d' CloudWatch application et les informations CloudWatch améliorées sur les conteneurs.

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 propre configuration de l'agent. Démarrez l'agent avec votre fichier de configuration d' 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 nom de pipeline dans votre fichier 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 code YAML.

Type de composant Composants disponibles

Récepteurs

otlp, prometheus, statsd, collectd, jmx, hostmetrics, filelog, tcplog, udplog, jaeger, zipkin, kafka, kubeletstats

Processors

batch, memory_limiter, filter, attributes, resource, resourcedetection, metricstransform, transform, cumulativetodelta, deltatocumulative, deltatorate, groupbyattrs, groupbytrace, k8sattributes, metricsgeneration, metricstarttime, probabilistic_sampler, span, tail_sampling

Exportateurs

otlphttp, awsemf, awscloudwatchlogs, awsxray, prometheusremotewrite, debug

Extensions

sigv4auth, headers_setter, file_storage, health_check, pprof, zpages

L' CloudWatch agent prend uniquement en charge l'écriture de données télémétriques vers les 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]
Note

Assurez-vous que la recherche de transactions est activée avant d'envoyer des traces au point de terminaison des traces OTLP.