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

Endpoint OTLP

OpenTelemetry Il Protocollo (OTLP) è un protocollo di distribuzione di dati di telemetria generico progettato per. OpenTelemetry CloudWatch OpenTelemetry gli endpoint sono endpoint HTTP 1.1. È necessario configurare il OpenTelemetry raccoglitore a cui iniziare a inviare dati di telemetria aperti a. CloudWatch Per ulteriori informazioni, consulta Nozioni di base. L'endpoint autentica i chiamanti utilizzando l'autenticazione Signature 4. Per ulteriori informazioni, consulta AWS Signature Version 4 per le richieste API.

Endpoint Traces

L'endpoint delle tracce segue lo schema. https://xray.AWS Region.amazonaws.com/v1/traces Ad esempio, per la regione Stati Uniti occidentali (Oregon) (us-west-2), l'endpoint sarà. https://xray.us-west-2.amazonaws.com/v1/traces

Devi configurare il tuo OpenTelemetry raccoglitore a cui iniziare a inviare tracce. CloudWatch Per iniziare, consulta Nozioni di base.

Registra l'endpoint

L'endpoint dei log segue lo schema. https://logs.Regione AWS.amazonaws.com/v1/logs Ad esempio, perUS West (Oregon) (us-west-2) Region, l'endpoint sarà. https://logs.us-west-2.amazonaws.com/v1/logs È possibile utilizzare l'endpoint precedente per inoltrare i log a un dispositivo e esistente. LogGroup LogStream Per ulteriori informazioni sulla configurazione LogGroup per l'acquisizione dei dati di log, consulta i concetti di Amazon CloudWatch Logs. È necessario configurare LogGroup e LogStream quando richiamare l' OpenTelemetry endpoint CloudWatch Logs impostando le intestazioni x-aws-log-stream HTTP x-aws-log-group e il nome rispettivamente. LogGroup LogStream Per ulteriori informazioni, consulta Nozioni di base.

Limiti e restrizioni degli endpoint

La tabella elenca i limiti e le restrizioni comuni degli endpoint per le tracce e i log.

Limite Endpoint Informazioni aggiuntive

Estensione del collettore richiesta

estensione sigv4auth

Per inviare tracce all'endpoint OTLP è necessario utilizzare sigv4authextension

Protocolli supportati

HTTP

L'endpoint supporta solo HTTP e non supporta gRPC

Versioni OTLP supportate

OTLP 1.x

Formato del payload

binario, json

L'endpoint accetta richieste utilizzando i formati binari e json

Metodi di compressione

gzip, nessuno

L'endpoint supporta solo gzip e nessun metodo di compressione

La tabella elenca i limiti e le restrizioni degli endpoint per le tracce.

Limite Tracce l'endpoint Informazioni aggiuntive

Numero massimo di byte/richiesta non compressi

5 MB

L'endpoint OTLP rifiuterà le richieste superiori a 5 MB quando il payload non è compresso.

Numero massimo di eventi/richiesta

10.000 intervalli

Il numero massimo consentito di intervalli in una richiesta è 10.000. Il superamento di questo limite comporterà il rifiuto della chiamata API.

Dimensioni della singola risorsa e dell'ambito

16 KB

Ogni risorsa unica e l'ambito corrispondente non devono superare i 16 KB di dimensione. Il superamento di questo limite per qualsiasi risorsa comporterà il rifiuto dell'intera chiamata API.

Dimensione massima della campata singola

200 KB

Gli intervalli superiori a 200 KB verranno rifiutati dall'endpoint.

Span ha creato timestamp

2 ore nel futuro e 14 giorni nel passato

Nessuno degli intervalli del batch può durare più di due ore nelle future o più di 14 giorni nel passato.

Intervallo di tempo massimo tra eventi/richiesta

24 ore

La tabella elenca i limiti e le restrizioni degli endpoint per i log.

Limite Registra l'endpoint Informazioni aggiuntive

Numero massimo di byte/richiesta non compressi

1 MB

L'endpoint OTLP rifiuterà le richieste superiori a 1 MB quando il payload non è compresso.

La dimensione massima della richiesta è di 1.048.576 byte dopo la decompressione e la deserializzazione dei dati binari serializzati dai buffer di protocollo. Questa dimensione viene calcolata come somma di tutti i messaggi di evento in UTF-8, più 26 byte per ogni record di registro.

Richieste al secondo

5000

5000 transazioni al secondo per account per regione È possibile richiedere un aumento della quota di limitazione al secondo utilizzando il servizio Service Quotas.

Numero massimo di eventi/richiesta

10.000 registri

Il numero massimo consentito di intervalli in una richiesta è 10.000. Il superamento di questo limite comporterà il rifiuto della chiamata API.

Dimensioni della singola risorsa e dell'ambito

16 KB

Ogni risorsa unica e l'ambito corrispondente non devono superare i 16 KB di dimensione. Il superamento di questo limite per qualsiasi risorsa comporterà il rifiuto dell'intera chiamata API.

Taglia unica LogEvent

1 MB

LogEvent la dimensione viene calcolata come somma delle dimensioni per ciascuno LogRecord, Ambito e Risorsa. Questa quota non può essere modificata.

Registra i timestamp creati

2 ore nel futuro e 14 giorni

I record di registro del batch non devono essere necessariamente in ordine cronologico. Tuttavia, i record di registro del batch non possono avere più di 2 ore nel futuro e non possono avere più di 14 giorni nel passato. Inoltre, nessuno dei record di registro può essere precedente al periodo di conservazione del gruppo di log.

Intervallo di tempo massimo tra eventi/richiesta

24 ore

Nota

I limiti degli account per i log sono condivisi tra l'SDK e il nuovo endpoint Logs.