Gerando registros de depuração

Use registros de depuração para solucionar problemas na sessão de reprodução de inserção de MediaTailor anúncios. Para gerar registros de depuração, defina o modo de registro para depurar na solicitação do player. MediaTailor Para relatórios do lado do servidor, defina o modo de registro na solicitação de reprodução. Para relatórios do lado do cliente, defina o modo de log na solicitação de inicialização da sessão.

Quando o modo de registro está definido como depuração, MediaTailor grava os dados do registro de depuração em Registros. CloudWatch Os registros de depuração fornecem informações sobre os seguintes eventos. Para obter uma lista completa dos dados produzidos nos registros de depuração, consulte Campos do registro de depuração.

• Interação de origem — Detalhes sobre MediaTailor a interação com o servidor de origem. Por exemplo, a resposta do manifesto de origem, o tipo de manifesto e a origemURL.

• Manifesto gerado — Detalhes sobre a resposta da sessão de reprodução de MediaTailor. Por exemplo, o manifesto que MediaTailor gera.

• Sessão inicializada — Detalhes da inicialização da sessão, como o ID da sessão.

Pré-requisitos

Para definir o modo de registro para depuração, primeiro você precisa conceder MediaTailor permissão para enviar registros para CloudWatch, caso ainda não tenha feito isso. Depois de conceder permissão MediaTailor para acessar CloudWatch, você estará pronto para ativar o modo de registro de depuração. Para obter informações sobre como conceder MediaTailor permissão de acesso, CloudWatch consulte Configurando permissões para a Amazon CloudWatch.

Como definir o modo de log para depuração

Esta seção explica como definir o modo de log para depuração para relatórios do lado do servidor e do lado do cliente.

Relatórios do lado do servidor

Para relatórios do lado do servidor, inclua o parâmetro e o valor da ?aws.logMode=DEBUG consulta na solicitação de GET HTTP reprodução do player para o endpoint or. HLS DASH MediaTailor Para obter informações gerais sobre relatórios do lado do servidor, consulte Relatórios do lado do servidor.

Importante

O valor DEBUG diferencia letras maiúsculas de minúsculas.

Uma solicitação de reprodução que inclui ?aws.logMode=DEBUG tem a seguinte aparência:

exemplo Solicitação de reprodução para um endpoint HLS

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

Depois de definir o modo de registro para depuração, recomendamos que você verifique se a sessão de registro de depuração está ativa. Para verificar se a sessão de depuração está ativa, verifique se há algum CloudWatch registro para o ID da sessão. O ID da sessão está incluído no endpoint de reprodução que MediaTailor fornece. Para obter mais informações, consulte Verify that the debug log mode is active for your playback session.

Relatórios do lado do cliente

Para relatórios do lado do cliente, inclua a logMode chave e o DEBUG valor no corpo da solicitação de inicialização da POST HTTP sessão do seu cliente no endpoint /v1/sessão. MediaTailor Para obter informações gerais sobre relatórios do lado do cliente, consulte Relatórios do lado do cliente.

Importante

O valor DEBUG diferencia letras maiúsculas de minúsculas.

Depois de definir o modo de log para depuração, recomendamos que você verifique se a sessão de depuração está ativa. Para verificar se a sessão de depuração está ativa, confirme se há um SESSION_INITIALIZED evento associado ao ID da sessão nos CloudWatch registros. O ID da sessão está incluído no endpoint de reprodução que MediaTailor fornece. Para obter mais informações, consulte Verify that the debug log mode is active for your playback session.

Máximo de sessões de depuração ativas

Você pode ter no máximo 10 sessões ativas de log de depuração. Quando seu player envia a solicitação de inicialização ou reprodução da sessão para MediaTailor, MediaTailor verifica se o limite foi atingido. Se tiver, MediaTailor verifica se há alguma sessão obsoleta. Uma sessão fica obsoleta se não for acessada em um determinado período de tempo. Para transmissões ao vivo, esse período é de 10 minutos, para VOD transmissões é de 30 minutos.

Se o limite máximo de sessões ativas do registro de depuração for atingido, os registros de depuração não serão CloudWatch gravados nos registros da sua sessão. Se você não vê registros de depuração nos CloudWatch registros da sua sessão, você pode ter atingido esse limite. Para confirmar se o limite foi atingido, consulteVerify that the debug log mode is active for your playback session.

Campos de registro de depuração

A tabela a seguir lista os campos do log de depuração nos quais MediaTailor grava. CloudWatch

Campo	Descrição
awsAccountId	Suas Conta da AWS IDENTIFICAÇÃO.
customerId	Seu ID de MediaTailor cliente.
eventTimestamp	O carimbo de data/hora ISO 8601 associado ao evento do registro de depuração.
eventType	O tipo de evento do registro de depuração. Valores: ORIGIN_INTERACTION— Detalhes sobre MediaTailor a interação com o servidor de origem. Por exemplo, a resposta do manifesto de origem, o tipo de manifesto e a origemURL. GENERATED_MANIFEST— Detalhes sobre a resposta da sessão de reprodução de MediaTailor. Por exemplo, o manifesto que MediaTailor gera. SESSION_INITIALIZED— Detalhes da inicialização da sessão, como o ID da sessão.
originRequestUrl	O URL do seu servidor de origem que é recuperado para essa solicitação.
mediaTailorPath	O MediaTailor endpoint que foi chamado, incluindo todos os parâmetros passados MediaTailor na solicitação inicial do manifesto.
requestId	O ID de uma HTTP solicitação específica para MediaTailor.
responseBody	O manifesto no corpo de resposta de MediaTailor. Esse é o manifesto de origem bruta ou o manifesto gerado por MediaTailor.
sessionId	O ID da sessão de reprodução.
sessionType	O tipo de sessão de reprodução. Valores: HLS, DASH

Leia os registros de depuração

MediaTailor grava os registros de depuração no Amazon CloudWatch Logs. Aplicam-se taxas típicas de CloudWatch registros. Use o CloudWatch Insights para ler os registros de depuração. Para obter informações sobre como usar o CloudWatch Logs Insights, consulte Análise de dados de registro com o CloudWatch Logs Insights no Guia do usuário do AWS CloudWatch Logs.

nota

Os registros de depuração podem levar alguns minutos para aparecer. CloudWatch Se você não visualizar os logs, aguarde alguns minutos e tente novamente. Se você ainda não vê os registros, pode ser que tenha atingido o número máximo de sessões ativas do registro de depuração. Para verificar se esse é o caso, execute uma CloudWatch consulta para ver se houve uma sessão de depuração inicializada para sua sessão de reprodução. Para obter mais informações, consulte Verify that the debug log mode is active for your playback session.

Exemplos

Esta seção inclui exemplos de consultas que você pode usar para ler dados de log de MediaTailor depuração.

exemplo 1: Verifique se o modo de registro de depuração está ativo para sua sessão de reprodução

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

exemplo 2: Veja as respostas de sua origem

fields @timestamp, responseBody, @message, mediaTailorPath
 | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"

exemplo 3: Visualize o manifesto gerado MediaTailor por para uma determinada sessão

fields @timestamp, responseBody, @message
 | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"

exemplo 4: Veja todos os eventos de um determinado requestId

Use essa consulta para visualizar o manifesto de origem e o manifesto gerado por MediaTailor.

fields @timestamp, responseBody, @message, mediaTailorPath
 | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"