Solucionar problemas com a integração com MediaTailor a CDN - AWS Elemental MediaTailor
Preparação para solução deGuias de solução de problemas específicos do fluxo de trabalho

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

Solucionar problemas com a integração com MediaTailor a CDN

Este guia abrangente de solução de problemas aborda problemas comuns de integração da rede de distribuição de conteúdo (CDN) em todas as AWS Elemental MediaTailor implementações, incluindo inserção de anúncios no lado do servidor (SSAI), montagem de canais e integração. AWS Elemental MediaPackage Quando sua CDN e sua MediaTailor integração tiverem problemas, use essa abordagem sistemática de diagnóstico para identificar rapidamente as causas-raiz e implementar soluções validadas.

Este guia se aplica a todas as integrações de MediaTailor CDN, independentemente do seu fluxo de trabalho específico. Para problemas específicos de serviços ou fluxos de trabalho específicos, consulte as seções de solução de problemas relacionadas mencionadas no final deste guia.

Antes de começar: tenha esses itens prontos para uma solução eficiente de problemas:

  • Amostra de reprodução URLs que demonstra o problema

  • Registros de acesso à CDN do período em que os problemas ocorreram

  • MediaTailor nome da configuração e AWS região

  • Tipo e versão do player (por exemplo, HLS.js 1.4.0, Video.js 8.0)

  • Informações do dispositivo e do navegador onde ocorrem problemas

Tópicos relacionados:

Preparação para solução de

Configure ferramentas e processos para simplificar a solução de problemas quando surgirem problemas de integração com a CDN. A preparação proativa torna a solução de problemas mais rápida e eficaz quando ocorrem problemas.

Permita um registro abrangente

Registros detalhados são essenciais para diagnosticar problemas de integração de CDN. Configure o registro para capturar as informações necessárias durante a solução de problemas.

  1. Habilite registros detalhados de acesso à CDN:

    • Configure o registro em log para todos os comportamentos de cache que lidam com MediaTailor solicitações

    • Inclua cadeias de caracteres de consulta e cabeçalhos personalizados nas entradas de registro

    • Configure ferramentas de análise de registros para identificar padrões e anomalias

    • Ative registros em tempo real para detecção imediata de problemas durante eventos ao vivo

    • Configure políticas de retenção de registros para manter dados históricos de solução de problemas

  2. Configurar MediaTailor o registro:

    • Ative os registros de acesso para suas MediaTailor configurações

    • Configure grupos de CloudWatch registros para gerenciamento centralizado de registros

    • Configure filtros de log para identificar padrões de erro

  3. Configure o registro do servidor de origem:

    • Habilite registros de acesso detalhados em seus servidores de origem de conteúdo

    • Inclua cabeçalhos de solicitação e códigos de resposta nos registros

    • Monitore as métricas de desempenho do servidor de origem

Adicionar cabeçalhos de solicitação de diagnóstico

Cabeçalhos personalizados ajudam a rastrear solicitações por meio de sua CDN e a identificar problemas de roteamento.

  1. Configure os cabeçalhos de diagnóstico da CDN:

    • Adicione um identificador exclusivo a cada solicitação (por exemplo,X-Request-ID)

    • Inclua informações específicas da CDN nos cabeçalhos da solicitação

    • Adicione informações de localização de borda ou POP (ponto de presença) para rastrear o roteamento geográfico

    • Inclua cabeçalhos de status do cache (Hit, Miss, RefreshHit) para análise do comportamento do cache

  2. Adicione cabeçalhos de resposta para depuração:

    • Incluir cabeçalhos de identificação do servidor

    • Adicione informações de tempo para análise de desempenho

    • Incluir cabeçalhos de controle de cache para solicitações de manifesto

Estabeleça métricas básicas de desempenho

Documente as faixas normais de desempenho para identificar rapidamente anomalias durante a solução de problemas:

  1. Registre as métricas básicas:

    • Taxas de acerto do cache para diferentes tipos de conteúdo

    • Percentis de tempo de resposta (P50, P95, P99)

    • Taxas de erro por código de status

    • Solicite padrões de volume por hora do dia

  2. Documente as expectativas de desempenho:

    • Alvo taxas de acerto do cache (mais de 95% para conteúdo, mais de 90% para anúncios)

    • Tempos de resposta aceitáveis (<100 ms em cache, <500 ms de origem)

    • Taxas de erro máximas aceitáveis (< 1% para 4xx, < 0,1% para 5xx)

  3. Crie painéis de desempenho: configure painéis de monitoramento que mostrem as métricas atuais em comparação com os valores básicos.

Prepare ferramentas de solução de problemas

Configure as ferramentas e as permissões de acesso necessárias para uma solução eficaz de problemas:

  1. Ferramentas de linha de comando:

    • curlpara testar solicitações e respostas HTTP

    • digou nslookup para solução de problemas de DNS

    • Ferramentas de validação HLS/DASH para verificação de manifestos

    • Ferramentas de análise de registros (grep, awk ou analisadores de registros especializados)

  2. Permissões de acesso:

    • Acesso ao console de gerenciamento CDN para análise de configuração

    • MediaTailor acesso ao console para verificação de configuração

    • CloudWatch acesso para métricas e análise de registros

    • Acesso ao servidor de origem para solução de problemas de back-end

  3. Documentação:

    • Diagramas de arquitetura de rede

    • CDN e documentação MediaTailor de configuração

    • Informações de contato para procedimentos de escalonamento

    • Runbooks de solução de problemas para cenários comuns

Guias de solução de problemas específicos do fluxo de trabalho

Este guia universal de solução de problemas aborda problemas comuns em todas as integrações de MediaTailor CDN. Para problemas específicos de fluxos de trabalho ou serviços específicos, consulte estes recursos especializados de solução de problemas:

Solução de problemas de inserção de anúncios no lado do servidor (SSAI)

Para problemas específicos de SSAI, incluindo falhas de inserção de anúncios, problemas de transição de anúncios e problemas de personalização, consulte a documentação de solução de problemas de SSAI específica do fluxo de trabalho.

Problemas comuns específicos do SSAI:

  • Falhas na inserção de anúncios e intervalos de anúncios vazios

  • Problemas de sincronização e tempo de transição de anúncios

  • Problemas de personalização e segmentação

  • Discrepâncias de rastreamento e análise de anúncios

Solução de problemas de montagem de canais

Para problemas específicos de montagem de canais, incluindo problemas de geração de manifestos e funcionalidade de mudança de horário, consulte a documentação do fluxo de trabalho de montagem de canais.

Problemas comuns de montagem de canais:

  • Erros de geração e compilação de manifestos

  • Janela de mudança de horário e problemas de funcionalidade do DVR

  • Disponibilidade do conteúdo de origem e problemas de failover

  • Cronograma do programa e sincronização de metadados

MediaPackage solução de problemas de integração

Para problemas MediaPackage específicos, incluindo filtragem de manifestos e problemas de endpoint EMP, consulte. Solução de problemas de integração de CDN

Problemas comuns de MediaPackage integração:

  • Erros de parâmetros de filtragem de manifestos

  • MediaPackage problemas de conectividade de endpoint

  • Problemas de comportamento de cache específicos do EMP

  • MediaPackage problemas de autenticação de origem

CloudFront solução de problemas específica

Para problemas CloudFront específicos de configuração e configuração, consulte a documentação de CloudFront integração.

CloudFront Problemas comuns:

  • Configuração de distribuição e configuração do comportamento do cache

  • Identidade de acesso e configuração de segurança do Origin

  • CloudFront códigos de erro e respostas específicos

  • Restrições geográficas e problemas de localização periférica

Recursos adicionais: