

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.

# Integre MediaTailor con una MediaPackage CDN
<a name="mediapackage-integration"></a>

AWS Elemental MediaTailor se integra AWS Elemental MediaPackage para ofrecer anuncios de vídeo personalizados a través de una red de entrega de contenido (CDN). MediaPackage es un servicio de empaquetado y creación de just-in-time vídeos que prepara y protege el contenido de vídeo para su distribución a través de Internet. Toma tu contenido de vídeo en directo o bajo demanda y lo empaqueta en formatos de streaming como HLS y DASH, lo que lo pone a disposición de los espectadores en varios dispositivos.

Al combinarlo MediaPackage con MediaTailor una CDN, se crea un flujo de trabajo de streaming completo que ofrece anuncios personalizados a gran escala. La CDN distribuye tu contenido por todo el mundo, lo que reduce la latencia y mejora la experiencia de los espectadores, al tiempo que MediaTailor inserta anuncios segmentados en tus transmisiones.

Este tema se centra en los pasos de integración esenciales para conseguir MediaTailor que tu CDN y tu CDN trabajen juntas. MediaPackage Para obtener información sobre las opciones de configuración avanzadas, la solución de problemas y la guía de supervisión, consulte[Siguientes pasos](#emp-cdn-next-steps).

## Comprensión del flujo MediaPackage de trabajo de CDN
<a name="emp-cdn-overview"></a>

Antes de configurar tu integración, es importante entender cómo MediaPackage funcionan juntas tu CDN y tu CDN: MediaTailor

1. **Preparación del contenido**: MediaPackage recibe tu contenido de vídeo en directo o bajo demanda y lo empaqueta en formatos de streaming (manifiestos y segmentos HLS o DASH).

1. **Inserción de anuncios**: MediaTailor solicita manifiestos a los espectadores MediaPackage, inserta anuncios personalizados y muestra los manifiestos modificados a los espectadores.

1. **Distribución global**: tu CDN almacena en caché y distribuye tanto los segmentos de contenido (de) como los segmentos de anuncios (de MediaPackage MediaTailor) a los espectadores de todo el mundo.

1. **Reproducción de los espectadores**: los reproductores de vídeo solicitan los manifiestos a través de la CDN, que distribuye las solicitudes de forma adecuada entre MediaTailor (en el caso de los manifiestos) y MediaPackage (en el caso de los segmentos de contenido).

Esta arquitectura ofrece varias ventajas:
+ **Escalabilidad**: la CDN gestiona una gran cantidad de espectadores sin afectar a los servidores de origen
+ **Rendimiento: el** contenido se entrega desde las ubicaciones periféricas más cercanas a los espectadores
+ **Rentabilidad: reducción** de los costes de ancho de banda mediante el almacenamiento en caché
+ **Fiabilidad**: las múltiples ubicaciones de borde proporcionan redundancia

## Requisitos previos
<a name="emp-cdn-prerequisites"></a>

Antes de empezar, asegúrese de tener configurados los siguientes componentes:

1. **MediaPackage terminal: MediaPackage terminal** configurado que recibe y empaqueta el contenido de vídeo. Para obtener instrucciones de configuración, consulte [Primeros pasos MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/getting-started.html) en la guía del MediaPackage usuario.

1. **MediaTailor configuración**: MediaTailor configuración que utiliza su MediaPackage punto final como origen del contenido. Para obtener instrucciones de configuración, consulte[Integración de una fuente de contenido para la inserción de MediaTailor anuncios](integrating-origin.md).

1. Distribución de **CDN: una distribución** de CDN (por ejemplo CloudFront) configurada para funcionar con contenido multimedia en streaming. Para obtener instrucciones de configuración, consulta [Cómo crear una distribución](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) en la guía CloudFront para desarrolladores.

1. Servidor de **decisiones publicitarias: un servidor** de decisiones publicitarias configurado que devuelve respuestas VAST o VMAP para la inserción de anuncios.

## Paso 1: Configura los ajustes esenciales de la CDN
<a name="mediapackage-best-practices"></a>

La configuración adecuada de la CDN es fundamental para una MediaPackage integración exitosa. Una configuración incorrecta puede provocar fallos en la reproducción, un rendimiento deficiente de la memoria caché y un aumento de los costes. Sin las políticas de caché y el reenvío de los parámetros de consulta adecuados, es posible que tu CDN no entregue los manifiestos correctamente o que evite por completo el almacenamiento en caché, lo que provocará una gran carga de trabajo en el servidor de origen y una experiencia de visualización degradada.

### Configura los ajustes básicos de la caché
<a name="mediapackage-cache-control"></a>

La configuración del almacenamiento en caché básico es esencial porque MediaPackage utiliza encabezados de control de caché específicos para optimizar la entrega de contenido. Sin una configuración de caché adecuada, la CDN podría ignorar estos encabezados, lo que generaría solicitudes de origen innecesarias y aumentaría la latencia. Sigue estos pasos para garantizar un comportamiento de almacenamiento en caché óptimo:

Para configurar el almacenamiento en caché básico que funcione con: MediaPackage

1. Abre los ajustes CloudFront de distribución en la CloudFront consola.

1. Selecciona o crea una política de caché para tu MediaPackage origen.

1. Activa la opción «Origin Cache-Control Headers».

1. Permite controlar el comportamiento del almacenamiento en caché MediaPackage a través de sus encabezados de control de caché.

Esta configuración básica permite establecer automáticamente las duraciones de caché adecuadas MediaPackage para diferentes tipos de contenido. Para implementar una optimización avanzada de la caché con valores TTL específicos y un ajuste del rendimiento, complete primero esta configuración básica y, a continuación, continúe. [Optimice el almacenamiento en caché de CDN para la entrega MediaTailor de contenido MediaPackage](cdn-emp-caching.md)

### Configure los parámetros de consulta esenciales
<a name="mediapackage-query-strings"></a>

La configuración de los parámetros de consulta es crucial para MediaPackage la funcionalidad. Su CDN debe reenviar parámetros de consulta específicos para habilitar funciones como la visualización con cambios de hora y la transmisión de baja latencia. Una configuración incorrecta de los parámetros de consulta puede impedir que estas funciones funcionen y me preocupa reducir la eficiencia de la memoria caché. Siga estos pasos para configurar el reenvío de los parámetros de consulta:

Para garantizar que su CDN reenvíe los parámetros de consulta necesarios a: MediaPackage

1. En tu configuración CloudFront de distribución, selecciona o crea una política de caché para las solicitudes de manifiesto.

1. En «Configuración de claves de caché», selecciona «Incluir cadenas de consulta especificadas».

1. Añada los siguientes parámetros de consulta esenciales:
   + `start`y `end` - Para una funcionalidad de visualización desplazada en el tiempo. Estos parámetros se transfieren MediaPackage a para definir ventanas de contenido específicas para su visualización inicial y puesta al día.
   + `_HLS_msn`y `_HLS_part` - Para admitir solicitudes de reproducción LL-HLS
   + `m`- Para capturar lo modificado ti/compame del punto final. MediaPackage las respuestas siempre incluyen la `?m=###` etiqueta para capturar la hora de modificación del punto final. Si el contenido ya está almacenado en caché con un valor diferente para esta etiqueta, CloudFront solicita un nuevo manifiesto en lugar de publicar la versión en caché
   + `aws.manifestfilter`- Para la funcionalidad de filtrado de manifiestos. Si utilizas el filtrado de manifiestos, debes incluir este parámetro para configurar la distribución de forma que reenvíe la cadena de `aws.manifestfilter` consulta al MediaPackage origen, lo cual es necesario para que funcione la función de filtrado de manifiestos

1. Incluye únicamente las cadenas de consulta que MediaPackage utilice. La inclusión de cadenas de consulta innecesarias reduce la eficiencia de la caché al crear varias variaciones de la caché para el mismo contenido.

Estos parámetros permiten la MediaPackage funcionalidad básica de la CDN. Si necesita implementar el filtrado de contenido para diferentes niveles de suscripción o tipos de dispositivos, complete primero esta configuración básica de parámetros de consulta y, a [Configura el filtrado de manifiestos con MediaTailor MediaPackage, y CDN](cdn-emp-manifest-filtering.md) continuación, continúe con.

Para obtener información sobre cómo se MediaTailor transfieren los parámetros de consulta `start` y cómo se transfieren `end` a MediaPackage ellos para visualizarlos [MediaTailor gestión de parámetros de consulta para los orígenes](origin-query-parameters.md) en [MediaTailor parámetros de consulta de manifiesto](manifest-query-parameters.md) intervalos de tiempo, consulte.

### Configure el tiempo de espera de respuesta para LL-HLS
<a name="mediapackage-response-timeout"></a>

La configuración del tiempo de espera es fundamental para el HLS de baja latencia, ya que el LL-HLS utiliza un mecanismo de «bloqueo de solicitudes» en el que la CDN espera a que lleguen nuevos segmentos de contenido. Si el tiempo de espera es demasiado corto, las solicitudes fallarán antes de poder responder con nuevos segmentos, lo que provocará interrupciones en la MediaPackage reproducción y una mala experiencia para el espectador. Configura los tiempos de espera adecuados para garantizar una reproducción fluida del LL-HLS:

Si utilizas un HLS de baja latencia, configura los ajustes de tiempo de espera de la CDN:

1. En la configuración de la CDN, busca la configuración de tiempo de espera de origen.

1. Establezca el valor de tiempo de espera de respuesta en al menos tres veces la duración de la pieza.

1. Por ejemplo, si la duración de las piezas es de 0,3 segundos, establece el tiempo de espera como mínimo en 0,9 segundos.

Esto garantiza que la CDN espere el tiempo suficiente para MediaPackage responder cuando utilice el mecanismo de solicitudes de bloqueo.

## Paso 2: Verifica tu integración
<a name="manifest-filtering-integration"></a>

Probar la integración es esencial para garantizar que todos los componentes funcionen correctamente juntos antes de que los espectadores experimenten problemas. Una integración fallida puede provocar interrupciones en la reproducción, la falta de anuncios o un rendimiento deficiente. Este proceso de verificación le ayuda a identificar y resolver problemas en un entorno controlado.

Tras configurar los ajustes de la CDN, comprueba que la integración funciona correctamente probando todo el flujo de trabajo, desde la solicitud de contenido hasta la inserción del anuncio.

### Paso 2.1: Probar la reproducción básica
<a name="manifest-filtering-overview"></a>

Las pruebas básicas de reproducción verifican que la CDN gestiona correctamente las solicitudes de manifiesto y las reenvía a. MediaTailor Esta prueba ayuda a identificar los problemas de configuración relacionados con las políticas de caché, el reenvío de los parámetros de consulta y la gestión de los manifiestos. Sigue estos pasos para probar la entrega de manifiestos básicos:

Comprueba que tu integración básica funciona solicitando un manifiesto a través de tu CDN:

1. Usa un navegador web o curl para solicitar la URL de un manifiesto a través de tu CDN.

1. Comprueba que el manifiesto se carga correctamente y que contiene tanto contenido como segmentos de anuncios.

1. Comprueba que el segmento URLs de contenido del manifiesto apunte a tu dominio de CDN.

1. Comprueba que el segmento de anuncios URLs también apunte a tu dominio de CDN.

Si el manifiesto se carga correctamente y contiene lo esperado URLs, tu integración básica funciona. Para obtener información sobre metodologías de prueba completas y procedimientos de validación avanzados, consulte[Pruebas y validación de CDN e MediaTailor integraciones](cdn-integration-testing.md). Para configurar una supervisión integral del rendimiento y el estado de su integración, consulte[Supervise el rendimiento de MediaPackage la CDN y las integraciones MediaTailor](cdn-emp-monitoring.md).

### Paso 2.2: Pruebe la reproducción del vídeo
<a name="manifest-filtering-cdn-config"></a>

Las pruebas de reproducción de vídeo garantizan que la integración completa funcione end-to-end, incluida la inserción de anuncios y la entrega de contenido a través de la CDN. Esta prueba comprueba que tanto los segmentos de contenido como los segmentos de anuncios se almacenan y distribuyen correctamente, y que la experiencia del espectador cumple tus estándares de calidad. Sigue estos pasos para probar todas las funciones de reproducción:

Compruebe que la reproducción de vídeo funciona correctamente con los anuncios insertados:

1. Usa un reproductor de vídeo (como Video.js o HLS.js) para reproducir tu contenido a través de la CDN.

1. Comprueba que el vídeo se reproduce sin problemas de almacenamiento en búfer.

1. Confirme que los anuncios se insertan en los momentos esperados durante la reproducción.

1. Comprueba que tanto el contenido como los segmentos de anuncios se carguen desde tu CDN (no directamente desde los orígenes).

Si la reproducción funciona sin problemas con los anuncios, tu integración funciona correctamente. Para obtener información sobre metodologías de prueba completas y procedimientos de validación avanzados, consulte[Pruebas y validación de CDN e MediaTailor integraciones](cdn-integration-testing.md). Si tiene problemas de reproducción, almacenamiento en búfer o inserción de anuncios, consulte. [Solución de problemas MediaPackage, CDN e integraciones MediaTailor](cdn-emp-troubleshooting.md)

## Siguientes pasos
<a name="emp-cdn-next-steps"></a>

Tras completar la integración básica, puedes implementar funciones y optimizaciones avanzadas:

**Optimización avanzada de CDN**  
Para obtener información detallada sobre la optimización de la caché, la configuración de TTL y el ajuste del rendimiento, consulte. [Optimice el almacenamiento en caché de CDN para la entrega MediaTailor de contenido MediaPackage](cdn-emp-caching.md)

**Filtrado de manifiestos**  
Para implementar el filtrado de contenido para servicios por niveles, optimización de dispositivos o control de acceso, consulte. [Configura el filtrado de manifiestos con MediaTailor MediaPackage, y CDN](cdn-emp-manifest-filtering.md)

**Resolución de problemas**  
Si tiene problemas con la integración, consulte[Solución de problemas MediaPackage, CDN e integraciones MediaTailor](cdn-emp-troubleshooting.md).

**Supervisión del rendimiento**  
Para configurar una supervisión integral y comprender las métricas clave de rendimiento, consulte[Supervise el rendimiento de MediaPackage la CDN y las integraciones MediaTailor](cdn-emp-monitoring.md).

# Configura el filtrado de manifiestos con MediaTailor MediaPackage, y CDN
<a name="cdn-emp-manifest-filtering"></a>

AWS Elemental MediaTailor utiliza el filtrado de manifiestos AWS Elemental MediaPackage para personalizar las transmisiones de audio y vídeo que se incluyen en los manifiestos que se envían a distintos espectadores a través de una red de entrega de contenido (CDN). Esto resulta especialmente útil para implementar ofertas de servicios escalonadas, optimizaciones específicas para cada dispositivo o controles de acceso al contenido.

Este tema se centra específicamente en la implementación de funciones de filtrado de manifiestos. Antes de implementar el filtrado de manifiestos, debe completar la configuración básica de integración de la red de entrega de contenido. Si aún no has configurado la integración de la red básica MediaPackage y de entrega de contenido, comienza con[Integre MediaTailor con una MediaPackage CDN](mediapackage-integration.md).

## Capacidades de filtrado de manifiestos
<a name="manifest-filtering-overview"></a>

Antes de implementar el filtrado de manifiestos, comprenda lo que puede lograr con esta función:

### Capacidades principales de filtrado
<a name="filtering-capabilities"></a>

El filtrado de manifiestos ofrece varias funciones clave que te ayudan a controlar la entrega de contenido:
+ Restrinja el acceso de los espectadores a contenido premium (como el 4K HEVC)
+ Diríjase a tipos de dispositivos específicos con las transmisiones adecuadas
+ Filtre el contenido en función de las frecuencias de muestreo de audio, los idiomas o los códecs de vídeo
+ Ofrezca diferentes niveles de calidad a diferentes suscriptores

### Casos de uso comunes
<a name="filtering-use-cases"></a>

Estos casos de uso demuestran cómo el filtrado de manifiestos puede abordar requisitos empresariales específicos:

**Niveles de suscripción**  
Ofrezca a los suscriptores básicos transmisiones de menor resolución y, al mismo tiempo, proporcione a los suscriptores premium acceso a contenido 4K  
Ejemplo: el nivel básico está limitado a 720p, el nivel Premium ofrece hasta 4K

**Optimización de dispositivos**  
Ofrezca automáticamente las transmisiones adecuadas en función de las capacidades del dispositivo  
Ejemplo: los dispositivos móviles obtienen velocidades de bits más bajas, los inteligentes TVs obtienen una mayor calidad

**Administración del ancho de banda**  
Limite la calidad de la transmisión durante los períodos de mayor uso para administrar los costos de la red  
Ejemplo: reduzca la velocidad máxima de bits durante eventos de alto tráfico

**Contenido regional**  
Sirve diferentes idiomas de audio o variantes de contenido según la ubicación del espectador  
Ejemplo: filtra automáticamente las pistas de audio en el idioma local

Para obtener más información sobre los conceptos de filtrado de manifiestos, consulte [Filtrado de manifiestos](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html) en la guía del AWS Elemental MediaPackage usuario.

## Configura tu CDN para el filtrado de manifiestos
<a name="cdn-filtering-configuration"></a>

La configuración de la CDN para el filtrado de manifiestos es esencial, ya que la CDN debe reenviar el parámetro de `aws.manifestfilter` consulta MediaPackage para que el filtrado funcione. Si no se reenvía correctamente las cadenas de consulta, la CDN eliminará los parámetros del filtro y todos los espectadores recibirán los manifiestos sin filtrar, independientemente del nivel de suscripción o de las capacidades del dispositivo. Esta configuración garantiza que la lógica de filtrado alcance MediaPackage y funcione según lo previsto.

Para habilitar el filtrado de manifiestos a través de tu CDN, debes configurar el reenvío de cadenas de consulta:

1. En tu CloudFront distribución, crea o edita el comportamiento de la caché para las solicitudes de manifiesto.

1. Para la **política de caché,** crea una nueva política o edita una existente.

1. En **Configuración de claves de caché**, selecciona «Incluir cadenas de consulta especificadas».

1. `aws.manifestfilter`Añádala a la lista de cadenas de consulta permitidas.

1. Si también utilizas otras MediaPackage funciones, añade sus parámetros de consulta:
   + `start`y `end` - Para una visualización desplazada en el tiempo
   + `time_delay`- Para la funcionalidad de retardo temporal
   + `_HLS_msn`y `_HLS_part` - Para LL-HLS

Para obtener más información sobre la creación de distribuciones, consulta [Crear una distribución](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) en la guía para CloudFront desarrolladores de Amazon.

## Implemente el filtrado del lado del cliente
<a name="client-side-filtering-implementation"></a>

La implementación en el lado del cliente consiste en definir la forma en que sus reproductores y aplicaciones de vídeo solicitan el contenido filtrado. Esta configuración determina el contenido que recibe cada espectador en función del nivel de suscripción, las capacidades del dispositivo u otros criterios. La implementación adecuada garantiza que los espectadores reciban solo el contenido al que deberían tener acceso y, al mismo tiempo, mantener una eficiencia óptima de la caché de la CDN.

Para implementar el filtrado de manifiestos en sus reproductores y aplicaciones de vídeo:

### Cómo funciona el filtrado
<a name="filtering-workflow"></a>

El proceso de filtrado funciona de la siguiente manera:

1. El reproductor de vídeo o la aplicación solicitan una URL de manifiesto que incluya los parámetros del filtro

1. La CDN reenvía la solicitud (incluidos los parámetros de consulta) a MediaTailor

1. MediaTailor transfiere los parámetros del filtro MediaPackage al solicitar el manifiesto de origen

1. MediaPackage aplica los filtros y devuelve un manifiesto personalizado que contiene solo las variantes que coinciden con sus criterios

1. MediaTailor procesa el manifiesto filtrado para la inserción de anuncios y lo devuelve al reproductor

### Formato de URL para filtrar
<a name="filtering-url-format"></a>

Comprender el formato de URL correcto es fundamental para una implementación exitosa del filtrado. Si se formatea la URL de forma incorrecta, se ignorarán los parámetros de filtrado o se producirán errores de HTTP. La estructura de la URL debe incluir parámetros de filtro como cadenas de consulta a las que reenvíe la CDN. MediaPackage Sigue estos pasos para implementar el formato de URL adecuado:

Para implementar el filtrado de manifiestos en tus reproductores de vídeo:

1. Modifica la solicitud de manifiesto de tu reproductor URLs para incluir los parámetros de filtro adecuados.

1. Usa el siguiente formato de URL con los parámetros de consulta:

   ```
   https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US
   ```

1. Cuando el reproductor solicite esta URL, MediaTailor pasará estos parámetros a MediaPackage, lo que dará como resultado un manifiesto filtrado.

## Escenarios de filtrado habituales
<a name="filtering-examples"></a>

Utilice estos ejemplos para implementar escenarios de filtrado comunes:

**Entrega de contenido específico para cada dispositivo**  
Para filtrar según las capacidades del dispositivo, añade este parámetro a tu solicitud de manifiesto:  

```
aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100
```
Este ejemplo limita el contenido a vídeo y audio H.264 con frecuencias de muestreo de hasta 44,1 kHz, lo que resulta adecuado para dispositivos móviles.

**Restricción de contenido premium**  
Para limitar el acceso al contenido de alta velocidad de bits, añade este parámetro a tu solicitud de manifiesto:  

```
aws.manifestfilter=video_bitrate:0-9000000
```
Este ejemplo restringe las velocidades de bits de vídeo a 9 Mbps o menos, lo que es adecuado para los niveles de suscripción básicos.

**Selección de idioma**  
Para filtrar por idiomas de audio específicos, añade este parámetro a tu solicitud de manifiesto:  

```
aws.manifestfilter=audio_language:fr,en-US,de
```
Este ejemplo incluye solo pistas de audio en francés, inglés estadounidense y alemán.

**Segmentación por resolución**  
Para filtrar por resoluciones de vídeo específicas, añade este parámetro a tu solicitud de manifiesto:  

```
aws.manifestfilter=video_height:240-360,720-1080
```
En este ejemplo se incluyen secuencias de vídeo con alturas entre 240 y 360 píxeles y entre 720 y 1080 píxeles, excluidas las resoluciones de gama media.

**Filtrado basado en códecs**  
Para filtrar códecs de vídeo específicos, añade este parámetro a tu solicitud de manifiesto:  

```
aws.manifestfilter=video_codec:h264,h265
```
Este ejemplo incluye solo transmisiones de vídeo H.264 y H.265, excluyendo otros códecs.

## Consideraciones y limitaciones especiales
<a name="filtering-considerations"></a>

Para evitar problemas comunes al implementar el filtrado de manifiestos:

### Limitaciones técnicas
<a name="technical-limitations"></a>
+ En el caso de los manifiestos TS, utilice grupos de renderizaciones de audio para evitar eliminar las transmisiones de vídeo que estén multiplexadas con secuencias de audio filtradas
+ En los manifiestos TS y CMAF, la frecuencia de muestreo de audio y la velocidad de bits del vídeo no se ven fácilmente en el manifiesto para su verificación
+ Los parámetros de solicitud adjuntos a las listas de reproducción o segmentos multimedia generarán un error HTTP 400

### Condiciones de error
<a name="error-conditions"></a>
+ Si el filtrado da como resultado un manifiesto vacío (ninguna transmisión cumple los criterios de filtrado), MediaPackage se mostrará un error HTTP 400
+ Las configuraciones de filtro conflictivas (filtros de punto final y parámetros de consulta) provocan errores HTTP 404
+ La sintaxis de filtro no válida o los tipos de filtro no compatibles provocan errores HTTP 400

### Consideraciones sobre el rendimiento
<a name="performance-considerations"></a>
+ Cada combinación de filtros única crea una entrada de caché independiente, lo que podría reducir la eficiencia de la caché
+ Los filtros complejos con muchos criterios pueden afectar al rendimiento de la generación de manifiestos
+ Considere la posibilidad de utilizar filtros a nivel de punto final para los escenarios de filtrado estático a fin de mejorar el rendimiento de la memoria caché

## Pruebe su implementación de filtrado
<a name="filtering-testing"></a>

Probar la implementación del filtrado de manifiestos es crucial para garantizar que los espectadores reciban el contenido correcto en función de su nivel de acceso y las capacidades del dispositivo. Si no se filtra correctamente, los espectadores pueden recibir niveles de calidad incorrectos, formatos no compatibles o contenido al que no deberían tener acceso. Las pruebas exhaustivas ayudan a identificar y resolver estos problemas antes de que afecten a los espectadores.

Para comprobar que el filtrado de manifiestos funciona correctamente, sigue estos pasos:

1. Solicita manifiestos con distintos parámetros de filtro y verifica los resultados

1. Compruebe que los manifiestos filtrados contengan solo las secuencias esperadas

1. Pruebe los casos límite (resultados vacíos, filtros no válidos) para garantizar una gestión adecuada de los errores

1. Compruebe que su CDN esté reenviando correctamente los parámetros del filtro

1. Realice pruebas con diferentes dispositivos y reproductores para garantizar la compatibilidad

Para solucionar problemas de filtrado, consulta *Solucionar problemas de integración de MediaPackage CDN*.

Si encuentras errores en el protocolo HTTP 400, manifiestos vacíos o parámetros de filtrado que no funcionan según lo esperado, consulta la guía específica [Solución de problemas MediaPackage, CDN e integraciones MediaTailor](cdn-emp-troubleshooting.md) para solucionar problemas relacionados con el filtrado de manifiestos.

# Optimice el almacenamiento en caché de CDN para la entrega MediaTailor de contenido MediaPackage
<a name="cdn-emp-caching"></a>

AWS Elemental MediaTailor requiere una configuración de almacenamiento en caché de la red de entrega de contenido (CDN) adecuada para un rendimiento óptimo cuando se utiliza AWS Elemental MediaPackage como origen del contenido. MediaPackage proporciona encabezados de control de caché específicos que indican a la red de distribución de contenido cuánto tiempo debe almacenar en caché los distintos tipos de contenido. Seguir estas recomendaciones garantiza una reproducción fluida y una entrega de contenido eficiente.

Este tema se centra específicamente en la optimización del comportamiento de almacenamiento en caché para maximizar el rendimiento y minimizar los costes. Antes de implementar la optimización avanzada del almacenamiento en caché, asegúrese de haber completado la configuración básica de integración de la red de entrega de contenido. Si aún no has configurado tu integración básica, comienza con[Integre MediaTailor con una MediaPackage CDN](mediapackage-integration.md).

## MediaPackage encabezados de control de caché
<a name="emp-cache-control-headers"></a>

MediaPackage establece valores TTL específicos para diferentes tipos de contenido a fin de optimizar el comportamiento del almacenamiento en caché:

**Listas de reproducción multivariantes (HLS y LL-HLS)**  
TTL: la mitad de la duración de los segmentos multimedia  
Motivo: estas listas de reproducción cambian a medida que aparecen nuevos segmentos, por lo que necesitan actualizarse con frecuencia

**Listas de reproducción multimedia (HLS normales)**  
TTL: la mitad de la duración de los segmentos multimedia  
Motivo: Al igual que las listas de reproducción multivariantes, se actualizan a medida que avanza el contenido

**Listas de reproducción multimedia (LL-HLS)**  
TTL: 1 segundo  
Motivo: la transmisión de baja latencia requiere actualizaciones muy frecuentes

**Segmentos multimedia y segmentos de inicio de TS**  
TTL: 1209600 segundos (14 días)  
Motivo: los segmentos multimedia no cambian una vez creados, por lo que se pueden almacenar en caché durante períodos prolongados

**Segmentos multimedia y segmentos de inicialización de CMAF**  
TTL: 1209600 segundos (14 días)  
Motivo: Al igual que los segmentos TS, son inmutables una vez creados

Para obtener recomendaciones completas de TTL para todos los MediaTailor flujos de trabajo y estrategias adicionales de optimización del almacenamiento en caché, consulte. [Optimización del almacenamiento en caché para CDN e integraciones MediaTailor](cdn-optimize-caching.md)

## Configure las políticas de caché de la CDN
<a name="cdn-cache-policy-configuration"></a>

La configuración adecuada de la política de caché es esencial para lograr un rendimiento y una rentabilidad óptimos. Los distintos tipos de contenido (manifiestos, segmentos, archivos de inicialización) tienen diferentes requisitos de almacenamiento en caché. El uso de comportamientos de caché independientes permite optimizar el almacenamiento en caché para cada tipo de contenido, lo que mejora las tasas de aciertos de la caché y reduce la carga de origen. Sin las políticas de caché adecuadas, es posible que recibas solicitudes de origen innecesarias, que aumenten los costes y que el rendimiento de la reproducción sea deficiente.

Para respetar adecuadamente los encabezados de MediaPackage control de caché y optimizar el almacenamiento en caché:

1. Abre la configuración de CloudFront distribución en la consola. CloudFront 

1. Crea comportamientos de caché independientes para distintos tipos de contenido:
   + Solicitudes de manifiesto (\$1.m3u8, \$1.mpd)
   + Segmentos multimedia (\$1.ts, \$1.mp4, \$1.m4s)
   + Segmentos de inicialización

1. Para cada comportamiento de caché, cree o seleccione una política de caché con la siguiente configuración:
   + Habilite la opción «Origin Cache-Control Headers»
   + Configura la «Política de solicitudes de Origin» para reenviar los encabezados necesarios
   + Configura el reenvío de cadenas de consulta en función del tipo de contenido

### Manifiesta el comportamiento de la caché
<a name="manifest-cache-behavior"></a>

Para las solicitudes de manifiesto (\$1.m3u8, \$1.mpd):
+ **Patrón de ruta: \$1.m3u8 y \$1.mpd**
+ Política de caché: respeta los **encabezados de control de caché de origen**
+ **Cadenas de consulta**: reenvían parámetros específicos (consulte) [Optimice el reenvío de cadenas de consulta](#cdn-query-string-optimization)
+ **Encabezados**: reenvía todos los encabezados (para ver los requisitos mínimos, consulte) [Cabeceras obligatorias para MediaTailor la integración de la CDN](cdn-configuration.md#cdn-required-headers)

### Comportamiento de la caché de segmentos multimedia
<a name="segment-cache-behavior"></a>

Para los segmentos multimedia (\$1.ts, \$1.mp4, \$1.m4s):
+ **Patrón de ruta**: \$1.ts, \$1.mp4, \$1.m4s
+ **Política de caché**: encabezados de control de caché de Honor Origin (TTL de 14 días)
+ **Cadenas de consulta**: ninguna (los segmentos no utilizan parámetros de consulta)
+ **Compresión**: permite mejorar el rendimiento de entrega

## Optimice el reenvío de cadenas de consulta
<a name="cdn-query-string-optimization"></a>

La optimización de la cadena de consulta es fundamental para la eficiencia de la caché, ya que los parámetros de consulta innecesarios crean múltiples variaciones de la caché para el mismo contenido. Cada combinación única de parámetros de consulta crea una entrada de caché independiente, lo que reduce las tasas de aciertos de la caché y aumenta las solicitudes de origen. Al reenviar solo las cadenas de consulta que MediaPackage realmente se utilizan, se maximiza la eficiencia de la caché y, al mismo tiempo, se mantiene toda la funcionalidad.

Configura tu CDN para que reenvíe solo las cadenas de consulta que MediaPackage utiliza, lo que mejora la eficiencia de la caché:

**Cadenas de consulta esenciales**  
`start`y `end` - Para ventanas de visualización desplazadas en el tiempo  
`time_delay`- Para aplicar un retardo temporal al contenido del manifiesto  
`_HLS_msn`,`_HLS_m`, y `_HLS_part` - Para solicitudes de reproducción LL-HLS

**Cadenas de consulta específicas de una función**  
`aws.manifestfilter`[- Para filtrar manifiestos](cdn-emp-manifest-filtering.md)

**importante**  
No incluyas ninguna otra cadena de consulta en tu clave de caché. MediaPackage ignora los parámetros no reconocidos e incluirlos reduce la eficiencia de la caché al crear variaciones de caché innecesarias.

## Técnicas de optimización del rendimiento
<a name="cache-performance-optimization"></a>

Estas optimizaciones se configuran en su CDN (por ejemplo CloudFront), no en MediaPackage o. MediaTailor Implemente estas optimizaciones adicionales para maximizar el rendimiento de la memoria caché:

### Escudo de origen
<a name="origin-shield-configuration"></a>

Origin Shield proporciona una capa de almacenamiento en caché adicional entre las ubicaciones periféricas y MediaPackage los puntos finales de la CDN. Esto reduce la cantidad de solicitudes que llegan a sus MediaPackage puntos finales, lo que puede mejorar el rendimiento y reducir los costes, especialmente durante los picos de tráfico o cuando las tasas de aciertos de caché son inferiores a las óptimas. Origin Shield resulta especialmente útil para las retransmisiones en directo, ya que es posible que varias ubicaciones periféricas soliciten el mismo contenido simultáneamente.

Activa Origin Shield para reducir la carga en tus MediaPackage puntos finales:

1. En tu CloudFront distribución, activa Origin Shield para tu MediaPackage origen.

1. Selecciona una región de Origin Shield cercana a tu MediaPackage punto de conexión.

1. Esto crea una capa de almacenamiento en caché adicional que reduce las solicitudes a MediaPackage.

### Configuración de compresión
<a name="compression-settings"></a>

Habilite la compresión de las respuestas basadas en texto:
+ Habilite la compresión de los archivos de manifiesto (\$1.m3u8, \$1.mpd)
+ No comprima los segmentos multimedia (ya comprimidos)
+ Asegúrese de que todos los encabezados se reenvíen a MediaPackage (para conocer los requisitos mínimos, consulte[Cabeceras obligatorias para MediaTailor la integración de la CDN](cdn-configuration.md#cdn-required-headers))

## Supervisa el rendimiento de la caché
<a name="cache-monitoring-metrics"></a>

Realice un seguimiento de estas métricas clave para garantizar un rendimiento óptimo de la memoria caché:

**Proporción de aciertos de caché**  
Objetivo: 90% o más para los segmentos de medios, 70% o más para los manifiestos  
Las proporciones bajas pueden indicar una configuración de TTL incorrecta o parámetros de consulta innecesarios

**Volumen de solicitudes de Origin**  
Supervise las solicitudes que llegan a los MediaPackage puntos finales  
Los volúmenes altos pueden indicar problemas de almacenamiento en caché

**Variaciones de claves de caché**  
Revise los patrones de las claves de la caché para identificar las variaciones innecesarias  
Demasiadas variaciones reducen la eficiencia de la memoria caché

Tras implementar estas optimizaciones de caché, configure la supervisión para hacer un seguimiento de su eficacia. Para obtener información sobre cómo supervisar las tasas de aciertos de la caché, los patrones de solicitudes de origen y otras métricas clave de rendimiento, consulte[Supervise el rendimiento de MediaPackage la CDN y las integraciones MediaTailor](cdn-emp-monitoring.md). Si observas un rendimiento de la caché deficiente o solicitudes de origen inesperadas, consulta los pasos [Solución de problemas MediaPackage, CDN e integraciones MediaTailor](cdn-emp-troubleshooting.md) para solucionar el problema.

# Supervise el rendimiento de MediaPackage la CDN y las integraciones MediaTailor
<a name="cdn-emp-monitoring"></a>

AWS Elemental MediaTailor requiere una supervisión eficaz para mantener un rendimiento óptimo de su AWS Elemental MediaPackage integración con la red de entrega de contenido (CDN). Este tema proporciona orientación sobre las métricas clave que se deben rastrear, las herramientas de supervisión que se deben utilizar y cómo configurar alertas para la detección proactiva de problemas.

Antes de configurar la supervisión, asegúrese de que la integración básica funcione correctamente. Si no ha completado la configuración básica de integración de la red de entrega de contenido, comience con[Integre MediaTailor con una MediaPackage CDN](mediapackage-integration.md). Si necesita solucionar los problemas identificados mediante la supervisión, consulte.. [Solución de problemas de integración de CDN](cdn-emp-troubleshooting.md)

## Métricas clave de rendimiento
<a name="key-performance-metrics"></a>

Supervisa estas métricas esenciales para garantizar un rendimiento óptimo de tu MediaPackage integración con la CDN:

### Métricas de rendimiento de la CDN
<a name="cdn-metrics"></a>

Para obtener métricas completas del rendimiento de la CDN, que incluyen los objetivos de porcentaje de aciertos de la caché, la supervisión del volumen de solicitudes de origen y los puntos de referencia del tiempo de respuesta, consulta la guía de [Parámetros de rendimiento para CDN e integraciones MediaTailor](cdn-performance-benchmarks.md) optimización de la CDN.

Consideraciones clave específicas del EMP para las métricas de la CDN:

**Encabezados de control de caché EMP**  
**Qué verificar**: asegúrese de que su CDN cumpla con los encabezados de control de caché del EMP para obtener un comportamiento óptimo del TTL  
**Comportamiento esperado**: los distintos tipos de contenido deben tener diferentes duraciones de caché en función de los encabezados del EMP  
Para obtener una guía detallada sobre la optimización de la caché EMP, consulte. [Optimice el almacenamiento en caché de CDN para la entrega MediaTailor de contenido MediaPackage](cdn-emp-caching.md)

**Impacto en los parámetros de consulta**  
**Qué supervisar**: Realice un seguimiento de cómo los parámetros de consulta específicos de EMP afectan a la eficiencia de la caché  
**Objetivo de optimización**: asegúrese de que solo los parámetros de consulta EMP necesarios se incluyan en las claves de caché

**Tiempos de respuesta de la CDN**  
**Qué supervisar**: Realice un seguimiento de los tiempos de respuesta de los diferentes tipos de contenido (manifiestos o segmentos).  
**Valores objetivo**:  
+ Contenido en caché: menos de 100 ms
+ Solicitudes de origen: menos de 500 ms

### MediaPackage métricas de rendimiento
<a name="emp-metrics"></a>

**Tasas de error**  
**Qué supervisar: Supervise** las tasas de error HTTP tanto de la CDN como de los puntos MediaPackage finales. Presta especial atención a los errores 4xx, que pueden indicar problemas de configuración.  
**Códigos de error clave**:  
+ 400 errores: a menudo están relacionados con problemas de filtrado de manifiestos
+ Errores 404: pueden indicar problemas de enrutamiento o configuración
+ Errores 504: problemas de tiempo de espera, especialmente con el LL-HLS

**Solicita volumen y patrones**  
**Qué supervisar**: Realice un seguimiento de los patrones de solicitudes hasta los MediaPackage puntos finales para identificar las tendencias de uso y las necesidades de capacidad.  
**Patrones a tener en cuenta:**  
+ Horas de uso máximo
+ Distribución geográfica de las solicitudes
+ Distribución del tipo de contenido (en vivo o bajo demanda)

### Métricas de latencia
<a name="latency-metrics"></a>

**End-to-end latencia**  
**Qué monitorear: para las** implementaciones de LL-HLS, supervise la end-to-end latencia desde la ingesta de contenido hasta la reproducción del espectador. Una latencia alta puede indicar problemas de configuración de la CDN.  
**Valores objetivo**:  
+ LL-HLS: latencia inferior a 3 segundos glass-to-glass
+ HLS normal: menos de 30 segundos

**Tiempo de generación del manifiesto**  
**Qué supervisar**: tiempo que se tarda en MediaPackage generar los manifiestos, especialmente con el filtrado aplicado.  
**Valores objetivo**: menos de 200 ms para la generación de manifiestos

## Herramientas y configuración de monitoreo
<a name="monitoring-tools"></a>

La configuración de herramientas de monitoreo integrales es esencial para mantener un rendimiento óptimo e identificar rápidamente los problemas antes de que afecten a los espectadores. Sin una supervisión adecuada, la degradación del rendimiento, las ineficiencias de la memoria caché o los problemas de integración pueden pasar desapercibidos hasta que los espectadores experimenten una calidad de reproducción deficiente. La configuración de monitoreo adecuada proporciona visibilidad de todos los aspectos de su integración con MediaPackage la CDN.

Utilice estos servicios y herramientas de AWS para supervisar su MediaPackage integración con la CDN:

### Amazon CloudWatch
<a name="cloudwatch-monitoring"></a>

Amazon CloudWatch proporciona la base para monitorizar tu MediaPackage integración con la CDN mediante la recopilación y el almacenamiento de métricas de ambos servicios. Una CloudWatch configuración adecuada garantiza que dispondrá de los datos necesarios para identificar las tendencias de rendimiento, solucionar problemas y optimizar la integración. Sin CloudWatch métricas, no tendrá visibilidad del rendimiento del sistema y es posible que no detecte los problemas hasta que se vuelvan críticos.

Configure la CloudWatch supervisión para una recopilación integral de métricas:

1. **MediaPackage métricas**: habilite CloudWatch las métricas de sus MediaPackage puntos finales para realizar un seguimiento de los volúmenes de solicitudes, las tasas de error y los tiempos de respuesta.

1. **Métricas de la CDN**: configúrelas CloudWatch para recopilar CloudFront métricas, incluidas las tasas de aciertos de la caché, los recuentos de solicitudes de origen y las tasas de error.

1. **Métricas personalizadas: cree métricas** personalizadas para empresas específicas, KPIs como la participación de los espectadores o la popularidad del contenido.

### CloudWatch cuadros de mando
<a name="dashboard-setup"></a>

Cree paneles completos para visualizar sus métricas:

1. **Panel de información general**: métricas de alto nivel que muestran el estado general del sistema

1. **Panel de rendimiento de la CDN**: métricas detalladas de la CDN, que incluyen el rendimiento de la caché y la distribución geográfica

1. **MediaPackage panel de rendimiento**: métricas MediaPackage específicas que incluyen patrones de solicitud y tasas de error

1. **Panel de latencia**: métricas de End-to-end latencia para diferentes tipos de contenido y regiones

### Análisis de registros
<a name="log-analysis"></a>

Configure el análisis de registros para una solución de problemas detallada:

1. **Registros de acceso a la CDN**: habilite y analice los registros de acceso a la CDN para comprender los patrones de solicitudes e identificar problemas

1. **MediaPackage CloudWatch registros**: supervise MediaPackage los registros para detectar errores y problemas de rendimiento

1. **Agregación** de CloudWatch registros: utilice Amazon Logs Insights o herramientas de terceros para analizar los patrones de registro

## Configure alertas y notificaciones
<a name="alerting-setup"></a>

La configuración de las alertas es crucial para la detección y resolución proactivas de los problemas. Sin las alertas adecuadas, los problemas pueden pasar desapercibidos hasta que afecten significativamente a la experiencia del espectador o provoquen interrupciones en el servicio. Las alertas bien configuradas te ayudan a identificar y abordar los problemas antes de que afecten a los espectadores y a garantizar que tu equipo esté informado de los problemas críticos que requieren atención inmediata.

Configura alertas proactivas para identificar los problemas antes de que afecten a los espectadores:

### Alertas críticas
<a name="critical-alerts"></a>

Configure alertas inmediatas para los problemas críticos:
+ **Tasas de error altas: alerta cuando las tasas** de error de 4 o 5 veces superen el 5% en un período de 5 minutos
+ El porcentaje de **aciertos de caché disminuye**: alerta cuando el ratio de aciertos de caché cae por debajo del 70% en los manifiestos o del 85% en los segmentos
+ **Alta latencia**: alerta cuando la end-to-end latencia supera los umbrales objetivo
+ Picos de **solicitudes de origen**: alerta cuando las solicitudes de origen aumentan más de un 50% en comparación con la línea base

### Alertas de advertencia
<a name="warning-alerts"></a>

Configure alertas de advertencia para detectar tendencias que puedan indicar la aparición de problemas:
+ **Degradación gradual del rendimiento**: alerta cuando los tiempos de respuesta aumenten un 20% en un período de 30 minutos
+ **Tendencias de eficiencia de la memoria caché**: alerta cuando las tasas de aciertos de memoria caché muestren tendencias decrecientes a lo largo del tiempo
+ **Patrones de tráfico inusuales**: alerta ante cambios inesperados en el volumen de solicitudes o en la distribución geográfica

## Utilice los datos de supervisión para la optimización
<a name="performance-optimization"></a>

Aproveche los datos de supervisión para mejorar el rendimiento de forma continua:

### Revisiones de rendimiento periódicas
<a name="regular-reviews"></a>

1. **Revisiones semanales**: analice las tendencias de rendimiento semanales e identifique las oportunidades de optimización

1. **Planificación mensual de la capacidad**: utilice los patrones de tráfico para planificar las necesidades de capacidad y la optimización de la CDN

1. **Revisiones trimestrales de la arquitectura**: evalúe la eficiencia general de la arquitectura e identifique las áreas de mejora

### Acciones de optimización comunes
<a name="optimization-actions"></a>

En función de los datos de supervisión, considere estas acciones de optimización:
+ **Ajustes en la política de caché**: modifique los valores de TTL en función de los patrones reales de actualización del contenido. Para obtener una guía detallada sobre la optimización del TTL, consulte. [Optimización del almacenamiento en caché para CDN e integraciones MediaTailor](cdn-optimize-caching.md)
+ **Optimización geográfica**: añada ubicaciones periféricas de CDN en regiones con mucho tráfico
+ **Optimización de los parámetros de consulta**: elimine los parámetros de consulta innecesarios que fragmentan la caché
+ **Configuración del escudo de origen**: implemente el escudo de origen en regiones con un alto volumen de solicitudes de origen

Para obtener una guía de monitoreo detallada específica MediaPackage, consulte [Monitorización MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/monitoring.html) en la guía del MediaPackage usuario.

# Solución de problemas MediaPackage, CDN e integraciones MediaTailor
<a name="cdn-emp-troubleshooting"></a>

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](cdn-troubleshooting.md) 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, consulte[Integre MediaTailor con una MediaPackage CDN](mediapackage-integration.md). Para obtener instrucciones sobre cómo optimizar el rendimiento de la caché después de resolver problemas, consulte[Almacenamiento en caché de CDN](cdn-emp-caching.md).

## Errores de filtrado de manifiestos
<a name="manifest-filtering-errors"></a>

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.

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

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

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

1. Compruebe que la cadena de parámetros total tenga menos de 1024 caracteres.
**Referencia**: [condiciones de error de filtrado de AWS Elemental MediaPackage manifiestos](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

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

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

1. 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

## Procedimientos de diagnóstico
<a name="validated-diagnostic-steps"></a>

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é
<a name="cache-performance-analysis"></a>

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](diagnose-performance-issues.md#cache-performance-troubleshooting) 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](cdn-emp-caching.md)

### Valide la configuración del filtrado de manifiestos
<a name="manifest-filtering-validation"></a>

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.

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

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

1. 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](cdn-emp-manifest-filtering.md) la guía de configuración completa.

### Valide la configuración de los parámetros de consulta
<a name="query-parameter-validation"></a>

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_msn`y `_HLS_part` - para compatibilidad con LL-HLS

1. 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/cdns.html)

## Referencia de códigos de error
<a name="documented-error-reference"></a>

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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

**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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

## Recursos adicionales de solución de problemas
<a name="additional-resources"></a>

Para cuestiones que no se tratan en este tema, consulta estos AWS recursos oficiales:
+ Vista [previa de un manifiesto desde AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-preview.html): utilice la vista previa del manifiesto para solucionar problemas de empaquetado de contenido
+ [Aumente la tasa de aciertos de la CloudFront caché](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html): guía completa sobre la optimización de la caché de la CDN
+ [Filtrado de manifiestos](https://docs.aws.amazon.com/mediapackage/latest/userguide/manifest-filtering.html): guía completa sobre la funcionalidad MediaPackage de filtrado