View a markdown version of this page

Corrija problemas de gerenciamento e rastreamento de sessões de CDN para MediaTailor - AWS Elemental MediaTailor

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á.

Corrija problemas de gerenciamento e rastreamento de sessões de CDN para MediaTailor

AWS Elemental MediaTailor o gerenciamento de sessões da rede de distribuição de conteúdo (CDN) é fundamental para a personalização e o rastreamento adequados de anúncios. Se você encontrar erros relacionados à sessão ou comportamento inconsistente em todas as solicitações:

  1. Verifique a consistência do ID da sessão:

    • Verifique se o player mantém o mesmo ID de sessão em todas as solicitações de uma única sessão de reprodução

    • Verifique os registros do CDN para confirmar se a sessão IDs está sendo encaminhada corretamente

    • Certifique-se de que a sessão IDs esteja devidamente codificada em URL nos parâmetros de consulta

    • Use CloudWatch registros para verificar a consistência do ID da sessão em todas as solicitações (consulte as etapas de validação abaixo)

  2. Valide a inicialização da sessão:

    • Confirme se a primeira solicitação de manifesto cria uma sessão com sucesso

    • Verifique o encaminhamento correto dos parâmetros da sessão (por exemplo,aws.sessionId)

    • Verifique a inicialização da sessão usando registros de depuração (consulte a configuração do registro de depuração abaixo)

  3. Ative o registro de depuração para solucionar problemas detalhados da sessão:

    • Para relatórios do lado do servidor: adicione ?aws.logMode=DEBUG à sua solicitação de reprodução:

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

    • Para relatórios do lado do cliente: inclua "logMode": "DEBUG" no corpo da solicitação de inicialização da sessão

    • Importante: o DEBUG valor diferencia maiúsculas de minúsculas

    • Máximo de 10 sessões de depuração ativas permitidas simultaneamente

  4. Use consultas CloudWatch de registros para validar o comportamento da sessão:

    • Verifique se a sessão de depuração está ativa:

      fields @timestamp, @message
| filter sessionId = "your-session-id-here"
| 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

    • Veja todos os eventos de uma sessão:

      fields @timestamp, @message, eventType, mediaTailorPath
| filter sessionId = "your-session-id-here"
| sort @timestamp asc

    • Verifique a geração do manifesto para uma sessão:

      fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"

  5. Encaminhamento de parâmetros da sessão de teste por meio de CDN:

    • Teste solicitações de manifesto com parâmetros de sessão diretamente MediaTailor (ignorando a CDN)

    • Compare o comportamento da sessão com e sem CDN para identificar problemas de encaminhamento

    • Verifique se a configuração de encaminhamento de parâmetros de consulta CDN inclui parâmetros relacionados à sessão

    • Verifique se o CDN não armazena em cache as respostas que deveriam ser específicas da sessão

Mensagens comuns de erro de sessão:

  • ConflictException(HTTP 409) - Várias solicitações simultâneas de playlists para a mesma sessão. Solução: garanta que seu player solicite playlists uma de cada vez, de acordo com a especificação HLS

  • NotFoundException(HTTP 404) - A sessão não está disponível ou a configuração não existe. Solução: verifique a validade da configuração e reinicialize a sessão

  • BadRequestException(HTTP 400) - ID de sessão inválida ou solicitação formatada incorretamente. Solução: verifique a formatação da solicitação e a validade do ID da sessão

Recursos adicionais de solução de problemas:

Critérios de sucesso: quando resolvidas, as sessões devem ser inicializadas corretamente, manter uma sessão IDs consistente em todas as solicitações e os registros de depuração devem mostrar os SESSION_INITIALIZED eventos adequados e a geração de manifestos sem erros.