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.
Generación AWS Elemental MediaTailor registros de depuración
Usa los registros de depuración para solucionar problemas relacionados con las sesiones de reproducción al insertar MediaTailor anuncios. Para generar registros de depuración, configura el modo de registro para depurar cuando el jugador lo solicite. MediaTailor Para generar informes desde el servidor, configura el modo de registro en la solicitud de reproducción. Para los informes del lado del cliente, defina 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 todos los tipos de eventos de registro en Logs. CloudWatch Los registros proporcionan información sobre los siguientes eventos. Para obtener una lista completa de los datos producidos en los registros de depuración, consulte los campos del registro de depuración.
-
Interacción de origen: detalles sobre MediaTailor las interacciones con el servidor de origen. Por ejemplo, la respuesta del manifiesto de origen, el tipo de manifiesto y la URL de origen.
-
Manifiesto generado: detalles sobre la respuesta de la sesión de reproducción desde MediaTailor. Por ejemplo, el manifiesto que se MediaTailor genera.
-
Sesión inicializada: detalles de inicialización de la sesión, como el identificador de la sesión.
Para personalizar los tipos de eventos de registro que recibe por sesión, consulte. Filtrar registros y eventos
Requisitos previos
Para configurar el modo de registro para depurar, primero debe conceder MediaTailor permiso para enviar los registros 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 el MediaTailor permiso de acceso, CloudWatch consulta Cómo configurar los permisos de Amazon CloudWatch.
Cómo configurar el modo de registro para depurar
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.
Server-side elaboración de informes
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 punto final HLS o DASH. MediaTailor Para obtener información general sobre los informes del lado del servidor, consulta Informes. Server-side
importante
El valor DEBUG distingue entre mayúsculas y minúsculas.
Una solicitud de reproducción que incluya ?aws.logMode=DEBUG tiene el siguiente aspecto:
ejemplo Solicitud de reproducción a un punto final de HLS
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUGTras 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 algún CloudWatch registro para el identificador de sesión. El ID de sesión se incluye en el punto final de reproducción que lo MediaTailor proporciona. Para obtener más información, consulte Verify that the debug log mode is active for your playback session.
Client-side generación de informes
Para los informes del lado del cliente, incluye la logMode clave y el DEBUG valor en el cuerpo de la solicitud de inicialización de la POST HTTP sesión de tu cliente en el MediaTailor punto final /. v1/session Para obtener información general sobre los informes del lado del cliente, consulte Informes. Client-Side
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, confirma que haya un SESSION_INITIALIZED evento asociado al identificador de sesión en los registros. CloudWatch El ID de sesión se incluye en el punto final de reproducción que lo 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 lo ha hecho, MediaTailor comprueba si hay alguna sesión obsoleta. 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 las transmisiones en VOD es 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 tu 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
En la siguiente tabla se enumeran los campos del registro de depuración en los que se MediaTailor escribe. CloudWatch
| Campo | Description (Descripción) |
|---|---|
awsAccountId |
Su Cuenta de AWS identificador. |
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 de registro de depuración. Valores:
|
originRequestUrl |
La 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 a los que se pasó MediaTailor en la solicitud de manifiesto inicial. |
requestId |
El ID de una solicitud HTTP específica para MediaTailor. |
responseBody |
El manifiesto en el cuerpo de la respuesta de MediaTailor. Este es el manifiesto de origen sin procesar o el manifiesto generado por MediaTailor. |
sessionId |
El identificador 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. Utilice CloudWatch Insights para leer los registros de depuración. Para obtener información sobre cómo usar 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 sigues sin ver los registros, es posible que hayas 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: Verifique que el modo de registro de depuración esté activo para su 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: Ve las respuestas desde tu origen
fields @timestamp, responseBody, @message, mediaTailorPath | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
ejemplo 3: Ver el manifiesto generado por MediaTailor para 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 un RequestID determinado
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"
