Solución de problemas MediaPackage, CDN e integraciones MediaTailor - AWS Elemental MediaTailor
Errores de filtrado de manifiestosProcedimientos de diagnósticoReferencia de códigos de errorRecursos adicionales de solución de problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Solución de problemas MediaPackage, CDN e integraciones MediaTailor

AWS Elemental MediaTailor la integración con la red de entrega de contenido (CDN) AWS Elemental MediaPackage y la red de entrega de contenido (CDN) pueden surgir problemas comunes que afectan a la reproducción, el almacenamiento en caché u otras funciones de integración. Utilice esta guía cuando tenga problemas de reproducción, problemas de almacenamiento en caché u otros errores relacionados con la integración.

Para obtener una guía completa de solución de problemas de CDN, incluidos los problemas de rendimiento de la caché universal, la resolución de errores de HTTP, los procedimientos de prueba y las técnicas de diagnóstico que se aplican a todas MediaTailor las implementaciones, consulte. Solucione problemas de integración de CDN Esta sección se centra en los requisitos MediaPackage específicos de solución de problemas.

Antes de solucionar el problema, asegúrese de haber completado correctamente la configuración básica de la integración. Si aún no ha configurado la integración o necesita revisar los pasos de configuración, consulteIntegre MediaTailor con una MediaPackage CDN . Para obtener instrucciones sobre cómo optimizar el rendimiento de la caché después de resolver problemas, consulteAlmacenamiento en caché de CDN.

Errores de filtrado de manifiestos

Problemas con la funcionalidad de filtrado de MediaPackage manifiestos, basados en condiciones de error documentadas:

Errores de HTTP 400 con filtrado de manifiestos

Síntomas: las solicitudes con aws.manifestfilter parámetros devuelven una solicitud incorrecta de HTTP 400

Causas validadas (de AWS la documentación):

  • Los criterios de filtrado dan como resultado un manifiesto vacío (ningún flujo coincide con las condiciones del filtro)

  • Nombres o valores de los parámetros de filtro no válidos

  • Sintaxis de cadena de consulta mal formada

  • Parámetros de filtro duplicados o repetidos

  • La cadena de parámetros del filtro supera los 1024 caracteres

  • Parámetros de consulta aplicados a listas de reproducción o segmentos multimedia (no compatibles)

Soluciones:

  1. Revise los parámetros del filtro para asegurarse de que coincidan con las transmisiones de contenido disponibles. Si el filtrado no produce secuencias coincidentes, MediaPackage devuelve HTTP 400.

  2. Valide la sintaxis del filtro comparándola con los nombres de parámetros y los formatos de valores compatibles.

  3. Compruebe si hay parámetros duplicados en la cadena de consulta.

  4. Asegúrese de que los parámetros del filtro solo se apliquen a listas de reproducción multivariantes, no a listas de reproducción o segmentos multimedia.

  5. Compruebe que la cadena de parámetros total tenga menos de 1024 caracteres.

Referencia: condiciones de error de filtrado de AWS Elemental MediaPackage manifiestos

El filtrado de manifiestos no funciona (HTTP 200 pero no se ha aplicado ningún filtrado)

Síntomas: las solicitudes devuelven el HTTP 200, pero el manifiesto contiene todas las secuencias en lugar del subconjunto filtrado

Causas posibles:

  • La CDN no reenvía el parámetro de consulta a aws.manifestfilter MediaPackage

  • No se encuentra el parámetro de filtro en las transmisiones disponibles (devuelve un manifiesto sin filtrar con HTTP 200)

Soluciones:

  1. Comprueba que tu política de caché de CDN esté incluida aws.manifestfilter en la lista de cadenas de consulta reenviadas.

  2. Pruebe los parámetros del filtro directamente con los MediaPackage puntos finales (sin pasar por la CDN) para comprobar que funcionan según lo esperado.

  3. Comprueba que los valores del filtro coincidan con las características reales de tus flujos de contenido.

Referencia: condiciones de error de filtrado AWS Elemental MediaPackage manifiesto

Procedimientos de diagnóstico

Los procedimientos de diagnóstico sistemáticos ayudan a identificar la causa raíz de los problemas de integración de forma rápida y eficiente. Seguir un enfoque estructurado evita perder tiempo con suposiciones incorrectas y garantiza que se aborde el problema real y no los síntomas. Estos pasos de diagnóstico basados en la evidencia están diseñados para aislar los problemas y guiarlo hacia la solución adecuada.

