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á.
Generating (Gerando) AWS Elemental MediaTailor 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 jogador para. 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 registro na solicitação de inicialização da sessão.
Quando o modo de registro é definido como depuração, MediaTailor grava todos os tipos de eventos de registro em CloudWatch Registros. 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 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 registro para depuração
Esta seção explica como definir o modo de log para depuração para relatórios do lado do servidor e relatórios do lado do cliente.
Server-side relatando
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 seu player para o endpoint HLS ou DASH. MediaTailor Para obter informações gerais sobre relatórios do lado do servidor, consulte Relatórios. Server-side
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.
Client-side relatando
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 para o MediaTailor endpoint /. v1/session Para obter informações gerais sobre relatórios do lado do cliente, consulte Client-Side Relatórios.
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 registro de depuração. Quando seu player envia a solicitação de inicialização da sessão ou reproduçã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 dentro de 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ê os 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 são MediaTailor gravados CloudWatch.
| Campo | Description |
|---|---|
awsAccountId |
Sua Conta da AWS identidade. |
customerId |
Seu ID de MediaTailor cliente. |
eventTimestamp |
O carimbo de data/hora ISO 8601 associado ao evento de registro de depuração. |
eventType |
O tipo de evento de registro de depuração. Valores:
|
originRequestUrl |
O URL do seu servidor de origem que é recuperado para essa solicitação. |
mediaTailorPath |
O MediaTailor endpoint que foi chamado, incluindo quaisquer parâmetros transmitidos 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 cobranças 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 de 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 os dados do 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: Exibir 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: Exibir todos os eventos de um determinado RequestID
Use essa consulta para visualizar o manifesto de origem e o manifesto gerado pelo MediaTailor.
fields @timestamp, responseBody, @message, mediaTailorPath | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
