Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Funciones de resolución de problemas y supervisión

Esta página le ayuda a diagnosticar los errores de funcionamiento más comunes y a supervisar el rendimiento de las funciones en la producción. La sección de solución de problemas está organizada por síntomas: comience con lo que observe y, a continuación, siga la causa y corríjala.

Supervisión

CloudWatch métricas

MediaTailor publica métricas para la ejecución de funciones en Amazon CloudWatch. No es necesario suscribirse.

Hook-level métricas: un punto de datos por ejecución de enlaces durante el ciclo de vida:

Function-level métricas: un punto de datos por ejecución de función individual:

Para obtener más información sobre cómo configurar las alarmas y trabajar con estas métricas, consulteSupervisión AWS Elemental MediaTailor con las CloudWatch métricas de Amazon.

Eventos de registro

MediaTailor emite un registro de eventos para la ejecución de la función. Los eventos de error se emiten de forma predeterminada. Los eventos completados y resumidos son opcionales.

Para activar el registro de eventos opcionales, consulteSupervisión AWS Elemental MediaTailor con las CloudWatch métricas de Amazon.

Utilice el eventId campo para correlacionar eventos a nivel de gancho y a nivel de función para la misma ejecución.

Los siguientes filtros de consultas de Amazon CloudWatch Logs Insights utilizan los eventos de error eventId para rastrear una sola ejecución:

fields @timestamp, eventType, functionId, errorType, cause
| filter eventId = "5dc6f040-0f72-4e8c-a64e-25eeef62708c"
| sort @timestamp asc

Resolución de problemas

Cuando se produce un error en una función, MediaTailor registra un errorType campo en el caso de error. Utilice este campo para identificar la clase de error:

Las entradas están organizadas por síntoma y hacen referencia a estos tipos de error cuando corresponde.

La expresión devuelve un valor nulo inesperadamente

Síntoma: el valor de salida que esperabas rellenar aparece null o falta en los parámetros del reproductor.

Causas posibles:

RESOURCE_LIMIT_ERROR: desbordamiento de pila

Síntoma: la función falla con y. errorType: "RESOURCE_LIMIT_ERROR" cause: "Stack overflow error"

Causa: la expresión superó la profundidad máxima de pila de 100 niveles. Esto suele ocurrir con expresiones condicionales (if/then/else) muy anidadas o con asignaciones de variables complejas.

Esto significa que la expresión tiene demasiados niveles de anidación como para MediaTailor procesarla.

Solución: simplifica la expresión. Divida la lógica compleja en varias entradas de salida o varios pasos en un ejecutor secuencial.

RESOURCE_LIMIT_ERROR: tiempo de espera de la CPU

Síntoma: la función falla con y. errorType: "RESOURCE_LIMIT_ERROR" cause: "Expression evaluation timeout: Check for infinite loop"

Causa: la expresión superó el límite de tiempo de CPU de 100 ms. Esto puede ocurrir con expresiones que realizan cálculos costosos en estructuras de datos de gran tamaño.

Solución: reduce la complejidad de la expresión. Si está procesando matrices grandes, considere la posibilidad de trasladar esa lógica a un servicio externo y llamarlo con una HTTP_REQUEST función.

RESTRICTION_ERROR: Función no permitida

Síntoma: la función falla con y. errorType: "RESTRICTION_ERROR" cause: "Function '<name>' is not allowed"

Causa: la expresión llama a una función de JSonata que no está en la lista de 38 funciones permitidas. Entre los ejemplos más comunes $filter se incluyen$reduce, $eval$split, y. $join

Solución: compruebe el cause campo para ver el nombre de la función bloqueada. Sustitúyalo por una alternativa permitida. Consulte Referencia de expresión JSonata la lista completa de 38 funciones permitidas.

Las funciones permitidas más utilizadas incluyen $string $number$substring,$contains, y$encodeUrlComponent.

RESTRICTION_ERROR: Expresión demasiado larga

Síntoma: la función no se puede crear ni actualizar con. cause: "Expression length <actual> exceeds limit <limit>"

Causa: una sola expresión supera los 1000 caracteres.

Solución: divide la expresión en partes más pequeñas. Usa varias entradas de salida o divide la lógica en varios pasos en un ejecutor secuencial. Utilice el enlace de variables (:=) para evitar la repetición de subexpresiones largas.

Error HTTP: el código de estado es nulo

Síntoma: en la salida de una HTTP_REQUEST función, response.statusCode esnull.

Causa: no se pudo acceder a la API externa, se agotó el tiempo de espera de la conexión o se produjo un error de red. Cuando esto ocurre, se MediaTailor establece response.statusCode ennull, en y response.body ennull. response.text "Internal Error"

Solución: compruebe siempre response.statusCode antes de acceder a los datos de respuesta:

{%response.statusCode = 200 ? response.body.value : 'default'%}

Esta expresión comprueba si la llamada HTTP devolvió un código de estado 200. Si lo hizo, utiliza el valor de respuesta. De lo contrario, vuelve a su valor predeterminado.

Si esto ocurre con frecuencia, compruebe si la API externa está en buen estado. Considera aumentarla RequestTimeoutMilliseconds si la API es lenta o disminuirla si quieres que falle rápidamente.

Error HTTP: el cuerpo de la respuesta es nulo

Síntoma: response.statusCode es 200 pero response.body lo esnull.

Causa: el cuerpo de la respuesta no es un JSON válido o tiene más de 20 000 caracteres. MediaTailor solo analiza las respuestas JSON con un máximo de 20 000 caracteres. response.body

Solución: se usa response.text como alternativa. El response.text campo contiene el cuerpo de la respuesta sin procesar truncado a 20 000 caracteres:

{%response.statusCode = 200 ? ($exists(response.body.id) ? response.body.id : $substring(response.text, 0, 100)) : 'error'%}

Si los datos que necesita superan el límite de 20 000 caracteres, considere la posibilidad de solicitar a la API externa que devuelva una respuesta más pequeña (por ejemplo, solicitando campos específicos).

Error HTTP: error en la validación de la URL

Síntoma: la función falla en tiempo de ejecución y aparece un mensaje que indica que la URL tiene un formato incorrecto, utiliza un esquema no válido o supera la longitud máxima.

Causas posibles:

VALIDATION_ERROR

Síntoma: la función falla conerrorType: "VALIDATION_ERROR". Este error puede producirse en el momento de la creación (al crear o actualizar la función) o en el momento de la ejecución (cuando la función se ejecuta durante una sesión).

Causas posibles:

Compruebe el cause campo del evento del registro de errores: identifica qué campo o expresión no se validó.

INTERNAL_ERROR

Síntoma: la función falla conerrorType: "INTERNAL_ERROR".

Causa: se ha producido un error en la infraestructura que no está relacionado con la configuración de la función.

Solución: vuelve a intentar la solicitud. Si el error persiste, ponte en contacto con AWS Support.