Raccogli metriche e tracce con OpenTelemetry - Amazon CloudWatch

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

È possibile raccogliere metriche e tracce dalle applicazioni o dai 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 &. 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. Speciifica che il server deve essere configurato con TLS.

    • cert_file— Percorso del certificato TLS da utilizzare per le connessioni TLS richieste.

    • key_file— 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 otlp sezione richiede un endpoint e una porta unici. Per informazioni dettagliate sulla suddivisione degli endpoint Metrics e Traces, consulta 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 diverse destinazioni, consulta. Crea o modifica manualmente il file di configurazione CloudWatch dell'agente L'esempio seguente mostra una configurazione che invia le metriche a: CloudWatch

Nota

Se esegui l'agente in ambienti containerizzati e invii telemetria dall'esterno della rete del contenitore dell'agente, assicurati di specificare l'endpoint come anziché l'endpoint predefinito. 0.0.0.0 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 e a un flusso di /aws/cwagent 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 sezionetraces_collected. traces L'esempio seguente mostra una configurazione che invia tracce a X-Ray:

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