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.
# Escribir AWS Elemental MediaTailor registros directamente en Amazon CloudWatch Logs
MediaTailor produce registros que contienen información detallada sobre la actividad de la sesión y las interacciones del servidor de decisiones publicitarias, y los escribe en Amazon CloudWatch. Los registros proporcionan una descripción secuencial de la actividad que se produce durante la sesión.
MediaTailor también puede utilizar registros vendidos para mayor flexibilidad en la entrega de registros y precios con descuento por volumen. Para obtener información sobre los registros vendidos, consulte. [Uso de registros vendidos](vended-logs.md)
**Topics**
+ [Permisos para Amazon CloudWatch Logs](monitoring-permissions.md)
+ [Registro «As Run» para AWS Elemental MediaTailor Channel Assembly](as-run-log.md)
+ [AWS Elemental MediaTailor Análisis de registros de ADS en Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)
# Permisos para Amazon CloudWatch Logs
Usa AWS Identity and Access Management (IAM) para crear un rol que dé AWS Elemental MediaTailor acceso a Amazon CloudWatch. Debe realizar estos pasos para que se publiquen CloudWatch los registros de su cuenta. CloudWatch publica automáticamente las métricas de tu cuenta.
**Para permitir el MediaTailor acceso a CloudWatch**
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación de la consola de IAM, seleccione **Roles** y, a continuación, elija **Crear rol**.
1. Elija el tipo de rol **Otra AWS cuenta**.
1. En el **campo ID de cuenta**, introduce tu ID de AWS cuenta.
1. Seleccione **Require external ID (Requerir ID externo)** y escriba **Midas**. Esta opción agrega automáticamente una condición a la política de confianza que permite al servicio asumir el rol únicamente si la solicitud incluye el `sts:ExternalId` correcto.
1. Elija **Siguiente: permisos**.
1. Añada una política de permisos que especifique qué acciones puede realizar este rol. Seleccione una de las siguientes opciones y después elija **Next: Review (Siguiente: Revisar)**:
+ **CloudWatchLogsFullAccess**para proporcionar acceso completo a Amazon CloudWatch Logs
+ **CloudWatchFullAccess**para proporcionar acceso completo a Amazon CloudWatch
1. En **Nombre de rol**, escriba **MediaTailorLogger** y luego elija **Crear rol**.
1. En la página **Roles**, seleccione el rol que acaba de crear.
1. Para actualizar la entidad principal, edite la relación de confianza:
1. En la página **Summary (Resumen)** del rol, elija la pestaña **Trust relationship (Relación de confianza)**.
1. Elija **Editar relación de confianza**.
1. En el documento de política, cambia el principal por el MediaTailor servicio. Debería tener un aspecto similar al siguiente:
```
"Principal": {
"Service": "mediatailor.amazonaws.com"
},
```
La política completa debe ser similar a la siguiente:
1. Elija **Actualizar política de confianza**.
# Registro «As Run» para AWS Elemental MediaTailor Channel Assembly
El registro *As Run*, del grupo de CloudWatch `MediaTailor/Channel/AsRunLog` registros, muestra información sobre los programas y las pausas publicitarias a medida que se reproducen.
Al crear un canal, el registro As Run está desactivado de forma predeterminada. Con la consola o el AWS Command Line Interface (AWS CLI), puedes activar y desactivar el estado del registro As Run para cada canal de tu cuenta.
Al habilitar el registro As Run, crea MediaTailor automáticamente un rol vinculado al servicio que permite MediaTailor escribir y administrar el registro As Run en tu cuenta de CloudWatch Logs. Para obtener más información acerca de los roles vinculados a servicios, consulte [Uso de roles vinculados a servicios para MediaTailor](using-service-linked-roles.md).
**nota**
Por el momento, el registro As Run solo admite el programa predeterminado. Por ahora, no es compatible con el AlternateMedia creado por las reglas del programa. Esto significa que actualmente no genera el registro de ejecución para AlternateMedia.
**Topics**
+ [Habilitar el registro As Run](enabling-as-run-log.md)
+ [Deshabilitar el registro de As Run](disabling-as-run-log.md)
# Habilitar el registro As Run
Para habilitar el registro As Run, especifique el nombre del canal y habilite el tipo de registro As *Run* para ese canal.
------
#### [ Console ]
**Para habilitar el registro As Run al crear un canal**
1. Inicie sesión en Consola de administración de AWS y abra la MediaTailor consola en [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. En el panel de navegación, seleccione **Conjunto** de **canales > Canales**.
1. En la barra de navegación, elija **Crear canal**.
1. En los paneles **Definir los detalles del canal**, **Configurar salidas** y **Control de acceso**, configure el canal como desee.
1. En el panel **de control de acceso**, seleccione **Siguiente**.
1. En el panel de **registro**, en **Tipos de registro**, seleccione **Habilitar como en ejecución** para habilitar el registro en ejecución.
**Para habilitar el registro As Run al actualizar un canal**
**nota**
Si el canal se está emitiendo actualmente, primero debes detenerlo para poder actualizarlo. Cuando detengas el canal, puedes seleccionar **Acciones** > **Editar** para empezar a actualizar el canal.
1. Inicia sesión en Consola de administración de AWS y abre la MediaTailor consola en [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. En el panel de navegación, seleccione **Conjunto** de **canales > Canales**.
1. Elija el canal que desee actualizar para activar el registro As Run.
1. Elija **Actions** (Acciones) > **Edit** (Editar).
1. En los paneles **Definir los detalles del canal**, **Configurar salidas** y **Control de acceso**, actualice la configuración del canal según lo desee.
1. En el panel **de control de acceso**, seleccione **Siguiente**.
1. En el panel de **registro**, en **Tipos de registro**, seleccione **Habilitar como en ejecución** para habilitar el registro en ejecución.
**Para habilitar el registro As Run desde la pestaña **Registro****
**nota**
Si el canal se está ejecutando actualmente, debes usar la pestaña **Registro** en lugar de elegir **Acciones** > **Editar** para habilitar el registro En ejecución.
1. Inicie sesión en Consola de administración de AWS y abra la MediaTailor consola en [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. En el panel de navegación, seleccione **Conjunto** de **canales > Canales**.
1. Elija el canal para el que desee habilitar el registro As Run.
1. En la barra de navegación situada debajo del nombre del canal, selecciona **Registro**.
1. En **Registro** > **Tipos de registro**, seleccione **Mientras se ejecuta** para activar el registro Como se ejecuta.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Para habilitar el registro As Run**
Ejecute el [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)comando y especifique los valores adecuados para los parámetros necesarios.
Este ejemplo está formateado para Linux, macOS o Unix y utiliza el carácter de barra invertida (\$1) de continuación de línea para mejorar la legibilidad.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types AS_RUN
```
Este ejemplo está formateado para Microsoft Windows y utiliza el carácter de continuación de la línea de intercalación (^) para mejorar la legibilidad.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types AS_RUN
```
Donde:
+ `MyChannel`es el nombre del canal del que eres propietario y para el que deseas habilitar el registro As Run.
Si el comando se ejecuta correctamente, verá un resultado similar al siguiente.
```
{
"ChannelName": "MyChannel",
"LogTypes": [
"AS_RUN"
]
}
```
------
# Deshabilitar el registro de As Run
Para deshabilitar el registro As Run en un canal que lo tenga activado, especifique el nombre del canal y deshabilite el tipo de registro *As Run* para ese canal.
------
#### [ Console ]
**Para deshabilitar el registro As Run al actualizar un canal**
**nota**
Si el canal se está emitiendo actualmente, primero debes detenerlo antes de poder actualizarlo. Cuando detengas el canal, puedes seleccionar **Acciones** > **Editar** para empezar a actualizar el canal.
1. Inicia sesión en Consola de administración de AWS y abre la MediaTailor consola en [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. En el panel de navegación, seleccione **Conjunto** de **canales > Canales**.
1. Elija el canal que desee actualizar para activar el registro As Run.
1. Elija **Actions** (Acciones) > **Edit** (Editar).
1. En los paneles **Definir los detalles del canal**, **Configurar salidas** y **Control de acceso**, actualice la configuración del canal según lo desee.
1. En el panel **de control de acceso**, seleccione **Siguiente**.
1. En el panel de **registro**, en **Tipos de registro**, desactive **Activar como en ejecución** para deshabilitar el registro En ejecución.
**Para deshabilitar el registro As Run desde la pestaña **Registro****
**nota**
Si el canal se está ejecutando actualmente, debes usar la pestaña **Registro** en lugar de elegir **Acciones** > **Editar** para deshabilitar el registro de As Run.
1. Inicie sesión en Consola de administración de AWS y abra la MediaTailor consola en [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. En el panel de navegación, seleccione **Conjunto** de **canales > Canales**.
1. Elija el canal para el que desee deshabilitar el registro As Run.
1. En la barra de navegación situada debajo del nombre del canal, selecciona **Registro**.
1. En **Registro** > **Tipos de registro**, desactive **Al ejecutar** para deshabilitar el registro Como ejecutar.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Para deshabilitar el registro As Run**
Ejecute el [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)comando y especifique los valores adecuados para los parámetros necesarios.
Este ejemplo está formateado para Linux, macOS o Unix y utiliza el carácter de barra invertida (\$1) de continuación de línea para mejorar la legibilidad.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types
```
Este ejemplo está formateado para Microsoft Windows y utiliza el carácter de continuación de la línea de intercalación (^) para mejorar la legibilidad.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types
```
Donde:
+ `MyChannel`es el nombre del canal del que eres propietario y para el que deseas deshabilitar el registro As Run.
Si el comando se ejecuta correctamente, verá un resultado similar al siguiente.
```
{
"ChannelName": "MyChannel",
"LogTypes": []
}
```
------
# AWS Elemental MediaTailor Análisis de registros de ADS en Amazon CloudWatch Logs Insights
Puede ver y consultar los registros del servidor de decisiones AWS Elemental MediaTailor publicitarias (ADS) mediante Amazon CloudWatch Logs Insights. MediaTailor envía los registros de eventos CloudWatch para que se procesen normalmente y se produzcan errores. Los registros se adhieren a un esquema JSON. A través de CloudWatch Logs Insights, puede seleccionar los registros por período de tiempo y, a continuación, ejecutar consultas sobre ellos.
Para obtener información general, consulte [Analizar los datos de registro con CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html).
**nota**
Para acceder a los registros, necesitas permisos para acceder a Amazon CloudWatch. Para obtener instrucciones, consulte [Permisos para Amazon CloudWatch Logs](monitoring-permissions.md).
**Para ver y consultar los registros de ADS mediante la CloudWatch consola**
1. Abra la CloudWatch consola en[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, en **Logs (Registros)**, elija **Insights (Conocimientos)**.
1. En la barra de búsqueda, escriba y**AdDec**, a continuación, seleccione en la lista desplegable`MediaTailor/AdDecisionServerInteractions`.
1. (Opcional) Ajuste el periodo de tiempo que desea estudiar.
1. (Opcional) Cambie la consulta en el cuadro de diálogo. Para obtener información general, consulte [Sintaxis de consultas de CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Para ver ejemplos de consultas de ADS de MediaTailor, consulte [Consultando los registros de ADS](querying-the-ads-logs.md).
1. Elija **Ejecutar consulta**. La consulta puede tardar unos segundos, durante los cuales aparece **Cancel (Cancelar)** en lugar de **Run query (Ejecutar consulta)**.
1. (Opcional) Para exportar los resultados como archivo CSV, elija **Actions (Acciones)** y, a continuación, elija **Download query results (CSV) [Descargar resultados de consulta (CSV)]**.
**nota**
La consola limita la cantidad de registros que devuelve en los resultados de las consultas y que exporta, por lo que, para datos masivos, utilice la API, el AWS Command Line Interface (AWS CLI) o un SDK.
**Topics**
+ [Consultando los registros de ADS](querying-the-ads-logs.md)
# Consultando los registros de ADS
CloudWatch Logs Insights ofrece un amplio conjunto de opciones para consultar sus registros. Para obtener información detallada sobre la sintaxis de consultas, consulte Sintaxis de [consultas de CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). En esta sección se proporcionan ejemplos de consultas comunes para comenzar a utilizar sus consultas de registros de ADS. Todas las consultas se ejecutan en los registros para la configuración del intervalo de tiempo actual.
La siguiente consulta recupera toda la información de los registros de ADS.
```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```
La siguiente consulta recupera todas las solicitudes al ADS. Esta consulta muestra una forma de recuperar el contenido del encabezado de la solicitud para MediaTailor los registros.
```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```
La siguiente consulta recupera los anuncios MediaTailor insertados para una sesión determinada.
```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```
La siguiente consulta recupera el rastreo URLs que realizó la MediaTailor llamada en nombre del jugador.
```
fields @timestamp, beaconInfo.trackingEvent, beaconInfo.beaconUri, beaconInfo.headers.0.value as @userAgent, beaconInfo.headers.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "BEACON_FIRED"
| sort @timestamp asc
```
La siguiente consulta recupera información para una sesión de reproducción específica filtrando los resultados por `sessionId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```
La siguiente consulta recupera información para una única solicitud filtrando los resultados por `requestId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```
La siguiente consulta recupera un recuento de entradas de registro para cada tipo de evento registrado.
```
fields eventType
| stats count() as @eventCount by eventType
```
La siguiente consulta recupera el ID de espacio publicitario y la lista de anuncios omitidos para todos los espacios publicitarios que habían omitido anuncios.
```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```