Solución de problemas relacionados con la integración MediaTailor de CDN - AWS Elemental MediaTailor
Preparación para solucionar problemasGuías de solución de problemas específicos para el flujo de trabajo

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 relacionados con la integración MediaTailor de CDN

Esta completa guía de solución de problemas cubre los problemas más comunes de integración de la red de entrega de contenido (CDN) en todas AWS Elemental MediaTailor las implementaciones, incluida la inserción de anuncios en el lado del servidor (SSAI), el ensamblaje de canales y la integración. AWS Elemental MediaPackage Cuando su CDN y su MediaTailor integración tengan problemas, utilice este enfoque de diagnóstico sistemático para identificar rápidamente las causas fundamentales e implementar soluciones validadas.

Esta guía se aplica a todas las integraciones de MediaTailor CDN, independientemente de su flujo de trabajo específico. Para conocer los problemas específicos de determinados servicios o flujos de trabajo, consulta las secciones de solución de problemas relacionadas a las que se hace referencia al final de esta guía.

Antes de empezar: tenga preparados los siguientes elementos para una solución de problemas eficaz:

  • Ejemplo de reproducción URLs que demuestra el problema

  • Registros de acceso a la CDN del período en que se produjeron los problemas

  • MediaTailor nombre y región de la AWS configuración

  • Tipo y versión del reproductor (por ejemplo, HLS.js 1.4.0, Video.js 8.0)

  • Información sobre el dispositivo y el navegador donde se producen los problemas

Temas relacionados:

Preparación para solucionar problemas

Configure herramientas y procesos para simplificar la solución de problemas cuando surjan problemas de integración de la CDN. La preparación proactiva hace que la solución de problemas sea más rápida y eficaz cuando se producen problemas.

Permita un registro completo

Los registros detallados son esenciales para diagnosticar los problemas de integración de la CDN. Configure el registro para capturar la información que necesitará durante la solución de problemas.

  1. Habilite los registros de acceso detallados a la CDN:

    • Configure el registro de todos los comportamientos de la caché que gestionan las solicitudes MediaTailor

    • Incluya cadenas de consulta y encabezados personalizados en las entradas de registro

    • Configure herramientas de análisis de registros para identificar patrones y anomalías

    • Habilite los registros en tiempo real para la detección inmediata de problemas durante los eventos en directo

    • Configure políticas de retención de registros para mantener los datos históricos de solución de problemas

  2. Configure MediaTailor el registro:

    • Habilite los registros de acceso para sus MediaTailor configuraciones

    • Configure grupos de CloudWatch registros para una administración centralizada de registros

    • Configure los filtros de registro para identificar los patrones de error

  3. Configure el registro del servidor de origen:

    • Habilite los registros de acceso detallados en sus servidores de origen de contenido

    • Incluye los encabezados de las solicitudes y los códigos de respuesta en los registros

    • Supervise las métricas de rendimiento del servidor de origen

Agregue encabezados de solicitudes de diagnóstico

Los encabezados personalizados ayudan a rastrear las solicitudes a través de la CDN e identificar los problemas de enrutamiento.

  1. Configura los encabezados de diagnóstico de la CDN:

    • Agregue un identificador único a cada solicitud (por ejemplo,) X-Request-ID

    • Incluya información específica de la CDN en los encabezados de las solicitudes

    • Agregue información sobre la ubicación de los bordes o el POP (punto de presencia) para rastrear el enrutamiento geográfico

    • Incluya encabezados de estado de la caché (Hit, Miss RefreshHit) para analizar el comportamiento de la caché

  2. Agregue encabezados de respuesta para la depuración:

    • Incluya encabezados de identificación del servidor

    • Agregue información de temporización para el análisis del rendimiento

    • Incluye encabezados de control de caché para las solicitudes de manifiesto

Establezca métricas de rendimiento de referencia

