View a markdown version of this page

Monitore e solucione problemas de sua CloudFront integração MediaTailor - AWS Elemental MediaTailor
Configurando o monitoramento para sua integraçãoMonitorando o desempenho do MQARSolução de problemas comuns doSolução de problemas de trabalhoPróximas etapas

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

Monitore e solucione problemas de sua CloudFront integração MediaTailor

AWS Elemental MediaTailor a integração com a Amazon CloudFront exige monitoramento e solução de problemas contínuos para manter o desempenho ideal. Depois de implementar sua CloudFront MediaTailor integração, monitore o desempenho e prepare-se para solucionar quaisquer problemas. A rede de entrega de conteúdo (CDN) fornece ferramentas para ajudar você a entender o desempenho de sua distribuição e identificar possíveis problemas.

Configurando o monitoramento para sua integração

Implemente essas estratégias de monitoramento para monitorar o desempenho de sua MediaTailor integração CloudFront e sua integração:

Para configurar o monitoramento de sua CloudFront MediaTailor integração

  1. Habilitar o registro CloudFront padrão:

    1. No CloudFront console, selecione sua distribuição.

    2. Escolha a guia Logs.

    3. Em Registros padrão, escolha Editar.

    4. Selecione Ativado e configure um bucket do Amazon S3 para armazenamento de logs.

    5. Escolha Salvar alterações.

  2. Configure registros CloudFront em tempo real:

    1. No CloudFront console, selecione sua distribuição.

    2. Escolha a guia Logs.

    3. Em Real-time registros, escolha Editar.

    4. Selecione Ativado e configure um stream de entrega do Amazon Kinesis Data Streams ou do Amazon Data Firehose.

    5. Inclua esses campos em sua configuração de registro:

      • time-to-first-byte- Tempo de resposta

      • sc-status- Código de status HTTP

      • c-ip- Endereço IP do visualizador

      • cs-uri-stem- Caminho do URI de solicitação

      • cs-user-agent- Agente de usuário

      • x-edge-result-type- Tipo de resultado (acerto, erro, erro)

    6. Escolha Salvar alterações.

  3. Crie CloudWatch painéis:

    1. No CloudWatch console, escolha Painéis.

    2. Escolha Create dashboard (Criar painel).

    3. Adicione widgets para essas CloudFront métricas:

      • Solicitações

      • BytesDownloaded

      • 4xx ErrorRate

      • 5xx ErrorRate

      • TotalErrorRate

      • CacheHitRate

  4. Configurar CloudWatch alarmes:

    1. No CloudWatch console, escolha Alarmes.

    2. Selecione Criar alarme.

    3. Crie alarmes para estas condições:

      • 5xx ErrorRate > 1% por 5 minutos

      • 4xx ErrorRate maior que 5% por 5 minutos

      • CacheHitRate menos de 80% por 30 minutos

Monitorando o desempenho do MQAR

Ao usar o MQAR, o monitoramento ajuda você a entender como CloudFront seleciona entre suas origens e se os índices de qualidade atendem às expectativas. Real-time os registros mostram essas decisões à medida que elas acontecem.

Para monitorar o desempenho do MQAR

  1. Habilite registros em tempo real para sua CloudFront distribuição.

  2. Inclua esses campos em sua configuração de registro:

    • r-host- O nome do host da origem selecionada

    • sr-reason- O motivo da seleção da origem

    • x-edge-mqcs- O índice de confiança da qualidade da mídia

  3. Configure um destino de log no Amazon Kinesis Data Streams ou no Amazon Data Firehose.

  4. Crie painéis ou alertas com base nessas métricas para monitorar os índices de qualidade e as decisões de seleção de origem.

exemplo Exemplo de CloudWatch painel para monitoramento de MQAR

Crie um CloudWatch painel com essas métricas:

  • Contagens de seleção de origem por região

  • Média dos índices de qualidade ao longo do tempo

  • Eventos de failover

  • Taxas de erro 4xx e 5xx por origem

