# 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](CloudWatch-OTLPGettingStarted.md). ## Punto de conexión de registros El punto de conexión de registros de seguimiento sigue el patrón `https://logs.Región de AWS.amazonaws.com/v1/logs`. Por ejemplo, en `US 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html). 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](CloudWatch-OTLPGettingStarted.md). 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). 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](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogObject.html). La compatibilidad con eventos de registro superiores a 1 MB y experiencia de LLO está disponible en Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Fráncfort), Asia-Pacífico (Sídney), Asia-Pacífico (Mumbai), Este de EE. UU. (Ohio), Europa (Irlanda), Asia-Pacífico (Tokio) y Asia-Pacífico (Singapur). ## Punto de conexión de métricas El punto de conexión de métricas sigue el patrón `https://monitoring.AWS Region.amazonaws.com/v1/metrics`. Por ejemplo, para la región Oeste de EE. UU. (Oregón) (us-west-2), el punto de conexión será `https://monitoring.us-west-2.amazonaws.com/v1/metrics`. Debe configurar el recopilador de OpenTelemetry para empezar a enviar métricas a CloudWatch. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). ## Punto de conexión de seguimientos El punto de conexión de seguimientos sigue el patrón `https://xray.AWS Region.amazonaws.com/v1/traces`. Por ejemplo, para la región Oeste de EE. UU. (Oregón) (us-west-2), el punto de conexión será `https://xray.us-west-2.amazonaws.com/v1/traces`. Debe configurar el recopilador de OpenTelemetry para empezar a enviar seguimientos a CloudWatch. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). ## Punto de conexión de RUM El punto de conexión de RUM sigue el patrón `https://dataplane.rum.{AWS Region}.amazonaws.com/v1/rum`. Por ejemplo, para la región Oeste de EE. UU. (Oregón), el punto de conexión es `https://dataplane.rum.us-west-2.amazonaws.com/v1/rum`. Este punto de conexión gestiona los *datos de telemetría del cliente* (solo los rastros y los registros con `eventName`) para las aplicaciones de CloudWatch RUM. Para usar este punto de conexión, debe crear un [monitor de aplicaciones de RUM](CloudWatch-RUM-get-started-create-app-monitor.md) con plataforma móvil (Android o iOS) y usar el fragmento de código generado para instrumentar aplicaciones. El fragmento extraerá los SDK móviles de RUM que están configurados con este punto de conexión. Puede configurar aún más los SDK para que RUM recopile la telemetría en consecuencia. El punto de conexión es compatible con las solicitudes autenticadas y no autenticadas. Puede utilizar AWS Signature Version 4 (SigV4) para solicitudes autenticadas o políticas basadas en recursos para permitir el acceso no autenticado desde aplicaciones móviles. Para obtener más información acerca de los modelos de autenticación definidos en sus SDK, consulte lo siguiente: + Aplicaciones para iOS: [SDK para iOS de AWS Distro para OpenTelemetry (ADOT)](https://github.com/aws-observability/aws-otel-swift). + Aplicaciones para Android: [SDK para Android de AWS Distro para OpenTelemetry (ADOT)](https://github.com/aws-observability/aws-otel-android). ## Límites y restricciones del punto de conexión En la tabla se indican los límites y restricciones comunes de los puntos de conexión para las métricas, los seguimientos y los registros. | Límite | Punto de conexión | Información adicional | | --- | --- | --- | | Extensión de recopilador requerida | [sigv4authextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/sigv4authextension) | Para enviar métricas o 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 indican los límites y restricciones de los puntos de conexión para las métricas y los seguimientos. | Límite | Punto de conexión de métricas | Información adicional | Código de error | | --- | --- | --- | --- | | Máximo TPS | 500 | Número máximo de solicitudes por segundo permitido por cuenta | 429 | | Tasa máxima de creación de nuevas series | 1 000 000 | Número máximo de series nuevas que se pueden crear en un periodo de 10 minutos. Este límite solo se aplica a la creación de nuevos nombres de métricas, no a la ingesta de puntos de datos para las métricas existentes. | 429: todas las métricas de las solicitudes están limitadas; 200: las métricas de las solicitudes están limitadas parcialmente | | Tamaño máximo de solicitud | 1 MB | El tamaño máximo sin comprimir de la solicitud. | 400 | | Recuento máximo de puntos de datos | 1 000 | El número máximo de puntos de datos enviados en una sola solicitud. Este número es una suma de ResourceMetrics, ScopeMetrics y Metrics. | 400 | | Tamaño máximo de los metadatos | 40 KB | El tamaño máximo combinado de todas las etiquetas y los valores de etiqueta aceptados para una serie por punto de datos. | 400: todas las métricas de las solicitudes son no válidas; 200: las métricas de las solicitudes son parcialmente no válidas | | Recuento máximo de etiquetas | 150 | Número máximo de etiquetas en los atributos de recurso, ámbito o punto de datos por punto de datos. | 400: todas las métricas de las solicitudes son no válidas; 200: las métricas de las solicitudes son parcialmente no válidas | En la tabla se muestran los límites y restricciones de los puntos de conexión para los registros. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html) **nota** Los límites de cuentas de los registros se comparten entre el SDK y el nuevo punto de conexión de los registros.