View a markdown version of this page

Solucione los problemas de seguimiento y gestión de las sesiones de la CDN para MediaTailor - AWS Elemental MediaTailor

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.

Solucione los problemas de seguimiento y gestión de las sesiones de la CDN para MediaTailor

AWS Elemental MediaTailor La gestión de las sesiones de la red de entrega de contenido (CDN) es fundamental para una correcta personalización y seguimiento de los anuncios. Si detectas errores relacionados con la sesión o un comportamiento incoherente en todas las solicitudes:

  1. Comprueba la coherencia de los ID de sesión:

    • Compruebe que el reproductor mantenga el mismo ID de sesión en todas las solicitudes de una sola sesión de reproducción

    • Comprueba los registros de la CDN para confirmar que la sesión IDs se está reenviando correctamente

    • Asegúrese de que la sesión IDs esté correctamente codificada en la URL en los parámetros de consulta

    • Usa CloudWatch los registros para verificar la coherencia de los ID de sesión en todas las solicitudes (consulta los pasos de validación que aparecen a continuación)

  2. Valide la inicialización de la sesión:

    • Confirme que la primera solicitud de manifiesto crea correctamente una sesión

    • Compruebe si el reenvío de los parámetros de sesión es correcto (por ejemplo,aws.sessionId)

    • Verifique la inicialización de la sesión mediante los registros de depuración (consulte la configuración del registro de depuración a continuación)

  3. Habilite el registro de depuración para solucionar problemas detallados de la sesión:

    • Para informes del lado del servidor: añade ?aws.logMode=DEBUG a tu solicitud de reproducción:

      GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG

    • Para los informes del lado del cliente: inclúyalos en el cuerpo de la solicitud de inicialización de "logMode": "DEBUG" la sesión

    • Importante: El valor distingue entre mayúsculas y DEBUG minúsculas

    • Se permiten un máximo de 10 sesiones de depuración activas simultáneamente

  4. Utilice las consultas CloudWatch de registros para validar el comportamiento de la sesión:

    • Compruebe que la sesión de depuración esté activa:

      fields @timestamp, @message
| filter sessionId = "your-session-id-here"
| filter eventType = "SESSION_INITIALIZED" # client-side reporting
or mediaTailorPath like "/v1/master" # server-side reporting HLS
or mediaTailorPath like "/v1/dash" # server-side reporting DASH

    • Ver todos los eventos de una sesión:

      fields @timestamp, @message, eventType, mediaTailorPath
| filter sessionId = "your-session-id-here"
| sort @timestamp asc

    • Compruebe la generación de manifiestos para una sesión:

      fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"

  5. Pruebe el reenvío de los parámetros de la sesión a través de la CDN:

    • Pruebe directamente las solicitudes de manifiesto con los parámetros de la sesión MediaTailor (omitiendo la CDN)

    • Compara el comportamiento de las sesiones con y sin CDN para identificar los problemas de reenvío

    • Compruebe que la configuración de reenvío de los parámetros de consulta de la CDN incluya los parámetros relacionados con la sesión

    • Comprueba que la CDN no almacene en caché las respuestas que deberían ser específicas de la sesión

Mensajes de error de sesión comunes:

  • ConflictException(HTTP 409): varias solicitudes de listas de reproducción simultáneas para la misma sesión. Solución: asegúrese de que el reproductor solicite las listas de reproducción de una en una según la especificación HLS

  • NotFoundException(HTTP 404): la sesión no está disponible o la configuración no existe. Solución: compruebe la validez de la configuración y reinicie la sesión

  • BadRequestException(HTTP 400): ID de sesión no válido o solicitud con un formato incorrecto. Solución: compruebe el formato de la solicitud y la validez del identificador de sesión

Recursos adicionales para la solución de problemas:

Criterios de éxito: una vez resueltos, las sesiones deben inicializarse correctamente, mantener una sesión coherente IDs en todas las solicitudes y los registros de depuración deben mostrar los SESSION_INITIALIZED eventos correctos y la generación de manifiestos sin errores.