As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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 log está configurado para depurar, MediaTailor grava todos os tipos de eventos de log em CloudWatch Logs. Os registros 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 interações com o servidor de origem. Por exemplo, a resposta do manifesto de origem, o tipo de manifesto e o URL de origem.
-
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.
Para personalizar os tipos de eventos de log que você recebe por sessão, consulteFiltrando registros e eventos.
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 HLS ou 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=DEBUGDepois 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 transmissões de VOD é 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 |
Sua Conta da AWS identidade. |
customerId |
Seu ID de MediaTailor cliente. |
eventTimestamp |
O timestamp ISO 8601 associado ao evento do registro de depuração. |
eventType |
O tipo de evento do registro de depuração. Valores:
|
originRequestUrl |
A URL do seu servidor de origem que é recuperada 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 solicitação HTTP 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: |
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 log 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"
