

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.

# Filtrar AWS Elemental MediaTailor registros y eventos
<a name="logs-filter"></a>

Los registros emitidos por una configuración de reproducción MediaTailor incluyen información sobre una variedad de actividades que tienen lugar durante la sesión de reproducción. Estas actividades se identifican en el tipo de evento de los registros. Muchos eventos se registran de forma predeterminada. Para ayudar a controlar el coste de los registros en Amazon CloudWatch, puedes especificar los registros que se MediaTailor emiten. 

MediaTailor le proporciona el control del filtrado de registros para que pueda hacer lo siguiente:
+ Especifique los eventos de registro que desea excluir de los registros
+ Habilite el registro de las respuestas sin procesar del servidor de decisiones publicitarias (ADS)

Puede configurar estas preferencias de filtrado de registros de forma independiente para cada sesión de reproducción o de forma predeterminada para todas las sesiones de reproducción si se trata de una configuración de reproducción. 
+ Para filtrar los registros por sesión, incluya los parámetros de consulta en la solicitud de inicialización de la sesión de reproducción.
+ Para filtrar los registros según la configuración de reproducción, utilice la MediaTailor consola o la API para indicar sus preferencias en los ajustes de configuración de reproducción. 

En las siguientes secciones se proporcionan instrucciones para activar el filtrado de registros en las sesiones y las configuraciones de reproducción.

# Filtros de registro por sesión
<a name="logs-filter-session"></a>

Para definir un nivel de detalle de registro personalizado para cada sesión, añada los siguientes parámetros a la solicitud inicial de sesión de reproducción del lado del servidor o del lado del cliente. Añada valores a los parámetros para representar los eventos que desee incluir o excluir, en un formato delimitado por comas:
+ `aws.adsInteractionLogPublishOptInEventTypes`para recibir registros de interacciones específicas con el servidor de decisiones publicitarias (ADS).
+ `aws.adsInteractionLogExcludeEventTypes`para dejar de recibir registros de interacciones de ADS específicas.
+ `aws.manifestServiceLogExcludeEventTypes`para dejar de recibir registros de interacciones específicas del servicio de manifiestos. 

Para obtener una lista de los tipos de registros y eventos que MediaTailor se emiten, consulte [Registros de manifiestos](log-types.md)[Registros de ADS](ads-log-format.md), y[Transcodificar registros](tm-log-format.md).

Si no pasa por ningún parámetro de consulta para filtrar los registros, MediaTailor escribe todos los registros en el destino de entrega. 

**Example inicialización de la sesión del lado del servidor con filtros de registro**  
Para excluir `GENERATED_MANIFEST` `PARSING_ERROR` eventos de los registros de manifiestos y de los registros `MAKING_ADS_REQUEST` de ADS, la solicitud de inicialización de la sesión tendría el siguiente aspecto:  

```
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST
```
Para habilitar los registros sin procesar de su ADS, incluya el `RAW_ADS_RESPONSE` valor del `AdsInteractionPublishOptInEventType` parámetro:  

```
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE
```

**Example inicialización de la sesión del lado del cliente con filtros de registro**  
Para excluir los eventos de registro durante la inicialización de la sesión del lado del cliente, incluya `availSuppression` y registre los parámetros en la solicitud POST del cliente a. MediaTailor Para obtener más información acerca de cómo crear una solicitud de sesión de reproducción del lado del cliente, consulte [Seguimiento de anuncios del lado del cliente](ad-reporting-client-side.md). En el siguiente ejemplo, se excluyen los `PARSING_ERROR` eventos de tus registros de manifiestos `CONFIG_SECURITY_ERROR` y de los registros de ADS. `MAKING_ADS_REQUEST`  

```
POST parent.m3u8
   {
       "adsInteractionLog": {
           ...
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
      "logMode": "DEBUG"
   }
```
 Para habilitar los registros sin procesar de su ADS, incluya el `RAW_ADS_RESPONSE ` valor del `publishOptInEventTypes` parámetro:   

```
POST parent.m3u8
   {
       "adsInteractionLog": {
           "publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
       "logMode": "DEBUG"
   }
```

# Filtros de registro de configuración por reproducción
<a name="logs-filter-config"></a>

Utilice los ajustes de la configuración de reproducción para definir los tipos de eventos de registro que se MediaTailor emiten de forma predeterminada desde esta configuración de reproducción. MediaTailor utiliza estos ajustes de filtrado de registros predeterminados para todas las sesiones que no incluyen los parámetros de consulta de filtrado en la solicitud de inicio de sesión. 

Puede optar por hacer lo siguiente:
+ Reciba registros de interacciones específicas con el servidor de decisiones publicitarias (ADS).
+ Excluya los registros de interacciones de ADS específicas.
+ Excluya los registros de interacciones específicas del servicio de manifiestos. 

Para establecer estos ajustes desde la MediaTailor consola, consulte[Creación de una configuración](configurations-create.md). Para obtener información MediaTailor sobre la API, consulte [https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html)la *referencia AWS Elemental MediaTailor de la API*.

Para obtener una lista de los tipos de registros y eventos que MediaTailor se emiten, consulte [Registros de manifiestos](log-types.md)[Registros de ADS](ads-log-format.md), y[Transcodificar registros](tm-log-format.md).