Para obter mais informações sobre como configurar registros em tempo real, consulte Real-time registros no guia do CloudFront desenvolvedor.

Solução de problemas comuns do

Podem surgir problemas com sua CloudFront MediaTailor integração, mesmo com um planejamento cuidadoso. Compreender problemas e soluções comuns ajuda você a resolver problemas rapidamente e minimizar o impacto do espectador.

Se você encontrar problemas com sua MediaTailor integração CloudFront e integração, verifique estes problemas e soluções comuns:

Problemas de cache do manifesto

Sintoma: manifestos obsoletos ou anúncios que não estão sendo atualizados

Solução: verifique se você está usando a política de CachingDisabled cache para caminhos multivariantes de playlists, playlists de mídia e MPD. Verifique se sua configuração encaminha os parâmetros de consulta corretamente.

Erros CORS

Sintoma: o console do navegador mostra erros de CORS ao acessar o conteúdo

Solução: configure uma política de cabeçalhos de resposta com os cabeçalhos CORS apropriados e associe-a ao seu comportamento de cache.

MQAR não está funcionando

Sintoma: a seleção de origem ignora os índices de qualidade

Solução: verifique se você ativou a opção Índice de qualidade de mídia nas configurações do seu grupo de origem. Verifique se você não está usando gatilhos voltados para a origem do Lambda @Edge.

Falhas na inserção de anúncios

Sintoma: os anúncios não estão sendo inseridos corretamente

Solução: verifique se a MediaTailor configuração aponta para sua CloudFront distribuição quanto ao prefixo do segmento de conteúdo. Verifique se sua configuração encaminha todos os cabeçalhos necessários.

Para problemas mais complexos, você pode usar estas abordagens de solução de problemas:

  1. Verifique os registros CloudFront de distribuição para ver se há padrões de erro

  2. Use ferramentas de desenvolvimento de navegador para inspecionar solicitações de rede

  3. Compare o conteúdo do manifesto MediaTailor diretamente em comparação com o conteúdo entregue por meio de CloudFront

  4. Teste com um player simples que suporta registros detalhados

Para obter mais assistência na solução de problemas, consulte a seção Solução de problemas no guia MediaTailor do usuário.

Solução de problemas de trabalho

Siga esta abordagem sistemática para solucionar problemas com sua MediaTailor integração CloudFront e sua integração:

Para solucionar problemas CloudFront e problemas de MediaTailor integração

  1. Identifique o problema específico:

    1. Determine se o problema afeta todos os espectadores ou apenas alguns

    2. Identifique quais tipos de conteúdo são afetados (manifestos, segmentos ou ambos)

    3. Anote quaisquer mensagens de erro ou sintomas

  2. Verifique CloudFront os registros:

    1. Procure códigos de status de erro (4xx ou 5xx)

    2. Verifique os hit/miss padrões de cache

    3. Verifique se as solicitações estão sendo encaminhadas para a origem correta

  3. Verifique a configuração:

    1. Verifique os comportamentos do cache para obter padrões de caminho corretos

    2. Verifique se as políticas de cache estão aplicadas corretamente

    3. Confirme se as políticas de solicitação de origem estão encaminhando os cabeçalhos necessários

  4. Teste o acesso direto:

    1. Tente acessar o conteúdo diretamente de MediaTailor (ignorando CloudFront)

    2. Compare as respostas entre acesso direto e CloudFront acesso

  5. Implemente a solução:

    1. Aplique a correção apropriada com base em suas descobertas

    2. Teste para verificar se o problema foi resolvido

    3. Documente o problema e a solução para referência futura

Próximas etapas

Depois de configurar o monitoramento e a solução de problemas para sua MediaTailor integração CloudFront e integração, considere estas próximas etapas:

  • Implemente a implantação automatizada usando AWS CloudFormation (consulteAutomatize MediaTailor e CDN com CloudFormation)

  • Crie runbooks para cenários operacionais comuns e procedimentos de solução de problemas

  • Configure a remediação automatizada para problemas comuns