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 do Soluçã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 MediaTailor integração CloudFront e integração, monitore o desempenho e prepare-se para solucionar qualquer problema. A rede de distribuição de conteúdo (CDN) fornece ferramentas para ajudá-lo 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 CloudFront de sua MediaTailor integração:

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

  1. Ativar 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 registros.

    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 Registros em tempo real, 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- Solicitar caminho do URI

      • 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

      • 4 xxErrorRate

      • 5xxErrorRate

      • TotalErrorRate

      • CacheHitRate

  4. Configurar CloudWatch alarmes:

    1. No CloudWatch console, escolha Alarmes.

    2. Selecione Criar alarme.

    3. Crie alarmes para estas condições:

      • 5 xxErrorRate > 1% por 5 minutos

      • 4 xxErrorRate 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. Registros em tempo real 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- A pontuação de confiança na 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 CloudWatch Painel de amostra para monitoramento de MQAR

Crie um CloudWatch painel com essas métricas:

  • A seleção de origem conta por região

  • Índices de qualidade médios ao longo do tempo

  • Eventos de failover

  • Taxas de erro de 4xx e 5xx por origem

Para obter mais informações sobre como configurar registros em tempo real, consulte Registros em tempo real 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 manifestos

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

Solução: verifique se você está usando a política de CachingDisabled cache para playlists multivariantes, playlists de mídia e caminhos 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 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 seus pontos MediaTailor de configuração 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 quanto a padrões de erro

  2. Use as ferramentas do desenvolvedor do navegador para inspecionar as solicitações de rede

  3. Compare o conteúdo do manifesto MediaTailor diretamente com o conteúdo fornecido por 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 CloudFront MediaTailor 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. CloudFront Registros de verificação:

    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 os 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 CloudFront MediaTailor integração, considere estas próximas etapas:

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

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

  • Configure a remediação automatizada para problemas comuns