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á.
# 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](cdn-troubleshooting.md) 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, consulte[Integre MediaTailor com uma MediaPackage CDN](mediapackage-integration.md). Para obter orientação sobre como otimizar o desempenho do cache após a resolução de problemas, consulte. [Cache CDN](cdn-emp-caching.md)
## 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.
1. Valide a sintaxe do filtro em relação aos nomes de parâmetros e formatos de valor suportados.
1. Verifique se há parâmetros duplicados em sua string de consulta.
1. Certifique-se de que os parâmetros do filtro sejam aplicados somente às playlists multivariantes, não às playlists ou segmentos de mídia.
1. 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**A filtragem de manifestos 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.
1. Teste os parâmetros do filtro diretamente nos MediaPackage endpoints (ignorando a CDN) para verificar se eles funcionam conforme o esperado.
1. 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
## 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](diagnose-performance-issues.md#cache-performance-troubleshooting) 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](cdn-emp-caching.md)
### 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.
1. Compare manifestos filtrados e não filtrados para confirmar se os fluxos esperados foram incluídos/excluídos.
1. Verifique se sua política de cache de CDN encaminha o parâmetro de `aws.manifestfilter` consulta.
1. 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](cdn-emp-manifest-filtering.md) 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_msn`e `_HLS_part` - para suporte LL-HLS
1. 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/cdns.html)
## 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
## 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-preview.html) manifesto para solucionar problemas de empacotamento de conteúdo
+ [Aumente a taxa de acertos do CloudFront cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html) - Guia abrangente para otimização do cache CDN
+ [Filtragem de manifestos](https://docs.aws.amazon.com/mediapackage/latest/userguide/manifest-filtering.html) - Guia completo da funcionalidade de MediaPackage filtragem