Solução de problemas MediaPackage, CDN e integrações MediaTailor

AWS Elemental MediaTailor a integração com AWS Elemental MediaPackage a rede de distribuição de conteúdo (CDN) pode encontrar problemas comuns que afetam a reprodução, o armazenamento em cache ou outras funcionalidades de integração. Use este guia quando encontrar problemas de reprodução, de cache ou outros erros relacionados à integração.

Para obter uma orientação abrangente sobre solução de problemas de CDN, incluindo problemas de desempenho de cache universal, resolução de erros HTTP, procedimentos de teste e técnicas de diagnóstico que se aplicam a todas as MediaTailor implementações, consulte. Solucionar problemas de integração com a CDN Esta seção se concentra nos requisitos MediaPackage específicos de solução de problemas.

Antes de solucionar problemas, verifique se você concluiu a configuração básica da integração corretamente. Se você ainda não configurou sua integração ou precisa revisar as etapas de configuração, consulteIntegre MediaTailor com uma MediaPackage CDN . Para obter orientação sobre como otimizar o desempenho do cache após a resolução de problemas, consulte. Cache CDN

Erros de filtragem de manifestos

Problemas com a funcionalidade de filtragem de MediaPackage manifestos, com base em condições de erro documentadas:

Erros HTTP 400 com filtragem de manifesto

Sintomas: solicitações com aws.manifestfilter parâmetros retornam HTTP 400 Bad Request

Causas validadas (da AWS documentação):

• Os critérios de filtro resultam em um manifesto vazio (nenhum fluxo corresponde às condições do filtro)

• Nomes ou valores de parâmetros de filtro inválidos

• Sintaxe de sequência de caracteres de consulta malformada

• Parâmetros de filtro duplicados ou repetidos

• A sequência de parâmetros do filtro excede 1024 caracteres

• Parâmetros de consulta aplicados a playlists ou segmentos de mídia (não suportados)

Soluções:

1. Revise seus parâmetros de filtro para garantir que eles correspondam aos fluxos de conteúdo disponíveis. Se a filtragem não resultar em fluxos correspondentes, MediaPackage retornará HTTP 400.

2. Valide a sintaxe do filtro em relação aos nomes de parâmetros e formatos de valor suportados.

3. Verifique se há parâmetros duplicados em sua string de consulta.

4. Certifique-se de que os parâmetros do filtro sejam aplicados somente às playlists multivariantes, não às playlists ou segmentos de mídia.

5. Verifique se a sequência total de parâmetros tem menos de 1024 caracteres.

Referência: condições de erro de filtragem de AWS Elemental MediaPackage manifestos

A filtragem de manifesto não está funcionando (HTTP 200, mas nenhuma filtragem aplicada)

Sintomas: as solicitações retornam HTTP 200, mas o manifesto contém todos os fluxos em vez do subconjunto filtrado

Causas possíveis:

• CDN não encaminha o parâmetro de aws.manifestfilter consulta para MediaPackage

• Parâmetro de filtro não encontrado nos fluxos disponíveis (retorna o manifesto não filtrado com HTTP 200)

Soluções:

1. Verifique se sua política de cache de CDN está incluída aws.manifestfilter na lista de cadeias de caracteres de consulta encaminhadas.

2. Teste os parâmetros do filtro diretamente nos MediaPackage endpoints (ignorando a CDN) para verificar se eles funcionam conforme o esperado.

3. Verifique se os valores do filtro correspondem às características reais dos seus fluxos de conteúdo.

Referência: condições de erro de filtragem de AWS Elemental MediaPackage manifestos

Procedimentos de diagnóstico

Os procedimentos sistemáticos de diagnóstico ajudam você a identificar a causa raiz dos problemas de integração com rapidez e eficiência. Seguir uma abordagem estruturada evita perda de tempo com suposições incorretas e garante que você resolva o problema real em vez dos sintomas. Essas etapas de diagnóstico baseadas em evidências foram projetadas para isolar problemas e orientá-lo até a solução apropriada.

Siga estas etapas de diagnóstico baseadas em evidências para identificar problemas:

Analise o desempenho do cache

A análise do desempenho do cache é crucial para as integrações do EMP porque a baixa eficiência do cache leva ao aumento da carga de origem, a custos mais altos e a possíveis problemas de reprodução.

