Puntos de conexión de OTLP
El protocolo de OpenTelemetry (OTLP) es un protocolo de entrega de datos de telemetría de uso general diseñado para OpenTelemetry. Los puntos de conexión de OpenTelemetry de CloudWatch son puntos de conexión HTTP 1.1. Debe configurar el recopilador de OpenTelemetry para empezar a enviar datos de telemetría abiertos a CloudWatch. Para obtener más información, consulte Introducción. El punto de conexión autentica a las personas que llaman mediante la autenticación de Signature 4. Para obtener más información, consulte Versión 4 de AWS Signature para solicitudes de API.
Punto de conexión de seguimientos
El punto de conexión de seguimientos sigue el patrón https://xray.. Por ejemplo, para la región Oeste de EE. UU. (Oregón) (us-west-2), el punto de conexión será AWS Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces.
Debe configurar el recopilador de OpenTelemetry para empezar a enviar seguimientos a CloudWatch. Para empezar, consulte Introducción.
Punto de conexión de registros
El punto de conexión de registros de seguimiento sigue el patrón https://logs.. Por ejemplo, en Región de AWS.amazonaws.com/v1/logsUS West (Oregon) (us-west-2) Region, el punto de conexión será https://logs.us-west-2.amazonaws.com/v1/logs. Puede utilizar el punto de conexión anterior para reenviar los registros a un LogGroup y LogStream existentes. Para obtener más información sobre cómo configurar LogGroup para la ingesta de datos de registro, consulte Conceptos de registros de Amazon CloudWatch. Se debe configurar LogGroup y LogStream cuando se invoca el punto de conexión de OpenTelemetry de CloudWatch Logs mediante el establecimiento de los encabezados HTTP x-aws-log-group y x-aws-log-stream en el nombre LogGroup y LogStream respectivamente. Para obtener más información, consulte Introducción.
Límites y restricciones del punto de conexión
En la tabla se enumeran los límites y restricciones comunes de los puntos de conexión para los seguimientos y los registros.
| Límite | Punto de conexión | Información adicional |
|---|---|---|
|
Extensión de recopilador requerida |
Para enviar seguimientos al punto de conexión de OTLP, debe usar sigv4authextension |
|
|
Protocolos admitidos |
HTTP |
El punto de conexión solo admite HTTP y no es compatible con gRPC |
|
Versiones compatibles con OTLP |
OTP 1.x |
|
|
Formato de cargas |
binario, json |
El punto de conexión acepta solicitudes en formatos binario y json |
|
Métodos de compresión |
gzip, ninguno |
El punto de conexión solo admite métodos de compresión gzip y sin compresión |
En la tabla se muestran los límites y restricciones de los puntos de conexión para los seguimientos.
| Límite | Punto de conexión de seguimientos | Información adicional |
|---|---|---|
|
Máximo de bytes sin comprimir por solicitud |
5 MB |
El punto de conexión de OTLP rechazará las solicitudes de más de 5 MB cuando la carga útil no esté comprimida. |
|
Máximo de eventos por solicitud |
10 000 unidades de seguimiento |
El número máximo permitido de unidades de seguimiento en una solicitud es de 10 000. Si se supera este límite, se rechazará la llamada a la API. |
|
Tamaño único de recurso y ámbito |
16 KB |
Cada recurso único y el ámbito correspondiente no deben superar los 16 KB de tamaño. Si cualquier recurso supera este límite, se rechazará la llamada a la API completa. |
|
Tamaño máximo de una sola unidad de seguimiento |
200 KB |
El punto de conexión rechazará las unidades de seguimiento de más de 200 KB. |
|
Marcas de tiempo creadas por unidades de seguimiento |
2 horas en el futuro y 14 días en el pasado |
Ninguna de las unidades de seguimiento del lote puede durar más de dos horas en el futuro o más de 14 días en el pasado. |
|
Intervalo de tiempo máximo en eventos por solicitud |
24 horas |
En la tabla se muestran los límites y restricciones de los puntos de conexión para los registros.
| Límite | Punto de conexión de registros | Información adicional |
|---|---|---|
|
Máximo de bytes sin comprimir por solicitud |
1 MB |
El punto de conexión de OTLP rechazará las solicitudes de más de 1 MB cuando la carga útil no esté comprimida. El tamaño máximo de solicitud es 1 048 576 bytes después de la descompresión y deserialización de datos binarios serializados por búferes de protocolo. Este tamaño se calcula como la suma de todos los mensajes de eventos en UTF-8, más 26 bytes para cada entrada del registro. |
Solicitud por segundo |
5000 |
5000 transacciones por segundo, por cuenta y por región. Puede solicitar un aumento de la cuota de limitación por segundo mediante el servicio Service Quotas. |
|
Máximo de eventos por solicitud |
10 000 registros |
El número máximo permitido de unidades de seguimiento en una solicitud es de 10 000. Si se supera este límite, se rechazará la llamada a la API. |
|
Tamaño único de recurso y ámbito |
16 KB |
Cada recurso único y el ámbito correspondiente no deben superar los 16 KB de tamaño. Si cualquier recurso supera este límite, se rechazará la llamada a la API completa. |
|
Tamaño único de LogEvent |
1 MB |
El tamaño de LogEvent se calcula como la suma de los tamaños de cada LogRecord, alcance y recurso. Esta cuota no se puede cambiar. |
Marcas de tiempo creadas por registros |
2 horas en el futuro y 14 días |
Las entradas de los registros del lote no tienen por qué estar en orden cronológico. Sin embargo, los registros del lote no pueden tener más de 2 horas en el futuro ni más de 14 días en el pasado. Además, ninguno de los registros puede ser anterior al periodo de retención del grupo de registros. |
|
Intervalo de tiempo máximo en eventos por solicitud |
24 horas |
nota
Los límites de cuentas de los registros se comparten entre el SDK y el nuevo punto de conexión de los registros.