Siga estos pasos de diagnóstico basados en la evidencia para identificar los problemas:

Análisis del rendimiento de la memoria caché

El análisis del rendimiento de la caché es crucial para las integraciones de EMP, ya que una mala eficiencia de la memoria caché provoca una mayor carga de origen, mayores costes y posibles problemas de reproducción.

Para obtener una solución integral de problemas de rendimiento de la caché, que incluye el análisis de la tasa de aciertos de la caché, la optimización de las claves de la caché y los pasos de diagnóstico sistemáticos, consulta Problemas de rendimiento de la caché de la CDN la guía principal de solución de problemas de la CDN.

Consideraciones sobre la caché específicas de EMP:

  • Encabezados de control de caché de EMP: compruebe que su CDN respete los encabezados de control de caché de EMP en lugar de anularlos

  • Parámetros de consulta EMP: asegúrese de que solo los parámetros de consulta EMP necesarios estén incluidos en las claves de caché

  • Comportamiento del TTL de EMP: confirme que los diferentes tipos de contenido de EMP tengan la duración de caché adecuada

Para obtener instrucciones detalladas sobre cómo optimizar las políticas de caché EMP y la configuración de TTL, consulte. Optimice el almacenamiento en caché de CDN para la entrega MediaTailor de contenido MediaPackage

Valide la configuración del filtrado de manifiestos

La validación del filtrado de manifiestos es esencial porque los problemas de filtrado pueden provocar que los espectadores reciban contenido incorrecto, formatos no compatibles o contenido al que no deberían tener acceso. Las pruebas sistemáticas ayudan a identificar si los problemas están relacionados con la configuración de la CDN, la sintaxis de los parámetros de filtro o la disponibilidad del contenido.

Pruebe la funcionalidad de filtrado de manifiestos de forma sistemática:

  1. Pruebe los parámetros del filtro directamente con los MediaPackage puntos finales (sin pasar por la CDN) para comprobar que funcionan correctamente.

  2. Compare los manifiestos filtrados y no filtrados para confirmar que las transmisiones esperadas están incluidas o excluidas.

  3. Compruebe que la política de caché de la CDN reenvíe el parámetro de consulta. aws.manifestfilter

  4. Compruebe si hay errores de HTTP 400 y compárelos con las condiciones de error documentadas.

Si necesitas implementar o modificar el filtrado de manifiestos después de resolver los problemas, consulta Configura el filtrado de manifiestos con MediaTailor MediaPackage, y CDN la guía de configuración completa.

Valide la configuración de los parámetros de consulta

Asegúrese de que su CDN reenvíe solo los parámetros de consulta necesarios:

  1. Revisa tu política de caché de la CDN para confirmar que solo AWS incluye los parámetros recomendados:

    • aws.manifestfilter- para filtrar manifiestos

    • aws.manifestsettings- para visualización desplazada en el tiempo

    • _HLS_msny _HLS_part - para compatibilidad con LL-HLS

  2. Elimine cualquier otro parámetro de consulta de su clave de caché, ya que los MediaPackage ignora y reduce la eficiencia de la caché.

Referencia: Trabajar con y AWS Elemental MediaPackage CDNs

Referencia de códigos de error

Referencia para las condiciones de error documentadas y sus causas:

Solicitud incorrecta del HTTP 400 (filtrado de manifiestos)

Causas documentadas:

  • La aplicación del filtro da como resultado un manifiesto vacío

  • Nombres o valores de parámetros no válidos

  • Sintaxis de cadena de consulta mal formada

  • Parámetros de filtro duplicados

  • La cadena de parámetros supera los 1024 caracteres

  • Consulta los parámetros de las listas de reproducción o los segmentos multimedia

Referencia: condiciones de error de filtrado MediaPackage manifiesto

HTTP 200 OK (no se ha aplicado ningún filtrado)

Causas documentadas:

  • El parámetro de filtro no se encuentra en las transmisiones disponibles (devuelve un manifiesto sin filtrar)

  • Solo los flujos de subtítulos están presentes después del filtrado (devuelve el manifiesto sin filtrar)

Referencia: condiciones de error de filtrado de MediaPackage manifiestos

Recursos adicionales de solución de problemas

Para cuestiones que no se tratan en este tema, consulta estos AWS recursos oficiales: