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.
Endpoint delle tracce
L'endpoint delle tracce segue lo schema https://xray.. Ad esempio, per la Regione Stati Uniti occidentali (Oregon) (us-west-2), l'endpoint sarà AWS
Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces.
Devi configurare il OpenTelemetry raccoglitore a cui iniziare a inviare tracce. CloudWatch L'endpoint autentica chi effettua le chiamate utilizzando l'autenticazione Signature 4. Per ulteriori informazioni, consulta AWS Signature Version 4 for API requests.
Endpoint dei log
L'endpoint dei log segue lo schema https://logs.. Ad esempio, per Regione AWS.amazonaws.com/v1/logsUS West (Oregon) (us-west-2) Region, l'endpoint sarà https://logs.us-west-2.amazonaws.com/v1/logs. Puoi utilizzare l'endpoint precedente per inoltrare i log a un LogGroup e un LogStream esistenti. 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. L'endpoint autentica chi effettua le chiamate utilizzando l'autenticazione Signature 4. Per ulteriori informazioni, consulta AWS Signature Version 4 for API requests.
Quando la dimensione degli eventi del registro supera 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ù vicina possibile a 1 MB. Le porzioni in eccesso vengono memorizzate come Large Log Objects (LLOs) e vengono aggiunti i campi del sistema di riferimento LLO. Facoltativamente, è possibile specificare i percorsi dei campi che devono essere troncati impostando l'intestazione x-aws-truncatable-fields HTTP. LLOs Possono essere recuperati e trasmessi in streaming utilizzando l'GetLogObjectAPI. 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), Asia Pacifico (Sydney), Asia Pacifico (Mumbai), Stati Uniti orientali (Ohio), Europa (Irlanda), Asia Pacifico (Tokyo) e Asia Pacifico (Singapore).
Endpoint RUM
L'endpoint RUM segue lo schema. https://dataplane.rum.{AWS
Region}.amazonaws.com/v1/rum Ad esempio, per la regione Stati Uniti occidentali (Oregon), l'endpoint è. https://dataplane.rum.us-west-2.amazonaws.com/v1/rum Questo endpoint gestisce i dati di telemetria lato client (solo tracce e record di registro) per le applicazioni RUM. eventName CloudWatch
Per utilizzare questo endpoint, devi creare un monitor di app RUM con piattaforma mobile (Android/iOS) e utilizzare lo snippet di codice generato per strumentare le tue applicazioni. Lo snippet estrarrà i RUM Mobile SDKs configurati con questo endpoint. È possibile configurare SDKs ulteriormente in modo che RUM raccolga la telemetria di conseguenza.
L'endpoint supporta richieste autenticate e non autenticate. È possibile utilizzare AWS Signature Version 4 (SigV4) per richieste autenticate o politiche basate sulle risorse per consentire l'accesso non autenticato dalle applicazioni mobili.
Per ulteriori informazioni sui modelli di autenticazione così come definiti nella loro definizione, consulta quanto segue: SDKs
-
Applicazioni iOS - AWS Distro for OpenTelemetry (ADOT) iOS SDK
. -
Applicazioni Android - AWS Distro per OpenTelemetry (ADOT
) Android SDK.
Limiti e restrizioni dell'endpoint
La tabella elenca i limiti e le restrizioni comuni degli endpoint per tracce e log.
| Limite | Endpoint | Informazioni aggiuntive |
|---|---|---|
|
Estensione del raccoglitore richiesta |
Per inviare tracce all'endpoint OTLP è necessario utilizzare sigv4authextension |
|
|
Protocolli supportati |
HTTP |
L'endpoint supporta solo HTTP e non supporta gRPC |
|
Versioni OLTP 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 | Endpoint delle tracce | Informazioni aggiuntive |
|---|---|---|
|
Numero massimo di byte non compressi per richiesta |
5 MB |
L'endpoint OTLP rifiuta le richieste superiori a 5 MB quando il payload non è compresso. |
|
Numero massimo di eventi per 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 specifica 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 dell'intervallo singolo |
200 KB |
Gli intervalli superiori a 200 KB verranno rifiutati dall'endpoint. |
|
Timestamp di creazione dell'intervallo |
2 ore nel futuro e 14 giorni nel passato |
Nessuno degli intervalli del batch può essere superiore a 2 ore nel futuro oppure oltre 14 giorni nel passato. |
|
Intervallo di tempo massimo in eventi per richiesta |
24 ore |
La tabella elenca i limiti e le restrizioni degli endpoint per i log.
| Limite | Endpoint dei log | Informazioni aggiuntive |
|---|---|---|
|
Numero massimo di byte non compressi per richiesta |
1 MB |
L'endpoint OTLP rifiuta 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 la somma di tutti i messaggi di eventi in UTF-8, più 26 byte per ogni record di log. |
|
20 MB Disponibile solo negli Stati Uniti orientali (Virginia settentrionale) Stati Uniti occidentali (Oregon), Europa (Francoforte), Asia Pacifico (Sydney), Asia Pacifico (Mumbai), Stati Uniti orientali (Ohio), Europa (Irlanda), Asia Pacifico (Tokyo) e Asia Pacifico (Singapore). |
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 CloudWatch le funzionalità di Logs, tra cui query e live tail. Per i log di dimensioni superiori a 1 MB: la parte in eccesso viene elaborata come Large Log Objects (). LLOs |
|
Richiesta al secondo |
5000 |
5.000 transazioni al secondo per account per Regione Puoi richiedere un aumento della quota di limitazione della larghezza di banda della rete al secondo utilizzando il servizio Service Quotas. |
|
Dimensioni della singola risorsa e dell'ambito |
16 KB |
Ogni risorsa specifica 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 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. |
Timestamp di creazione dei log |
2 ore nel futuro e 14 giorni nel passato |
I record di log nel batch non devono essere necessariamente in ordine cronologico. Tuttavia, i record di log nel batch non possono essere superiori a 2 ore nel futuro e oltre 14 giorni nel passato. Inoltre, nessuno dei record di log può essere precedente al periodo di conservazione del gruppo di log. |
|
Intervallo di tempo massimo in eventi per richiesta |
24 ore |
|
|
Numero massimo di eventi per richiesta |
10.000 log |
Il numero massimo di eventi del log in un batch è 10.000. Il superamento di questo limite comporterà il rifiuto della chiamata API. |
|
Numero massimo di oggetti log di grandi dimensioni per richiesta |
1 record di log Disponibile negli Stati Uniti orientali (Virginia settentrionale) Stati Uniti occidentali (Oregon), Europa (Francoforte), Asia Pacifico (Sydney), Asia Pacifico (Mumbai), Stati Uniti orientali (Ohio), Europa (Irlanda), Asia Pacifico (Tokyo) e Asia Pacifico (Singapore). |
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 log per richiesta. |
|
Numero massimo di oggetti log di grandi dimensioni per record |
10 LLOs Disponibile negli Stati Uniti orientali (Virginia settentrionale) Stati Uniti occidentali (Oregon), Europa (Francoforte), Asia Pacifico (Sydney), Asia Pacifico (Mumbai), Stati Uniti orientali (Ohio), Europa (Irlanda), Asia Pacifico (Tokyo) e Asia Pacifico (Singapore). |
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 dei log.
