Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CloudWatch Amazon-Vertreter
<a name="CloudWatch-OTLPCloudWatchAgent"></a>

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
<a name="CloudWatch-OTLPCloudWatchAgent-Components"></a>

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
<a name="CloudWatch-OTLPCloudWatchAgent-Examples"></a>

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.