¿Cómo soluciono el error de cuota de rastreo en X-Ray?

Descripción breve

Los siguientes escenarios pueden provocar que los documentos de rastreo superen el límite permitido en AWS X-Ray:

• Ha enviado un mayor número de segmentos agrupados en lotes para realizar un rastreo cuando el tamaño del documento de rastreo supera los 500 KB.
• Ha enviado segmentos no agrupados en lotes para realizar un rastreo cuando el tamaño del documento de rastreo supera los 100 KB.
• Ha añadido segmentos, metadatos y anotaciones personalizados que aumentaron el tamaño del documento de rastreo.

El límite superior del tamaño de un documento de rastreo X-Ray cambia de forma dinámica en función del número de segmentos que se envíen juntos. Esto se debe a la función de rastreo de límite excedido. Para enviar un número elevado de segmentos en un lote adjunto a un rastreo, el límite superior es de 500 KB. Para los segmentos individuales que envíe con un intervalo de tiempo adjunto a un rastreo, el límite superior es de 100 KB.

Cuanto más rápido envíe un rastreo (cuantos más segmentos agrupe y envíe), más aumentará la eficiencia de la compresión. Cuanto más lento envíe un rastreo (se envían los segmentos de forma individual con un intervalo de tiempo), más se dividirá el rastreo en varias revisiones. Además, cuanto más lento envíe un rastreo, más capacidad de almacenamiento de la memoria caché consumirá en el backend. Los rastreos que duran más producen más duplicados y dan lugar a que X-Ray recopile menos datos.

Solución

Nota: Si recibe errores al ejecutar los comandos de la interfaz de la línea de comandos de AWS (AWS CLI), asegúrese de que está utilizando la versión más reciente de AWS CLI.

Consulte el rastreo en la consola de X-Ray o ejecute el siguiente comando para confirmar que el documento de rastreo supera el límite de tamaño:

aws xray batch-get-traces --trace-ids <EXAMPLE_TRACE_ID>

**Nota:**Sustituya EXAMPLE\ _TRACE\ _ID con el ID de su rastreo.

X-Ray recopila la siguiente información para obtener un rastreo mayor:

{
    "Id": "<EXAMPLE_TRACE_ID>",
    "Duration": 187.859,
    "LimitExceeded": true,
    "Segments": [
         ...
     ]
     ....
 }

Nota:Si el parámetroLimitExceeded es verdadero, significa que ha superado la cuota de rastreo o segmento.

Mayor número de segmentos agrupados en lotes para un rastreo cuando el tamaño del documento de rastreo supera los 500 KB

Este escenario se produce al integrar Step Functions con X-Ray. Cuando integra Step Functions con X-Ray, no puede personalizar qué rastrea X-Ray y qué no rastrea. Al pasar el ID de rastreo por todas las funciones de AWS Lambda, los datos del segmento se añaden al ID de rastreo.

Si utiliza Step Functions, siga estos pasos:

1. Acceda a Step Functions y, a continuación, desactive el rastreo activo.
2. Transmita el ID de rastreo a las funciones de Lambda solo para los flujos de trabajo críticos y no supere el límite superior de rastreo.
3. Si Lambda recibe el encabezado de rastreo de los servicios ascendentes, elimine el permiso PutTraceSegments del rol de ejecución Lambda. El límite superior se ajusta dinámicamente.

Si no utiliza Step Functions, siga estos pasos:

1. Depure su código para comprobar si está pasando el mismo ID de rastreo para diferentes solicitudes.
2. Rompa el rastreo. Para ello, no pase el ID de rastreo de la invocación a los servicios posteriores.
3. Cree un nuevo ID de rastreo a partir del punto de ruptura.

Nota: Si crea un ID de rastreo para cada aplicación, aumentará el recuento de rastreos. Para facilitar el rastreo, mantenga los flujos de trabajo críticos de las aplicaciones como parte de un solo rastreo.

Para obtener más información, consulte AWS X-Ray y Step Functions.

Segmentos no agrupados para un rastreo en el que el tamaño del documento de rastreo supere los 100 KB

Para este escenario, utilice la solución de la sección anterior.

Rompa los rastreos para alcanzar el nuevo límite superior de 100 KB. O bien agrupe más segmentos en la aplicación para aumentar el límite superior a 500 KB. El procesamiento por lotes de segmentos solo se admite con el SDK de telemetría abierta. Si utiliza el SDK de X-Ray, cambie la forma en que la aplicación envía los segmentos.

Se agregaron segmentos, metadatos y anotaciones personalizados que aumentaron el tamaño del documento

Para reducir el tamaño del documento de rastreo, no añada segmentos personalizados adicionales al mismo ID de rastreo. Añada segmentos personalizados solo para los flujos de trabajo necesarios. Además, para reducir el tamaño del documento de rastreo, reduzca los metadatos y las anotaciones en los rastreos.