Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

L' CloudWatch agente è basato su OpenTelemetry Collector, quindi è possibile utilizzarlo per ricevere OpenTelemetry dati e inviarli agli endpoint CloudWatch OTLP. Per la maggior parte dei clienti, questo è il metodo consigliato per inviare dati di OpenTelemetry telemetria a CloudWatch, poiché un singolo agente può anche fornire esperienze curate come Application Signals e Enhanced Container Insights. CloudWatch CloudWatch 

Per inviare OpenTelemetry dati tramite l'agente oggi, è necessario fornire una configurazione del OpenTelemetry raccoglitore in YAML e aggiungerla alla configurazione propria dell'agente. Avvia l'agente con il file di configurazione CloudWatch dell'agente, quindi aggiungi il file YAML: 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
```

L'agente unisce le due configurazioni all'avvio e registra la configurazione risolta. Per evitare conflitti di fusione con le pipeline create automaticamente dall'agente, aggiungi un suffisso personalizzato a ciascun componente e al nome della pipeline nel tuo OpenTelemetry file YAML (ad esempio,). `otlphttp/cwagent`

## Componenti supportati OpenTelemetry
<a name="CloudWatch-OTLPCloudWatchAgent-Components"></a>

I seguenti OpenTelemetry componenti possono essere configurati nella configurazione YAML aggiunta. Usa il nome del tipo di componente mostrato qui come chiave nel tuo YAML.


| Tipo di componente | Componenti disponibili | 
| --- | --- | 
| Ricevitori | `otlp`, `prometheus`, `statsd`, `collectd`, `jmx`, `hostmetrics`, `filelog`, `tcplog`, `udplog`, `jaeger`, `zipkin`, `kafka`, `kubeletstats` | 
| Processori | `batch`, `memory_limiter`, `filter`, `attributes`, `resource`, `resourcedetection`, `metricstransform`, `transform`, `cumulativetodelta`, `deltatocumulative`, `deltatorate`, `groupbyattrs`, `groupbytrace`, `k8sattributes`, `metricsgeneration`, `metricstarttime`, `probabilistic_sampler`, `span`, `tail_sampling` | 
| Esportatori | `otlphttp`, `awsemf`, `awscloudwatchlogs`, `awsxray`, `prometheusremotewrite`, `debug` | 
| Estensioni | `sigv4auth`, `headers_setter`, `file_storage`, `health_check`, `pprof`, `zpages` | 

L' CloudWatch agente supporta solo la scrittura di telemetria per le destinazioni. AWS 

## Esempi di configurazione
<a name="CloudWatch-OTLPCloudWatchAgent-Examples"></a>

Gli esempi seguenti inviano ogni segnale all'endpoint CloudWatch OTLP corrispondente utilizzando l'esportatore e l'estensione. `otlphttp` `sigv4auth` Ogni nome di componente e pipeline utilizza un `/cwagent` suffisso per evitare conflitti con le pipeline create automaticamente dall'agente. Sostituisci {{region}} con la tua regione. AWS 

**Parametri**

```
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]
```

**Log**

```
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]
```

**Tracce**

```
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]
```

**Nota**  
Assicurati che Transaction Search sia abilitato prima di inviare le tracce all'endpoint di tracciamento OTLP.