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.

Quando le dimensioni degli eventi di registro superano 1 MB, CloudWatch Logs tronca automaticamente fino a 10 campi, a partire dai campi più grandi. Ogni campo viene troncato in base alle esigenze per mantenere la dimensione totale dell'evento il più vicino possibile a 1 MB. Le porzioni in eccesso vengono memorizzate come vengono aggiunti i campi del sistema di riferimento Large Log Objects (LLOs) e LLO. Facoltativamente, è possibile specificare i percorsi dei campi che devono essere troncati impostando l'intestazione HTTP. x-aws-truncatable-fields LLOs Possono essere recuperati e trasmessi in streaming utilizzando l'API. GetLogObject Per ulteriori informazioni, consulta GetLogObject. Il supporto per eventi di registro di dimensioni superiori a 1 MB e l'esperienza LLO sono disponibili negli Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Europa (Francoforte) e Asia Pacifico (Sydney).

Limiti e restrizioni sugli 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 di intervalli in un batch è 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.
	20 MB Disponibile solo negli Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Europa (Francoforte) e Asia Pacifico (Sydney).	La dimensione massima della richiesta è di 20 MB (20.971.520 byte) dopo la decompressione e la decodifica del payload OTLP dal formato JSON. Per log fino a 1 MB: questi log hanno pieno accesso a tutte le funzionalità di Logs, comprese le query e il live tail. CloudWatch Per i log di dimensioni superiori a 1 MB: la parte in eccesso viene elaborata come Large Log Objects (). LLOs
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.
Singola dimensione della 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 future e 14 giorni fa	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
Numero massimo di eventi/richiesta	10.000 registri	Il numero massimo di eventi di registro in un batch è 10.000. Il superamento di questo limite comporterà il rifiuto della chiamata API.
Numero massimo di oggetti/richiesta di log	1 record di registro Disponibile negli Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Europa (Francoforte) e Asia Pacifico (Sydney).	Per i contenuti che superano 1 MB in un evento di registro, il contenuto in eccesso viene archiviato come. LLOs Limitato a 1 record di registro per richiesta.
Numero massimo di oggetti/record di log	10 LLOs Disponibile negli Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Europa (Francoforte) e Asia Pacifico (Sydney).	Un singolo record di registro può contenere fino a 10. LLOs

Nota

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