Documente los rangos de rendimiento normales para identificar rápidamente las anomalías durante la resolución de problemas:

  1. Registre las métricas de referencia:

    • Proporciones de aciertos en caché para diferentes tipos de contenido

    • Percentiles de tiempo de respuesta (P50, P95, P99)

    • Tasas de error por código de estado

    • Solicita patrones de volumen por hora del día

  2. Documente las expectativas de rendimiento:

    • Índices de aciertos de la caché objetivo (más del 95% para el contenido y más del 90% para los anuncios)

    • Tiempos de respuesta aceptables (<100 ms en caché, <500 ms en origen)

    • Tasas de error máximas aceptables (< 1% para 4xx, < 0,1% para 5xx)

  3. Cree paneles de rendimiento: configure paneles de supervisión que muestren las métricas actuales en comparación con los valores de referencia.

Prepare herramientas de solución de problemas

Configure las herramientas y los permisos de acceso necesarios para una solución de problemas eficaz:

  1. Herramientas de línea de comandos:

    • curlpara probar las solicitudes y respuestas HTTP

    • digo nslookup para solucionar problemas de DNS

    • Herramientas de validación HLS/DASH para la verificación de manifiestos

    • Herramientas de análisis de registros (grep, awk o analizadores de registros especializados)

  2. Permisos de acceso:

    • Acceso a la consola de administración de la CDN para revisar la configuración

    • MediaTailor acceso a la consola para verificar la configuración

    • CloudWatch acceso para el análisis de métricas y registros

    • Acceso al servidor Origin para solucionar problemas de backend

  3. Documentación:

    • Diagramas de arquitectura de red

    • CDN y documentación MediaTailor de configuración

    • Información de contacto para los procedimientos de escalamiento

    • Guías de resolución de problemas para situaciones comunes

Guías de solución de problemas específicos para el flujo de trabajo

Esta guía universal de solución de problemas cubre los problemas más comunes en todas MediaTailor las integraciones de CDN. Para problemas específicos de determinados flujos de trabajo o servicios, consulta estos recursos especializados de solución de problemas:

Solución de problemas de inserción de anuncios en el lado del servidor (SSAI)

Para obtener información sobre problemas específicos del SSAI, como los errores de inserción de anuncios, los problemas de transición de anuncios y los problemas de personalización, consulte la documentación de solución de problemas del SSAI específica para cada flujo de trabajo.

Problemas comunes específicos del SSAI:

  • Fallos al insertar anuncios y pausas de anuncios vacías

  • Problemas de sincronización y temporización de la transición

  • Problemas de personalización y segmentación

  • Discrepancias en el seguimiento y el análisis de anuncios

Solución de problemas de ensamblaje de canales

Para obtener información sobre problemas específicos del ensamblaje de canales, incluidos los problemas de generación de manifiestos y la funcionalidad de cambio horario, consulte la documentación del flujo de trabajo del ensamblaje de canales.

Problemas comunes de ensamblaje de canales:

  • Errores de generación y compilación de manifiestos

  • Problemas con la ventana de cambio de hora y el funcionamiento del DVR

  • Problemas de disponibilidad del contenido fuente y de conmutación por error

  • Sincronización de metadatos y programación del programa

MediaPackage solución de problemas de integración

Para problemas MediaPackage específicos, como el filtrado de manifiestos y los problemas de los terminales EMP, consulteSolución de problemas de integración de CDN.

Problemas de MediaPackage integración comunes:

  • Errores manifiestos en los parámetros de filtrado

  • MediaPackage problemas de conectividad de terminales

  • Problemas de comportamiento de la caché específicos de EMP

  • MediaPackage problemas de autenticación de origen

CloudFront solución de problemas específicos

Para obtener información sobre problemas CloudFront específicos de configuración y configuración, consulte CloudFront la documentación de integración.

CloudFront Problemas comunes:

  • Configuración de distribución y configuración del comportamiento de la caché

  • Configuración de identidad y seguridad de acceso a Origin

  • CloudFront códigos de error y respuestas específicos

  • Restricciones geográficas y problemas de ubicación de los bordes

Recursos adicionales: