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à.

# Raccogli metriche e tracce con OpenTelemetry
<a name="CloudWatch-Agent-OpenTelemetry-metrics"></a>

 Puoi raccogliere metriche e tracce dalle tue applicazioni o servizi utilizzando l' CloudWatchagente con il OpenTelemetry protocollo (OTLP), una popolare soluzione open source. Puoi utilizzare qualsiasi OpenTelemetry SDK per inviare metriche e tracce all'agente. CloudWatch Per ulteriori informazioni su ciò che è disponibile OpenTelemetry SDKs, consulta [Lingua OpenTelemetry APIs supportata &](https://opentelemetry.io/docs/languages/). SDKs .

Per raccogliere OpenTelemetry metriche e tracce, aggiungete una `otlp` sezione al file di configurazione dell' CloudWatch agente. La sezione contiene i seguenti campi:
+ `grpc_endpoint` : Opzionale. Speciifica l'indirizzo che l' CloudWatchagente deve utilizzare per ascoltare le OpenTelemetry metriche o le tracce inviate utilizzando chiamate di procedura remota gRPC. Il formato è `ip:port`. Questo indirizzo deve corrispondere all'indirizzo impostato per l'esportatore gRPC nell'SDK. OpenTelemetry Se ometti questo campo, verrà utilizzato il valore predefinito `127.0.0.1:4317`.
+ `http_endpoint` : Opzionale. Speciifica l'indirizzo che l' CloudWatch agente deve utilizzare per ascoltare le OpenTelemetry metriche o le tracce inviate tramite HTTP. Il formato è `ip:port`. Questo indirizzo deve corrispondere all'indirizzo impostato per l'esportatore HTTP nell'SDK. OpenTelemetry Se ometti questo campo, verrà utilizzato il valore predefinito `127.0.0.1:4318`.
+ `tls` : Opzionale. Specifica che il server deve essere configurato con TLS.
  + `cert_file`: il percorso del certificato TLS da utilizzare per le connessioni TLS richieste.
  + `key_file`: il percorso della chiave TLS da utilizzare per le connessioni TLS richieste.

La `otlp` sezione può essere inserita in più sezioni all'interno del file di configurazione dell' CloudWatch agente a seconda di come e dove si desidera inviare le metriche e le tracce.

**Importante**  
Ogni sezione `otlp` richiede un endpoint e una porta univoci. Per informazioni dettagliate sulla suddivisione degli endpoint delle metriche e delle tracce, consulta [OTLP Exporter](https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/) Configuration nella documentazione SDK. OpenTelemetry 

Per inviare i parametri al CloudWatch nostro Amazon Managed Service for Prometheus, aggiungi `otlp` la sezione sottostante all'interno della sezione. `metrics_collected` `metrics` Per ulteriori informazioni sull'invio di metriche a destinazioni diverse, consulta[Crea o modifica manualmente il file di configurazione CloudWatch dell'agente](CloudWatch-Agent-Configuration-File-Details.md). L'esempio seguente mostra una configurazione che invia metriche a: CloudWatch

**Nota**  
 Se esegui l'agente in ambienti containerizzati e invii telemetria dall'esterno della rete del container dell'agente, assicurati di specificare l'endpoint come `0.0.0.0` anziché l'endpoint predefinito `127.0.0.1`.

```
{
  "metrics": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}
```

Per inviare i parametri ad Amazon CloudWatch Logs utilizzando il formato Embedded metric (EMF), aggiungi la `otlp` sezione sotto `metrics_collected` all'interno della sezione. `logs` Per impostazione predefinita, questo invia i log EMF al gruppo di log `/aws/cwagent` e un flusso di log generato. Per impostazione predefinita, le metriche vengono estratte nel namespace `CWAgent`. L'esempio seguente mostra una configurazione che invia le metriche come log EMF a Logs: CloudWatch 

```
{
  "logs": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}
```

Per inviare tracce a AWS X-Ray, aggiungete la `otlp` sezione sottostante all'interno della sezione`traces_collected`. `traces` L'esempio seguente mostra una configurazione che invia le metriche a X-Ray:

```
{
  "traces": {
    "traces_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}
```