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.
Cuando el tamaño del evento de registro supera 1 MB, Registros de CloudWatch trunca automáticamente hasta 10 campos, comenzando por los campos más grandes. Cada campo se trunca según sea necesario para mantener el tamaño total del evento lo más cerca posible de 1 MB. Las partes sobrantes se almacenan como objetos de registro grandes (LLO) y se agregan los campos del sistema de referencia LLO. Como alternativa, puede especificar las rutas de los campos que deben truncarse mediante la configuración del x-aws-truncatable-fields encabezado HTTP. Los LLO se pueden recuperar y volver a retransmitir mediante la API GetLogObject. Para obtener más información, consulte GetLogObject. Dispone del soporte para eventos de registro de más de 1 MB y la experiencia de LLO en las regiones Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Fráncfort) y Asia-Pacífico (Sídney).
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 de intervalos en un lote 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. |
|
20 MB Disponible solo en las regiones Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Fráncfort) y Asia-Pacífico (Sídney). |
El tamaño máximo de la solicitud es de 20 MB (20 971 520 bytes) después de descomprimir y decodificar la carga útil OTLP en formato JSON. Para registros de hasta 1 MB: estos registros tienen acceso completo a todas las características de Registros de CloudWatch, incluidas las consultas y el seguimiento en directo. Para registros de más de 1 MB: la parte sobrante se procesa como objetos de registro grandes (LLO). |
|
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. |
|
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 |
|
|
Máximo de eventos por solicitud |
10 000 registros |
El número máximo de eventos de registro en un lote es de 10 000. Si se supera este límite, se rechazará la llamada a la API. |
|
Número máximo de objetos de registro grandes por solicitud |
1 entrada de registro Disponible en las regiones Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Fráncfort) y Asia-Pacífico (Sídney). |
En el caso del contenido que supere 1 MB en un evento de registro, el exceso de contenido se almacena como LLO. Limitado a 1 registro por solicitud. |
|
Número máximo de objetos de registro grandes por registro |
10 LLO Disponible en las regiones Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Fráncfort) y Asia-Pacífico (Sídney). |
Un solo registro de registro puede contener hasta 10 LLO. |
nota
Los límites de cuentas de los registros se comparten entre el SDK y el nuevo punto de conexión de los registros.
