CloudWatch Amazon-Vertreter

Der CloudWatch Agent basiert auf dem OpenTelemetry Collector, sodass Sie ihn verwenden können, um OpenTelemetry Daten zu empfangen und an die CloudWatch OTLP-Endpunkte zu senden. Für die meisten Kunden ist dies die empfohlene Methode zum Senden von OpenTelemetry Telemetriedaten CloudWatch, da ein einziger Agent auch kuratierte Erlebnisse wie CloudWatch Application Signals und CloudWatch Enhanced Container Insights bereitstellen kann.

Um heute OpenTelemetry Daten über den Agenten zu senden, geben Sie eine OpenTelemetry Collector-Konfiguration in YAML an und fügen sie an die eigene Konfiguration des Agenten an. Starten Sie den Agenten mit Ihrer CloudWatch Agenten-Konfigurationsdatei und hängen Sie dann die YAML-Datei an OpenTelemetry :

/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

Der Agent führt die beiden Konfigurationen beim Start zusammen und protokolliert die aufgelöste Konfiguration. Um Zusammenführungskonflikte mit Pipelines zu vermeiden, die der Agent automatisch erstellt, fügen Sie jeder Komponente und jedem Pipeline-Namen in Ihrer OpenTelemetry YAML ein benutzerdefiniertes Suffix hinzu (z. B.). otlphttp/cwagent

Unterstützte Komponenten OpenTelemetry

Die folgenden OpenTelemetry Komponenten können Sie in Ihrer angehängten YAML-Konfiguration konfigurieren. Verwenden Sie den hier angezeigten Komponententypnamen als Schlüssel in Ihrer YAML.

Komponententyp	Verfügbare Komponenten
Empfänger	otlp, prometheus, statsd, collectd, jmx, hostmetrics, filelog, tcplog, udplog, jaeger, zipkin, kafka, kubeletstats
Prozessoren	batch, memory_limiter, filter, attributes, resource, resourcedetection, metricstransform, transform, cumulativetodelta, deltatocumulative, deltatorate, groupbyattrs, groupbytrace, k8sattributes, metricsgeneration, metricstarttime, probabilistic_sampler, span, tail_sampling
Exporteure	otlphttp, awsemf, awscloudwatchlogs, awsxray, prometheusremotewrite, debug
Erweiterungen	sigv4auth, headers_setter, file_storage, health_check, pprof, zpages

Der CloudWatch Agent unterstützt nur das Schreiben von Telemetrie an AWS Ziele.

Beispiele für Konfigurationen

In den folgenden Beispielen wird jedes Signal mithilfe des otlphttp Exporters und der Erweiterung an den entsprechenden CloudWatch OTLP-Endpunkt gesendet. sigv4auth Jeder Komponenten- und Pipelinename verwendet ein /cwagent Suffix, um Konflikte mit Pipelines zu vermeiden, die der Agent automatisch erstellt. Ersetzen Sie es region durch Ihre Region AWS .

Metriken

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]

Protokolle

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]

Ablaufverfolgungen

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]

Anmerkung

Stellen Sie sicher, dass die Transaktionssuche aktiviert ist, bevor Sie Traces an den OTLP-Traces-Endpunkt senden.