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.
Generando registros de depuración
Usa los registros de depuración para solucionar problemas relacionados con la inserción de MediaTailor anuncios y las sesiones de reproducción. Para generar registros de depuración, configura el modo de registro para que se depure cuando el reproductor lo solicite. MediaTailor Para los informes del lado del servidor, configura el modo de registro en la solicitud de reproducción. Para los informes del lado del cliente, configure el modo de registro en la solicitud de inicialización de la sesión.
Cuando el modo de registro está configurado para depurar, MediaTailor escribe los datos del registro de depuración en los registros. CloudWatch Los registros de depuración proporcionan información sobre los siguientes eventos. Para obtener una lista completa de los datos generados en los registros de depuración, consulte los campos del registro de depuración.
-
Interacción de origen: detalles sobre MediaTailor la interacción con el servidor de origen. Por ejemplo, la respuesta al manifiesto de origen, el tipo de manifiesto y el origenURL.
-
Manifiesto generado: detalles sobre la respuesta de la sesión de reproducción de MediaTailor. Por ejemplo, el manifiesto que se MediaTailor genera.
-
Sesión inicializada: detalles de inicialización de la sesión, como el ID de la sesión.
Requisitos previos
Para configurar el modo de registro para que se depure, primero debe conceder MediaTailor permiso para enviar los registros a CloudWatch, si aún no lo ha hecho. Una vez que hayas otorgado el permiso de MediaTailor acceso CloudWatch, estarás listo para habilitar el modo de registro de depuración. Para obtener información sobre cómo conceder MediaTailor permisos de acceso, CloudWatch consulta Configuración de permisos para Amazon CloudWatch.
¿Cómo configurar el modo de registro para que depure
En esta sección se explica cómo configurar el modo de registro para depurar los informes del lado del servidor y del lado del cliente.
Informes del lado del servidor
Para los informes del lado del servidor, incluye el parámetro y el valor de la ?aws.logMode=DEBUG consulta en la solicitud de GET HTTP reproducción del reproductor al terminal o terminal. HLS DASH MediaTailor Para obtener información general sobre los informes del lado del servidor, consulte Informes del lado del servidor.
importante
El valor DEBUG distingue entre mayúsculas y minúsculas.
Una solicitud de reproducción que incluye ?aws.logMode=DEBUG tiene el siguiente aspecto:
ejemplo Solicitud de reproducción a un HLS punto final
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUGDespués de configurar el modo de registro para depurar, le recomendamos que compruebe que la sesión de registro de depuración esté activa. Para comprobar que la sesión de depuración está activa, compruebe si hay CloudWatch registros para el ID de sesión. El ID de sesión se incluye en el punto final de reproducción que se MediaTailor proporciona. Para obtener más información, consulte Verify that the debug log mode is active for your playback session.
Informes del lado del cliente
Para los informes del lado del cliente, incluya la logMode clave y el DEBUG valor en el cuerpo de la solicitud de inicialización de la POST HTTP sesión del cliente en el punto final /v1/session. MediaTailor Para obtener información general sobre los informes del lado del cliente, consulte Informes del lado del cliente.
importante
El valor DEBUG distingue entre mayúsculas y minúsculas.
Después de configurar el modo de registro para depurar, le recomendamos que compruebe que la sesión de depuración esté activa. Para comprobar que la sesión de depuración esté activa, confirme que haya un SESSION_INITIALIZED evento asociado al ID de sesión en los registros. CloudWatch El ID de sesión se incluye en el punto final de reproducción que se MediaTailor proporciona. Para obtener más información, consulte Verify that the debug log mode is active for your playback session.
Número máximo de sesiones de depuración activas
Puede tener un máximo de 10 sesiones de registro de depuración activas. Cuando el reproductor envía su solicitud de inicialización de sesión o reproducción a MediaTailor, MediaTailor comprueba si se ha alcanzado el límite. Si es así, MediaTailor comprueba si hay sesiones obsoletas. Una sesión está obsoleta si no se ha accedido a ella en un período de tiempo determinado. Para las transmisiones en directo, este período de tiempo es de 10 minutos, para VOD las transmisiones, de 30 minutos.
Si se ha alcanzado el límite máximo de sesiones de registro de depuración activas, los registros de depuración no se escriben en los CloudWatch registros de la sesión. Si no ves los registros de depuración en CloudWatch los registros de tu sesión, es posible que hayas alcanzado este límite. Para confirmar si se ha alcanzado el límite, consulteVerify that the debug log mode is active for your playback session.
Depurar campos de registro
La siguiente tabla muestra los campos del registro de depuración en los que se MediaTailor escribe. CloudWatch
| Campo | Descripción |
|---|---|
awsAccountId |
Sus Cuenta de AWS ID. |
customerId |
Tu identificador de MediaTailor cliente. |
eventTimestamp |
La marca de tiempo ISO 8601 asociada al evento del registro de depuración. |
eventType |
El tipo de evento del registro de depuración. Valores:
|
originRequestUrl |
El URL de su servidor de origen que se recupera para esta solicitud. |
mediaTailorPath |
El MediaTailor punto final al que se llamó, incluidos los parámetros transferidos MediaTailor en la solicitud de manifiesto inicial. |
requestId |
El ID de una HTTP solicitud específica dirigida a MediaTailor. |
responseBody |
El manifiesto que aparece en el cuerpo de la respuesta de MediaTailor. Este es el manifiesto de origen bruto o el manifiesto generado por MediaTailor. |
sessionId |
El ID de la sesión de reproducción. |
sessionType |
El tipo de sesión de reproducción. Valores: |
Lea los registros de depuración
MediaTailor escribe los registros de depuración en Amazon CloudWatch Logs. Se aplican CloudWatch los cargos típicos de Logs. Use CloudWatch Insights para leer los registros de depuración. Para obtener información sobre cómo utilizar CloudWatch Logs Insights, consulte Análisis de datos de registro con CloudWatch Logs Insights en la Guía del usuario de AWS CloudWatch Logs.
nota
Los registros de depuración pueden tardar unos minutos en CloudWatch aparecer. Si no ve los registros, espere unos minutos e inténtelo de nuevo. Si sigue sin ver los registros, es posible que haya alcanzado el número máximo de sesiones de registro de depuración activas. Para comprobar si este es el caso, ejecuta una CloudWatch consulta para comprobar si se ha inicializado una sesión de depuración para tu sesión de reproducción. Para obtener más información, consulte Verify that the debug log mode is active for your playback session.
Ejemplos
En esta sección se incluyen ejemplos de consultas que puede utilizar para leer los datos del registro de MediaTailor depuración.
ejemplo 1: Compruebe que el modo de registro de depuración esté activo para la sesión de reproducción
fields @timestamp, @message | filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90" | 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
ejemplo 2: Consulta las respuestas de tu origen
fields @timestamp, responseBody, @message, mediaTailorPath | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
ejemplo 3: Ver el manifiesto generado MediaTailor por una sesión determinada
fields @timestamp, responseBody, @message | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
ejemplo 4: Ver todos los eventos de una determinada requestId
Utilice esta consulta para ver el manifiesto de origen y el manifiesto generado por MediaTailor.
fields @timestamp, responseBody, @message, mediaTailorPath | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