Para uma solução abrangente de problemas de desempenho de cache, incluindo análise da taxa de acertos de cache, otimização da chave de cache e etapas sistemáticas de diagnóstico, consulte Problemas de desempenho do cache CDN o guia principal de solução de problemas da CDN.

Considerações sobre cache específicas do EMP:

• Cabeçalhos de controle de cache do EMP: verifique se sua CDN respeita os cabeçalhos de controle de cache do EMP em vez de substituí-los

• Parâmetros de consulta EMP: Certifique-se de que somente os parâmetros de consulta EMP necessários sejam incluídos nas chaves de cache

• Comportamento do EMP TTL: confirme se os diferentes tipos de conteúdo do EMP têm durações de cache apropriadas

Para obter orientações detalhadas sobre como otimizar as políticas de cache do EMP e as configurações de TTL, consulte. Otimize o armazenamento em cache da CDN MediaTailor e a entrega de conteúdo MediaPackage

Validar a configuração de filtragem de manifestos

A validação da filtragem de manifestos é essencial porque problemas de filtragem podem fazer com que os espectadores recebam conteúdo incorreto, formatos incompatíveis ou conteúdo ao qual eles não deveriam ter acesso. O teste sistemático ajuda a identificar se os problemas estão relacionados à configuração da CDN, à sintaxe dos parâmetros do filtro ou à disponibilidade do conteúdo.

Teste sistematicamente a funcionalidade de filtragem de manifestos:

1. Teste os parâmetros do filtro diretamente nos MediaPackage endpoints (ignorando a CDN) para verificar se eles funcionam corretamente.

2. Compare manifestos filtrados e não filtrados para confirmar se os fluxos esperados foram incluídos/excluídos.

3. Verifique se sua política de cache de CDN encaminha o parâmetro de aws.manifestfilter consulta.

4. Verifique se há erros de HTTP 400 e compare-os com as condições de erro documentadas.

Se você precisar implementar ou modificar a filtragem de manifestos após resolver problemas, consulte Configurar a filtragem de manifestos com MediaTailor MediaPackage, e CDN para obter orientações completas de configuração.

Validar a configuração dos parâmetros de consulta

Certifique-se de que sua CDN encaminhe somente os parâmetros de consulta necessários:

1. Revise sua política de cache de CDN para confirmar se ela inclui somente os parâmetros AWS recomendados:

   • aws.manifestfilter- para filtragem de manifestos

   • aws.manifestsettings- para visualização com mudança de horário

   • _HLS_msne _HLS_part - para suporte LL-HLS

2. Remova quaisquer outros parâmetros de consulta da sua chave de cache, pois MediaPackage os ignora e eles reduzem a eficiência do cache.

Referência: Trabalhando com AWS Elemental MediaPackage e CDNs

Referência de código de erro

Referência para condições de erro documentadas e suas causas:

Solicitação incorreta de HTTP 400 (filtragem de manifesto)

Causas documentadas:

• A aplicação dos resultados do filtro em um manifesto vazio

• Nomes ou valores de parâmetros inválidos

• Sintaxe de sequência de caracteres de consulta malformada

• Parâmetros de filtro duplicados

• A sequência de parâmetros excede 1024 caracteres

• Parâmetros de consulta em playlists ou segmentos de mídia

Referência: condições de erro de filtragem de MediaPackage manifestos

HTTP 200 OK (sem filtragem aplicada)

Causas documentadas:

• Parâmetro de filtro não encontrado nos fluxos disponíveis (retorna o manifesto não filtrado)

• Somente fluxos de legendas estão presentes após a filtragem (retorna o manifesto não filtrado)

Referência: condições de erro de filtragem de MediaPackage manifestos

Recursos adicionais para solução de problemas

Para questões não abordadas neste tópico, consulte estes AWS recursos oficiais:

• Visualizando um manifesto de AWS Elemental MediaPackage- Use a visualização prévia do manifesto para solucionar problemas de empacotamento de conteúdo

• Aumente a taxa de acertos do CloudFront cache - Guia abrangente para otimização do cache CDN

• Filtragem de manifestos - Guia completo da funcionalidade de MediaPackage filtragem