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.
# Supervisar y etiquetar los recursos AWS Elemental MediaTailor
La supervisión es una parte importante del mantenimiento de la fiabilidad, la disponibilidad y el rendimiento de las AWS Elemental MediaTailor demás AWS soluciones. AWS proporciona las siguientes herramientas de monitoreo para observar MediaTailor, informar cuando algo anda mal y tomar medidas automáticas cuando sea apropiado:
+ *Amazon CloudWatch* monitorea tus AWS recursos y las aplicaciones en las que AWS ejecutas en tiempo real. Puede recopilar métricas y realizar un seguimiento de las métricas, crear paneles personalizados y definir alarmas que le advierten o que toman medidas cuando una métrica determinada alcanza el umbral que se especifique. Por ejemplo, puede CloudWatch hacer un seguimiento del uso de la CPU u otras métricas de sus instancias de Amazon EC2 y lanzar automáticamente nuevas instancias cuando sea necesario. Para obtener más información, consulta la [Guía del CloudWatch usuario de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
+ *Amazon CloudWatch Logs* te permite supervisar, almacenar y acceder a tus archivos de registro de todas las interacciones con tu servidor de decisiones publicitarias (ADS). AWS Elemental MediaTailor Emite registros de las solicitudes de anuncios, los redireccionamientos y las respuestas, así como de las solicitudes y respuestas de informes. Los errores de los servidores ADS y de origen también se emiten a los grupos de registros de Amazon CloudWatch. MediaTailor también proporciona información sobre los anuncios omitidos y los motivos por los que se omitieron. Para obtener más información, consulte [Solución de problemas de omisión de anuncios](troubleshooting-ad-skipping-overview.md). También se pueden archivar los datos del registro en un almacenamiento de larga duración. Para obtener información general, consulta la [Guía del usuario CloudWatch de Amazon Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). Para obtener información sobre los registros de ADS y cómo acceder a ellos para analizarlos a través de Amazon CloudWatch Logs Insights, consulte[AWS Elemental MediaTailor Análisis de registros de ADS en Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md).
**Topics**
+ [Visualización de AWS Elemental MediaTailor los registros](monitoring-through-logs.md)
+ [Monitorización AWS Elemental MediaTailor con CloudWatch métricas de Amazon](monitoring-cloudwatch-metrics.md)
+ [Grabación de llamadas a AWS Elemental MediaTailor la API](logging-using-cloudtrail.md)
+ [Recibir alertas AWS Elemental MediaTailor de ensamblaje de canales](channel-assembly-alerts.md)
+ [Etiquetado AWS Elemental MediaTailor de recursos](tagging.md)
+ [Supervisión de AWS los servicios multimedia con el monitor de flujo de trabajo](monitor-with-workflow-monitor.md)
# Visualización de AWS Elemental MediaTailor los registros
MediaTailor emite registros que describen una variedad de hitos y actividades en los canales y las configuraciones de reproducción. Puede usar estos registros para obtener visibilidad de su flujo de trabajo y solucionar problemas relacionados con el servicio. En los temas siguientes se describen los registros y las opciones de registro.
**Topics**
+ [Registros de ADS](ads-log-format.md)
+ [Registros de manifiestos](log-types.md)
+ [Transcodificar registros](tm-log-format.md)
+ [Uso de registros vendidos](vended-logs.md)
+ [Escribir registros en CloudWatch Logs](monitoring-cw-logs.md)
+ [Controlar el volumen de los registros de las sesiones de inserción de anuncios](log-configuration.md)
+ [Filtrar registros y eventos](logs-filter.md)
+ [Generar registros de depuración](debug-log-mode.md)
# AWS Elemental MediaTailor Descripción de los registros de ADS y tipos de eventos
En las siguientes secciones se describen los registros que se MediaTailor emiten para describir los eventos relacionados con el servidor de decisiones publicitarias (ADS). Estos son `AdDecisionServerInteractions` registros.
**Topics**
+ [Eventos de AdDecisionServerInteractions](#log-types-adsinteraction)
+ [Descripción del registro de ADS](#ads-log-description)
+ [Esquema JSON del registro ADS](#ads-log-json-schema)
## Eventos de AdDecisionServerInteractions
Los siguientes eventos se emiten durante MediaTailor las interacciones con el servidor de decisiones publicitarias (ADS).
| Registro | Description (Descripción) |
| --- | --- |
| AD\$1MARKER\$1FOUND | MediaTailor encontró un marcador publicitario en el manifiesto. |
| BEACON\$1FIRED | Se activó una baliza de rastreo para informar sobre eventos publicitarios. En el modo de generación de informes del lado del servidor (predeterminado), se MediaTailor activa la baliza. En el modo de generación de informes del lado del cliente, el dispositivo de reproducción dispara la baliza. |
| EMPTY\$1VAST\$1RESPONSE | El ADS devolvió una respuesta VAST vacía que no contenía anuncios. |
| EMPTY\$1VMAP\$1RESPONSE | El ADS devolvió una respuesta de VMAP vacía. |
| ERROR\$1ADS\$1INVALID\$1RESPONSE | El ADS devolvió un código de estado distinto del 200. |
| ERROR\$1ADS\$1IO | MediaTailor detectó un error al intentar comunicarse con el ADS. |
| ERROR\$1ADS\$1RESPONSE\$1PARSE | MediaTailor se produjo un error al analizar la respuesta del ADS. |
| ERROR\$1ADS\$1RESPONSE\$1UNKNOWN\$1ROOT\$1ELEMENT | La respuesta de ADS contiene un elemento raíz no válido. |
| ERROR\$1ADS\$1TIMEOUT | Se agotó el tiempo de espera de la MediaTailor solicitud al ADS. |
| ERROR\$1DISALLOWED\$1HOST | No se permite el alojamiento de ADS. |
| ERROR\$1FIRING\$1BEACON\$1FAILED | MediaTailor falló al disparar la baliza de rastreo. |
| ERROR\$1PERSONALIZATION\$1DISABLED | La inserción de anuncios está deshabilitada para esta sesión. |
| ERROR\$1UNKNOWN | MediaTailor detectó un error desconocido durante la solicitud de ADS. |
| ERROR\$1UNKNOWN\$1HOST | Se desconoce el host de ADS. |
| ERROR\$1VAST\$1INVALID\$1MEDIA\$1FILE | El VAST Ad tiene un MediaFile elemento no válido o falta. |
| ERROR\$1VAST\$1INVALID\$1VAST\$1AD\$1TAG\$1URI | La respuesta VAST contiene un elemento no válidoVASTAdTagURI. |
| ERROR\$1VAST\$1MISSING\$1CREATIVES | El Ad VAST contiene cero o varios Creatives elementos. Se requiere exactamente un Creatives elemento. |
| ERROR\$1VAST\$1MISSING\$1IMPRESSION | El VAST no Ad contiene ningún Impression elemento. Se requiere al menos un Impression elemento. |
| ERROR\$1VAST\$1MISSING\$1MEDIAFILES | El Ad VAST contiene cero o varios MediaFiles elementos. Se requiere exactamente un MediaFiles elemento. |
| ERROR\$1VAST\$1MISSING\$1OVERLAYS | MediaTailor no recibí ninguna creatividad no lineal del servidor de anuncios. |
| ERROR\$1VAST\$1MULTIPLE\$1LINEAR | El VAST Ad contiene varios Linear elementos. |
| ERROR\$1VAST\$1MULTIPLE\$1TRACKING\$1EVENTS | El Ad VAST contiene varios TrackingEvents elementos. |
| ERROR\$1VAST\$1REDIRECT\$1EMPTY\$1RESPONSE | La solicitud de redireccionamiento de VAST devolvió una respuesta vacía. |
| ERROR\$1VAST\$1REDIRECT\$1FAILED | La solicitud de redireccionamiento de VAST detectó un error. |
| ERROR\$1VAST\$1REDIRECT\$1MULTIPLE\$1VAST | La solicitud de redireccionamiento de VAST devolvió varios anuncios. |
| FILLED\$1AVAIL | MediaTailor llenó correctamente el formulario de disponibilidad. |
| FILLED\$1OVERLAY\$1AVAIL | MediaTailor llenó correctamente la función de superposición. |
| INTERSTITIAL\$1VOD\$1FAILURE | La solicitud o respuesta de ADS detectó un problema al llenar las reservas intersticiales de la lista de reproducción de VOD. No se insertará ningún anuncio. |
| INTERSTITIAL\$1VOD\$1SUCCESS | MediaTailor campos intersticiales rellenados correctamente para la lista de reproducción de VOD. |
| MAKING\$1ADS\$1REQUEST | MediaTailor solicita anuncios a la ADS. |
| MODIFIED\$1TARGET\$1URL | MediaTailor modificó la URL de destino saliente. |
| NON\$1AD\$1MARKER\$1FOUND | MediaTailor ha encontrado un marcador publicitario inutilizable en el manifiesto. |
| RAW\$1ADS\$1RESPONSE | MediaTailor recibió una respuesta de ADS sin procesar. |
| REDIRECTED\$1VAST\$1RESPONSE | MediaTailor recibió una respuesta de VAST después de seguir la redirección de VAST. |
| VAST\$1REDIRECT | La respuesta al anuncio VAST contiene una redirección. |
| VAST\$1RESPONSE | MediaTailor recibió una respuesta VAST. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1SUCCESS | MediaTailor creó correctamente un plan de disponibilidad temporal para la plantilla de VOD. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1VAST\$1RESPONSE\$1FOR\$1OFFSET | MediaTailor está creando un plan de disponibilidad temporal para la plantilla de VOD. MediaTailor recibió una gran respuesta en relación con el intervalo de tiempo. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1WARNING\$1NO\$1ADVERTISEMENTS | La solicitud o respuesta de ADS detectó un problema al crear un plan de disponibilidad temporal para la plantilla de VOD. No se insertará ningún anuncio. |
| WARNING\$1NO\$1ADVERTISEMENTS | MediaTailor Se ha producido un problema al rellenar el formulario. No se ha insertado ningún anuncio. |
| WARNING\$1URL\$1VARIABLE\$1SUBSTITUTION\$1FAILED | MediaTailor no puede sustituir variables dinámicas en la URL de ADS. Comprueba la configuración de la URL. |
| WARNING\$1VPAID\$1AD\$1DROPPED | Se ha eliminado un anuncio de VPAID porque falta una lista o porque la sesión utiliza informes del lado del servidor. |
## Descripción del registro de ADS
En esta sección se describe la estructura y el contenido de la descripción del registro de ADS. Para explorar por su cuenta en un editor JSON, utilice el listado en [Esquema JSON del registro ADS](#ads-log-json-schema).
Cada evento del registro de ADS contiene los campos estándar que generan los CloudWatch registros. Para obtener más información, consulte [Analizar los datos de registro con CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html).
### ADS registra las propiedades
En esta sección se describen las propiedades de los registros de ADS.
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| adsRequestUrl | cadena | false | La URL completa de la solicitud de ADS realizada por MediaTailor. |
| avail | objeto de tipo [avail](#ads-logs-avail) | false | Información sobre una página que está MediaTailor llena de anuncios. Actualmente, para el tipo de FILLED\$1AVAIL evento, este es el plan que se creó MediaTailor cuando apareció por primera vez la función Avail. La forma en que se llena finalmente el espacio publicitario puede variar de este plan, en función de cómo se reproduce el contenido. |
| awsAccountId | cadena | true | El ID de la cuenta de AWS MediaTailor de la configuración que se utilizó para la sesión. |
| customerId | cadena | true | La versión hash del ID de cuenta de AWS, que puede utilizar para correlacionar varias entradas de registro. |
| eventDescription | cadena | true | Una breve descripción del evento que activó este mensaje de registro, proporcionada por el MediaTailor servicio. De forma predeterminada, está vacío. Ejemplo: Got VAST response. |
| eventTimestamp | cadena | true | La fecha y la hora del evento. |
| eventType | cadena | true | El código del evento que activó este mensaje de registro. Ejemplo: VAST\$1RESPONSE. |
| originId | cadena | true | El nombre de la MediaTailor configuración. Esto es diferente del origen de contenido del vídeo, que también forma parte de la configuración. |
| prefetchScheduleName | cadena | false | El nombre del programa de captura previa asociado a este evento publicitario. |
| requestHeaders | matriz de tipo [requestheaders](#ads-logs-requestheaders) | false | Los encabezados que se MediaTailor incluyen en la solicitud de ADS. Normalmente, los registros los incluyen cuando se produce un error en una solicitud al ADS, para facilitar la solución de problemas. |
| requestId | cadena | true | El ID de la MediaTailor solicitud, que puede utilizar para correlacionar varias entradas de registro de la misma solicitud. |
| sessionId | cadena | true | El identificador numérico único que MediaTailor se asignó a la sesión del jugador. Todas las solicitudes que un jugador realiza para una sesión tienen el mismo ID de sesión. Ejemplo: e039fd39-09f0-46b2-aca9-9871cc116cde. |
| sessionType | string (valores legales: [DASH, HLS]) | true | El tipo de transmisión del jugador. |
| vastAd | objeto de tipo [vastAd](#ads-logs-vastAd) | false | Información sobre un único anuncio analizado a partir de la respuesta VAST. |
| vastResponse | objeto de tipo [vastResponse](#ads-logs-vastResponse) | false | Información sobre la respuesta VAST que MediaTailor recibió del ADS. |
| vodCreativeOffsets | objeto de tipo [vodCreativeOffsets](#ads-logs-vodCreativeOffsets) | false | En función de la respuesta del VMAP, en función de la respuesta del VMAP, está disponible un mapa que indica los intervalos de tiempo en el manifiesto en los que se MediaTailor insertará. |
| vodVastResponseTimeOffset | número | false | Desfase de tiempo específico de VMAP para la inserción de anuncios de VOD. |
### adContent
En esta sección se describen las propiedades adContent de los registros de ADS.
**Propiedades adContent de registros de ADS**
| Propiedad | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| adPlaylistUris | objeto de tipo [adPlaylistUris](#ads-logs-adPlaylistUris) | false | La correspondencia desde el manifiesto de origen de una variante al manifiesto de anuncios de la variante. Para DASH, este contiene una única entrada, ya que todas las variantes están representadas en un único manifiesto de DASH. |
### adPlaylistUris
En esta sección se describen las propiedades de los registros de ADS adPlaylistUris.
**adPlaylistUris Propiedades de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| | cadena | false | La URL del manifiesto de anuncios para la variante específica. |
### avail
En esta sección se describen las propiedades de la disponibilidad de los registros de ADS.
**Propiedades de espacio publicitario de registros de ADS**
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| availId | cadena | true | El identificador único para esta disponibilidad. Para HLS, este es el número de secuencia de medios donde comienza el espacio publicitario. Para DASH, este es el ID del periodo. |
| creativeAds | matriz de tipo [creativeAd](#ads-logs-creativeAd) | true | Los anuncios que MediaTailor se insertaron en él están disponibles. |
| fillRate | número | true | La velocidad a la que los anuncios rellenan la duración del espacio publicitario, de 0,0 (para 0 %) a 1,0 (para 100 %). |
| filledDuration | número | true | La suma de las duraciones de todos los anuncios insertados en el espacio publicitario. |
| numAds | número | true | La cantidad de anuncios que MediaTailor se insertaron en la oferta. |
| originAvailDuration | número | true | La duración del espacio publicitario tal y como se especifica en la transmisión de contenido desde el origen (CUE\$1OUT o SCTE). |
| skippedAds | matriz de tipo [skippedAd](#ads-logs-skippedAd) | false | Los anuncios que MediaTailor no se insertaron, por motivos como TRANSCODE\$1IN\$1PROGRESS yTRANSCODE\$1ERROR. Para ver una lista de los motivos por los que se omiten los anuncios, consulte[Solución de problemas de omisión de anuncios](troubleshooting-ad-skipping-overview.md). |
| slateAd | objeto de tipo [slateAd](#ads-logs-slateAd) | true | La información sobre el anuncio de pizarra, que se MediaTailor utiliza para rellenar los segmentos vacíos, está disponible. |
### creativeAd
En esta sección se describen las propiedades creativeAd de los registros de ADS.
**Propiedades creativeAd de registros de ADS**
| Propiedad | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| adContent | objeto de tipo [adContent](#ads-logs-adContent) | true | Información sobre el contenido del anuncio insertado. |
| creativeUniqueId | cadena | true | El identificador único del anuncio, que se utiliza como clave para la transcodificación. Este es el campo de ID del anuncio en la respuesta VAST, si está disponible. De lo contrario, es la URL intermedia del anuncio. |
| trackingEvents | objeto de tipo [trackingEvents](#ads-logs-trackingEvents) | true | La baliza de seguimiento URLs de los distintos eventos de seguimiento del anuncio. Las claves son los nombres de los eventos y los valores son una lista de balizas URLs. |
| transcodedAdDuration | número | true | La duración del anuncio, calculada a partir del recurso transcodificado. |
| uri | cadena | true | La URL de la versión intermedia del anuncio, que es la entrada del transcodificador. |
| vastDuration | número | true | La duración del anuncio, tal como se analiza a partir de la respuesta VAST. |
### requestheaders
En esta sección se describen las propiedades requestheaders de los registros de ADS.
**Propiedades de requestheaders de registros de ADS**
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| name | cadena | true | El nombre del encabezado. |
| value | cadena | true | El valor del encabezado. |
### skippedAd
En esta sección se describen las propiedades skippedAd de los registros de ADS.
**Propiedades skippedAd de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| adMezzanineUrl | cadena | true | La URL intermedia del anuncio omitido. |
| creativeUniqueId | cadena | true | El identificador único del anuncio, que se utiliza como clave para la transcodificación. Este es el campo de ID del anuncio en la respuesta VAST, si está disponible. De lo contrario, es la URL intermedia del anuncio. |
| skippedReason | cadena | true | El código que indica por qué no se insertó el anuncio. Ejemplo: TRANSCODE\$1IN\$1PROGRESS. Para ver una lista de los motivos por los que se omiten los anuncios, consulte[Solución de problemas de omisión de anuncios](troubleshooting-ad-skipping-overview.md). |
| transcodedAdDuration | número | false | La duración del anuncio, calculada a partir del recurso transcodificado. |
| vastDuration | número | true | La duración del anuncio, tal como se analiza a partir de la respuesta VAST. |
### slateAd
En esta sección se describen las propiedades slateAd de los registros de ADS.
**Propiedades slateAd de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| adContent | objeto de tipo [adContent](#ads-logs-adContent) | true | Información sobre el contenido del anuncio insertado. |
| creativeUniqueId | cadena | true | El identificador único del anuncio, que se utiliza como clave para la transcodificación. Este es el campo de ID del anuncio en la respuesta VAST, si está disponible. De lo contrario, es la URL intermedia del anuncio. |
| transcodedAdDuration | número | true | La duración del anuncio, calculada a partir del recurso transcodificado. |
| uri | cadena | true | La URL de la versión intermedia del anuncio, que es la entrada del transcodificador. |
### trackingEvents
En esta sección se describen las propiedades trackingEvents de los registros de ADS.
**Propiedades trackingEvents de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| | matriz de tipo string | false | La lista URLs de indicadores del evento de seguimiento especificado (impresión, completo, etc.) |
### vastAd
En esta sección se describen las propiedades vastAd de de los registros de ADS.
**Propiedades de vastAd de registros de ADS**
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| adSystem | cadena | true | El valor de la etiqueta AdSystem en la respuesta VAST. |
| adTitle | cadena | true | Los archivos multimedia que están disponibles para el anuncio en la respuesta VAST. |
| creativeAdId | cadena | true | El valor del atributo adId de la etiqueta Creative en la respuesta VAST. |
| creativeId | cadena | true | El valor del atributo id de la etiqueta Creative en la respuesta VAST. |
| duration | número | true | La duración aproximada del anuncio, en función de la etiqueta duration en el elemento linear de la respuesta VAST. |
| trackingEvents | objeto de tipo [trackingEvents](#ads-logs-trackingEvents) | true | La baliza URLs de seguimiento de los distintos eventos de seguimiento del anuncio. Las claves son los nombres de los eventos y los valores son una lista de balizas URLs. |
| vastAdId | cadena | true | El valor del atributo id de la etiqueta Ad en la respuesta VAST |
| vastAdTagUri | cadena | false | El URI de redirección específico de VMAP para un anuncio. |
| vastMediaFiles | matriz de tipo [vastMediaFile](#ads-logs-vastMediaFile) | true | La lista de archivos multimedia disponibles para el anuncio en la respuesta VAST. |
### vastMediaFile
En esta sección se describen las propiedades de los registros de ADS vastMediaFile.
**vastMediaFile Propiedades de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| apiFramework | cadena | true | El marco de API necesario para administrar el archivo multimedia. Ejemplo: VPAID. |
| bitrate | número | true | La velocidad de bits del archivo multimedia. |
| delivery | cadena | true | El protocolo utilizado para el archivo multimedia, establecido en progresivo o en streaming. |
| height | número | true | La altura en píxeles del archivo multimedia. |
| id | cadena | true | El valor del atributo id de la etiqueta MediaFile. |
| type | cadena | true | El tipo MIME del archivo multimedia, tomado del atributo type de la etiqueta MediaFile. |
| uri | cadena | true | La URL de la versión intermedia del anuncio, que es la entrada del transcodificador. |
| width | número | true | El ancho de píxeles del archivo multimedia. |
### vastResponse
En esta sección se describen las propiedades vastResponse de los registros de ADS.
**Propiedades vastResponse de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| errors | matriz de tipo string | true | El error URLs se analizó a partir de las Error etiquetas de la respuesta VAST. |
| vastAds | matriz de tipo [vastAd](#ads-logs-vastAd) | true | Los anuncios analizados desde la respuesta VAST. |
| version | cadena | true | La versión de la especificación VAST, analizada a partir del atributo version de la etiqueta VAST en la respuesta. |
### vodCreativeOffsets
En esta sección se describen las propiedades de los registros de ADS vodCreativeOffsets.
**vodCreativeOffsets Propiedades de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| | matriz de tipo [vodCreativeOffset](#ads-logs-vodCreativeOffset) | false | Un mapeo desde un desfase de tiempo en el manifiesto a una lista de anuncios que se van a insertar en este momento. |
### vodCreativeOffset
En esta sección se describen las propiedades de los registros de ADS vodCreativeOffset.
**vodCreativeOffset Propiedades de los registros de ADS**
| Propiedad | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| adContent | objeto de tipo [adContent](#ads-logs-adContent) | true | Información sobre el contenido del anuncio insertado. |
| creativeUniqueId | cadena | true | El identificador único del anuncio, que se utiliza como clave para la transcodificación. Este es el campo de ID del anuncio en la respuesta VAST, si está disponible. De lo contrario, es la URL intermedia del anuncio. |
| trackingEvents | objeto de tipo [trackingEvents](#ads-logs-trackingEvents) | true | La baliza URLs de seguimiento de los distintos eventos de seguimiento del anuncio. Las claves son los nombres de los eventos y los valores son una lista de balizas URLs. |
| transcodedAdDuration | número | true | La duración del anuncio, calculada a partir del recurso transcodificado. |
| uri | cadena | true | La URL de la versión intermedia del anuncio, que es la entrada del transcodificador. |
| vastDuration | número | true | La duración del anuncio, tal como se analiza a partir de la respuesta VAST. |
## Esquema JSON del registro ADS
A continuación, se muestra el esquema JSON del registro de AWS Elemental MediaTailor ADS.
```
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "http://amazon.com/elemental/midas/mms/adsLogSchema.json",
"type": "object",
"title": "AWS Elemental MediaTailor ADS Log JSON Schema",
"required": [
"eventType",
"eventTimestamp",
"requestId",
"sessionType",
"eventDescription",
"awsAccountId",
"customerId",
"originId",
"sessionId"
],
"additionalProperties": false,
"properties": {
"eventType": {
"$id": "#/properties/eventType",
"type": "string",
"description": "The code for the event that triggered this log message. Example: VAST_RESPONSE.",
"examples": [
"FILLED_AVAIL"
]
},
"eventTimestamp": {
"$id": "#/properties/eventTimestamp",
"type": "string",
"description": "The date and time of the event.",
"examples": [
"1970-01-01T00:00:00Z"
],
"format": "date-time"
},
"requestId": {
"$id": "#/properties/requestId",
"type": "string",
"description": "The MediaTailor request ID, which you can use to correlate multiple log entries for the same request.",
"examples": [
"c7c7ae8c-a61e-44e0-8efd-7723995337a1"
],
"pattern": "^(.*)$"
},
"sessionType": {
"$id": "#/properties/sessionType",
"type": "string",
"enum": [
"HLS",
"DASH"
],
"description": "The player's stream type."
},
"eventDescription": {
"$id": "#/properties/eventDescription",
"type": "string",
"description": "A short description of the event that triggered this log message, provided by the MediaTailor service. By default, this is empty. Example: Got VAST response.",
"default": "",
"examples": [
"Got VAST response"
],
"pattern": "^(.*)$"
},
"awsAccountId": {
"$id": "#/properties/awsAccountId",
"type": "string",
"description": "The AWS account ID for the MediaTailor configuration that was used for the session."
},
"customerId": {
"$id": "#/properties/customerId",
"type": "string",
"description": "The hashed version of the AWS account ID, which you can use to correlate multiple log entries.",
"pattern": "^(.*)$"
},
"originId": {
"$id": "#/properties/originId",
"type": "string",
"description": "The configuration name from the MediaTailor configuration. This is different from the video content source, which is also part of the configuration.",
"examples": [
"external-canary-dash-serverside-reporting-onebox"
],
"pattern": "^(.*)$"
},
"sessionId": {
"$id": "#/properties/sessionId",
"type": "string",
"description": "The unique numeric identifier that MediaTailor assigned to the player session. All requests that a player makes for a session have the same session ID. Example: e039fd39-09f0-46b2-aca9-9871cc116cde.",
"examples": [
"120b9873-c007-40c8-b3db-0f1bd194970b"
],
"pattern": "^(.*)$"
},
"avail": {
"$id": "#/properties/avail",
"type": "object",
"title": "avail",
"description": "Information about an avail that MediaTailor fills with ads. Currently, for the FILLED_AVAIL event type, this is the plan created by MediaTailor when it first encounters the avail. How the avail is eventually filled may vary from this plan, depending on how the content plays out. ",
"required": [
"creativeAds",
"originAvailDuration",
"filledDuration",
"fillRate",
"driftMillisecondsAtAvailStart",
"numAds",
"slateAd",
"availId"
],
"additionalProperties": false,
"properties": {
"originAvailDuration": {
"$id": "#/properties/avail/originAvailDuration",
"type": "number",
"description": "The duration of the avail as specified in the content stream from the origin (CUE_OUT or SCTE)."
},
"filledDuration": {
"$id": "#/properties/avail/filledDuration",
"type": "number",
"description": "The sum of the durations of all the ads inserted into the avail."
},
"fillRate": {
"$id": "#/properties/avail/fillRate",
"type": "number",
"description": "The rate at which the ads fill the avail duration, from 0.0 (for 0%) to 1.0 (for 100%)."
},
"driftMillisecondsAtAvailStart": {
"$id": "#/properties/avail/driftMillisecondsAtAvailStart",
"type": "number",
"description": "The cumulative drift at the beginning of this avail. A positive value implies that we are moving away from the live edge, a negative value implies that we are moving towards the live edge."
},
"creativeAds": {
"$id": "#/properties/avail/creativeAds",
"type": "array",
"description": "The ads that MediaTailor inserted into the avail.",
"items": {
"type": "object",
"title": "creativeAd",
"description": "Information about a single inserted ad.",
"required": [
"uri",
"creativeUniqueId",
"adSystem",
"adContent",
"trackingEvents",
"vastDuration",
"transcodedAdDuration"
],
"additionalProperties": false,
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adSystem": { "$ref": "#/definitions/adSystem" },
"adContent": { "$ref": "#/definitions/adContent" },
"trackingEvents": { "$ref": "#/definitions/trackingEvents" },
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
}
}
},
"numAds": {
"$id": "#/properties/avail/numAds",
"type": "number",
"description": "The number of ads that MediaTailor inserted into the avail."
},
"slateAd": {
"$id": "#/properties/avail/slateAd",
"type": ["object", "null"],
"title": "slateAd",
"description": "Information about the slate ad, which MediaTailor uses to fill any unfilled segments in the avail.",
"additionalProperties": false,
"required": [
"uri",
"creativeUniqueId",
"adContent",
"transcodedAdDuration"
],
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adContent": { "$ref": "#/definitions/adContent" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
}
},
"availId": {
"$id": "#/properties/avail/availId",
"type": "string",
"description": "The unique identifier for this avail. For HLS, this is the media sequence number where the avail begins. For DASH, this is the period ID."
},
"skippedAds": {
"$id": "#/properties/avail/skippedAds",
"type": "array",
"description": "The ads that MediaTailor didn't insert, for reasons like TRANSCODE_IN_PROGRESS and TRANSCODE_ERROR.",
"items": {
"type": "object",
"title": "skippedAd",
"description": "Information about a single skipped ad.",
"required": [
"creativeUniqueId",
"adMezzanineUrl",
"skippedReason",
"vastDuration"
],
"additionalProperties": false,
"properties": {
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adMezzanineUrl": {
"type": "string",
"description": "The mezzanine URL of the skipped ad."
},
"skippedReason": {
"type": "string",
"description": "The code that indicates why the ad wasn't inserted. Example: TRANSCODE_IN_PROGRESS."
},
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
"targetVariant": {
"type": "object",
"title": "targetVariant",
"description": "The target variant of the source content. This key is present when an ad wasn't inserted due to the source content containing a variant that could not match to any variants present in this ad.",
"required": [
"mediaProtocol",
"mediaType",
"bitrate",
"mediaResolution",
"codecs"
],
"additionalProperties": false,
"properties": {
"mediaProtocol": {
"type": "string",
"description": "The media protocol of this variant, such as HLS.",
"enum": [
"HLS",
"DASH"
]
},
"mediaType": {
"type": "array",
"description": "The media type of this variant, such as VIDEO.",
"items": {
"type": "string",
"enum": [
"VIDEO",
"AUDIO",
"SUBTITLES",
"TRICK_PLAY"
],
"description": "Media type, such as VIDEO."
}
},
"bitrate": {
"$ref": "#/definitions/bitrate"
},
"mediaResolution": {
"type": "object",
"title": "mediaResolution",
"description": "The media resolution of this variant.",
"required": [
"width",
"height"
],
"additionalProperties": false,
"properties": {
"width": {
"$ref": "#/definitions/width"
},
"height": {
"$ref": "#/definitions/height"
}
}
},
"codecs": {
"type": "array",
"description": "The codecs of this variant.",
"items": {
"type": "string",
"description": "Codec, such as avc1."
}
}
}
}
}
}
},
"adBreakTrackingEvents": {
"$id": "#properties/avail/adBreakTrackingEvents",
"type": "object",
"title": "adBreakTrackingEvents",
"description": "VMAP/ad break tracking events and corresponding URL",
"properties": {
"items": {
"$ref": "#/definitions/adBreakTrackingEvents"
}
}
}
}
},
"vastResponse": {
"$id": "#/properties/vastResponse",
"type": "object",
"title": "vastResponse",
"description": "Information about the VAST response that MediaTailor received from the ADS.",
"required": [
"version",
"vastAds",
"errors",
"nonLinearAdsList"
],
"additionalProperties": false,
"properties": {
"version": {
"$id": "#/properties/vastResponse/version",
"type": "string",
"description": "The VAST specification version, parsed from the version attribute of the VAST tag in the response.",
"examples": [
"3.0"
],
"pattern": "^(.*)$"
},
"vastAds": {
"$id": "#/properties/vastResponse/vastAds",
"type": "array",
"description": "The ads parsed from the VAST response.",
"items": {
"$ref": "#/definitions/vastAd"
}
},
"errors": {
"$id": "#/properties/vastResponse/errors",
"type": "array",
"description": "The error URLs parsed from the Error tags in the VAST response.",
"items": {
"type": "string",
"description": "A single error URL."
}
},
"nonLinearAdsList": {
"$id": "#/properties/vastResponse/nonLinearAds",
"type": "array",
"description": "A list of NonLinearAds as they are read from the VAST response.",
"items": {
"$ref": "#/definitions/nonLinearAds"
}
}
}
},
"vastAd": {
"$ref": "#/definitions/vastAd"
},
"vodVastResponseTimeOffset": {
"$id": "#/properties/vodVastResponseTimeOffset",
"type": "number",
"description": "The VMAP specific time offset for VOD ad insertion.",
"examples": [
5.0
]
},
"vodCreativeOffsets": {
"$id": "#/properties/vodCreativeOffsets",
"type": "object",
"title": "vodCreativeOffsets",
"description": "A map that indicates the time offsets in the manifest where MediaTailor will insert avails, based on the VMAP response.",
"additionalProperties": {
"type": "array",
"$id": "#/properties/vodCreativeOffsets/entry",
"description": "A mapping from a time offset in the manifest to a list of ads to insert at this time.",
"items": {
"type": "object",
"$id": "#/properties/vodCreativeOffsets/entry/items",
"title": "vodCreativeOffset",
"description": "The list of ads to insert at the specified time offset.",
"additionalProperties": false,
"required": [
"uri",
"creativeUniqueId",
"vastDuration",
"transcodedAdDuration",
"adContent",
"trackingEvents"
],
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
"adContent": { "$ref": "#/definitions/adContent" },
"trackingEvents": { "$ref": "#/definitions/trackingEvents" }
}
}
}
},
"adsRequestUrl": {
"$id": "#/properties/adsRequestUrl",
"type": "string",
"description": "The full URL of the ADS request made by MediaTailor."
},
"adMarkers": {
"$id": "#/properties/adMarkers",
"type": "string",
"description": "Found Ad Marker in the Manifest."
},
"segmentationUpid": {
"$id": "#/properties/segmentationUpid",
"type": "string",
"description": "Value of segmentation upid parsed from ad markers in manifest."
},
"segmentationTypeId": {
"$id": "#/properties/segmentationTypeId",
"type": "integer",
"description": "Value of segmentation typeId parsed from ad markers in manifest."
},
"requestHeaders": {
"$id": "#/properties/requestHeaders",
"type": "array",
"description": "The headers that MediaTailor included with the ADS request. Typically, the logs include these when a request to the ADS fails, to help with troubleshooting.",
"items": {
"type": "object",
"title": "requestheaders",
"description": "The name and value for a single header included in the ADS request.",
"required": [
"name",
"value"
],
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"description": "The name of the header."
},
"value": {
"type": "string",
"description": "The value of the header."
}
}
}
},
"originalTargetUrl": {
"$id": "#/properties/originalTargetUrl",
"type": "string",
"description": "The old URL to which MediaTailor was going to make a request."
},
"prefetchScheduleName": {
"$id": "#/properties/prefetchScheduleName",
"type": "string",
"description": "The name of the prefetch schedule associated with this ad event.",
"examples": [
"PrefetchScheduleName"
],
"pattern": "^(.*)$"
},
"updatedTargetUrl": {
"$id": "#/properties/updatedTargetUrl",
"type": "string",
"description": "The new URL to which MediaTailor is making a request."
},
"rawAdsResponse": {
"$id": "#/properties/rawAdsResponse",
"type": "string",
"description": "Paginated ADS response as it's exactly returned to MediaTailor."
},
"rawAdsResponseIndex": {
"$id": "#/properties/rawAdsResponseIndex",
"type": "integer",
"description": "Integer value denoting this rawAdsResponse's index into the full ADS response. This value is used to order the paginated messages for this ADS response."
}
},
"__COMMENT_oneOf": "The oneOf section defines subtypes for our events. Subtypes can have different rules, including which fields are required. For more information, see https://json-schema.org/understanding-json-schema/reference/combining.html#oneof ",
"oneOf": [
{ "$ref": "#/definitions/eventAdMarkersFound" },
{ "$ref": "#/definitions/eventNonAdMarkerFound" },
{ "$ref": "#/definitions/eventMakingAdsRequest" },
{ "$ref": "#/definitions/eventModifiedTargetUrl" },
{ "$ref": "#/definitions/eventRawAdsResponse" },
{ "$ref": "#/definitions/eventVastResponse" },
{ "$ref": "#/definitions/eventFilledAvail" },
{ "$ref": "#/definitions/eventFilledOverlayAvail" },
{ "$ref": "#/definitions/eventErrorFiringBeaconFailed" },
{ "$ref": "#/definitions/eventWarningNoAdvertisements" },
{ "$ref": "#/definitions/eventUnknownHost" },
{ "$ref": "#/definitions/eventErrorAdsTimeout" },
{ "$ref": "#/definitions/eventErrorVastMissingOverlays" },
{ "$ref": "#/definitions/eventPlannedAvail" },
{ "$ref": "#/definitions/eventEmptyVastResponse" },
{ "$ref": "#/definitions/eventEmptyVmapResponse" },
{ "$ref": "#/definitions/eventErrorUnknown" },
{ "$ref": "#/definitions/eventVastRedirect" },
{ "$ref": "#/definitions/eventRedirectedVastResponse" },
{ "$ref": "#/definitions/eventErrorAdsMissingImpression" },
{ "$ref": "#/definitions/eventErrorAdsResponseParse" },
{ "$ref": "#/definitions/eventErrorAdsInvalidResponse" },
{ "$ref": "#/definitions/eventErrorDisallowedHost"},
{ "$ref": "#/definitions/eventPersonalizationDisabled"},
{ "$ref": "#/definitions/eventWarningDynamicVariableSubFailed"},
{ "$ref": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset" },
{ "$ref": "#/definitions/eventVodTimeBasedAvailPlanSuccess" }
],
"definitions": {
"eventAdMarkersFound": {
"$id": "#/definitions/eventAdMarkersFound",
"required": [
"eventType",
"adMarkers"
],
"properties": {
"eventType": {
"type": "string",
"const": "AD_MARKER_FOUND"
}
}
},
"eventNonAdMarkerFound": {
"$id": "#/definitions/eventNonAdMarkerFound",
"required": [
"eventType",
"adMarkers"
],
"properties": {
"eventType": {
"type": "string",
"const": "NON_AD_MARKER_FOUND"
}
}
},
"eventMakingAdsRequest": {
"$id": "#/definitions/eventMakingAdsRequest",
"required": [
"eventType",
"adsRequestUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "MAKING_ADS_REQUEST"
}
}
},
"eventModifiedTargetUrl": {
"$id": "#/definitions/eventModifiedTargetUrl",
"required": [
"eventType",
"originalTargetUrl",
"updatedTargetUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "MODIFIED_TARGET_URL"
}
}
},
"eventRawAdsResponse": {
"$id": "#/definitions/eventRawAdsResponse",
"required": [
"eventType",
"rawAdsResponse",
"rawAdsResponseIndex"
],
"properties": {
"eventType": {
"type": "string",
"const": "RAW_ADS_RESPONSE"
}
}
},
"eventVastResponse": {
"$id": "#/definitions/eventVastResponse",
"_comment": "NOTE: the vastResponse property should ideally be marked as a required field for this event, but unfortunately, in the case of an empty vast response, we currently emit an EMPTY_VAST_RESPONSE followed by a VAST_RESPONSE, and the vastResponse property is not present in the latter. We need to fix this so that we don't emit both of those events in the empty response case, and update this schema to flag vastResponse as required for VAST_RESPONSE.",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "VAST_RESPONSE"
}
}
},
"eventFilledAvail": {
"$id": "#/definitions/eventFilledAvail",
"required": [
"eventType",
"avail"
],
"properties": {
"eventType": {
"type": "string",
"const": "FILLED_AVAIL"
}
}
},
"eventFilledOverlayAvail": {
"$id": "#/definitions/eventFilledOverlayAvail",
"required": [
"eventType",
"avail"
],
"properties": {
"eventType": {
"type": "string",
"const": "FILLED_OVERLAY_AVAIL"
}
}
},
"eventErrorVastMissingOverlays": {
"$id": "#/definitions/eventErrorVastMissingOverlays",
"required": [
"eventType",
"adsRequestUrl",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_VAST_MISSING_OVERLAYS"
}
}
},
"eventErrorFiringBeaconFailed": {
"$id": "#/definitions/eventErrorFiringBeaconFailed",
"required": [
"eventType",
"error",
"beaconInfo"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_FIRING_BEACON_FAILED"
}
}
},
"eventWarningNoAdvertisements": {
"$id": "#/definitions/eventWarningNoAdvertisements",
"required": [
"eventType"
],
"_comment": "We should really have a more descriptive error field for these events",
"properties": {
"eventType": {
"type": "string",
"const": "WARNING_NO_ADVERTISEMENTS"
}
}
},
"eventUnknownHost": {
"$id": "#/definitions/eventUnknownHost",
"required": [
"eventType",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_UNKNOWN_HOST"
}
}
},
"eventErrorAdsTimeout": {
"$id": "#/definitions/eventErrorAdsTimeout",
"required": [
"eventType",
"adsRequestUrl",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_TIMEOUT"
}
}
},
"eventPlannedAvail": {
"$id": "#/definitions/eventPlannedAvail",
"required": [
"eventType"
],
"_comment": "TODO: Flesh this out as we implement it",
"properties": {
"eventType": {
"type": "string",
"const": "PLANNED_AVAIL"
}
}
},
"eventEmptyVastResponse": {
"$id": "#/definitions/eventEmptyVastResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "EMPTY_VAST_RESPONSE"
}
}
},
"eventEmptyVmapResponse": {
"$id": "#/definitions/eventEmptyVmapResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "EMPTY_VMAP_RESPONSE"
}
}
},
"eventErrorUnknown": {
"$id": "#/definitions/eventErrorUnknown",
"required": [
"eventType"
],
"_comment": "TODO: we should have a field for the exception message or something",
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_UNKNOWN"
}
}
},
"eventVastRedirect": {
"$id": "#/definitions/eventVastRedirect",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "VAST_REDIRECT"
}
}
},
"eventRedirectedVastResponse": {
"$id": "#/definitions/eventRedirectedVastResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "REDIRECTED_VAST_RESPONSE"
}
},
"_comment": "NOTE that the property vastResponse is not required because empty vast responses do not contain a vastResponse."
},
"eventErrorAdsResponseParse": {
"$id": "#/definitions/eventErrorAdsResponseParse",
"required": [
"eventType"
],
"_comment": "We should have a field with an error message here",
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_RESPONSE_PARSE"
}
}
},
"eventErrorAdsInvalidResponse": {
"$id": "#/definitions/eventErrorAdsInvalidResponse",
"required": [
"eventType",
"additionalInfo"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_INVALID_RESPONSE"
}
}
},
"eventErrorAdsMissingImpression": {
"$id": "#/definitions/eventErrorAdsMissingImpression",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_VAST_MISSING_IMPRESSION"
}
}
},
"eventErrorDisallowedHost": {
"$id": "#/definitions/eventErrorDisallowedHost",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_DISALLOWED_HOST"
}
}
},
"eventPersonalizationDisabled": {
"$id": "#/definitions/eventPersonalizationDisabled",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_PERSONALIZATION_DISABLED"
}
}
},
"eventWarningDynamicVariableSubFailed": {
"$id": "#/definitions/eventWarningDynamicVariableSubFailed",
"required": [
"eventType",
"adsRequestUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "WARNING_URL_VARIABLE_SUBSTITUTION_FAILED"
}
}
},
"eventVodTimeBasedAvailPlanVastResponseForOffset": {
"$id": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset",
"required": [
"eventType",
"vastResponse"
],
"properties": {
"eventType": {
"type": "string",
"const": "VOD_TIME_BASED_AVAIL_PLAN_VAST_RESPONSE_FOR_OFFSET"
}
}
},
"eventVodTimeBasedAvailPlanSuccess": {
"$id": "#/definitions/eventVodTimeBasedAvailPlanSuccess",
"required": [
"eventType",
"vodCreativeOffsets"
],
"properties": {
"eventType": {
"type": "string",
"const": "VOD_TIME_BASED_AVAIL_PLAN_SUCCESS"
}
}
},
"creativeUniqueId": {
"type": "string",
"description": "The unique identifier for the ad, used as a key for transcoding. This is the ID field for the creative in the VAST response, if available. Otherwise, it's the mezzanine URL of the ad. "
},
"adSystem": {
"type": "string",
"description": "The value of the AdSystem tag in the VAST response. "
},
"vastDuration": {
"type": "number",
"description": "The duration of the ad, as parsed from the VAST response."
},
"transcodedAdDuration": {
"type": "number",
"description": "The duration of the ad, calculated from the transcoded asset."
},
"adContent": {
"$id": "#/properties/adContent",
"type": ["object", "null"],
"title": "adContent",
"description": "Information about the content of the inserted ad.",
"additionalProperties": false,
"properties": {
"adPlaylistUris": {
"$id": "#/properties/adContent/adPlaylistUris",
"type": "object",
"title": "adPlaylistUris",
"description": "The mapping from the origin manifest for a variant to the ad manifest for the variant. For DASH, this contains a single entry, because all variants are represented in a single DASH manifest. ",
"additionalProperties": {
"$id": "#/properties/adContent/adPlaylistUris/adPlaylistUri",
"type": "string",
"description": "The URL of the ad manifest for the specific variant."
}
}
}
},
"adMezzanineUri": {
"type": "string",
"description": "The URL of the mezzanine version of the ad, which is the input to the transcoder."
},
"bitrate": {
"type": "integer",
"examples": [
533
],
"description": "The bitrate."
},
"width": {
"type": "integer",
"examples": [
1280
],
"description": "Width in pixels."
},
"height": {
"type": "integer",
"examples": [
720
],
"description": "Height in pixels."
},
"trackingEvents": {
"type": "object",
"title": "trackingEvents",
"description": "The tracking beacon URLs for the various tracking events for the ad. The keys are the event names, and the values are a list of beacon URLs.",
"additionalProperties": {
"type": "array",
"description": "The list of beacon URLs for the specified tracking event (impression, complete, and so on)",
"items": {
"type": "string",
"description": "The beacon URLs for this tracking event."
}
}
},
"nonLinearAds": {
"$id": "#/properties/nonLinearAds",
"type": "object",
"title": "nonLinearAds",
"description": "A NonLinearAds as it appears in the VAST response.",
"required": [
"nonLinearAdList",
"nonLinearTrackingEvents"
],
"properties": {
"nonLinearAdList": {
"type": "array",
"description": "List of non linear ads as they exist within one NonLinearAds.",
"items": {
"type": "object",
"title": "nonLinearAdList",
"description": "List of NonLinearAd as they are parsed from its parent NonLinearAds.",
"properties": {
"nonLinearAdId": {
"type": "string",
"description": "Ad ID of this non linear ad."
},
"nonLinearAdSystem": {
"type": "string",
"description": "Ad system of this non linear ad's parent Inline ad."
},
"nonLinearAdTitle": {
"type": "string",
"description": "Ad title of this non linear ad's parent Inline ad."
},
"nonLinearCreativeId": {
"type": "string",
"description": "Creative ID of this non linear ad's parent Creative ad."
},
"nonLinearCreativeAdId": {
"type": "string",
"description": "Creative ad ID of this non linear ad."
},
"nonLinearCreativeSequence": {
"type": "string",
"description": "Creative sequence of this non linear ad."
},
"nonLinearWidth": {
"type": "string",
"description": "Width of this non linear ad."
},
"nonLinearHeight": {
"type": "string",
"description": "Height of this non linear ad."
},
"nonLinearExpandedWidth": {
"type": "string",
"description": "Expanded width of this non linear ad."
},
"nonLinearExpandedHeight": {
"type": "string",
"description": "Expanded height of this non linear ad."
},
"nonLinearScalable": {
"type": "boolean",
"description": "Boolean denoting if this non linear ad is scalable."
},
"nonLinearMaintainAspectRatio": {
"type": "boolean",
"description": "Boolean denoting if aspect ratio should be maintained for this non linear ad."
},
"nonLinearMinSuggestedDuration": {
"type": "string",
"description": "Min suggested duration for this non linear ad."
},
"nonLinearApiFramework": {
"type": "string",
"description": "API framework for this non linear ad's parent Inline ad."
},
"nonLinearStaticResource": {
"type": "string",
"description": "Static resource for this non linear ad."
},
"nonLinearStaticResourceCreativeType": {
"type": "string",
"description": "Static Resource creative type for this non linear ad."
},
"nonLinearIFrameResource": {
"type": "string",
"description": "I-Frame resource for this non linear ad."
},
"nonLinearHtmlResource": {
"type": "string",
"description": "HTML resource for this non linear ad."
},
"nonLinearAdParameters": {
"type": "string",
"description": "Ad parameters for this non linear ad."
},
"nonLinearClickThrough": {
"type": "string",
"description": "Click Through data for this non linear ad."
},
"nonLinearClickTracking": {
"type": "string",
"description": "Click Tracking data for this non linear ad."
},
"nonLinearClickTrackingId": {
"type": "string",
"description": "Click Tracking ID for this non linear ad."
}
}
}
},
"nonLinearTrackingEvents": { "$ref": "#/definitions/trackingEvents" },
"extensions": {
"$id": "#/properties/nonLinearAds/extensions",
"type": "array",
"description": "Extensions that exist for this NonLinearAds.",
"items": {
"$id": "#/properties/nonLinearAds/extensions/items",
"type": "object",
"title": "Extensions",
"description": "Extensions found in non linear ads",
"additionalProperties": false,
"properties": {
"extensionType": {
"$id": "#/properties/nonLinearAds/extensions/extensionType",
"type": "string",
"description": "The value of the extension type attribute of the Extensions tag.",
"examples": [
"FreeWheel"
]
},
"extensionContent": {
"$id": "#/properties/nonLinearAds/extensions/extensionContent",
"type": "string",
"description": "The extension content attribute of the Extensions tag.",
"examples": [
"progressive"
]
}
}
}
}
}
},
"adBreakTrackingEvents": {
"$id": "#/properites/adBreakTrackingEvents",
"type": "object",
"title": "adBreakTrackingEvents",
"description": "These are all VMAP ad break tracking events.",
"additionalProperties": {
"type": "array",
"description": "VMAP/ad break tracking events and corresponding URL",
"items": {
"type": "string",
"description": "The beacon URLs for this tracking event."
}
}
},
"vastAd": {
"$id": "#/properties/vastAd",
"type": "object",
"title": "vastAd",
"description": "Information about a single ad parsed from the VAST response.",
"required": [
"vastAdId",
"adSystem",
"adTitle",
"creativeId",
"creativeAdId",
"duration",
"vastMediaFiles",
"trackingEvents"
],
"additionalProperties": false,
"properties": {
"vastAdId": {
"$id": "#/properties/vastAd/vastAdId",
"type": "string",
"description": "The value of the id attribute of the Ad tag in the VAST response",
"examples": [
"ad1"
]
},
"adSystem": {"$ref": "#/definitions/adSystem" } ,
"adTitle": {
"$id": "#/properties/vastAd/adTitle",
"type": "string",
"description": "The media files that are available for the ad in the VAST response.",
"examples": [
"External NCA1C1L1 LinearInlineSkippable"
]
},
"creativeId": {
"$id": "#/properties/vastAd/creativeId",
"type": "string",
"description": "The value of the id attribute of the Creative tag in the VAST response.",
"examples": [
"creative1"
]
},
"creativeAdId": {
"$id": "#/properties/vastAd/creativeAdId",
"type": "string",
"description": "The value of the adId attribute of the Creative tag in the VAST response."
},
"duration": {
"$id": "#/properties/vastAd/duration",
"type": "number",
"description": "The approximate duration of the ad, based on the duration tag in the linear element of the VAST response.",
"examples": [
30,
30.0
]
},
"vastMediaFiles": {
"$id": "#/properties/vastAd/vastMediaFiles",
"type": "array",
"description": "The list of available media files for the ad in the VAST response.",
"items": {
"$id": "#/properties/vastAd/vastMediaFiles/items",
"type": "object",
"title": "vastMediaFile",
"description": "Information about a media file for the ad.",
"required": [
"uri",
"id",
"delivery",
"type",
"apiFramework",
"width",
"height",
"bitrate"
],
"additionalProperties": false,
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"id": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/id",
"type": "string",
"description": "The value of the id attribute of the MediaFile tag.",
"examples": [
"GDFP"
]
},
"delivery": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/delivery",
"type": "string",
"description": "The protocol used for the media file, set to either progressive or streaming.",
"examples": [
"progressive"
]
},
"type": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/type",
"type": "string",
"description": "The MIME type of the media file, taken from the type attribute of the MediaFile tag.",
"examples": [
"video/mp4"
]
},
"apiFramework": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/apiFramework",
"type": "string",
"description": "The API framework needed to manage the media file. Example: VPAID."
},
"width": {
"$ref": "#/definitions/width"
},
"height": {
"$ref": "#/definitions/height"
},
"bitrate": {
"$ref": "#/definitions/bitrate"
}
}
}
},
"trackingEvents": { "$ref": "#/definitions/trackingEvents" },
"vastAdTagUri": {
"$id": "#/properties/vastAd/vastAdTagUri",
"type": "string",
"description": "The VMAP-specific redirect URI for an ad.",
"examples": [
"https://ads.redirect.com/redirect1"
]
}
}
}
}
}
```
# AWS Elemental MediaTailor los registros de manifiesto, la descripción y los tipos de eventos
En las siguientes secciones se describen los registros que se MediaTailor emiten para describir los eventos del servidor de origen al solicitar y recibir un manifiesto. Estos son `ManifestService` registros.
**Topics**
+ [Eventos de ManifestService](#log-types-origininteraction)
+ [El manifiesto registra las propiedades](#manifest-logs-main)
## Eventos de ManifestService
Los siguientes eventos se emiten durante MediaTailor las interacciones con el origen.
| Registro | Description (Descripción) |
| --- | --- |
| CONFIG\$1SECURITY\$1ERROR | La MediaTailor configuración tiene un problema de seguridad. |
| CONFIG\$1SYNTAX\$1ERROR | El origen y la ruta del activo dan como resultado una URL mal formada. |
| CONNECTION\$1ERROR | Se ha rechazado o se ha producido un error en la MediaTailor conexión con el origen. |
| GENERATED\$1MANIFEST | MediaTailor generó un manifiesto. Debe tener el modo de depuración activado para recibir estos registros. Para obtener información sobre el modo de registro de depuración, incluido cómo activarlo, consulte. [Generar registros de depuración](debug-log-mode.md) |
| HOST\$1DISALLOWED | MediaTailor no permite solicitudes HTTP a este host. |
| INCOMPATIBLE\$1HLS\$1VERSION | El manifiesto usa una versión HLS incompatible. MediaTailor requiere la versión 3 o superior. |
| INVALID\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | El manifiesto DASH de un solo período no es válido. MediaTailor pasa por un manifiesto DASH de un solo período. |
| IO\$1ERROR | MediaTailor detectó un error de E/S durante la comunicación con el origen. |
| LAST\$1PERIOD\$1MISSING\$1AUDIO | En el último punto del manifiesto de DASH falta todo el audio AdaptationSets debido a una desalineación del audio o vídeo de origen. Para evitar problemas de reproducción, retrasa la publicación del último período hasta, al menos, la siguiente solicitud. |
| LAST\$1PERIOD\$1MISSING\$1AUDIO\$1WARNING | En el último punto del manifiesto de DASH falta todo el audio AdaptationSets porque el audio de origen o el vídeo no están alineados correctamente. Elegir publicar (no retrasar) el último período. La falta de audio puede provocar problemas de reproducción. |
| MANIFEST\$1ERROR | Error en la solicitud de MediaTailor manifiesto. |
| NO\$1MASTER\$1OR\$1MEDIA\$1PLAYLIST | La respuesta de origen no contiene una lista de reproducción principal ni una lista de reproducción multimedia. |
| NO\$1MASTER\$1PLAYLIST | La respuesta de origen no contiene la lista de reproducción principal esperada. |
| NO\$1MEDIA\$1PLAYLIST | La respuesta de origen no contiene la lista de reproducción multimedia esperada. |
| ORIGIN\$1MANIFEST | MediaTailor obtuvo un manifiesto de origen. Debe tener el modo de depuración activado para recibir estos registros. Para obtener información sobre el modo de registro de depuración, incluido cómo activarlo, consulte. [Generar registros de depuración](debug-log-mode.md) |
| PARSING\$1ERROR | El origen no puede analizar la solicitud de manifiesto. |
| SCTE35\$1PARSING\$1ERROR | MediaTailor no puede analizar el Signal Binary elemento del manifiesto. |
| SESSION\$1INITIALIZED | Se ha inicializado una sesión. Debe tener el modo de depuración activado para recibir estos registros. Para obtener información sobre el modo de registro de depuración, incluido cómo activarlo, consulte. [Generar registros de depuración](debug-log-mode.md) |
| TIMEOUT\$1ERROR | Se agotó el tiempo de espera de la solicitud de MediaTailor manifiesto. |
| TRACKING\$1RESPONSE | MediaTailor proporcionó una respuesta de seguimiento. Debe tener el modo de depuración activado para recibir estos registros. Para obtener información sobre el modo de registro de depuración, incluido cómo activarlo, consulte. [Generar registros de depuración](debug-log-mode.md) |
| UNKNOWN\$1ERROR | MediaTailor ha detectado un error desconocido. |
| UNKNOWN\$1HOST | Se desconoce el anfitrión. |
| UNSUPPORTED\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | No se admite el manifiesto DASH de un solo período. MediaTailor pasa por un manifiesto DASH de un solo período. |
## El manifiesto registra las propiedades
En esta sección se describen las propiedades de los registros de manifiestos.
| Propiedad | Tipo | Obligatorio/a |
| --- | --- | --- |
| awsAccountId | cadena | true |
| eventTimestamp | cadena | true |
| originId | cadena | true |
| customerId | cadena | false |
| eventType | cadena | false |
| sessionId | cadena | false |
| originRequestUrl | cadena | false |
| mediaTailorPath | cadena | false |
| requestId | cadena | false |
| responseBody | cadena | false |
| sessionType | string (valores legales: [DASH, HLS]) | false |
| requestNextToken | cadena | false |
| eventDescription | cadena | false |
| assetPath | cadena | false |
| originFullUrl | cadena | false |
| originPrefixUrl | cadena | false |
| additionalInfo | cadena | false |
| cause | cadena | false |
| response | cadena | false |
| httpCode | cadena | false |
| errorMessage | cadena | false |
| adAdsResponse | cadena | false |
| adAdsRawResponse | cadena | false |
| adAdsRequest | cadena | false |
| adNumNewAvails | cadena | false |
| generatedMediaPlaylist | cadena | false |
| requestStartTime | cadena | false |
| requestEndTime | cadena | false |
| requestStartTimeEpochMillis | cadena | false |
| requestEndTimeEpochMillis | cadena | false |
# AWS Elemental MediaTailor la descripción de los registros de transcodificación y los tipos de eventos
En las siguientes secciones se describen los registros que se MediaTailor emiten para describir los eventos del servicio de transcodificación cuando se preparan las creatividades para la creación de anuncios. Estos son registros. `TranscodeService`
**Topics**
+ [Eventos de TranscodeService](#log-types-tminteraction)
+ [Transcodificar las propiedades de los registros](#transcode-logs-main)
## Eventos de TranscodeService
Los siguientes eventos se emiten durante MediaTailor las interacciones durante la transcodificación de anuncios.
| Registro | Description (Descripción) |
| --- | --- |
| IMPORT\$1ERROR | MediaTailor se produjo un error interno durante un trabajo de importación (en el caso de anuncios preacondicionados). Uso de un conjunto de anuncios vacío. |
| INITIALIZED | MediaTailor inicializó un trabajo de transcodificación o un trabajo de importación (para anuncios preacondicionados). |
| INTERNAL\$1ERROR | MediaTailor ha detectado un error interno. Uso de un conjunto de anuncios vacío. |
| MISSING\$1VARIANTS | MediaTailor no se ha podido transcodificar el anuncio porque faltan variantes. Uso de un conjunto de anuncios vacío. |
| PROFILE\$1NOT\$1FOUND | MediaTailor no se ha podido transcodificar el anuncio porque falta un perfil para transcodificar. Uso de un conjunto de anuncios vacío. |
| TRANSCODE\$1COMPLETED | La transcodificación de vídeo está completa. El anuncio se puede utilizar para la inserción de anuncios. |
| TRANSCODE\$1ERROR | MediaTailor se produjo un error interno durante un trabajo de transcodificación. Uso de un conjunto de anuncios vacío. |
| TRANSCODE\$1IN\$1PROGRESS | La transcodificación de vídeo está en curso. El vídeo transcodificado no está listo. Uso de un conjunto de anuncios vacío. |
## Transcodificar las propiedades de los registros
En esta sección se describen las propiedades de los registros de transcodificación.
| Propiedad | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| awsAccountId | cadena | true | El ID de AWS cuenta de la MediaTailor configuración que se utilizó para la sesión. |
| eventTimestamp | cadena | true | La fecha y la hora del evento. |
| originId | cadena | true | El nombre de la MediaTailor configuración. Esto es diferente del origen de contenido del vídeo, que también forma parte de la configuración. |
| eventType | cadena | false | El código del evento que activó este mensaje de registro. Ejemplo: TRANSCODE\$1ERROR. |
| eventDescription | cadena | false | Una breve descripción del evento que activó este mensaje de registro, proporcionada por el MediaTailor servicio. De forma predeterminada, está vacío. |
| sessionId | cadena | false | El identificador numérico único que MediaTailor se asignó a la sesión del jugador. Todas las solicitudes que un jugador realiza para una sesión tienen el mismo ID de sesión. Ejemplo: e039fd39-09f0-46b2-aca9-9871cc116cde. |
| creativeUniqueId | cadena | false | El identificador único de la creatividad publicitaria que se está transcodificando. |
| profileName | cadena | false | |
| adUri | cadena | false | El URI de la creatividad publicitaria. |
| transcodeRequestId | cadena | false | El identificador único de esta solicitud de transcodificación. |
| cacheStatus | cadena | false | Indica si se MediaTailor ha almacenado en caché el anuncio transcodificado. |
# Uso de registros vendidos para enviar registros AWS Elemental MediaTailor
Puedes usar los registros vendidos para tener mayor flexibilidad y controlar dónde entregar los registros que se MediaTailor emiten desde tu configuración de reproducción.
Con los registros vendidos, MediaTailor envía toda la actividad de registro asociada a una configuración a Amazon CloudWatch Logs. CloudWatch A continuación, Logs envía el porcentaje de registros que especifique al destino elegido. Los destinos admitidos son un grupo de CloudWatch registros de Amazon Logs, un bucket de Amazon S3 o una transmisión de Amazon Data Firehose.
Como los registros vendidos están disponibles a precios de descuento por volumen, podrías ahorrar costes en comparación con el envío de registros directamente a CloudWatch Logs. Para conocer los precios, consulta *Vended Logs* en la pestaña **Logs** de [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/).
Para utilizar los registros vendidos, debes hacer lo siguiente:
1. [Inclusión de permisos](#vended-logs-perms).
1. [Cree destinos de entrega de registros](#vended-logs-destinations).
1. [Configure la entrega de CloudWatch registros en Logs](#vended-logs-delivery).
1. [Habilita los registros vendidos MediaTailor](#vended-logs-config).
Para obtener más información sobre los registros vendidos, consulte [Habilitar el registro desde AWS los servicios](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) en la guía del usuario de CloudWatch registros. MediaTailor admite la versión 2 de registros vendidos.
## Paso 1: Añadir permisos para la entrega de MediaTailor registros
La persona que configura los registros vendidos debe tener permisos para crear el destino de entrega, configurar la entrega de registros y habilitar los registros vendidos. MediaTailor Utilice las siguientes políticas para asegurarse de tener los permisos adecuados para configurar los registros de venta.
**Políticas de CloudWatch registros y destinos de entrega**
Las siguientes secciones de la *Guía del usuario de Amazon CloudWatch Logs* proporcionan las políticas que le permiten trabajar con los registros de CloudWatch Logs y sus destinos de entrega. Si envías los registros a varias ubicaciones, puedes combinar las declaraciones de políticas en una sola política en lugar de crear varias políticas.
+ [Los registros se envían a CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs)
+ [Registros enviados a Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-S3)
+ [Registros enviados a Firehose](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-Firehose)
**Política de configuración desde la consola**
Si está configurando la entrega de registros vendidos a través de la consola en lugar de la API AWS CLI, debe tener los siguientes permisos adicionales en su política.
**Política para los inicios de sesión de Vended MediaTailor**
Para crear, ver o modificar los registros vendidos que se envían MediaTailor, debe tener los siguientes permisos en su política.
Para obtener información sobre cómo añadir permisos y trabajar con políticas, consulte[Identity and Access Management para AWS Elemental MediaTailor](security-iam.md).
## Paso 2: Crear destinos de entrega para MediaTailor los registros
Cree los recursos a los que se enviarán sus registros. Registre el ARN del recurso para usarlo en la configuración de la entrega de registros en un paso posterior.
**CloudWatch Registra el destino de entrega del grupo de registros**
Utilice una de las siguientes opciones como ayuda para crear un grupo de registros.
+ Para la consola, consulte [Crear un grupo de CloudWatch registros en Logs en](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) la *Guía del usuario de Amazon CloudWatch Logs*.
+ Para obtener información sobre la API, consulte [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)la *referencia de la API de Amazon CloudWatch Logs.*
+ Para SDKs una CLI, consulte [Uso `CreateLogGroup` con un AWS SDK o AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) en la *Guía del usuario de Amazon CloudWatch Logs*.
**Destino de entrega de cubos de Amazon S3**
Utilice una de las siguientes opciones como ayuda para crear un bucket.
+ Para la consola y la CLI, consulte [Crear un depósito](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) en la *Guía del usuario de Amazon Simple Storage Service*. SDKs
+ Para obtener información sobre la API, consulte [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)la *referencia de la API de Amazon Simple Storage Service*.
**Destino de entrega de Firehose Stream**
Para obtener ayuda para crear una transmisión, consulte [Crear una transmisión de Firehose desde la consola](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) en la Guía para desarrolladores de *Amazon Data Firehose*.
## Paso 3: Habilite los registros vendidos para la configuración de reproducción MediaTailor
Cree o actualice la configuración de reproducción que enviará los registros al destino de entrega que creó en el paso anterior. Registre el nombre de la configuración para utilizarla en la configuración de la entrega de registros en un paso posterior.
+ Para habilitar los registros vendidos a través de la consola, utilice [Creación de una configuración](configurations-create.md) o [Edición de los ajustes de configuración](configurations-edit.md) edite una configuración para acceder a los ajustes de **registro**. Para ver **las estrategias de registro**, elija **Registros vendidos.**
+ Para habilitar los registros vendidos a través de la API, debes tener una configuración existente. Se utiliza `ConfigureLogsForPlaybackConfiguration` para añadir la estrategia `Vended logs` de registro.
Si utiliza la estrategia de MediaTailor registro antigua de enviar los registros directamente a CloudWatch Logs y desea migrarlos a los registros vendidos, consulte[Migración de la estrategia de registro](vended-logs-migrate.md).
**importante**
Si cambias la estrategia de registro de Legacy CloudWatch a la de registros vendidos, MediaTailor realizará este cambio en cuanto guardes las actualizaciones. Dejará de recibir registros hasta que haya configurado completamente el registro vendido.
## Paso 4: Configurar la entrega de registros en Logs CloudWatch
En CloudWatch los registros, debe crear tres elementos para representar las partes de la entrega de registros. Estos elementos se describen en detalle [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)en la *referencia de la API de Amazon CloudWatch Logs*. Los pasos generales para configurar la entrega con la API CloudWatch Logs son los siguientes.
**Para configurar la entrega de CloudWatch registros en Logs (API)**
1. Se utiliza [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)para añadir la fuente de los registros.
A `DeliverySource` representa la configuración de reproducción que genera los registros. Necesita el nombre de la configuración de reproducción para crear la`DeliverySource`.
1. Se utiliza [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)para añadir el destino en el que se escribirán los registros.
A `DeliveryDestination` representa el destino de entrega. Necesita el ARN del grupo de registros, el depósito o la transmisión para crear el. `DeliveryDestination`
1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)Utilícelo si va a entregar registros entre cuentas.
Si el destino de entrega está en una cuenta diferente a la de la configuración de reproducción, necesitas una`DeliveryDestinationPolicy`. Esta política permite a CloudWatch Logs entregar registros a`DeliveryDestination`.
1. Se utiliza [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)para vincular el `DeliverySource` al`DeliveryDestination`.
A `Delivery` representa la conexión entre el `DeliverySource` y`DeliveryDestination`.
# Migración de su estrategia de AWS Elemental MediaTailor registro
Si cambias la estrategia de registro de registros heredados CloudWatch a registros vendidos, MediaTailor realizará este cambio en cuanto guardes las actualizaciones. Para evitar interrupciones en el flujo de trabajo de registro, siga los siguientes pasos para migrar su estrategia de registro.
1. Siga los pasos tal y como se describe en [Uso de registros vendidos](vended-logs.md). Para [Habilita los registros vendidos MediaTailor](vended-logs.md#vended-logs-config) ello, seleccione *ambas* estrategias de registro (**registros vendidos** y **tradicionales CloudWatch**).
MediaTailor enviará los registros a través de ambos registros vendidos y directamente a CloudWatch Logs.
1. Realice los cambios necesarios en su flujo de trabajo que dependan de su estrategia de registro y del destino de entrega.
1. Revise [Habilita los registros vendidos MediaTailor](vended-logs.md#vended-logs-config) y elimine el **legado CloudWatch** de las **estrategias de registro**.
# 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)
```
# Controlar el volumen de registros AWS Elemental MediaTailor
MediaTailor Los registros de las sesiones de inserción de anuncios a veces son detallados. Para reducir los costes de registro, puede definir el porcentaje de registros de sesión que se MediaTailor envía a Amazon CloudWatch Logs. Por ejemplo, si tu configuración de reproducción tiene 1000 sesiones de inserción de anuncios y estableces un valor de porcentaje habilitado de`60`, MediaTailor envía los registros de 600 de las sesiones a CloudWatch Logs. MediaTailor decide aleatoriamente para qué sesiones enviar los registros. Si desea ver los registros de una sesión específica, puede utilizar el [modo de registro de depuración](debug-log-mode.md).
Cuando estableces un porcentaje de registro, crea MediaTailor automáticamente un rol vinculado al servicio que otorga MediaTailor los permisos necesarios para escribir CloudWatch registros en tu cuenta. Para obtener información sobre cómo se MediaTailor utilizan los roles vinculados a un servicio, consulte. [Uso de roles vinculados a servicios para MediaTailor](using-service-linked-roles.md)
## Creación de una configuración de registro
Para controlar el porcentaje de registros de sesión que se MediaTailor escriben en los CloudWatch registros, debe crear una *configuración de registro* para la configuración de reproducción. Al crear una configuración de registro, se especifica un *nombre de configuración de reproducción* y un valor *porcentual activado*.
------
#### [ Console ]
**Para crear una configuración de registro para una configuración de reproducción *existente***
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 **configuración** de reproducción, selecciona la configuración de reproducción para la que quieres establecer la configuración de registro.
1. Elija **Edit (Edición de)**.
1. En **Configuración de registro**, especifique un valor **porcentual activado**.
**Para crear una configuración de registro para una *nueva* configuración de reproducción**
+ Siga el procedimiento indicado en [Configuración de registro](configurations-create.md#configurations-log-configurations).
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Para crear una configuración de registro para una configuración de reproducción *existente***
Para crear una configuración de registro mediante el AWS CLI, ejecute el comando [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) 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-playback-configuration \
--percent-enabled 10 \
--playback-configuration-name MyPlaybackConfiguration
```
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-playback-configuration ^
--percent-enabled 10 ^
--playback-configuration-name MyPlaybackConfiguration
```
Donde:
+ `percent-enabled`es el porcentaje de los registros de las sesiones de configuración de reproducción que MediaTailor se envía a Logs. CloudWatch
+ `playback-configuration-name`es el nombre de la configuración de reproducción para la que se van a establecer los ajustes de configuración del registro.
Si el comando se ejecuta correctamente, verá un resultado similar al siguiente.
```
{
"PercentEnabled": 10,
"PlaybackConfigurationName": "MyPlaybackConfiguration"
}
```
**Para crear una configuración de registro para una *nueva* configuración de reproducción**
+ Utilice la `configure-logs-for-playback-configuration` opción para el [put-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html)comando.
------
## Desactivar una configuración de registro
*Después de crear una configuración de registro, no puede eliminarla, solo puede desactivarla.* Para desactivar la configuración de registro, defina el valor del **porcentaje habilitado** en **0** con la consola o la MediaTailor API. Esto desactiva todos los registros de sesión de esa configuración de reproducción.
Si desea eliminar el rol vinculado al servicio que se MediaTailor utiliza para las configuraciones de registro de su cuenta, primero debe desactivar todas las configuraciones de registro. Para obtener información sobre cómo eliminar el rol vinculado al servicio, consulte. [Uso de roles vinculados a servicios para MediaTailor](using-service-linked-roles.md)
------
#### [ Console ]
**Para desactivar la configuración de registro en una configuración de reproducció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 **configuración de reproducción**, selecciona la configuración de reproducción en la que quieres desactivar la configuración de registro.
1. Elija **Edit (Edición de)**.
1. En **Configuración de registro**, defina el valor **del porcentaje habilitado** en. `0` Esto desactiva todo el registro de sesiones para esta configuración de reproducción.
1. Seleccione **Guardar**.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Para desactivar una configuración de registro**
+ Establezca el `percent-enabled` valor para `0` usar el comando [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html).
------
# Filtrar AWS Elemental MediaTailor registros y eventos
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
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 /v1/master///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 /v1/master///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
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).
# Generar registros de AWS Elemental MediaTailor depuración
Usa los registros de depuración para solucionar problemas relacionados con la inserción de MediaTailor anuncios y las sesiones de reproducción. Para generar registros de depuración, configura el modo de registro para que se depure cuando el reproductor lo solicite. MediaTailor *Para los informes del lado del servidor, configura el modo de registro en la solicitud de reproducción.* *Para los informes del lado del cliente, configure el modo de registro en la solicitud de inicialización de la sesión.*
Cuando el modo de registro está configurado para depurar, graba todos los tipos de eventos MediaTailor de registro en los registros. CloudWatch Los registros proporcionan información sobre los siguientes eventos. Para obtener una lista completa de los datos generados en los registros de depuración, consulte los campos del [registro de depuración](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html#debug-log-mode-fields).
+ **Interacción de origen**: detalles sobre MediaTailor las interacciones con el servidor de origen. Por ejemplo, la respuesta al manifiesto de origen, el tipo de manifiesto y la URL de origen.
+ **Manifiesto generado**: detalles sobre la respuesta de la sesión de reproducción de MediaTailor. Por ejemplo, el manifiesto que se MediaTailor genera.
+ **Sesión inicializada**: detalles de inicialización de la sesión, como el ID de la sesión.
Para personalizar los tipos de eventos de registro que recibe por sesión, consulte. [Filtrar registros y eventos](logs-filter.md)
## Requisitos previos
Para configurar el modo de registro para que se depure, primero debe conceder MediaTailor permiso para enviar los registros CloudWatch, si aún no lo ha hecho. Una vez que hayas otorgado el permiso de MediaTailor acceso CloudWatch, estarás listo para habilitar el modo de registro de depuración. Para obtener información sobre cómo conceder MediaTailor permisos de acceso, CloudWatch consulta [Configuración de permisos para Amazon CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-permissions.html).
## ¿Cómo configurar el modo de registro para que depure
En esta sección se explica cómo configurar el modo de registro para depurar los informes del lado del servidor y del lado del cliente.
### Informes del lado del servidor
Para los informes del lado del servidor, incluye el parámetro y el valor de la `?aws.logMode=DEBUG` consulta en la solicitud de `GET HTTP` reproducción del reproductor al punto final HLS o DASH. MediaTailor [Para obtener información general sobre los informes del lado del servidor, consulta los informes del lado del servidor.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-server-side.html)
**importante**
El valor `DEBUG` distingue entre mayúsculas y minúsculas.
Una solicitud de reproducción que incluye `?aws.logMode=DEBUG` tiene el siguiente aspecto:
**Example Solicitud de reproducción a un punto final HLS**
```
GET /v1/master///?aws.logMode=DEBUG
```
Después de configurar el modo de registro para depurar, le recomendamos que compruebe que la sesión de registro de depuración esté activa. Para comprobar que la sesión de depuración está activa, compruebe si hay CloudWatch registros para el ID de sesión. El ID de sesión se incluye en el punto final de reproducción que se MediaTailor proporciona. Para obtener más información, consulte [Verify that the debug log mode is active for your playback session](#debug-active).
### Informes del lado del cliente
Para los informes del lado del cliente, incluya la `logMode` clave y el `DEBUG` valor en el cuerpo de la solicitud de inicialización de la `POST HTTP` sesión del cliente en el punto final /v1/session. MediaTailor [Para obtener información general sobre los informes del lado del cliente, consulte Informes del lado del cliente.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-client-side.html)
**importante**
El valor `DEBUG` distingue entre mayúsculas y minúsculas.
Después de configurar el modo de registro para depurar, le recomendamos que compruebe que la sesión de depuración esté activa. Para comprobar que la sesión de depuración esté activa, confirme que haya un `SESSION_INITIALIZED` evento asociado al ID de sesión en los registros. CloudWatch El ID de sesión se incluye en el punto final de reproducción que se MediaTailor proporciona. Para obtener más información, consulte [Verify that the debug log mode is active for your playback session](#debug-active).
## Número máximo de sesiones de depuración activas
Puede tener un máximo de 10 sesiones de registro de depuración activas. Cuando el reproductor envía su solicitud de inicialización de sesión o reproducción a MediaTailor, MediaTailor comprueba si se ha alcanzado el límite. Si lo ha hecho, MediaTailor comprueba si hay sesiones obsoletas. Una sesión está obsoleta si no se ha accedido a ella en un período de tiempo determinado. En el caso de las transmisiones en directo, este período de tiempo es de 10 minutos y en el de VOD, de 30 minutos.
Si se ha alcanzado el límite máximo de sesiones de registro de depuración activas, los registros de depuración no se escriben en los CloudWatch registros de la sesión. Si no ves los registros de depuración en CloudWatch los registros de tu sesión, es posible que hayas alcanzado este límite. Para confirmar si se ha alcanzado el límite, consulte[Verify that the debug log mode is active for your playback session](#debug-active).
## Depurar campos de registro
La siguiente tabla muestra los campos del registro de depuración en los que se MediaTailor escribe. CloudWatch
| Campo | Description (Descripción) |
| --- | --- |
| awsAccountId | Tu Cuenta de AWS ID. |
| customerId | Tu identificador de MediaTailor cliente. |
| eventTimestamp | La marca de tiempo ISO 8601 asociada al evento del registro de depuración. |
| eventType | El tipo de evento del registro de depuración. Valores:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/mediatailor/latest/ug/debug-log-mode.html) |
| originRequestUrl | La URL del servidor de origen que se recupera para esta solicitud. |
| mediaTailorPath | El MediaTailor punto final al que se llamó, incluidos los parámetros transferidos MediaTailor en la solicitud de manifiesto inicial. |
| requestId | El ID de una solicitud HTTP específica dirigida a MediaTailor. |
| responseBody | El manifiesto del cuerpo de la respuesta de MediaTailor. Este es el manifiesto de origen bruto o el manifiesto generado por MediaTailor. |
| sessionId | El ID de la sesión de reproducción. |
| sessionType | El tipo de sesión de reproducción. Valores: `HLS`, `DASH` |
## Lea los registros de depuración
MediaTailor escribe los registros de depuración en Amazon CloudWatch Logs. Se aplican CloudWatch los cargos típicos de Logs. Use CloudWatch Insights para leer los registros de depuración. Para obtener información sobre cómo usar CloudWatch Logs Insights, consulte [Análisis de datos de registro con CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) en la *Guía del usuario de AWS CloudWatch Logs*.
**nota**
Los registros de depuración pueden tardar unos minutos en CloudWatch aparecer. Si no ve los registros, espere unos minutos e inténtelo de nuevo. Si sigue sin ver los registros, es posible que haya alcanzado el número máximo de sesiones de registro de depuración activas. Para comprobar si este es el caso, ejecuta una CloudWatch consulta para comprobar si se ha inicializado una sesión de depuración para tu sesión de reproducción. Para obtener más información, consulte [Verify that the debug log mode is active for your playback session](#debug-active).
### Ejemplos
En esta sección se incluyen ejemplos de consultas que puede utilizar para leer los datos del registro de MediaTailor depuración.
**Example 1: Compruebe que el modo de registro de depuración esté activo para la sesión de reproducción**
```
fields @timestamp, @message
| filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
| filter eventType = "SESSION_INITIALIZED" # client-side reporting
or mediaTailorPath like “/v1/master" # server-side reporting HLS
or mediaTailorPath like “/v1/dash" # server-side reporting DASH
```
**Example 2: Vea las respuestas de su origen**
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
```
**Example 3: Ver el manifiesto generado MediaTailor por una sesión determinada**
```
fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
```
**Example 4: Ver todos los eventos de una determinada `requestId`**
Utilice esta consulta para ver el manifiesto de origen y el manifiesto generado por MediaTailor.
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
```
# Monitorización AWS Elemental MediaTailor con CloudWatch métricas de Amazon
Puede monitorizar AWS Elemental MediaTailor las métricas utilizando CloudWatch. CloudWatch recopila datos sin procesar sobre el rendimiento del servicio y los procesa para convertirlos en métricas legibles y prácticamente en tiempo real. Estas estadísticas se mantienen durante 15 meses, de forma que pueda obtener acceso a información histórica y disponer de una mejor perspectiva sobre el desempeño de su aplicación web o servicio. También puede establecer alarmas que vigilen determinados umbrales y enviar notificaciones o realizar acciones cuando se cumplan dichos umbrales. Para obtener más información, consulta la [Guía del CloudWatch usuario de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
Las métricas pueden resultar útiles a la hora de investigar los manifiestos obsoletos. Para obtener más información, consulte [Uso de métricas para diagnosticar manifiestos obsoletos](stale-manifest-diagnose.md).
Las métricas se agrupan en primer lugar por el espacio de nombres de servicio y, a continuación, por las diversas combinaciones de dimensiones dentro de cada espacio de nombres.
**Para ver las métricas mediante la consola CloudWatch**
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, seleccione **Métricas**.
1. En **Todas las métricas**, selecciona el espacio de **MediaTailor**nombres.
1. Seleccione la dimensión de métrica para ver las métricas (por ejemplo, **originID**).
1. Especifique el período de tiempo que desea ver.
**Para ver las métricas con () AWS Command Line Interface AWS CLI**
+ En el símbolo del sistema, ejecute el siguiente comando:
```
aws cloudwatch list-metrics --namespace "AWS/MediaTailor"
```
## AWS Elemental MediaTailor CloudWatch métricas
El espacio de AWS Elemental MediaTailor nombres incluye las siguientes métricas. Estas métricas se publican de forma predeterminada en su cuenta.
### Métricas de Channel Assembly (CA)
En la siguiente tabla, todas las métricas están disponibles por canal o por canal de salida.
| Métrica | Description (Descripción) |
| --- | --- |
| 4xxErrorCount | El número de `4xx` errores. |
| 5xxErrorCount | El número de `5xx` errores. |
| RequestCount | El número total de solicitudes . El recuento de transacciones depende en gran medida de la frecuencia con la que los jugadores soliciten los manifiestos actualizados y del número de jugadores. Cada solicitud del reproductor se contabiliza como una transacción. |
| TotalTime | El tiempo que el servidor de aplicaciones tardó en procesar la solicitud, incluido el tiempo empleado en recibir los bytes del cliente y la red y escribirlos en ellos. |
#### Métricas de inserción de anuncios en el lado del servidor (SSAI)
En la siguiente tabla, se muestran las métricas de inserción de anuncios del lado del servidor.
| Métrica | Description (Descripción) |
| --- | --- |
| AdDecisionServer.Ads | El número de anuncios incluidos en las respuestas del servidor de decisiones publicitarias (ADS) en el período de CloudWatch tiempo que especificaste. |
| AdDecisionServer.Duration | La duración total, en milisegundos, de todos los anuncios que se MediaTailor recibieron del ADS en el período de CloudWatch tiempo que especificaste. Esta duración puede ser superior a la `Avail.Duration` que especificó. |
| AdDecisionServer.Errors | El número de respuestas con código de estado no HTTP 200, respuestas vacías y respuestas agotadas que se MediaTailor recibieron del ADS en el período de CloudWatch tiempo que especificó. |
| AdDecisionServer.FillRate | Media simple de los índices en los que las respuestas del ADS han llenado los espacios publicitarios individuales correspondientes durante el período de tiempo especificado. Para obtener la media ponderada, calcule la `AdDecisionServer.Duration` como porcentaje de la `Avail.Duration`. Para obtener más información acerca de las medias simples y ponderadas, consulte [Promedios simples y ponderados](#metrics-simple-average). |
| AdDecisionServer.Latency | El tiempo de respuesta en milisegundos de las solicitudes realizadas por el ADS MediaTailor . |
| AdDecisionServer.Timeouts | El número de solicitudes enviadas al ADS que se agotó el tiempo de espera en el período de CloudWatch tiempo que especificó. |
| AdNotReady | Número de veces que el ADS ha apuntando hacia un anuncio que el servicio de transcodificación interna todavía no ha transcodificado durante el período de tiempo que ha especificado. Un valor alto de esta métrica puede contribuir a obtener una `Avail.FillRate` general baja. |
| AdsBilled | El número de anuncios que se MediaTailor facturan a los clientes en función de su inserción. |
| Avail.Duration | El número total planificado de milisegundos de anuncios disponibles en un período de CloudWatch tiempo. El total planificado se basa en la duración de la disponibilidad de los anuncios que figuran en el manifiesto de origen. |
| Avail.FilledDuration | La cantidad planificada de milisegundos de tiempo de disponibilidad del anuncio que MediaTailor se llenará de anuncios dentro del CloudWatch período de tiempo. |
| Avail.FillRate | El promedio simple planificado de las tarifas a las que MediaTailor se publicará un anuncio individual está disponible dentro del CloudWatch período de tiempo. Para obtener la media ponderada, calcule la `Avail.FilledDuration` como porcentaje de la `Avail.Duration`. Para obtener más información acerca de las medias simples y ponderadas, consulte [Promedios simples y ponderados](#metrics-simple-average). La `Avail.FillRate` máxima que MediaTailor puede alcanzar su límite por la `AdDecisionServer.FillRate`. Si la `Avail.FillRate` es baja, compárela con la `AdDecisionServer.FillRate`. Si la `AdDecisionServer.FillRate` es baja, es posible que su ADS no devuelva suficientes anuncios para las duraciones de los espacios publicitarios. |
| Avail.Impression | El número de anuncios con eventos de seguimiento de impresiones que se MediaTailor muestran durante la señalización en el servidor (no el número de impresiones). |
| Avail.ObservedDuration | El número total observado de milisegundos de disponibilidad de anuncios que se produjeron durante el período de tiempo. CloudWatch `Avail.ObservedDuration`se emite al final de la publicación del anuncio y se basa en la duración de los segmentos que aparecen en el manifiesto durante la publicación del anuncio. |
| Avail.ObservedFilledDuration | El número observado de milisegundos de tiempo de disponibilidad del anuncio que se MediaTailor llenaron de anuncios dentro del CloudWatch período de tiempo. |
| Avail.ObservedFillRate | El promedio simple observado de las tasas de publicación de los anuncios individuales MediaTailor rellenados durante un CloudWatch período de tiempo. Se emite solo para los manifiestos HLS, en la primera `CUE-IN` etiqueta. Si no hay ninguna `CUE-IN` etiqueta, MediaTailor no emite esta métrica. |
| Avail.ObservedSlateDuration | El número total observado de milisegundos de pizarra que se insertó en el CloudWatch período. |
| GetManifest.Age | La antigüedad total del manifiesto en milisegundos. Se mide desde el momento en que el origen crea el manifiesto hasta el momento en que MediaTailor envía el manifiesto personalizado. Para obtener más información sobre las métricas para medir la antigüedad del manifiesto, consulte[Uso de métricas para diagnosticar manifiestos obsoletos](stale-manifest-diagnose.md). |
| GetManifest.Errors | El número de errores recibidos al MediaTailor generar los manifiestos en el período de CloudWatch tiempo que especificó. |
| GetManifest.Latency | El tiempo de MediaTailor respuesta en milisegundos de la solicitud para generar manifiestos. Para obtener más información sobre las métricas para medir la antigüedad del manifiesto, consulte[Uso de métricas para diagnosticar manifiestos obsoletos](stale-manifest-diagnose.md). |
| GetManifest.MediaTailorAge | La cantidad de tiempo que se ha almacenado el manifiesto MediaTailor en milisegundos. Se mide desde que se MediaTailor recibe una respuesta de origen hasta que se MediaTailor envía el manifiesto personalizado. Para obtener más información sobre las métricas para medir la antigüedad del manifiesto, consulte[Uso de métricas para diagnosticar manifiestos obsoletos](stale-manifest-diagnose.md). |
| Origin.Age | La cantidad de tiempo que el origen tiene el manifiesto en milisegundos. Se mide desde el momento en que el origen crea el manifiesto hasta el momento en que MediaTailor envía la solicitud de origen. Todas `origin.*` las métricas se emiten para las solicitudes que se gestionan directamente desde el origen. No se emiten para las respuestas de origen almacenadas en caché. Para obtener más información sobre las métricas para medir la antigüedad del manifiesto, consulte[Uso de métricas para diagnosticar manifiestos obsoletos](stale-manifest-diagnose.md). |
| Origin.Errors | El número de respuestas con código de estado distintas del HTTP 200 y de respuestas que han agotado el tiempo de espera y que se MediaTailor han recibido del servidor de origen en el período de CloudWatch tiempo que especificó. Todas las `origin.*` métricas se emiten para las solicitudes que se gestionan directamente desde el origen. No se emiten para las respuestas de origen almacenadas en caché. |
| Origin.ManifestFileSizeBytes | El tamaño del archivo del manifiesto de origen en bytes tanto para HLS como para DASH. Por lo general, esta métrica se usa junto con`Origin.ManifestFileSizeTooLarge`. Todas `origin.*` las métricas se emiten para las solicitudes que se gestionan directamente desde el origen. No se emiten para las respuestas de origen almacenadas en caché. |
| Origin.ManifestFileSizeTooLarge | El número de respuestas del origen que tienen un tamaño de manifiesto superior a la cantidad configurada. Por lo general, esta métrica se usa junto con`Origin.ManifestFileSizeBytes`. Todas `origin.*` las métricas se emiten para las solicitudes que se gestionan directamente desde el origen. No se emiten para las respuestas de origen almacenadas en caché. |
| Origin.Timeouts | El número de solicitudes enviadas al servidor de origen que han agotado el tiempo de espera en el período de CloudWatch tiempo que especificó. Todas `origin.*` las métricas se emiten para las solicitudes que se gestionan directamente desde el origen. No se emiten para las respuestas de origen almacenadas en caché. |
| Requests | El número de transacciones simultáneas por segundo en todos los tipos de solicitudes. El recuento de transacciones depende principalmente del número de jugadores y de la frecuencia con la que los jugadores solicitan manifiestos actualizados. Cada solicitud del reproductor se contabiliza como una transacción. |
| SkippedReason.DurationExceeded | El número de anuncios que no se insertaron fue válido porque el ADS devolvió una duración de los anuncios superior a la duración de disponibilidad especificada. Un valor alto para esta métrica podría contribuir a crear una discrepancia entre la `Avail.Ads` métrica y. `AdDecisionServer.Ads` Para obtener más información sobre los motivos por los que se omite un anuncio, consulte. [Solución de problemas de omisión de anuncios](troubleshooting-ad-skipping-overview.md) |
| SkippedReason.EarlyCueIn | El número de anuncios omitidos debido a una publicación temprana. `CUE-IN` |
| SkippedReason.ImportError | El número de anuncios omitidos debido a un error en el trabajo de importación. |
| SkippedReason.ImportInProgress | El número de anuncios omitidos debido a un trabajo de importación activo existente. |
| SkippedReason.InternalError | El número de anuncios omitidos debido a un error MediaTailor interno. |
| SkippedReason.NewCreative | El número de anuncios que no se insertaron fue útil porque era la primera vez que un cliente solicitaba el activo. Un valor alto para esta métrica podría contribuir temporalmente a un valor global bajo`Avail.FillRate`, hasta que los activos se puedan transcodificar correctamente. |
| SkippedReason.NoVariantMatch | El número de anuncios omitidos debido a que no hay ninguna variante que coincida entre el anuncio y el contenido. |
| SkippedReason.PersonalizationThresholdExceeded | La duración de los anuncios que superen el **umbral de personalización establecido** en esta configuración. |
| SkippedReason.ProfileNotFound | El número de anuncios omitidos debido a que no se encontró el perfil de transcodificación. |
| SkippedReason.TranscodeError | El número de anuncios omitidos debido a un error de transcodificación. |
| SkippedReason.TranscodeInProgress | El recuento del número de anuncios que no se insertaron fue válido porque el anuncio aún no se había transcodificado. Un valor alto para esta métrica podría contribuir temporalmente a un valor global bajo`Avail.FillRate`, hasta que los activos se puedan transcodificar correctamente. |
| GetAssets.Requests | El número de solicitudes de listas de activos recibidas para las sesiones de HLS Interstitials durante el período de tiempo. CloudWatch Utilice esta métrica para supervisar el volumen de toma de decisiones sobre anuncios de encuadernación tardía y comprender la magnitud del uso de HLS Interstitials. |
| GetAssets.Latency | El tiempo de respuesta de las solicitudes de listas de activos en milisegundos para las sesiones de HLS Interstitials. Supervisa esta métrica para garantizar un rendimiento óptimo en la toma de decisiones sobre anuncios e identifica los posibles obstáculos en el flujo de trabajo de encuadernación tardía. |
**nota**
En las sesiones de HLS Interstitials, algunas métricas se comportan de forma diferente debido al carácter tardío de la toma de decisiones sobre anuncios:
`Avail.ObservedFilledDuration`coincide`Avail.FilledDuration`, ya que no se puede observar el comportamiento real de reproducción del lado del cliente. MediaTailor
`Avail.ObservedSlateDuration`informa sobre la duración planificada de la lista a partir de las respuestas a la lista de activos y no de la reproducción observada.
Las métricas con el prefijo «Observado» proporcionan valores estimados para las sesiones de HLS Interstitials.
### Promedios simples y ponderados
Puedes recuperar el promedio simple y el promedio ponderado de las respuestas de la ADS a las solicitudes de anuncios MediaTailor y de cómo MediaTailor rellena la disponibilidad de anuncios:
+ Las *medias simples* se proporcionan en `AdDecisionServer.FillRate` y `Avail.FillRate`. Estas son las medias de los porcentajes del índice de relleno de los espacios publicitarios individuales durante el período de tiempo especificado. Las medias simples no tienen en cuenta las diferencias entre las duraciones de los distintos espacios publicitarios.
+ Las *medias ponderadas* son los porcentajes del índice de relleno del total de las duraciones de todos los espacios publicitarios. Se calcula como (`AdDecisionServer.Duration`\$1 100)/`Avail.Duration` y (`Avail.FilledDuration`\$1 100)/`Avail.Duration`. Estas medias reflejan las diferencias entre las duraciones de cada espacio publicitario. De este modo, se da más importancia a las que duran más.
Para un periodo de tiempo que contiene tan solo un espacio publicitario, la media simple proporcionada por `AdDecisionServer.FillRate` es igual a la media ponderada proporcionada por (`AdDecisionServer.Duration`\$1 100)/`Avail.Duration`. La media simple proporcionada por `Avail.FillRate` es igual a la media ponderada proporcionada por (`Avail.FilledDuration`\$1 100)/`Avail.Duration`.
**Ejemplo**
Supongamos que el período de tiempo que ha especificado tiene los dos siguientes espacios publicitarios:
+ El primer espacio publicitario tiene una duración de 90 segundos:
+ La respuesta del ADS para el espacio publicitario proporciona 45 segundos de anuncios (50 % lleno).
+ MediaTailor ocupa 45 segundos del tiempo de anuncio disponible (rellena el 50%).
+ El segundo espacio publicitario tiene una duración de 120 segundos:
+ La respuesta del ADS para el espacio publicitario proporciona 120 segundos de anuncios (100 % lleno).
+ MediaTailor ocupa 90 segundos del tiempo de anuncio disponible (ocupa el 75%).
Las métricas son las siguientes:
+ `Avail.Duration` equivale a 210, que es la suma de las dos duraciones de los espacios publicitarios: 90 \$1 120.
+ `AdDecisionServer.Duration` equivale a 165, que es la suma de las dos duraciones de respuesta: 45 \$1 120.
+ `Avail.FilledDuration` equivale a 135, que es la suma de las dos duraciones llenas: 45 \$1 90.
+ `AdDecisionServer.FillRate` equivale al 75 %, que es la media de los porcentajes llenos de cada espacio publicitario: (50 % \$1 100 %) / 2. Esta es la media simple.
+ La media ponderada de los índices de relleno del ADS es de 78,57 %, que equivale a `AdDecisionServer.Duration` como porcentaje de `Avail.Duration`: (165\$1100) / 210. Este cálculo tiene en cuenta las diferencias de las duraciones.
+ `Avail.FillRate` equivale al 62,5 %, que es la media de los porcentajes llenados de cada espacio publicitario: (50 % \$1 75 %) / 2. Esta es la media simple.
+ La media ponderada de las tasas MediaTailor de ocupación disponibles es del 64,29%, que es el `Avail.FilledDuration` porcentaje de`Avail.Duration`: (135\$1100)/210. Este cálculo tiene en cuenta las diferencias de las duraciones.
El máximo `Avail.FillRate` que se MediaTailor puede alcanzar con un anuncio disponible es del 100%. El ADS puede devolver más tiempo de anuncios del disponible en el espacio publicitario, pero solo MediaTailor puede rellenar todo el tiempo disponible.
## AWS Elemental MediaTailor CloudWatch dimensiones
Puede filtrar los AWS Elemental MediaTailor datos mediante la siguiente dimensión.
| Dimensión | Description (Descripción) |
| --- | --- |
| `Configuration Name` | Indica la configuración a la que pertenece la métrica. |
# Uso de métricas para diagnosticar manifiestos obsoletos desde AWS Elemental MediaTailor
Un manifiesto obsoleto es aquel que no se ha actualizado recientemente. Los distintos flujos de trabajo de inserción de anuncios pueden tener diferentes tolerancias en cuanto al tiempo que debe transcurrir antes de que un manifiesto se considere obsoleto, en función de diversos factores (como los requisitos de los sistemas posteriores). Puedes usar CloudWatch las métricas de Amazon para identificar los manifiestos que superen la tolerancia de estancamiento de tu flujo de trabajo y ayudar a identificar qué podría estar causando los retrasos en las actualizaciones de los manifiestos.
Las siguientes métricas ayudan a identificar los manifiestos obsoletos y sus causas.
Para obtener información sobre todas las métricas que se MediaTailor emiten, consulte. [AWS Elemental MediaTailor CloudWatch métricas](monitoring-cloudwatch-metrics.md#metrics)
| Métrica | Definición | Uso |
| --- | --- | --- |
| GetManifest.Age | Mide la antigüedad total del manifiesto, incluidos ambos `GetManifest.MediaTailorAge` y `Origin.Age` para esta configuración. | Puedes usar esta métrica para identificar los manifiestos que han superado el umbral de actualización y están obsoletos. Configura alarmas en esta métrica para que recibas alertas cuando se publiquen manifiestos obsoletos. Para obtener información sobre las alarmas, consulta [Alarmar en las métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) en la *Guía del CloudWatch usuario de Amazon.* Cuando recibas una alarma, utiliza `Origin.Age` y `GetManifest.MediaTailorAge` para identificar MediaTailor si el origen es el causante del bloqueo. |
| Origin.Age | Mide cuánto tiempo tiene el origen el manifiesto antes de enviarlo MediaTailor para esta configuración.Esta métrica no se emite cuando la respuesta proviene de una red de entrega de contenido (CDN). La respuesta debe provenir del origen `Origin.Age` para que se emita. | Al identificar los manifiestos obsoletos`GetManifest.Age`, puede analizar la `Origin.Age` métrica y la `GetManifest.MediaTailorAge` métrica para determinar qué es lo que contribuye a la obsolescencia manifiesta. Si descubres que los tiempos de procesamiento en el origen `Origin.Age` son más largos que los habituales, es probable que el problema se deba al sistema original, por lo que deberías centrar el diagnóstico allí. |
| GetManifest.MediaTailorAge | Mide cuánto tiempo MediaTailor ha almacenado este manifiesto para esta configuración. | Al identificar los manifiestos obsoletos`GetManifest.Age`, puede analizar la `GetManifest.MediaTailorAge` métrica y la `Origin.Age` métrica para determinar qué es lo que contribuye a la obsolescencia manifiesta. Si tarda más de lo habitual en personalizar un manifiesto MediaTailor, `GetManifest.MediaTailorAge` es probable que sea la causa del problema, por lo que MediaTailor deberías centrar los diagnósticos en ese aspecto. `GetManifest.Latency`puede identificar con más detalle cuánto tiempo se tarda en MediaTailor crear un manifiesto personalizado. |
| GetManifest.Latency | Mide el tiempo que se tarda en MediaTailor procesar la solicitud y crear un manifiesto personalizado para esta configuración. | Cuando comparas `Origin.Age` `GetManifest.MediaTailorAge` y determinas que esa MediaTailor es la causa del retraso en la entrega del manifiesto, puedes analizar la `GetManifest.Latency` métrica para determinar si el proceso de personalización del manifiesto contribuye a que el manifiesto quede obsoleto. `GetManifest.MediaTailorAge`mide el tiempo total durante el que se almacena el manifiesto. MediaTailor `GetManifest.Latency`mide cuánto tiempo de almacenamiento se utiliza para MediaTailor personalizar el manifiesto en respuesta a una solicitud. |
# Grabación de llamadas a AWS Elemental MediaTailor la API
AWS Elemental MediaTailor está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o un AWS servicio en MediaTailor. CloudTrail captura todas las llamadas a la API MediaTailor como eventos. Las llamadas capturadas incluyen llamadas desde la MediaTailor consola y llamadas en código a las operaciones de la MediaTailor API. Si crea una ruta, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos para MediaTailor. Si no configura una ruta, podrá ver los eventos más recientes en la CloudTrail consola, en el **historial de eventos**. Con la información recopilada por usted CloudTrail, puede determinar el destinatario de la solicitud MediaTailor, la dirección IP desde la que se realizó la solicitud, quién la realizó, cuándo se realizó y detalles adicionales.
Para obtener más información CloudTrail, consulte la [Guía AWS CloudTrail del usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## AWS Elemental MediaTailor información en CloudTrail
CloudTrail está habilitada en su AWS cuenta al crear la cuenta. Cuando se produce una actividad en AWS Elemental MediaTailor, esa actividad se registra en un CloudTrail evento junto con otros eventos de AWS servicio en el **historial de eventos**. Puedes ver, buscar y descargar los eventos recientes en tu AWS cuenta. Para obtener más información, consulta Cómo [ver eventos con el historial de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Para tener un registro continuo de los eventos de tu AWS cuenta, incluidos los eventos de tu cuenta AWS Elemental MediaTailor, crea una ruta. Un *rastro* permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando crea una ruta en la consola, la ruta se aplica a todas AWS las regiones. La ruta registra los eventos de todas las regiones de la AWS partición y envía los archivos de registro al bucket de Amazon S3 que especifique. Además, puede configurar otros AWS servicios para analizar más a fondo los datos de eventos recopilados en los CloudTrail registros y actuar en función de ellos. Para obtener más información, consulte los siguientes temas:
+ [Crear una ruta para tu AWS cuenta](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [AWS integraciones de servicios con registros CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configuración de las notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Recibir archivos de CloudTrail registro de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [recibir archivos de CloudTrail registro de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Todas AWS Elemental MediaTailor las acciones se registran CloudTrail y se documentan en la [referencia de la AWS Elemental MediaTailor API](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html). Por ejemplo, las llamadas a las operaciones `PutPlaybackConfiguration` y `ListPlaybackConfigurations` generan entradas en los archivos de registro de CloudTrail.
Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente:
+ Si la solicitud se realizó con el usuario raíz o con las credenciales AWS Identity and Access Management (de IAM)
+ si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado
+ Si la solicitud la realizó otro servicio AWS
Para obtener más información, consulte [Elemento userIdentity de CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Descripción de las entradas de los archivos de AWS Elemental MediaTailor registro
Un rastro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una única solicitud de cualquier origen e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etcétera. Los archivos de registro de CloudTrail no son un rastro de la pila ordenada de las llamadas a la API públicas, por lo que no aparecen en ningún orden específico.
El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la `PutPlaybackConfiguration` acción:
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:53:46Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "PutPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename",
"AdDecisionServerUrl": "http://exampleads.com"
},
"responseElements": {
"SessionInitializationEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/session/AKIAIOSFODNN7EXAMPLE/examplename/",
"DashConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/examplename/",
"MpdLocation": "EMT_DEFAULT"
},
"AdDecisionServerUrl": "http://exampleads.com",
"CdnConfiguration": {},
"PlaybackEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com",
"HlsConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/examplename/"
},
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename"
},
"requestID": "1a2b3c4d-1234-5678-1234-1a2b3c4d5e6f",
"eventID": "987abc65-1a2b-3c4d-5d6e-987abc654def",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la `GetPlaybackConfiguration` acción:
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:52:37Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "GetPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"Name": "examplename"
},
"responseElements": null,
"requestID": "0z1y2x3w-0123-4567-9876-6q7r8s9t0u1v",
"eventID": "888ddd77-3322-eeww-uuii-abc123jkl343",
"readOnly": true,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
# Recibir alertas AWS Elemental MediaTailor de ensamblaje de canales
MediaTailor crea alertas sobre los problemas o posibles problemas que se produzcan con los recursos de ensamblaje de su canal. La alerta describe el problema, cuándo se produjo y los recursos afectados.
Puede ver las alertas en Consola de administración de AWS, the AWS Command Line Interface (AWS CLI) o mediante programación mediante la MediaTailor [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API. AWS SDKs
**importante**
Las alertas solo están disponibles para los recursos de ensamblaje de canales creados a partir del 14 de julio de 2021.
**Alertas de ensamblaje de canales**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/mediatailor/latest/ug/channel-assembly-alerts.html)
## Solución de problemas de alertas relacionadas con manifiestos
Cuando encuentres alertas relacionadas con un manifiesto`UNPARSABLE_MANIFEST`, como, o `VARIANT_DURATION_MISMATCH``TARGET_DURATION_MISMATCH`, comprueba lo siguiente:
1. **Verifica los requisitos de la fuente**: asegúrate de que tu contenido cumpla los requisitos descritos en[Integración de una fuente de contenido para la inserción de MediaTailor anuncios](integrating-origin.md).
1. **Compruebe los registros de los manifiestos**: para obtener un análisis detallado de los errores de los manifiestos y los tipos de eventos, consulte[AWS Elemental MediaTailor los registros de manifiesto, la descripción y los tipos de eventos](log-types.md).
1. **Compruebe los códigos de error**: para obtener un análisis detallado de los errores, consulte[Solución de problemas MediaTailor](troubleshooting.md).
1. **Revisa el formato del manifiesto**: comprueba que el manifiesto sigue las especificaciones de formato correctas para tu protocolo de streaming (HLS o DASH).
## Visualización de alertas
Puede ver las alertas de cualquier recurso MediaTailor de ensamblaje de canales. Al ver las alertas de los canales y programas, MediaTailor incluye todos los recursos relacionados contenidos en el canal o programa. Por ejemplo, cuando ve las alertas de un programa específico, también ve las alertas de la ubicación de origen y las fuentes de VOD que contiene el programa.
Para ver las alertas, lleve a cabo el siguiente procedimiento.
------
#### [ Console ]
**Para ver las alertas en la consola**
1. Abra la MediaTailor consola en [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Elija el recurso del que desee ver las alertas.
1. Seleccione la pestaña **Alertas** para ver las alertas.
------
#### [ AWS Command Line Interface (AWS CLI) ]
Para enumerar las alertas de un recurso de ensamblaje de canales, necesita el [nombre de recurso de Amazon (ARN) del recurso](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html). Puede usar el `describe-resource_type` comando de AWS Command Line Interface (AWS CLI) para obtener el ARN del recurso. Por ejemplo, ejecute el comando [describe-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/describe-channel.html) para obtener el ARN de un canal específico:
```
aws mediatailor describe-channel --channel-name MyChannelName
```
A continuación, utilice el comando [aws mediatailor list-alerts para enumerar las alertas asociadas](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/list-alerts.html) al recurso:
```
aws mediatailor list-alerts --resource-arn arn:aws:mediatailor:region:aws-account-id:resource-type/resource-name
```
------
#### [ API ]
Para enumerar las alertas de un recurso de ensamblaje de canales, necesita el [nombre de recurso de Amazon (ARN) del recurso](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html). Puedes usar la `DescribeResource` operación en la MediaTailor API para obtener el ARN del recurso. Por ejemplo, utilice la [DescribeChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeChannel.html)operación para obtener el ARN de un canal específico.
A continuación, utilice la [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API para enumerar las alertas del recurso.
------
## Gestión de alertas
Cuando se produzca una alerta, visualícelas en la Consola de administración de AWS API de alertas o utilice la AWS Command Line Interface (AWS CLI) o la API de MediaTailor alertas para determinar las posibles fuentes del problema. AWS SDKs
Tras resolver el problema, MediaTailor borra la alerta.
# Etiquetado AWS Elemental MediaTailor de recursos
Una *etiqueta* es una etiqueta de metadatos que se asigna o que se AWS asigna a un AWS recurso. Cada etiqueta consta de una *clave* y un *valor*. En el caso de etiquetas que usted asigna, debe definir la clave y el valor. Por ejemplo, puede definir la clave como `stage` y el valor de un recurso como `test`.
Las etiquetas lo ayudan a hacer lo siguiente:
+ Identifique y organice sus AWS recursos. Muchos AWS servicios admiten el etiquetado, por lo que puede asignar la misma etiqueta a los recursos de diferentes servicios para indicar que los recursos están relacionados. Por ejemplo, puede asignar la misma etiqueta a un AWS Elemental MediaPackage canal y un punto final que a una AWS Elemental MediaTailor configuración.
+ Realice un seguimiento de sus AWS costes. Estas etiquetas se activan en el Administración de facturación y costos de AWS panel de control. AWS utiliza las etiquetas para clasificar los costes y entregarle un informe mensual de asignación de costes. Para obtener más información, consulte [Uso de etiquetas de asignación](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la [guía del usuario de AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Controle el acceso a sus AWS recursos. Para obtener más información, consulte [Control del acceso mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la [Guía del usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html).
En las siguientes secciones se proporciona más información sobre las etiquetas para AWS Elemental MediaTailor.
## Recursos compatibles en AWS Elemental MediaTailor
Los siguientes recursos AWS Elemental MediaTailor admiten el etiquetado:
+ Canales
+ Configuraciones
+ SourceLocations
+ VodSources
## Restricciones de las etiquetas
Las siguientes restricciones básicas se aplican a las etiquetas de los AWS Elemental MediaTailor recursos:
+ Cantidad máxima de etiquetas que puede asignar a un recurso: 50
+ Longitud máxima de la clave: 128 caracteres Unicode.
+ Longitud máxima del valor: 256 caracteres Unicode.
+ Caracteres válidos para claves y valores: a-z, A-Z, 0-9, espacio y los siguientes caracteres: \$1 . : / = \$1 - y @
+ Las claves y los valores distinguen entre mayúsculas y minúsculas
+ No utilice `aws:` como prefijo para claves, ya que su uso está reservado a AWS.
## Administrar etiquetas en AWS Elemental MediaTailor
Puede establecer etiquetas como propiedades en un recurso. Puedes añadir, editar y eliminar etiquetas a través de la AWS Elemental MediaTailor API o del AWS Command Line Interface (AWS CLI). Para obtener más información, consulte la [referencia de la API AWS Elemental MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html).
# Supervisión de AWS los servicios multimedia con el monitor de flujo de trabajo
El monitor de flujo de trabajo es una herramienta para el descubrimiento, la visualización y el monitoreo de AWS los flujos de trabajo de los medios. El monitor de flujo de trabajo está disponible en la AWS consola y en la API. Se puede usar para descubrir y crear mapeos visuales de los recursos del flujo de trabajo, denominados *mapas de señales*. Puede crear y gestionar plantillas de CloudWatch alarmas y EventBridge reglas de Amazon para supervisar los recursos mapeados. Las plantillas de monitoreo que cree se transforman en AWS CloudFormation plantillas desplegables para permitir la repetibilidad. AWS Las plantillas de alarma recomendadas proporcionan una supervisión predefinida basada en las mejores prácticas.
**Descubrimiento**
Utilice los mapas de señales para descubrir automáticamente AWS los recursos interconectados asociados a su flujo de trabajo multimedia. El descubrimiento puede comenzar en cualquier recurso de servicio compatible y crea un end-to-end mapeo del flujo de trabajo. Los mapas de señales se pueden usar como herramientas de visualización independientes o mejorarse con plantillas de supervisión.
![\[Componentes de descubrimiento del monitor de flujo de trabajo.\]](http://docs.aws.amazon.com/es_es/mediatailor/latest/ug/images/workflowmonitor-discovery.png)
**Monitorización**
Puede crear plantillas personalizadas de CloudWatch alarmas y EventBridge reglas para supervisar el estado y el estado de sus flujos de trabajo multimedia. Hay plantillas de prácticas recomendadas sobre las alarmas para importarlas a su entorno de monitor de flujo de trabajo. Puede utilizar esas plantillas tal cual o bien editarlas para adaptarlas mejor a su flujo de trabajo. Todas las plantillas que cree se transforman en plantillas de CloudFormation para poder implementarlas de forma repetida.
![\[Componentes de supervisión del monitor de flujo de trabajo.\]](http://docs.aws.amazon.com/es_es/mediatailor/latest/ug/images/workflowmonitor-monitoring.png)
**nota**
El uso del monitor de flujo de trabajo no conlleva ningún costo directo. Sin embargo, hay costos asociados a los recursos que se crean y utilizan para supervisar el flujo de trabajo.
Cuando se implementa la supervisión, se crean Amazon CloudWatch y EventBridge los recursos de Amazon. Al utilizar la consola AWS de administración, antes de implementar la supervisión en un mapa de señales, se le notificará cuántos recursos se crearán. Para obtener más información sobre los precios, consulte: [CloudWatchprecios](https://aws.amazon.com/cloudwatch/pricing/) y [EventBridge precios](https://aws.amazon.com/eventbridge/pricing/).
El monitor de flujo de trabajo utiliza AWS CloudFormation plantillas para implementar los EventBridge recursos CloudWatch y. Estas plantillas se almacenan en un bucket de Amazon Simple Storage Service de clase estándar que el monitor del flujo de trabajo crea en su nombre durante el proceso de implementación y generarán cargos por almacenamiento y recuperación de objetos. Para obtener más información acerca de los precios, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).
Las vistas previas generadas en el mapa de señales de AWS Elemental MediaPackage los canales del monitor de flujo de trabajo se envían desde el punto final de MediaPackage Origin y conllevan gastos de transferencia de datos. Para conocer los precios, consulte: [MediaPackageprecios](https://aws.amazon.com/mediapackage/pricing/).
## Componentes del monitor de flujo de trabajo
El monitor de flujo de trabajo tiene cuatro componentes principales:
+ CloudWatch plantillas de alarmas: defina las condiciones que le gustaría monitorear CloudWatch. Puede crear sus propias plantillas de alarmas o importar plantillas predefinidas creadas por AWS. Para obtener más información, consulte: [CloudWatch grupos de alarmas y plantillas para supervisar su AWS flujo de trabajo multimedia](monitor-with-workflow-monitor-configure-alarms.md)
+ EventBridge plantillas de reglas: EventBridge defina cómo se envían las notificaciones cuando se activa una alarma. Para obtener más información, consulte: [EventBridge grupos de reglas y plantillas para supervisar el flujo de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-notifications.md)
+ Mapas de señales: utilice un proceso automatizado para crear mapas de flujo de trabajo de AWS Elemental utilizando AWS los recursos existentes. Los mapas de señales se pueden usar para descubrir recursos en el flujo de trabajo e implementar la supervisión de estos. Para obtener más información, consulte [Mapas de señales del monitor de flujo de trabajo](monitor-with-workflow-monitor-configure-signal-maps.md).
+ Información general: la página de información general permite supervisar directamente el estado de varios mapas de señales de una ubicación. Revise las métricas, los registros y las alarmas de los flujos de trabajo. Para obtener más información, consulte [Información general del monitor de flujo de trabajo](monitor-with-workflow-monitor-operate-overview.md).
## Servicios admitidos
El monitor de flujo de trabajo admite el descubrimiento automático y el mapeo de señales de los recursos asociados a los siguientes servicios:
+ AWS Elemental MediaConnect
+ AWS Elemental MediaLive
+ AWS Elemental MediaPackage
+ AWS Elemental MediaTailor
+ Amazon S3
+ Amazon CloudFront
**Topics**
+ [Componentes del monitor de flujo de trabajo](#monitor-with-workflow-monitor-components)
+ [Servicios admitidos](#monitor-with-workflow-monitor-supported-services)
+ [Configuración del monitor de flujo de trabajo para monitorear AWS los servicios multimedia](monitor-with-workflow-monitor-configure.md)
+ [Uso del monitor de flujo de trabajo](monitor-with-workflow-monitor-operate.md)
# Configuración del monitor de flujo de trabajo para monitorear AWS los servicios multimedia
Para configurar por primera vez el monitor de flujo de trabajo, debe crear las plantillas de alarmas y de eventos y descubrir los mapas de señales que se utilizan para supervisar sus flujos de trabajo multimedia. La siguiente guía contiene los pasos necesarios para configurar los roles de IAM de nivel de administrador y de operador, crear recursos del monitor de flujo de trabajo e implementar la supervisión en sus flujos de este tipo.
**Topics**
+ [Introducción al monitor de flujo de trabajo](monitor-with-workflow-monitor-configure-getting-started.md)
+ [Grupos y plantillas del monitor de flujo de trabajo](monitor-with-workflow-monitor-configure-templates.md)
+ [Mapas de señales del monitor de flujo de trabajo](monitor-with-workflow-monitor-configure-signal-maps.md)
+ [Cuotas del monitor de flujo de trabajo](monitor-with-workflow-monitor-configure-quotas.md)
# Introducción al monitor de flujo de trabajo
En los pasos siguientes se ofrece información general básica sobre el uso del monitor de flujo de trabajo por primera vez.
1. Configurar los permisos de IAM para los roles de administrador y operador en el monitor de flujo de trabajo: [Políticas de IAM del monitor de flujo de trabajo](monitor-with-workflow-monitor-configure-getting-started-IAM.md)
1. Cree plantillas de alarmas o importe plantillas predefinidas creadas por AWS: [Alarmas de CloudWatch](monitor-with-workflow-monitor-configure-alarms.md)
1. Cree eventos de notificación que serán entregados por EventBridge: [EventBridge reglas ](monitor-with-workflow-monitor-configure-notifications.md)
1. Descubre mapas de señales con tus recursos AWS elementales existentes: [Mapas de señales ](monitor-with-workflow-monitor-configure-signal-maps.md)
1. Adjuntar las plantillas de alarmas y las reglas de notificación al mapa de señales: [Cómo adjuntar plantillas](monitor-with-workflow-monitor-configure-signal-maps-attach.md)
1. Implementar las plantillas para comenzar a supervisar el mapa de señales: [Implementación de plantillas de supervisión](monitor-with-workflow-monitor-configure-deploy.md)
1. Usar la sección de información general de la consola de AWS para supervisar y revisar los recursos del monitor de flujo de trabajo: [Descripción general de ](monitor-with-workflow-monitor-operate-overview.md)
![\[Los pasos individuales para configurar el monitor de flujo de trabajo. Para comenzar, cree los roles de IAM. A continuación, cree plantillas para las alarmas y los eventos. Después, descubra un mapa de señales y adjunte las plantillas al mapa. Una vez que se adjunten plantillas a un mapa de señales, estas deben implementarse. El último paso consiste en supervisar mediante las plantillas y los recursos de información general.\]](http://docs.aws.amazon.com/es_es/mediatailor/latest/ug/images/workflowmonitor-overview-steps.png)
# Políticas de IAM del monitor de flujo de trabajo
El monitor de flujo de trabajo interactúa con varios AWS servicios para crear mapas de señales, crear EventBridge recursos CloudWatch y CloudFormation plantillas. Dado que el monitor de flujo de trabajo interactúa con una amplia gama de servicios, se deben asignar políticas AWS Identity and Access Management (IAM) específicas para estos servicios. En los siguientes ejemplos se indican las políticas de IAM necesarias para los roles de IAM de administrador y operador.
## Política de IAM de administrador
A continuación, se muestra un ejemplo de política de IAM de monitor de flujo de trabajo para administradores. Este rol permite crear y gestionar los recursos del monitor de flujo de trabajo y de los servicios compatibles que interactúan con este monitor.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:List*",
"cloudwatch:Describe*",
"cloudwatch:Get*",
"cloudwatch:PutAnomalyDetector",
"cloudwatch:PutMetricData",
"cloudwatch:PutMetricAlarm",
"cloudwatch:PutCompositeAlarm",
"cloudwatch:PutDashboard",
"cloudwatch:DeleteAlarms",
"cloudwatch:DeleteAnomalyDetector",
"cloudwatch:DeleteDashboards",
"cloudwatch:TagResource",
"cloudwatch:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudformation:List*",
"cloudformation:Describe*",
"cloudformation:CreateStack",
"cloudformation:UpdateStack",
"cloudformation:DeleteStack",
"cloudformation:TagResource",
"cloudformation:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudfront:List*",
"cloudfront:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ec2:DescribeNetworkInterfaces"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"events:List*",
"events:Describe*",
"events:CreateEventBus",
"events:PutRule",
"events:PutTargets",
"events:EnableRule",
"events:DisableRule",
"events:DeleteRule",
"events:RemoveTargets",
"events:TagResource",
"events:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"logs:Describe*",
"logs:Get*",
"logs:TagLogGroup",
"logs:TagResource",
"logs:UntagLogGroup",
"logs:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediaconnect:List*",
"mediaconnect:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"medialive:*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage:List*",
"mediapackage:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackagev2:List*",
"mediapackagev2:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage-vod:List*",
"mediapackage-vod:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediatailor:List*",
"mediatailor:Describe*",
"mediatailor:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"resource-groups:ListGroups",
"resource-groups:GetGroup",
"resource-groups:GetTags",
"resource-groups:GetGroupQuery",
"resource-groups:GetGroupConfiguration",
"resource-groups:CreateGroup",
"resource-groups:UngroupResources",
"resource-groups:GroupResources",
"resource-groups:DeleteGroup",
"resource-groups:UpdateGroupQuery",
"resource-groups:UpdateGroup",
"resource-groups:Tag",
"resource-groups:Untag"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"s3:*"
],
"Resource": "arn:aws:s3:::workflow-monitor-templates*"
},
{
"Effect": "Allow",
"Action": [
"sns:TagResource",
"sns:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"tag:Get*",
"tag:Describe*",
"tag:TagResources",
"tag:UntagResources"
],
"Resource": "*"
}
]
}
```
------
## Política de IAM de operador
A continuación, se muestra un ejemplo de política de IAM de monitor de flujo de trabajo para operadores. Este rol permite el acceso limitado y de solo lectura a los recursos del monitor de flujo de trabajo y de los servicios compatibles que interactúan con este monitor.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:List*",
"cloudwatch:Describe*",
"cloudwatch:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudformation:List*",
"cloudformation:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudfront:List*",
"cloudfront:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ec2:DescribeNetworkInterfaces"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"events:List*",
"events:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"logs:Describe*",
"logs:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediaconnect:List*",
"mediaconnect:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"medialive:List*",
"medialive:Get*",
"medialive:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage:List*",
"mediapackage:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackagev2:List*",
"mediapackagev2:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage-vod:List*",
"mediapackage-vod:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediatailor:List*",
"mediatailor:Describe*",
"mediatailor:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": "arn:aws:s3:::workflow-monitor-templates*"
},
{
"Effect": "Allow",
"Action": [
"tag:Get*",
"tag:Describe*"
],
"Resource": "*"
}
]
}
```
------
# Grupos y plantillas del monitor de flujo de trabajo
Antes de poder implementar la supervisión del flujo de trabajo en un mapa de señales, debe crear los grupos y las plantillas para CloudWatch las alarmas y EventBridge notificaciones. Las CloudWatch plantillas definen qué escenarios y umbrales se utilizarán para activar las alarmas. Las EventBridge plantillas determinarán cómo se le notifican estas alarmas.
Si solo desea mapear los recursos conectados y no quiere utilizar las funciones de plantilla de supervisión del monitor de flujo de trabajo, puede utilizar los mapas de señales sin CloudWatch plantillas. EventBridge Para obtener más información sobre el uso de los mapas de señales, consulte [Mapas de señales ](monitor-with-workflow-monitor-configure-signal-maps.md).
**Topics**
+ [CloudWatch grupos de alarmas y plantillas para supervisar su AWS flujo de trabajo multimedia](monitor-with-workflow-monitor-configure-alarms.md)
+ [EventBridge grupos de reglas y plantillas para supervisar el flujo de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-notifications.md)
# CloudWatch grupos de alarmas y plantillas para supervisar su AWS flujo de trabajo multimedia
Las alarmas del monitor de flujo de trabajo le permiten utilizar CloudWatch las métricas existentes como base de las alarmas para sus mapas de señales. Puede crear un grupo de plantillas de alarma para ordenar y clasificar los tipos de alarmas que son importantes para el flujo de trabajo. Dentro de cada grupo de plantillas de alarmas, puede crear plantillas de alarmas con CloudWatch métricas y parámetros específicos que desee supervisar. Puede crear sus propias plantillas de alarma o importar las plantillas de alarma recomendadas creadas por AWS. Tras crear un grupo de plantillas de alarmas y las plantillas correspondientes incluidas en ese grupo, puede adjuntar uno o varios de estos grupos de plantillas de alarmas a un mapa de señales.
Primero debe crear un grupo de plantillas de alarmas. Una vez creado un grupo de plantillas de alarmas, puede crear sus propias plantillas o utilizar las plantillas recomendadas creadas por AWS. Si quiere crear sus propias plantillas de alarmas, continúe en esta página. Para obtener más información sobre cómo importar plantillas recomendadas, consulte [Plantillas recomendadas](monitor-with-workflow-monitor-configure-alarms-recommended-templates.md).
En esta sección se describe la creación de CloudWatch alarmas mediante el monitor de flujo de trabajo. Para obtener más información sobre cómo gestiona el CloudWatch servicio las alarmas y detalles de los componentes de las alarmas, consulta: [Uso de CloudWatch alarmas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) en la *Guía del CloudWatch usuario de Amazon*
## Creación de grupos de plantillas de alarmas
Los grupos de plantillas de alarmas permiten ordenar y clasificar los tipos de alarmas que son importantes para el flujo de trabajo.
**Cómo crear un grupo de plantillas de alarmas**
1. En el panel de navegación de la consola del monitor de flujo de trabajo, seleccione **las plantillas de CloudWatch alarmas**.
1. Seleccione **Crear grupo de plantillas de alarmas**.
1. Asigne a este un **Nombre del grupo** único y una **Descripción** opcional.
1. Seleccione **Crear**. Se le dirigirá a la página de detalles del grupo de plantillas de alarmas recién creado.
## Creación de plantillas de alarmas
Puede crear plantillas de alarmas con las CloudWatch métricas y los parámetros que desee supervisar.
**Cómo crear una plantilla de alarma**
1. En la página de detalles del grupo de plantillas de alarmas, seleccione **Crear plantilla de alarma**.
1. Asigne a esta un **Nombre de plantilla** único y una **Descripción** opcional.
1. En la sección **Elegir una métrica**:
1. Seleccione un **Tipo de recurso objetivo**. El tipo de recurso de destino es un recurso para el servicio respectivo, como un canal para MediaLive MediaPackage y/o un flujo para MediaConnect.
1. Seleccione un **Nombre de métrica**. Esta es la CloudWatch métrica que sirve de base para la alarma. La lista de métricas cambiará en función del **Tipo de recurso objetivo** seleccionado.
1. En la sección **Ajustes de alarmas**:
**nota**
Para obtener más información sobre cómo gestiona el CloudWatch servicio las alarmas y detalles de los componentes de las alarmas, consulta: [Uso de CloudWatch alarmas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) en la *Guía del CloudWatch usuario de Amazon*
1. Seleccione un elemento en **Estadística**. Se trata de un valor, como una **Suma** o un **Promedio**, que se usará para supervisar la métrica.
1. Seleccione el **Operador de comparación**. Este campo hace referencia al **Umbral** que se establece en el siguiente paso.
1. Defina un **Umbral**. Se trata de un valor numérico que el **Operador de comparación** utiliza para determinar que el estado es mayor que, menor que o igual que.
1. Establezca un **Periodo**. Se trata de un valor temporal en segundos. El **Periodo** es el tiempo durante el que interactúan la **Estadística**, el **Operador de comparación** y el **Umbral** para determinar si se activa la alarma.
1. Configure los **Puntos de datos**. Este valor determina cuántos puntos de datos son necesarios para activar la alarma.
1. Seleccione cómo **Tratar los datos faltantes**. Esta opción determina cómo reacciona la alarma ante la falta de datos.
1. Elija **Crear** para completar el proceso.
Un ejemplo de plantilla de alarma completa podría tener los siguientes parámetros: Se monitorea un **tipo de recurso objetivo** de MediaConnect flujo para determinar el **nombre de la métrica** de desconexiones. El valor de **Estadística** está establecido en Suma con un **Operador de comparación** de “mayor o igual que” y un **Umbral** de 10. El **Periodo** está establecido en 60 segundos y solo requiere 1 de 1 **punto de datos**. La opción **Tratar los datos faltantes** está establecida en “ignorar”.
El resultado de esta configuración es que el monitor de flujo de trabajo supervisará las desconexiones del flujo. Si se producen 10 o más desconexiones en un plazo de 60 segundos, la alarma se activará. Basta con que se produzcan 10 o más desconexiones en 60 segundos una sola vez para que la alarma se active.
# Plantillas de alarma recomendadas para supervisar el flujo de trabajo AWS multimedia
Las plantillas recomendadas por el monitor de flujo de trabajo son una selección selecta de métricas de servicio de AWS Elemental con ajustes de alarma predefinidos adecuados para cada métrica. Si no desea crear plantillas de alarmas personalizadas, las plantillas recomendadas le proporcionan las mejores prácticas de supervisión creadas por AWS.
El monitor de flujo de trabajo contiene grupos de plantillas recomendadas para cada servicio compatible. Estos grupos están diseñados para aplicar supervisión basada en prácticas recomendadas a tipos específicos de flujos de trabajo. Cada grupo de plantillas contiene una cuidada selección de alarmas configuradas a partir de métricas específicas del servicio. Por ejemplo, un grupo de plantillas recomendado para un flujo de trabajo MediaLive multiplex tendrá un conjunto de métricas preconfiguradas diferente al de un flujo de trabajo de CDI. MediaConnect
**Cómo usar las plantillas de alarmas recomendadas**
1. Siga los pasos para [crear un grupo de plantillas de alarmas](monitor-with-workflow-monitor-configure-alarms.md#monitor-with-workflow-monitor-alarms-groups-create) o seleccione uno existente.
1. En la sección **Plantillas de alarma**, seleccione **Importar**. Deberá importar las plantillas recomendadas de AWS a su grupo de plantillas.
1. Usa el menú desplegable de **grupos de plantillas de CloudWatch alarmas** para seleccionar un grupo recomendado. AWS Estos grupos contienen alarmas seleccionadas para servicios específicos.
1. Seleccione las plantillas que quiera importar mediante las casillas de verificación. Cada plantilla enumerará sus métricas y valores de supervisión preconfigurados, además de proporcionar una descripción de la métrica. Cuando haya terminado de seleccionar las plantillas, seleccione el botón **Agregar**.
1. Las plantillas seleccionadas se pasarán a la sección **Plantillas de alarma a importar**. Revise sus opciones y seleccione **Importar**.
1. Una vez finalizada la importación, las plantillas seleccionadas se agregarán al grupo de plantillas. Si quiere agregar más plantillas, repita el proceso de importación.
1. Las plantillas importadas pueden personalizarse tras la importación. La configuración de la alarma se puede modificar para adaptarla a sus necesidades correspondientes.
# EventBridge grupos de reglas y plantillas para supervisar el flujo de trabajo AWS multimedia
CloudWatch usa EventBridge las reglas de Amazon para enviar notificaciones. Comience por crear un grupo de plantillas de eventos. En ese grupo de plantillas de eventos, se van a crear plantillas de eventos que determinen las condiciones que crean una notificación y a quién se notifica.
En esta sección se describe la creación de EventBridge reglas mediante el monitor de flujo de trabajo. Para obtener más información sobre cómo el EventBridge servicio usa las reglas, consulta: [EventBridge reglas](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) en la *Guía del EventBridge usuario de Amazon*
## Creación de grupos de plantillas de eventos
Los grupos de plantillas de eventos permiten ordenar y clasificar los eventos en función de su caso de uso.
**Cómo crear un grupo de plantillas de eventos**
1. En el panel de navegación de la consola del monitor de flujo de trabajo, seleccione **las plantillas de EventBridge reglas**.
1. Seleccione **Crear grupo de plantillas de eventos**.
1. Asigne a este un **Nombre del grupo** único y una **Descripción** opcional.
1. Seleccione **Crear**. Se le dirigirá a la página de detalles del grupo de plantillas de alarmas recién creado.
## Creación de plantillas de eventos
Puede enviar notificaciones basadas en las plantillas de eventos que cree.
**Cómo crear una plantilla de evento**
1. En la página de detalles del grupo de plantillas de eventos, seleccione **Crear plantilla de evento**.
1. Asigne a esta un **Nombre de plantilla** único y una **Descripción** opcional.
1. En la sección **Ajustes de reglas**:
1. Seleccione un **Tipo de evento**. Al seleccionar un tipo de evento, puede elegir entre varios eventos creados por una **alarma activa AWS o seleccionar Signal map active alarm** para usar una alarma creada por una plantilla de alarma.
1. Seleccione un **Servicio objetivo**. Esto determina cómo quiere que se le notifique este evento. Puedes seleccionar Amazon Simple Notification Service o CloudWatch registros.
1. Después de seleccionar un servicio objetivo, seleccione un **Objetivo**. Será un tema de Amazon SNS o un grupo de CloudWatch registros, según el servicio de destino que selecciones.
1. Elija **Crear** para completar el proceso.
# Mapas de señales del monitor de flujo de trabajo
Los mapas de Signal son mapeos visuales de los AWS recursos de su flujo de trabajo multimedia. Puede usar el monitor de flujo de trabajo para iniciar el descubrimiento de mapas de señales en cualquiera de los tipos de recursos admitidos. Durante el proceso de descubrimiento, el monitor de flujo de trabajo mapeará de forma automática y recursiva todos los recursos conectados. AWS Una vez creado el mapa de señales, puede usar la consola del monitor de flujo de trabajo para realizar tareas como implementar plantillas de supervisión, ver las métricas y observar los detalles de los recursos asignados.
**Topics**
+ [Creación de mapas de señales para flujos de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-signal-maps-create.md)
+ [Visualización de mapas de señales de flujos de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-signal-maps-view.md)
+ [Adjuntar plantillas de alarmas y eventos al mapa de señales de su flujo de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-signal-maps-attach.md)
+ [Implementación de plantillas en el mapa de señales de su flujo de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-deploy.md)
+ [Actualización del mapa de señales de su flujo de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-signal-maps-update.md)
+ [Eliminar el mapa de señales de su flujo de trabajo AWS multimedia](monitor-with-workflow-monitor-configure-signal-maps-delete.md)
# Creación de mapas de señales para flujos de trabajo AWS multimedia
Puede utilizar los mapas de señales del monitor de flujo de trabajo para crear un mapeo visual de todos los AWS recursos conectados en su flujo de trabajo multimedia.
**Cómo crear un mapa de señales**
1. En el panel de navegación de la consola del monitor de flujo de trabajo, seleccione **Mapas de señales**.
1. Seleccione **Crear mapa de señales**.
1. Asigne un **Nombre** y una **Descripción** al mapa de señales.
1. En la sección **Descubra un nuevo mapa de señales** se muestran los recursos de la cuenta actual y de la región seleccionada. Seleccione un recurso para iniciar el descubrimiento de mapas de señales. El recurso seleccionado será el punto de partida del descubrimiento.
1. Seleccione **Crear**. Espere unos instantes para que se complete el proceso de descubrimiento. Una vez que el proceso se haya completado, se le presentará el nuevo mapa de señales.
**nota**
Las vistas previas generadas en el mapa de señales del monitor de flujo de trabajo para los AWS Elemental MediaPackage canales se envían desde el punto final de MediaPackage Origin y conllevan gastos de transferencia de datos. Para conocer los precios, consulte: [MediaPackageprecios](https://aws.amazon.com/mediapackage/pricing/).
# Visualización de mapas de señales de flujos de trabajo AWS multimedia
Los mapas de señales del monitor de flujo de trabajo le permiten ver un mapeo visual de todos los AWS recursos conectados en su flujo de trabajo multimedia.
**Vistas de los mapas de señales**
Tras seleccionar un mapa de señales, dispone de dos vistas que se pueden utilizar para supervisar o configurar ese mapa. **Supervisar el mapa de señales** y **Configurar mapa de señales** es un botón contextual que se encuentra en la parte superior derecha de la sección de la consola del mapa de señales.
Si usa la sección **Mapas de señales** del panel de navegación para seleccionar su mapa correspondiente, dicho mapa se mostrará en la vista de configuración. La vista de configuración permite realizar cambios en los grupos de plantillas adjuntos a este mapa de señales, implementar las plantillas adjuntas, así como ver las etiquetas y los detalles básicos del mapa en cuestión.
Si usa la sección **Información general** del panel de navegación para seleccionar su mapa de señales, dicho mapa se mostrará en la vista de supervisión. La vista de monitoreo muestra las CloudWatch alarmas, EventBridge reglas, alertas, registros y métricas de este mapa de señales.
La vista se puede cambiar en cualquier momento; para ello, seleccione el botón **Supervisar el/Configurar mapa de señales** en la parte superior derecha. La vista de configuración requiere permisos de IAM de nivel de administrador. Los permisos de IAM necesarios pueden verse aquí: [Políticas de IAM del monitor de flujo de trabajo](monitor-with-workflow-monitor-configure-getting-started-IAM.md)
**Navegación por el mapa de señales**
Un mapa de señales contiene los nodos de todos los recursos de AWS compatibles que haya descubierto el monitor de flujo de trabajo. Algunos recursos, como los MediaLive canales y los MediaPackage puntos finales, pueden mostrar vistas previas en miniatura del contenido, si las vistas previas en miniatura están disponibles.
Si selecciona un nodo de recursos y la opción **Ver los detalles del recurso seleccionado** en el menú desplegable **Acciones**, accederá a la página de detalles del servicio asociado. Por ejemplo, si seleccionas un MediaLive canal y seleccionas **Ver los detalles del recurso seleccionado**, se abrirá la página de detalles de la MediaLive consola para ese canal.
Al seleccionar un nodo de recursos, se filtrará la lista de alarmas activas solo para ese nodo. Si selecciona el valor **ARN objetivo** del recurso en la alarma activa, se le dirigirá a la página de detalles del servicio asociado, con el recurso seleccionado abierto.
# Adjuntar plantillas de alarmas y eventos al mapa de señales de su flujo de trabajo AWS multimedia
Una vez que haya creado las plantillas de alarmas y eventos, debe adjuntarlas a un mapa de señales. Todas las plantillas de alarmas y eventos que haya creado pueden adjuntarse a cualquier mapa de señales descubierto.
**Cómo adjuntar plantillas de alarmas y eventos al mapa de señales**
1. En el panel de navegación de la consola del monitor de flujo de trabajo, seleccione **Mapas de señales** y elija el mapa de este tipo con el que quiere trabajar.
1. En la parte superior derecha de la página del mapa de señales, en la pestaña de grupos de **plantillas de CloudWatch alarmas, selecciona Adjuntar grupos** **de plantillas de CloudWatch alarmas**.
1. En la nueva sección que se abre, elija todos los grupos de plantillas de alarmas que quiera aplicar a este mapa de señales y, a continuación, seleccione **Agregar**. Esto hará que los grupos de plantillas de alarma seleccionados pasen a la sección Grupos de **plantillas de CloudWatch alarmas adjuntos**.
1. Si selecciona **Guardar**, se guardarán los cambios y se le devolverá a la página del mapa de señales.
1. A la derecha de la página del mapa de señales, seleccione la pestaña de **grupos de plantillas de EventBridge reglas** y, a continuación, seleccione **Adjuntar grupos de plantillas de EventBridge reglas**.
1. En la nueva sección que se abre, elija todos los grupos de plantillas de eventos que quiera aplicar a este mapa de señales y, a continuación, seleccione **Agregar**. Esto hará que los grupos de plantillas de reglas seleccionados pasen a la sección de **grupos de plantillas de EventBridge reglas adjuntos**.
1. Si selecciona **Guardar**, se guardarán los cambios y se le devolverá a la página del mapa de señales.
1. Ha asignado plantillas de CloudWatch alarmas y EventBridge reglas al mapa de señales, pero la supervisión aún no está implementada. En la siguiente sección, se abordará la implementación de los recursos de supervisión.
# Implementación de plantillas en el mapa de señales de su flujo de trabajo AWS multimedia
Una vez que haya adjuntado las plantillas de alarmas y eventos al mapa de señales, debe implementar la supervisión. Hasta que no se complete la implementación, la supervisión del mapa de señales no estará activa.
El monitor de flujo de trabajo solo implementará las alarmas que sean pertinentes para el mapa de señales seleccionado. Por ejemplo, el grupo de plantillas de alarmas adjunto puede contener alarmas para varios servicios MediaLive, como MediaPackage, y MediaConnect. Si el mapa de señales seleccionado solo contiene MediaLive recursos, no se desplegará ninguna MediaConnect alarma MediaPackage o no se desplegará ninguna alarma.
**Cómo implementar las plantillas de supervisión**
1. Después de adjuntar los grupos de plantillas de alarmas y eventos al mapa de señales y guardar los cambios, seleccione **Implementar el monitor** en el menú desplegable **Acciones**.
1. Se le pedirá que confirme el despliegue y se le mostrará la cantidad CloudWatch y EventBridge los recursos que se crearán. Si quiere continuar, seleccione **Implementar**.
**nota**
El uso del monitor de flujo de trabajo no conlleva ningún costo directo. Sin embargo, hay costos asociados a los recursos que se crean y utilizan para supervisar el flujo de trabajo.
Cuando se implementa la supervisión, se crean Amazon CloudWatch y EventBridge los recursos de Amazon. Al utilizar la consola AWS de administración, antes de implementar la supervisión en un mapa de señales, se le notificará cuántos recursos se crearán. Para obtener más información sobre los precios, consulte: [CloudWatchprecios](https://aws.amazon.com/cloudwatch/pricing/) y [EventBridge precios](https://aws.amazon.com/eventbridge/pricing/).
El monitor de flujo de trabajo utiliza AWS CloudFormation plantillas para implementar los EventBridge recursos CloudWatch y. Estas plantillas se almacenan en un bucket de Amazon Simple Storage Service de clase estándar que el monitor del flujo de trabajo crea en su nombre durante el proceso de implementación y generarán cargos por almacenamiento y recuperación de objetos. Para obtener más información acerca de los precios, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).
1. El estado de la implementación aparece junto al nombre del mapa de señales. El estado del despliegue también está visible en la sección **Stacks** de la CloudFormation consola. Después de la creación e implementación de los recursos, comenzará la supervisión del mapa de señales en breve.
# Actualización del mapa de señales de su flujo de trabajo AWS multimedia
Si se realiza algún cambio en el flujo de trabajo, puede que tenga que redescubrir el mapa de señales e implementar de nuevo los recursos de supervisión. El monitor de flujo de trabajo es una herramienta de visualización y supervisión que no tiene la capacidad de realizar ningún cambio en el flujo de trabajo. Los mapas de señales representan una point-in-time visualización de su flujo de trabajo. En caso de que agregue, elimine o modifique significativamente algunas partes del flujo de trabajo multimedia, le recomendamos que redescubra el mapa de señales. Si tiene recursos de supervisión adjuntos al mapa de señales, le recomendamos que vuelva a implementar la supervisión tras el proceso de redescubrimiento.
**Cómo redescubrir un mapa de señales**
1. En el panel de navegación de la consola del monitor de flujo de trabajo, seleccione **Mapas de señales** y elija el mapa de este tipo con el que quiere trabajar.
1. Compruebe que se encuentra en la vista **Configurar mapa de señales**. Para obtener más información acerca de cómo cambiar las vistas, consulte [Visualización de mapas de señales ](monitor-with-workflow-monitor-configure-signal-maps-view.md).
1. En la parte superior derecha de la página del mapa de señales, seleccione el menú desplegable **Acciones**. Seleccione **Redescubrir**.
1. Aparece la pantalla de redescubrimiento. Seleccione un recurso que forme parte del flujo de trabajo que va a redescubrir. Seleccione el botón **Redescubrir**.
1. El mapa de señales se volverá a crear de acuerdo con el flujo de trabajo actual. Si necesita volver a implementar los recursos de supervisión, permanezca en la página de este mapa de señales. Todas las plantillas de supervisión adjuntas anteriormente seguirán estándolo, pero deben volver a implementarse.
**Cómo volver a implementar las plantillas de supervisión después del redescubrimiento de un mapa de señales**
1. Tras el redescubrimiento, se le dirigirá al mapa de señales actualizado. Para volver a implementar las plantillas de supervisión, seleccione **Implementar el monitor** en el menú desplegable **Acciones**.
1. Se le pedirá que confirme el despliegue y se le indicará el número CloudWatch y EventBridge los recursos que se crearán. Si quiere continuar, seleccione **Implementar**.
1. El estado de la implementación aparece junto al nombre del mapa de señales. Después de la creación e implementación de los recursos, comenzará la supervisión del mapa de señales en breve.
# Eliminar el mapa de señales de su flujo de trabajo AWS multimedia
Si ya no necesita un mapa de señales, puede eliminarlo. Si tiene plantillas de monitoreo desplegadas en el mapa de señales, el proceso de eliminación le pedirá que elimine todas las plantillas CloudWatch y EventBridge los recursos que se hayan desplegado en este mapa de señales. La eliminación de los recursos implementados no afecta a las plantillas que los han creado. Esta eliminación de recursos es para garantizar que no tenga CloudWatch EventBridge recursos desplegados pero no utilizados.
**Cómo eliminar un mapa de señales**
1. En el panel de navegación de la consola del monitor de flujo de trabajo, elija **Mapas de señales** y seleccione el botón de opción situado junto al mapa de este tipo que quiere eliminar.
1. Seleccione el botón **Eliminar**. Se le pedirá que confirme la eliminación de los recursos de supervisión. Seleccione **Eliminar** para iniciar el proceso de eliminación de los recursos de supervisión.
1. La columna **Implementación de monitor** mostrará el estado actual. Cuando el estado haya cambiado a **DELETE\$1COMPLETE**, vuelva a seleccionar el botón **Eliminar**.
1. Se le pedirá que confirme la eliminación del mapa de señales. Seleccione **Eliminar** para continuar y eliminar el mapa de señales.
# Cuotas del monitor de flujo de trabajo
La siguiente sección contiene las cuotas para los recursos del monitor de flujo de trabajo. Cada cuota se establece “por cuenta”. Si necesita aumentar una cuota para su cuenta, puede utilizar la [consola AWS Service Quotas](https://console.aws.amazon.com/servicequotas/home) para solicitar un aumento, a menos que se indique lo contrario en la tabla siguiente.
**Cuotas**
| Tipo de recurso | Cuota |
| --- | --- |
| CloudWatch grupos de plantillas de alarmas | 20 |
| CloudWatch plantillas de alarmas | 200 |
| EventBridge grupos de plantillas de reglas | 20 |
| EventBridge plantillas de reglas | 200 |
| Mapas de señales | 30 |
| Mapas de señales: grupos de plantillas de CloudWatch alarmas adjuntos a un único mapa de señales | 5No se puede aumentar esta cuota. |
| Mapas de señales: grupos de plantillas de EventBridge reglas adjuntos a un único mapa de señales | 5No se puede aumentar esta cuota. |
# Uso del monitor de flujo de trabajo
Use las secciones de **información general** y **mapas de señales** de la consola del monitor de flujo de trabajo para revisar el estado actual de los flujos de trabajo y cualquier alarma, métrica y registro asociados.
**Topics**
+ [Información general del monitor de flujo de trabajo](monitor-with-workflow-monitor-operate-overview.md)
+ [Registros y métricas de información general para el monitor de flujo de trabajo](monitor-with-workflow-monitor-operate-logs-metrics.md)
+ [Uso de mapas de señales del monitor de flujo de trabajo](monitor-with-workflow-monitor-operate-signal-maps.md)
# Información general del monitor de flujo de trabajo
La sección de **descripción general** de la consola del monitor del flujo de trabajo es un panel que proporciona at-a-glance información sobre los mapas de señales. En la sección de información general, puede ver el estado actual de la monitorización de cada mapa de señales, así como CloudWatch las métricas y CloudWatch los registros asociados. Puede seleccionar cualquier mapa de señales para ir a la página de la consola del mapa en cuestión.
**Filtrado de la información general**
Use la barra de **búsqueda** de la sección de información general para filtrar la lista de mapas de señales con restricciones contextuales. Tras seleccionar la barra de búsqueda, aparece una lista de **Propiedades** por las que puede filtrar. Al seleccionar una propiedad, aparecen **Operadores** como Es igual a, Contiene, No es igual a y No contiene. Al seleccionar un operador, se crea una lista de recursos a partir del tipo de propiedad seleccionado. Al seleccionar uno de estos recursos, la lista de mapas de señales solo mostrará aquellos que se ajusten a la restricción definida.
# Registros y métricas de información general para el monitor de flujo de trabajo
Para ver CloudWatch las métricas y los registros de un mapa de señales, selecciona el botón de radio situado junto al nombre del mapa de señales. Debajo de la lista de mapas de señales aparece una interfaz con pestañas para las métricas y los registros.
**CloudWatch Métricas**
CloudWatch las métricas del mapa de señales seleccionado dependerán del contexto y solo mostrarán las métricas asociadas a los servicios utilizados en el flujo de trabajo de ese mapa de señales. Puede usar las herramientas de métricas en pantalla para personalizar los periodos e intervalos de tiempo de las métricas que se muestran.
**CloudWatch Registros**
Si asoció un grupo de CloudWatch registros al mapa de señales, ese grupo se mostrará aquí.
# Uso de mapas de señales del monitor de flujo de trabajo
En la sección de **información general** de la consola, puede seleccionar un mapa de señales específico para ver más información sobre este y los recursos de supervisión adjuntos.
Tras seleccionar un mapa de señales, aparecerá el mapa de señales y una serie de secciones con pestañas que contienen más información:
+ CloudWatch alarmas
+ EventBridge reglas
+ AWS Alertas elementales
+ Métricas
+ Registros
+ Detalles básicos
**Navegación por el mapa de señales**
Un mapa de señales contiene los nodos de todos los recursos de AWS compatibles que haya descubierto el monitor de flujo de trabajo. Algunos recursos, como los MediaLive canales y los MediaPackage terminales, pueden mostrar vistas previas en miniatura del contenido, si están disponibles.
Si selecciona un nodo de recursos y la opción **Ver los detalles del recurso seleccionado** en el menú desplegable **Acciones**, accederá a la página de detalles del servicio asociado. Por ejemplo, si seleccionas un MediaLive canal y seleccionas **Ver los detalles del recurso seleccionado**, se abrirá la página de detalles de la MediaLive consola para ese canal.
Al seleccionar un nodo de recursos, se filtrará la lista de alarmas activas solo para ese nodo. Si selecciona el valor **ARN objetivo** del recurso en la alarma activa, se le dirigirá a la página de detalles del servicio asociado, con el recurso seleccionado abierto.