Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Ressources de surveillance et de balisage AWS Elemental MediaTailor La surveillance joue un rôle important dans le maintien de la fiabilité, de la disponibilité AWS Elemental MediaTailor et des performances de vos autres AWS solutions. AWS fournit les outils de surveillance suivants pour surveiller MediaTailor, signaler tout problème et prendre des mesures automatiques le cas échéant : + *Amazon CloudWatch* surveille vos AWS ressources et les applications que vous utilisez AWS en temps réel. Vous pouvez collecter et suivre les métriques, créer des tableaux de bord personnalisés, et définir des alarmes qui vous informent ou prennent des mesures lorsqu’une métrique spécifique atteint un seuil que vous spécifiez. Par exemple, vous pouvez CloudWatch suivre l'utilisation du processeur ou d'autres indicateurs de vos instances Amazon EC2 et lancer automatiquement de nouvelles instances en cas de besoin. Pour plus d'informations, consultez le [guide de CloudWatch l'utilisateur Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). + *Amazon CloudWatch Logs* vous permet de surveiller, de stocker et d'accéder à vos fichiers journaux à partir de toutes les interactions avec votre serveur de décision publicitaire (ADS). AWS Elemental MediaTailor émet des journaux pour les demandes publicitaires, les redirections, les réponses et les demandes de rapports et réponses. Des erreurs provenant de l'ADS et des serveurs d'origine sont également transmises aux groupes de journaux sur Amazon CloudWatch. MediaTailor fournit également des informations sur les publicités ignorées et les raisons pour lesquelles elles ont été ignorées. Pour de plus amples informations, veuillez consulter [Résolution des problèmes liés au non-respect des publicités](troubleshooting-ad-skipping-overview.md). Vous pouvez également archiver vos données de journaux dans une solution de stockage hautement durable. Pour obtenir des informations générales, consultez le [guide de l'utilisateur Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). Pour plus d'informations sur les journaux ADS et sur la manière d'y accéder à des fins d'analyse via Amazon CloudWatch Logs Insights, consultez[AWS Elemental MediaTailor Analyse des journaux ADS dans Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md). **Topics** + [Affichage des AWS Elemental MediaTailor journaux](monitoring-through-logs.md) + [Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon](monitoring-cloudwatch-metrics.md) + [Enregistrement des appels AWS Elemental MediaTailor d'API](logging-using-cloudtrail.md) + [Réception d'alertes d'assemblage de AWS Elemental MediaTailor canaux](channel-assembly-alerts.md) + [Ressources de balisage AWS Elemental MediaTailor](tagging.md) + [Surveillance des services AWS multimédias avec un moniteur de flux de travail](monitor-with-workflow-monitor.md) # Affichage des AWS Elemental MediaTailor journaux MediaTailor émet des journaux qui décrivent une variété de jalons et d'activités dans les chaînes et les configurations de lecture. Vous pouvez utiliser ces journaux pour avoir une meilleure visibilité sur votre flux de travail et pour résoudre les problèmes liés au service. Les rubriques suivantes décrivent les journaux et les options de journalisation. **Topics** + [journaux ADS](ads-log-format.md) + [Journaux du manifeste](log-types.md) + [Journaux de transcodage](tm-log-format.md) + [Utilisation des journaux vendus](vended-logs.md) + [Écrire des journaux dans des CloudWatch journaux](monitoring-cw-logs.md) + [Contrôle du volume des journaux des sessions d'insertion de publicités](log-configuration.md) + [Filtrage des journaux et des événements](logs-filter.md) + [Génération de journaux de débogage](debug-log-mode.md) # AWS Elemental MediaTailor Description des journaux ADS et types d'événements Les sections suivantes décrivent les journaux émis pour décrire les MediaTailor événements liés au serveur de décision publicitaire (ADS). Ce sont `AdDecisionServerInteractions` des journaux. **Topics** + [Événements AdDecisionServerInteractions](#log-types-adsinteraction) + [Description du journal ADS](#ads-log-description) + [Schéma JSON du journal ADS](#ads-log-json-schema) ## Événements AdDecisionServerInteractions Les événements suivants sont émis lors des MediaTailor interactions avec le serveur de décision publicitaire (ADS). | Journal | Description | | --- | --- | | AD\$1MARKER\$1FOUND | MediaTailor J'ai trouvé un marqueur publicitaire dans le manifeste. | | BEACON\$1FIRED | Une balise de suivi a été déclenchée pour signaler des événements publicitaires. En mode de rapport côté serveur (par défaut), MediaTailor déclenche la balise. En mode de rapport côté client, le périphérique de lecture déclenche la balise. | | EMPTY\$1VAST\$1RESPONSE | L'ADS a renvoyé une réponse VAST vide ne contenant aucune publicité. | | EMPTY\$1VMAP\$1RESPONSE | L'ADS a renvoyé une réponse VMAP vide. | | ERROR\$1ADS\$1INVALID\$1RESPONSE | L'ADS a renvoyé un code de statut autre que 200. | | ERROR\$1ADS\$1IO | MediaTailor a rencontré une erreur lors de la tentative de communication avec l'ADS. | | ERROR\$1ADS\$1RESPONSE\$1PARSE | MediaTailor a rencontré une erreur lors de l'analyse de la réponse ADS. | | ERROR\$1ADS\$1RESPONSE\$1UNKNOWN\$1ROOT\$1ELEMENT | La réponse ADS contient un élément racine non valide. | | ERROR\$1ADS\$1TIMEOUT | La MediaTailor demande adressée à l'ADS a expiré. | | ERROR\$1DISALLOWED\$1HOST | L'hôte ADS n'est pas autorisé. | | ERROR\$1FIRING\$1BEACON\$1FAILED | MediaTailor n'a pas réussi à déclencher la balise de repérage. | | ERROR\$1PERSONALIZATION\$1DISABLED | L'insertion d'annonces est désactivée pour cette session. | | ERROR\$1UNKNOWN | MediaTailor a rencontré une erreur inconnue lors de la demande ADS. | | ERROR\$1UNKNOWN\$1HOST | L'hôte ADS est inconnu. | | ERROR\$1VAST\$1INVALID\$1MEDIA\$1FILE | Le VAST Ad contient un MediaFile élément non valide ou manquant. | | ERROR\$1VAST\$1INVALID\$1VAST\$1AD\$1TAG\$1URI | La réponse VAST contient une valeur non valideVASTAdTagURI. | | ERROR\$1VAST\$1MISSING\$1CREATIVES | Le Ad VAST contient zéro ou plusieurs Creatives éléments. Un seul Creatives élément est requis. | | ERROR\$1VAST\$1MISSING\$1IMPRESSION | Le VAST Ad ne contient aucun Impression élément. Au moins un Impression élément est requis. | | ERROR\$1VAST\$1MISSING\$1MEDIAFILES | Le Ad VAST contient zéro ou plusieurs MediaFiles éléments. Un seul MediaFiles élément est requis. | | ERROR\$1VAST\$1MISSING\$1OVERLAYS | MediaTailor je n'ai reçu aucune création non linéaire de la part du serveur publicitaire. | | ERROR\$1VAST\$1MULTIPLE\$1LINEAR | Le Ad VAST contient plusieurs Linear éléments. | | ERROR\$1VAST\$1MULTIPLE\$1TRACKING\$1EVENTS | Le Ad VAST contient plusieurs TrackingEvents éléments. | | ERROR\$1VAST\$1REDIRECT\$1EMPTY\$1RESPONSE | La demande de redirection VAST a renvoyé une réponse vide. | | ERROR\$1VAST\$1REDIRECT\$1FAILED | La demande de redirection VAST a rencontré une erreur. | | ERROR\$1VAST\$1REDIRECT\$1MULTIPLE\$1VAST | La demande de redirection VAST a renvoyé plusieurs annonces. | | FILLED\$1AVAIL | MediaTailor a rempli le fichier avail avec succès. | | FILLED\$1OVERLAY\$1AVAIL | MediaTailor a rempli avec succès la superposition disponible. | | INTERSTITIAL\$1VOD\$1FAILURE | La demande ou la réponse ADS a rencontré un problème lors du remplissage des espaces interstitiels pour la playlist VOD. Aucune annonce ne sera insérée. | | INTERSTITIAL\$1VOD\$1SUCCESS | MediaTailor disponibilités interstitielles remplies avec succès pour la playlist VOD. | | MAKING\$1ADS\$1REQUEST | MediaTailor demande des publicités à l'ADS. | | MODIFIED\$1TARGET\$1URL | MediaTailor a modifié l'URL cible sortante. | | NON\$1AD\$1MARKER\$1FOUND | MediaTailor J'ai trouvé un marqueur publicitaire non exploitable dans le manifeste. | | RAW\$1ADS\$1RESPONSE | MediaTailor a reçu une réponse ADS brute. | | REDIRECTED\$1VAST\$1RESPONSE | MediaTailor a reçu une réponse VAST après avoir suivi la redirection VAST. | | VAST\$1REDIRECT | La réponse publicitaire VAST contient une redirection. | | VAST\$1RESPONSE | MediaTailor a reçu une réponse VASTE. | | VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1SUCCESS | MediaTailor a créé avec succès un plan de disponibilité basé sur le temps pour le modèle VOD. | | VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1VAST\$1RESPONSE\$1FOR\$1OFFSET | MediaTailor crée un plan de disponibilité basé sur le temps pour le modèle de VOD. MediaTailor a reçu une réponse VAST pour le décalage horaire. | | VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1WARNING\$1NO\$1ADVERTISEMENTS | La demande ou la réponse ADS a rencontré un problème lors de la création d'un plan de disponibilité basé sur le temps pour le modèle de VOD. Aucune annonce ne sera insérée. | | WARNING\$1NO\$1ADVERTISEMENTS | MediaTailor a rencontré un problème lors du remplissage du fichier. Aucune annonce n'est insérée. | | WARNING\$1URL\$1VARIABLE\$1SUBSTITUTION\$1FAILED | MediaTailor Impossible de remplacer des variables dynamiques dans l'URL ADS. Vérifiez la configuration de l'URL. | | WARNING\$1VPAID\$1AD\$1DROPPED | Une annonce VPAID a été supprimée en raison d'une liste manquante, ou la session utilise des rapports côté serveur. | ## Description du journal ADS Cette section décrit la structure et le contenu de la description du journal ADS. Pour explorer vous-même dans un éditeur JSON, utilisez la liste à l'adresse [Schéma JSON du journal ADS](#ads-log-json-schema). Chaque événement du journal ADS contient les champs standard générés par CloudWatch Logs. Pour plus d'informations, voir [Analyser les données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). ### Propriétés des journaux ADS Cette section décrit les propriétés des journaux ADS. | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | adsRequestUrl | chaîne | false | URL complète de la demande ADS effectuée par MediaTailor. | | avail | objet de type [avail](#ads-logs-avail) | false | Informations sur une offre MediaTailor remplie de publicités. Actuellement, pour le type d'FILLED\$1AVAILévénement, il s'agit du plan créé MediaTailor lorsqu'il rencontre l'avantage pour la première fois. La façon dont la diffusion est finalement remplie peut varier en fonction de la façon dont le contenu se déroule. | | awsAccountId | chaîne | true | L'ID de compte AWS correspondant à la MediaTailor configuration utilisée pour la session. | | customerId | chaîne | true | Version hachée de l'ID de compte AWS, que vous pouvez utiliser pour établir une corrélation entre plusieurs entrées de journaux. | | eventDescription | chaîne | true | Brève description de l'événement qui a déclenché ce message de journal, fournie par le MediaTailor service. Par défaut, celle-ci est vide. Exemple: Got VAST response. | | eventTimestamp | chaîne | true | Date et heure de l’événement. | | eventType | chaîne | true | Code de l'événement qui a déclenché ce message de journal. Exemple: VAST\$1RESPONSE. | | originId | chaîne | true | Le nom de la configuration issu de la MediaTailor configuration. Cette source est différente de la source de contenu vidéo, qui fait également partie de la configuration. | | prefetchScheduleName | chaîne | false | Nom du calendrier de prélecture associé à cet événement publicitaire. | | requestHeaders | tableau de type [requestheaders](#ads-logs-requestheaders) | false | Les en-têtes MediaTailor inclus dans la demande ADS. Généralement, les journaux incluent ceux-ci lorsqu'une demande à ADS échoue, pour faciliter le dépannage. | | requestId | chaîne | true | L'ID de MediaTailor demande, que vous pouvez utiliser pour corréler plusieurs entrées de journal pour la même demande. | | sessionId | chaîne | true | Identifiant numérique unique MediaTailor attribué à la session du joueur. Toutes les demandes effectuées par un joueur pour une session ont le même ID de session. Exemple: e039fd39-09f0-46b2-aca9-9871cc116cde. | | sessionType | string (valeurs légales : [DASH, HLS]) | true | Type de flux du lecteur. | | vastAd | objet de type [vastAd](#ads-logs-vastAd) | false | Informations sur une seule publicité analysée à partir de la réponse VAST. | | vastResponse | objet de type [vastResponse](#ads-logs-vastResponse) | false | Informations sur la réponse VAST MediaTailor reçue de l'ADS. | | vodCreativeOffsets | objet de type [vodCreativeOffsets](#ads-logs-vodCreativeOffsets) | false | Une carte qui indique les décalages temporels dans le manifeste où les options MediaTailor seront insérées, en fonction de la réponse VMAP. | | vodVastResponseTimeOffset | number | false | Décalage horaire spécifique au VMAP pour l'insertion de publicités VOD. | ### adContent Cette section décrit les propriétés de l’objet adContent des journaux ADS. **Propriétés de l’objet adContent des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | adPlaylistUris | objet de type [adPlaylistUris](#ads-logs-adPlaylistUris) | false | Mappage du manifeste d'origine pour une variante au manifeste publicitaire pour la variante. Pour DASH, ceci contient une seule entrée, car toutes les variantes sont représentées dans un seul manifeste DASH. | ### adPlaylistUris Cette section décrit les propriétés des journaux ADS adPlaylistUris. **adPlaylistUris Propriétés des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | | chaîne | false | URL du manifeste publicitaire pour la variante spécifique. | ### avail Cette section décrit les propriétés de l’objet avail des journaux ADS. **Propriétés de l’objet avail des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | availId | chaîne | true | Identifiant unique pour cette diffusion. Pour HLS, il s'agit du numéro de séquence média où la diffusion commence. Pour DASH, il s'agit de l'ID de période. | | creativeAds | tableau de type [creativeAd](#ads-logs-creativeAd) | true | Les publicités MediaTailor insérées dans le fichier. | | fillRate | number | true | Vitesse à laquelle les publicités remplissent la durée de diffusion, de 0,0 (pour 0 %) à 1,0 (pour 100 %). | | filledDuration | number | true | Somme des durées de toutes les publicités insérées dans la diffusion. | | numAds | number | true | Le nombre d'annonces MediaTailor insérées dans le fichier Avail. | | originAvailDuration | number | true | Durée de la diffusion telle que spécifiée dans le flux de contenu à partir de l'origine (CUE\$1OUT ou SCTE). | | skippedAds | tableau de type [skippedAd](#ads-logs-skippedAd) | false | Les publicités qui MediaTailor n'ont pas été insérées, pour des raisons telles que TRANSCODE\$1IN\$1PROGRESS etTRANSCODE\$1ERROR. Pour obtenir la liste des raisons pour lesquelles les publicités ont été ignorées, consultez[Résolution des problèmes liés au non-respect des publicités](troubleshooting-ad-skipping-overview.md). | | slateAd | objet de type [slateAd](#ads-logs-slateAd) | true | Informations sur l'annonce Slate, qui est MediaTailor utilisée pour remplir les segments vides disponibles. | ### creativeAd Cette section décrit les propriétés de l’objet creativeAd des journaux ADS. **Propriétés de l’objet creativeAd des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | adContent | objet de type [adContent](#ads-logs-adContent) | true | Informations sur le contenu de la publicité insérée. | | creativeUniqueId | chaîne | true | Identifiant unique de la publicité, utilisé comme clé pour le transcodage. Il s'agit du champ ID de la création dans la réponse VAST, si disponible. Sinon, il s'agit de l'URL mezzanine de la publicité. | | trackingEvents | objet de type [trackingEvents](#ads-logs-trackingEvents) | true | La balise de suivi URLs pour les différents événements de suivi de l'annonce. Les clés sont les noms des événements et les valeurs sont une liste de balises URLs. | | transcodedAdDuration | number | true | Durée de la publicité, calculée à partir de l'asset transcodé. | | uri | chaîne | true | URL de la version mezzanine de la publicité, qui est l'entrée du transcodeur. | | vastDuration | number | true | Durée de la publicité, telle qu'analysée à partir de la réponse VAST. | ### requestheaders Cette section décrit les propriétés des objets requestheaders des journaux ADS. **Propriétés des objets requestheaders des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | name | chaîne | true | Nom de l'en-tête. | | value | chaîne | true | Valeur de l'en-tête. | ### skippedAd Cette section décrit les propriétés de l’objet skippedAd des journaux ADS. **Propriétés de l’objet skippedAd des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | adMezzanineUrl | chaîne | true | URL mezzanine de la publicité ignorée. | | creativeUniqueId | chaîne | true | Identifiant unique de la publicité, utilisé comme clé pour le transcodage. Il s'agit du champ ID de la création dans la réponse VAST, si disponible. Sinon, il s'agit de l'URL mezzanine de la publicité. | | skippedReason | chaîne | true | Code qui indique pourquoi la publicité n'a pas été insérée. Exemple: TRANSCODE\$1IN\$1PROGRESS. Pour obtenir la liste des raisons pour lesquelles les publicités ont été ignorées, consultez[Résolution des problèmes liés au non-respect des publicités](troubleshooting-ad-skipping-overview.md). | | transcodedAdDuration | number | false | Durée de la publicité, calculée à partir de l'asset transcodé. | | vastDuration | number | true | Durée de la publicité, telle qu'analysée à partir de la réponse VAST. | ### slateAd Cette section décrit les propriétés de l’objet slateAd des journaux ADS. **Propriétés de l’objet slateAd des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | adContent | objet de type [adContent](#ads-logs-adContent) | true | Informations sur le contenu de la publicité insérée. | | creativeUniqueId | chaîne | true | Identifiant unique de la publicité, utilisé comme clé pour le transcodage. Il s'agit du champ ID de la création dans la réponse VAST, si disponible. Sinon, il s'agit de l'URL mezzanine de la publicité. | | transcodedAdDuration | number | true | Durée de la publicité, calculée à partir de l'asset transcodé. | | uri | chaîne | true | URL de la version mezzanine de la publicité, qui est l'entrée du transcodeur. | ### trackingEvents Cette section décrit les propriétés des objets trackingEvents des journaux ADS. **Propriétés des objets trackingEvents des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | | tableau de type chaîne | false | La liste des balises URLs pour l'événement de suivi spécifié (impression, complet, etc.) | ### vastAd Cette section décrit les propriétés de l’objet vastAd des journaux ADS. **Propriétés de l’objet vastAd des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | adSystem | chaîne | true | Valeur de la balise AdSystem dans la réponse VAST. | | adTitle | chaîne | true | Fichiers multimédias qui sont disponibles pour la publicité dans la réponse VAST. | | creativeAdId | chaîne | true | Valeur de l'attribut adId de la balise Creative dans la réponse VAST. | | creativeId | chaîne | true | Valeur de l'attribut id de la balise Creative dans la réponse VAST. | | duration | number | true | Durée approximative de la publicité, en fonction de la balise duration dans l'élément linear de la réponse VAST. | | trackingEvents | objet de type [trackingEvents](#ads-logs-trackingEvents) | true | La balise de suivi URLs pour les différents événements de suivi de l'annonce. Les clés sont les noms des événements et les valeurs sont une liste de balises URLs. | | vastAdId | chaîne | true | Valeur de l'attribut id de la balise Ad dans la réponse VAST. | | vastAdTagUri | chaîne | false | URI de redirection spécifique à VMAP pour une publicité. | | vastMediaFiles | tableau de type [vastMediaFile](#ads-logs-vastMediaFile) | true | Liste des fichiers multimédias disponibles pour la publicité dans la réponse VAST. | ### vastMediaFile Cette section décrit les propriétés des journaux ADS vastMediaFile. **vastMediaFile Propriétés des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | apiFramework | chaîne | true | Cadre d'API nécessaire pour gérer le fichier multimédia. Exemple: VPAID. | | bitrate | number | true | Vitesse de transmission du fichier multimédia. | | delivery | chaîne | true | Protocole utilisé pour le fichier multimédia, défini sur progressif ou streaming. | | height | number | true | Hauteur en pixels du fichier multimédia. | | id | chaîne | true | Valeur de l'attribut ID de la balise MediaFile. | | type | chaîne | true | Type MIME du fichier multimédia, extrait de l'attribut de type de la balise MediaFile. | | uri | chaîne | true | URL de la version mezzanine de la publicité, qui est l'entrée du transcodeur. | | width | number | true | Largeur en pixels du fichier multimédia. | ### vastResponse Cette section décrit les propriétés de l’objet vastResponse des journaux ADS. **Propriétés de l’objet vastResponse des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | errors | tableau de type chaîne | true | L'erreur URLs analysée à partir des Error balises de la réponse VAST. | | vastAds | tableau de type [vastAd](#ads-logs-vastAd) | true | Publicités analysées à partir de la réponse VAST. | | version | chaîne | true | Version de spécification VAST, analysée à partir de l'attribut version de la balise VAST dans la réponse. | ### vodCreativeOffsets Cette section décrit les propriétés des journaux ADS vodCreativeOffsets. **vodCreativeOffsets Propriétés des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | | tableau de type [vodCreativeOffset](#ads-logs-vodCreativeOffset) | false | Mappage d'un décalage horaire dans le manifeste avec une liste de publicités à insérer à cet horaire. | ### vodCreativeOffset Cette section décrit les propriétés des journaux ADS vodCreativeOffset. **vodCreativeOffset Propriétés des journaux ADS** | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | adContent | objet de type [adContent](#ads-logs-adContent) | true | Informations sur le contenu de la publicité insérée. | | creativeUniqueId | chaîne | true | Identifiant unique de la publicité, utilisé comme clé pour le transcodage. Il s'agit du champ ID de la création dans la réponse VAST, si disponible. Sinon, il s'agit de l'URL mezzanine de la publicité. | | trackingEvents | objet de type [trackingEvents](#ads-logs-trackingEvents) | true | La balise de suivi URLs pour les différents événements de suivi de l'annonce. Les clés sont les noms des événements et les valeurs sont une liste de balises URLs. | | transcodedAdDuration | number | true | Durée de la publicité, calculée à partir de l'asset transcodé. | | uri | chaîne | true | URL de la version mezzanine de la publicité, qui est l'entrée du transcodeur. | | vastDuration | number | true | Durée de la publicité, telle qu'analysée à partir de la réponse VAST. | ## Schéma JSON du journal ADS Le schéma JSON du journal AWS Elemental MediaTailor ADS est répertorié ci-dessous. ``` { "$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 description des journaux manifestes et types d'événements Les sections suivantes décrivent les journaux émis pour décrire les événements MediaTailor liés au serveur d'origine lors de la demande et de la réception d'un manifeste. Ce sont `ManifestService` des journaux. **Topics** + [Événements ManifestService](#log-types-origininteraction) + [Propriétés des journaux du manifeste](#manifest-logs-main) ## Événements ManifestService Les événements suivants sont émis lors MediaTailor des interactions avec l'origine. | Journal | Description | | --- | --- | | CONFIG\$1SECURITY\$1ERROR | La MediaTailor configuration présente un problème de sécurité. | | CONFIG\$1SYNTAX\$1ERROR | L'origine et le chemin de la ressource entraînent une URL mal formée. | | CONNECTION\$1ERROR | La MediaTailor connexion à l'origine a été refusée ou a échoué. | | GENERATED\$1MANIFEST | MediaTailor a généré un manifeste. Le mode de débogage doit être activé pour recevoir ces journaux. Pour plus d'informations sur le mode journal de débogage, notamment sur la façon de l'activer, consultez[Génération de journaux de débogage](debug-log-mode.md). | | HOST\$1DISALLOWED | MediaTailor n'autorise pas les requêtes HTTP adressées à cet hôte. | | INCOMPATIBLE\$1HLS\$1VERSION | Le manifeste utilise une version HLS incompatible. MediaTailor nécessite la version 3 ou supérieure. | | INVALID\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Le manifeste DASH à période unique n'est pas valide. MediaTailor passe par un manifeste DASH à période unique. | | IO\$1ERROR | MediaTailor a rencontré une erreur d'E/S lors de la communication avec l'origine. | | LAST\$1PERIOD\$1MISSING\$1AUDIO | Tout le son est absent du dernier point du manifeste DASH en AdaptationSets raison d'un désalignement audio ou vidéo de l'origine. Pour éviter les problèmes de lecture, retardez la publication de la dernière période au moins jusqu'à la prochaine demande. | | LAST\$1PERIOD\$1MISSING\$1AUDIO\$1WARNING | Tout le son est absent du dernier point du manifeste DASH en AdaptationSets raison d'un désalignement audio ou vidéo de l'origine. Choisir de publier (et non de retarder) la dernière période. L'absence de son peut entraîner des problèmes de lecture. | | MANIFEST\$1ERROR | La demande de MediaTailor manifeste a échoué. | | NO\$1MASTER\$1OR\$1MEDIA\$1PLAYLIST | La réponse d'origine ne contient pas de liste de lecture principale ou de liste de lecture multimédia. | | NO\$1MASTER\$1PLAYLIST | La réponse d'origine ne contient pas la playlist principale attendue. | | NO\$1MEDIA\$1PLAYLIST | La réponse d'origine ne contient pas la liste de lecture multimédia attendue. | | ORIGIN\$1MANIFEST | MediaTailor J'ai récupéré un manifeste d'origine. Le mode de débogage doit être activé pour recevoir ces journaux. Pour plus d'informations sur le mode journal de débogage, notamment sur la façon de l'activer, consultez[Génération de journaux de débogage](debug-log-mode.md). | | PARSING\$1ERROR | L'origine n'est pas en mesure d'analyser la demande de manifeste. | | SCTE35\$1PARSING\$1ERROR | MediaTailor est incapable d'analyser Signal Binary l'élément du manifeste. | | SESSION\$1INITIALIZED | Une session a été initialisée. Le mode de débogage doit être activé pour recevoir ces journaux. Pour plus d'informations sur le mode journal de débogage, notamment sur la façon de l'activer, consultez[Génération de journaux de débogage](debug-log-mode.md). | | TIMEOUT\$1ERROR | Le délai imparti pour la demande de MediaTailor manifeste a expiré. | | TRACKING\$1RESPONSE | MediaTailor a envoyé une réponse de suivi. Le mode de débogage doit être activé pour recevoir ces journaux. Pour plus d'informations sur le mode journal de débogage, notamment sur la façon de l'activer, consultez[Génération de journaux de débogage](debug-log-mode.md). | | UNKNOWN\$1ERROR | MediaTailor a rencontré une erreur inconnue. | | UNKNOWN\$1HOST | L'hôte est inconnu. | | UNSUPPORTED\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Le manifeste DASH à période unique n'est pas pris en charge. MediaTailor passe par un manifeste DASH à période unique. | ## Propriétés des journaux du manifeste Cette section décrit les propriétés des journaux du manifeste. | Propriété | Type | Obligatoire | | --- | --- | --- | | awsAccountId | chaîne | true | | eventTimestamp | chaîne | true | | originId | chaîne | true | | customerId | chaîne | false | | eventType | chaîne | false | | sessionId | chaîne | false | | originRequestUrl | chaîne | false | | mediaTailorPath | chaîne | false | | requestId | chaîne | false | | responseBody | chaîne | false | | sessionType | string (valeurs légales : [DASH, HLS]) | false | | requestNextToken | chaîne | false | | eventDescription | chaîne | false | | assetPath | chaîne | false | | originFullUrl | chaîne | false | | originPrefixUrl | chaîne | false | | additionalInfo | chaîne | false | | cause | chaîne | false | | response | chaîne | false | | httpCode | chaîne | false | | errorMessage | chaîne | false | | adAdsResponse | chaîne | false | | adAdsRawResponse | chaîne | false | | adAdsRequest | chaîne | false | | adNumNewAvails | chaîne | false | | generatedMediaPlaylist | chaîne | false | | requestStartTime | chaîne | false | | requestEndTime | chaîne | false | | requestStartTimeEpochMillis | chaîne | false | | requestEndTimeEpochMillis | chaîne | false | # AWS Elemental MediaTailor description des journaux de transcodage et types d'événements Les sections suivantes décrivent les journaux émis pour décrire les événements MediaTailor liés au service de transcodage lors de la préparation de créations pour l'assemblage publicitaire. Ce sont `TranscodeService` des journaux. **Topics** + [Événements TranscodeService](#log-types-tminteraction) + [Propriétés des journaux de transcodage](#transcode-logs-main) ## Événements TranscodeService Les événements suivants sont émis lors des MediaTailor interactions lors du transcodage des publicités. | Journal | Description | | --- | --- | | IMPORT\$1ERROR | MediaTailor a rencontré une erreur interne lors d'une tâche d'importation (pour les annonces préconditionnées). En utilisant un ensemble d'annonces vides. | | INITIALIZED | MediaTailor a initialisé une tâche de transcodage ou une tâche d'importation (pour les publicités préconditionnées). | | INTERNAL\$1ERROR | MediaTailor a rencontré une erreur interne. En utilisant un ensemble d'annonces vides. | | MISSING\$1VARIANTS | MediaTailor Impossible de transcoder l'annonce en raison de variantes manquantes. En utilisant un ensemble d'annonces vides. | | PROFILE\$1NOT\$1FOUND | MediaTailor Impossible de transcoder l'annonce en raison d'un profil manquant à transcoder. En utilisant un ensemble d'annonces vides. | | TRANSCODE\$1COMPLETED | Le transcodage vidéo est terminé. L'annonce peut être utilisée pour l'insertion d'annonces. | | TRANSCODE\$1ERROR | MediaTailor a rencontré une erreur interne lors d'une tâche de transcodage. En utilisant un ensemble d'annonces vides. | | TRANSCODE\$1IN\$1PROGRESS | Le transcodage vidéo est en cours. La vidéo transcodée n'est pas prête. En utilisant un ensemble d'annonces vides. | ## Propriétés des journaux de transcodage Cette section décrit les propriétés des journaux de transcodage. | Propriété | Type | Obligatoire | Description | | --- | --- | --- | --- | | awsAccountId | chaîne | true | ID de AWS compte pour la MediaTailor configuration utilisée pour la session. | | eventTimestamp | chaîne | true | Date et heure de l’événement. | | originId | chaîne | true | Le nom de la configuration issu de la MediaTailor configuration. Cette source est différente de la source de contenu vidéo, qui fait également partie de la configuration. | | eventType | chaîne | false | Code de l'événement qui a déclenché ce message de journal. Exemple: TRANSCODE\$1ERROR. | | eventDescription | chaîne | false | Brève description de l'événement qui a déclenché ce message de journal, fournie par le MediaTailor service. Par défaut, celle-ci est vide. | | sessionId | chaîne | false | Identifiant numérique unique MediaTailor attribué à la session du joueur. Toutes les demandes effectuées par un joueur pour une session ont le même ID de session. Exemple: e039fd39-09f0-46b2-aca9-9871cc116cde. | | creativeUniqueId | chaîne | false | Identifiant unique de la création publicitaire en cours de transcodage. | | profileName | chaîne | false | | | adUri | chaîne | false | L'URI de la création publicitaire. | | transcodeRequestId | chaîne | false | Identifiant unique pour cette demande de transcodage. | | cacheStatus | chaîne | false | Indique si l'annonce transcodée est mise en MediaTailor cache. | # Utiliser les journaux vendus pour envoyer AWS Elemental MediaTailor des journaux Vous pouvez utiliser les journaux automatiques pour plus de flexibilité et de contrôle quant à l'endroit où distribuer les journaux émis à partir de votre configuration de lecture. MediaTailor Avec les journaux vendus, MediaTailor envoie toutes les activités des journaux associées à une configuration à Amazon CloudWatch Logs. CloudWatch Logs envoie ensuite le pourcentage de journaux que vous spécifiez à la destination que vous avez choisie. Les destinations prises en charge sont un groupe de CloudWatch journaux Amazon Logs, un bucket Amazon S3 ou un flux Amazon Data Firehose. Les journaux vendus étant disponibles à des prix réduits, vous pourriez réaliser des économies par rapport à l'envoi direct des CloudWatch journaux à Logs. Pour connaître les tarifs, consultez la section *Vended Logs* dans l'onglet **Logs** d'[Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/). Pour utiliser les journaux automatiques, vous devez effectuer les opérations suivantes : 1. [Ajout d’autorisations](#vended-logs-perms). 1. [Création de destinations de livraison de journaux](#vended-logs-destinations). 1. [Configurer la livraison des CloudWatch journaux dans Logs](#vended-logs-delivery). 1. [Activer les connexions automatiques MediaTailor](#vended-logs-config). Pour plus d'informations sur les journaux vendus, voir [Activer la journalisation à partir des AWS services](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) dans le guide de l'utilisateur CloudWatch des journaux. MediaTailor prend en charge la version 2 des journaux vendus. ## Étape 1 : ajouter des autorisations pour la livraison du MediaTailor journal La personne qui configure les journaux vendus doit être autorisée à créer la destination de livraison, à configurer la livraison des journaux et à activer les connexions vendues. MediaTailor Utilisez les politiques suivantes pour vous assurer que vous disposez des autorisations appropriées pour configurer les journaux de vente. **Politiques relatives aux CloudWatch journaux et aux destinations de livraison** Les sections suivantes du *guide de l'utilisateur d'Amazon CloudWatch Logs* présentent les politiques qui vous permettent de travailler avec Logs in CloudWatch Logs et vos destinations de livraison. Si vous envoyez des journaux à plusieurs emplacements, vous pouvez combiner les déclarations de politique en une seule politique au lieu de créer plusieurs politiques. + [Logs envoyés à CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs) + [Journaux envoyés à Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-S3) + [Logs envoyés à Firehose](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-Firehose) **Politique de configuration depuis la console** Si vous configurez la livraison des journaux vendus via la console plutôt que via l'API AWS CLI, vous devez disposer des autorisations supplémentaires suivantes dans votre politique. **Politique relative aux connexions automatiques MediaTailor** Pour créer, consulter ou modifier les journaux de livraison vendus MediaTailor, vous devez disposer des autorisations suivantes dans votre politique. Pour plus d'informations sur l'ajout d'autorisations et l'utilisation des politiques, consultez[Identity and Access Management pour AWS Elemental MediaTailor](security-iam.md). ## Étape 2 : créer des destinations de livraison pour les MediaTailor journaux Créez les ressources auxquelles vos journaux seront envoyés. Enregistrez l'ARN de la ressource à utiliser lors de la configuration de la livraison du journal lors d'une étape ultérieure. **CloudWatch Logs : destination de livraison du groupe de journaux** Utilisez l'une des méthodes suivantes pour vous aider à créer un groupe de journaux. + Pour la console, consultez [Créer un groupe de CloudWatch journaux dans Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) du *guide de l'utilisateur Amazon CloudWatch Logs*. + Pour l'API, consultez le [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)manuel *Amazon CloudWatch Logs API Reference.* + Pour SDKs et CLI, consultez la section [Utilisation `CreateLogGroup` avec un AWS SDK ou AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) dans le *guide de l'utilisateur Amazon CloudWatch Logs*. **Destination de livraison du compartiment Amazon S3** Utilisez l'une des méthodes suivantes pour vous aider à créer un bucket. + Pour la console et la CLI SDKs, consultez la section [Créer un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*. + Pour l'API, consultez [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)le manuel *Amazon Simple Storage Service API Reference*. **Destination de livraison de Firehose Stream** Pour obtenir de l'aide sur la création d'un flux, consultez la section [Créer un flux Firehose depuis la console](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) dans le manuel *Amazon Data Firehose Developer* Guide. ## Étape 3 : activer les journaux vendus pour la configuration de MediaTailor lecture Créez ou mettez à jour la configuration de lecture qui enverra les journaux à la destination de livraison que vous avez créée à l'étape précédente. Enregistrez le nom de la configuration à utiliser lors de la configuration de la livraison du journal lors d'une étape ultérieure. + Pour activer les journaux vendus via la console, utilisez [Création d'une configuration](configurations-create.md) ou [Modification des paramètres de configuration](configurations-edit.md) modifiez une configuration pour accéder aux paramètres de **journalisation**. Pour les **stratégies de journalisation**, choisissez **Vended logs**. + Pour activer les journaux automatiques via l'API, vous devez disposer d'une configuration existante. `ConfigureLogsForPlaybackConfiguration`À utiliser pour ajouter la stratégie de journalisation`Vended logs`. Si vous utilisez l'ancienne stratégie de MediaTailor journalisation qui consiste à envoyer des journaux directement vers CloudWatch Logs et que vous souhaitez migrer vers des journaux vendus, consultez[Migration de la stratégie de journalisation](vended-logs-migrate.md). **Important** Si vous modifiez la stratégie de journalisation de Legacy CloudWatch à celle de vended logs, vous MediaTailor effectuerez cette modification dès que vous aurez enregistré les mises à jour. Vous ne recevrez plus de journaux tant que vous n'aurez pas entièrement configuré la journalisation automatique. ## Étape 4 : configurer la livraison des CloudWatch journaux dans Logs Dans CloudWatch Logs, vous devez créer trois éléments pour représenter les éléments de livraison des logs. Ces éléments sont décrits en détail [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)dans le manuel *Amazon CloudWatch Logs API Reference*. Les étapes de haut niveau pour configurer la livraison avec l'API CloudWatch Logs sont les suivantes. **Pour configurer la livraison des CloudWatch journaux dans Logs (API)** 1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)À utiliser pour ajouter la source des journaux. A `DeliverySource` représente la configuration de lecture qui génère les journaux. Vous avez besoin du nom de la configuration de lecture pour créer le`DeliverySource`. 1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)À utiliser pour ajouter la destination où les journaux seront écrits. A `DeliveryDestination` représente la destination de livraison. Vous avez besoin de l'ARN du groupe de logs, du bucket ou du stream pour créer le`DeliveryDestination`. 1. À utiliser [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)si vous distribuez des journaux entre comptes. Si la destination de livraison se trouve dans un compte différent de celui de la configuration de lecture, vous avez besoin d'un`DeliveryDestinationPolicy`. Cette politique permet à CloudWatch Logs de fournir des journaux au`DeliveryDestination`. 1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)À utiliser pour `DeliverySource` lier le`DeliveryDestination`. A `Delivery` représente le lien entre `DeliverySource` et`DeliveryDestination`. # Migration de votre stratégie de AWS Elemental MediaTailor journalisation Si vous modifiez la stratégie de journalisation de Legacy CloudWatch à celle de vended logs, vous MediaTailor effectuerez cette modification dès que vous aurez enregistré les mises à jour. Pour éviter toute interruption de votre flux de journalisation, suivez les étapes ci-dessous pour migrer votre stratégie de journalisation. 1. Suivez les étapes décrites dans la section [Utilisation des journaux vendus](vended-logs.md). Pour[Activer les connexions automatiques MediaTailor](vended-logs.md#vended-logs-config), sélectionnez *les deux* stratégies de journalisation (**Vended logs** et **Legacy CloudWatch**). MediaTailor enverra les journaux à la fois par le biais de journaux vendus et directement à CloudWatch Logs. 1. Apportez les modifications nécessaires à votre flux de travail en fonction de votre stratégie de journalisation et de votre destination de livraison. 1. Revisitez [Activer les connexions automatiques MediaTailor](vended-logs.md#vended-logs-config) et supprimez **Legacy CloudWatch** des **stratégies de journalisation**. # Écrire AWS Elemental MediaTailor des journaux directement sur Amazon CloudWatch Logs MediaTailor produit des journaux contenant des informations détaillées sur l'activité des sessions et les interactions avec le serveur de décision publicitaire, et les écrit sur Amazon CloudWatch. Les journaux fournissent une description séquentielle de l'activité qui se produit au cours de la session. MediaTailor peut également utiliser des journaux vendus pour plus de flexibilité en matière de livraison des journaux et de tarification à prix réduits en fonction du volume. Pour plus d'informations sur les journaux vendus, consultez[Utilisation des journaux vendus](vended-logs.md). **Topics** + [Autorisations pour Amazon CloudWatch Logs](monitoring-permissions.md) + [Journal « As Run » pour l'assemblage des AWS Elemental MediaTailor canaux](as-run-log.md) + [AWS Elemental MediaTailor Analyse des journaux ADS dans Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md) # Autorisations pour Amazon CloudWatch Logs Utilisez Gestion des identités et des accès AWS (IAM) pour créer un rôle donnant AWS Elemental MediaTailor accès à Amazon CloudWatch. Vous devez effectuer ces étapes pour que CloudWatch les journaux soient publiés pour votre compte. CloudWatch publie automatiquement les statistiques de votre compte. **Pour autoriser MediaTailor l'accès à CloudWatch** 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Dans le volet de navigation de la console IAM, sélectionnez **Roles** (Rôles), puis **Create role** (Créer un rôle). 1. Choisissez le type de rôle **Autre AWS compte**. 1. Pour **ID de compte**, entrez votre identifiant de AWS compte. 1. Sélectionnez **Demander un ID externe** et entrez **Midas**. Cette option ajoute automatiquement une condition à la stratégie d'approbation qui permet au service d'assumer le rôle uniquement si la demande inclut l'élément `sts:ExternalId` approprié. 1. Choisissez **Suivant : Autorisations**. 1. Ajoutez une stratégie d'autorisations qui spécifie les actions que ce rôle peut effectuer. Sélectionnez l'une des options suivantes, puis choisissez **Next : Review** : + **CloudWatchLogsFullAccess**pour fournir un accès complet à Amazon CloudWatch Logs + **CloudWatchFullAccess**pour fournir un accès complet à Amazon CloudWatch 1. Pour **Nom du rôle**, saisissez **MediaTailorLogger**, puis choisissez **Créer un rôle**. 1. Sur la page **Rôles**, sélectionnez le rôle que vous venez de créer. 1. Modifiez la relation d'approbation pour mettre à jour le mandataire : 1. Sur la page **Récapitulatif** du rôle, choisissez l'onglet **Relation d'approbation**. 1. Choisissez **Modifier la relation d’approbation**. 1. Dans le document de politique, remplacez le principal par le MediaTailor service. Elle doit ressembler à ce qui suit : ``` "Principal": { "Service": "mediatailor.amazonaws.com" }, ``` L'ensemble de la stratégie doit se présenter comme suit : 1. Choisissez **Mettre à jour la politique d'approbation**. # Journal « As Run » pour l'assemblage des AWS Elemental MediaTailor canaux Le journal *As Run*, dans le groupe de CloudWatch `MediaTailor/Channel/AsRunLog` journaux, affiche des informations sur les programmes et les pauses publicitaires au fur et à mesure de leur diffusion. Lorsque vous créez un canal, le journal As Run est désactivé par défaut. À l'aide de la console ou du AWS Command Line Interface (AWS CLI), vous pouvez activer et désactiver l'état du journal As Run pour chaque canal de votre compte. Lorsque vous activez le journal As Run, un rôle lié au service est MediaTailor automatiquement créé qui permet d'écrire et MediaTailor de gérer le journal As Run dans votre compte CloudWatch Logs. Pour plus d’informations sur les rôles liés à un service, consultez [Utilisation de rôles liés à un service pour MediaTailor](using-service-linked-roles.md). **Note** Le journal As Run ne prend actuellement en charge que le programme par défaut. Pour l'instant, il ne prend pas en charge le AlternateMedia créé par les règles du programme. Cela signifie qu'il ne génère actuellement pas le journal As Run pour AlternateMedia. **Topics** + [Activation du journal As Run](enabling-as-run-log.md) + [Désactivation du journal As Run](disabling-as-run-log.md) # Activation du journal As Run Pour activer le journal As Run, spécifiez le nom du canal et activez le type *de journal As Run* pour ce canal. ------ #### [ Console ] **Pour activer le journal As Run lors de la création d'une chaîne** 1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**. 1. Dans la barre de navigation, choisissez **Create channel**. 1. Dans les volets **Définir les détails du canal**, **Configurer les sorties** et **Contrôle d'accès**, configurez votre canal comme vous le souhaitez. 1. Dans le volet **de contrôle d'accès**, choisissez **Next**. 1. Dans le volet **Journalisation**, sous **Types de journaux**, sélectionnez **Activer en tant qu'exécution** pour activer le journal en cours d'exécution. **Pour activer le journal As Run lors de la mise à jour d'un canal** **Note** Si la chaîne est en cours d'exécution, vous devez d'abord l'arrêter avant de pouvoir la mettre à jour. Après avoir arrêté le canal, vous pouvez choisir **Actions** > **Modifier** pour commencer à le mettre à jour. 1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**. 1. Choisissez le canal que vous souhaitez mettre à jour pour activer le journal As Run. 1. Sélectionnez **Actions** > **Edit** (Modifier). 1. Dans les volets **Définir les détails du canal**, **Configurer les sorties** et **Contrôle d'accès**, mettez à jour la configuration de votre canal comme vous le souhaitez. 1. Dans le volet **de contrôle d'accès**, choisissez **Next**. 1. Dans le volet **Journalisation**, sous **Types de journaux**, sélectionnez **Activer en tant qu'exécution** pour activer le journal en cours d'exécution. **Pour activer le journal As Run depuis l'onglet **Logging**** **Note** Si le canal est en cours d'exécution, vous devez utiliser l'onglet **Logging** au lieu de choisir **Actions** > **Modifier** pour activer le journal As Run. 1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**. 1. Choisissez le canal pour lequel vous souhaitez activer le journal As Run. 1. Dans la barre de navigation située sous le nom de la chaîne, choisissez **Logging**. 1. Sous **Journalisation** > **Types de journaux**, sélectionnez **En cours d'exécution** pour activer le journal en cours d'exécution. ------ #### [ AWS Command Line Interface (AWS CLI) ] **Pour activer le journal As Run** Exécutez la [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)commande et spécifiez les valeurs appropriées pour les paramètres requis. Cet exemple est formaté pour Linux, macOS ou Unix et utilise le caractère de continuation de ligne barre oblique inverse (\$1) pour améliorer la lisibilité. ``` $ aws mediatailor configure-logs-for-channel \ --channel-name MyChannel \ --log-types AS_RUN ``` Cet exemple est formaté pour Microsoft Windows et utilise le caractère de continuation de ligne caret (^) pour améliorer la lisibilité. ``` C:\> aws mediatailor configure-logs-for-channel ^ --channel-name MyChannel ^ --log-types AS_RUN ``` Où : + `MyChannel`est le nom de la chaîne dont vous êtes propriétaire et pour laquelle vous souhaitez activer le journal As Run. Si la commande s'exécute correctement, vous recevez une sortie similaire à ce qui suit. ``` { "ChannelName": "MyChannel", "LogTypes": [ "AS_RUN" ] } ``` ------ # Désactivation du journal As Run Pour désactiver le journal As Run pour un canal sur lequel il est activé, spécifiez le nom du canal et désactivez le type de journal As *Run* pour ce canal. ------ #### [ Console ] **Pour désactiver le journal As Run lors de la mise à jour d'une chaîne** **Note** Si la chaîne est en cours d'exécution, vous devez d'abord l'arrêter avant de pouvoir la mettre à jour. Après avoir arrêté le canal, vous pouvez choisir **Actions** > **Modifier** pour commencer à le mettre à jour. 1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**. 1. Choisissez le canal que vous souhaitez mettre à jour pour activer le journal As Run. 1. Sélectionnez **Actions** > **Edit** (Modifier). 1. Dans les volets **Définir les détails du canal**, **Configurer les sorties** et **Contrôle d'accès**, mettez à jour la configuration de votre canal comme vous le souhaitez. 1. Dans le volet **de contrôle d'accès**, choisissez **Next**. 1. Dans le volet **Journalisation**, sous **Types de journaux**, décochez **Activer en tant qu'exécution** pour désactiver le journal en cours d'exécution. **Pour désactiver le journal As Run dans l'onglet **Logging**** **Note** Si le canal est en cours d'exécution, vous devez utiliser l'onglet **Logging** au lieu de choisir **Actions** > **Modifier** pour désactiver le journal As Run. 1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**. 1. Choisissez le canal pour lequel vous souhaitez désactiver le journal As Run. 1. Dans la barre de navigation située sous le nom de la chaîne, choisissez **Logging**. 1. Sous **Journalisation** > **Types de journaux**, désélectionnez **En cours d'exécution** pour désactiver le journal en cours d'exécution. ------ #### [ AWS Command Line Interface (AWS CLI) ] **Pour désactiver le journal As Run** Exécutez la [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)commande et spécifiez les valeurs appropriées pour les paramètres requis. Cet exemple est formaté pour Linux, macOS ou Unix et utilise le caractère de continuation de ligne barre oblique inverse (\$1) pour améliorer la lisibilité. ``` $ aws mediatailor configure-logs-for-channel \ --channel-name MyChannel \ --log-types ``` Cet exemple est formaté pour Microsoft Windows et utilise le caractère de continuation de ligne caret (^) pour améliorer la lisibilité. ``` C:\> aws mediatailor configure-logs-for-channel ^ --channel-name MyChannel ^ --log-types ``` Où : + `MyChannel`est le nom de la chaîne dont vous êtes propriétaire et pour laquelle vous souhaitez désactiver le journal As Run. Si la commande s'exécute correctement, vous recevez une sortie similaire à ce qui suit. ``` { "ChannelName": "MyChannel", "LogTypes": [] } ``` ------ # AWS Elemental MediaTailor Analyse des journaux ADS dans Amazon CloudWatch Logs Insights Vous pouvez consulter et interroger les journaux du serveur de décision AWS Elemental MediaTailor publicitaire (ADS) à l'aide d'Amazon CloudWatch Logs Insights. MediaTailor envoie des journaux d'événements à CloudWatch des fins de traitement normal et de conditions d'erreur. Les journaux respectent un schéma JSON. Grâce à CloudWatch Logs Insights, vous pouvez sélectionner les journaux par période, puis exécuter des requêtes sur ceux-ci. Pour des informations générales, voir [Analyser les données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). **Note** Pour accéder aux journaux, vous devez disposer d'autorisations pour accéder à Amazon CloudWatch. Pour obtenir des instructions, veuillez consulter [Autorisations pour Amazon CloudWatch Logs](monitoring-permissions.md). **Pour afficher et interroger les journaux ADS à l'aide de la CloudWatch console** 1. Ouvrez la CloudWatch console à l'adresse[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le volet de navigation, sous **Logs (Journaux)**, choisissez **Insights**. 1. Dans la barre de recherche**AdDec**, entrez, puis dans la liste déroulante, sélectionnez`MediaTailor/AdDecisionServerInteractions`. 1. (Facultatif) Ajustez la période que vous souhaitez étudier. 1. (Facultatif) Modifiez la requête dans la boîte de dialogue. Pour obtenir des conseils généraux, voir [Syntaxe de requête CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Pour obtenir des exemples de requêtes pour ADS MediaTailor, consultez [Consultation des journaux ADS](querying-the-ads-logs.md). 1. Choisissez **Exécuter la requête**. La requête peut prendre quelques secondes, pendant lesquelles **Cancel (Annuler)** apparaît à la place de **Run query (Exécuter la requête)**. 1. (Facultatif) Pour exporter les résultats sous forme de fichier CSV, choisissez **Actions**, puis **Download query results (CSV) (Télécharger les résultats de la requête - CSV)**. **Note** La console limite le nombre d'enregistrements qu'elle renvoie dans les résultats des requêtes et qu'elle exporte. Par conséquent, pour les données en masse, utilisez l'API, le AWS Command Line Interface (AWS CLI) ou un SDK. **Topics** + [Consultation des journaux ADS](querying-the-ads-logs.md) # Consultation des journaux ADS CloudWatch Logs Insights fournit un ensemble complet d'options pour interroger vos journaux. Pour des informations détaillées sur la syntaxe des requêtes, voir Syntaxe de [requête CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Cette section fournit des exemples de requêtes courantes pour vous aider à démarrer avec vos requêtes de journaux ADS. Toutes les requêtes s'exécutent sur les journaux pour le paramètre de plage de temps actuel. La requête suivante récupère toutes les informations des journaux ADS. ``` fields @timestamp, eventType, sessionId, requestId, @message | sort sessionId, @timestamp asc ``` La requête suivante récupère toutes les demandes adressées à ADS. Cette requête montre un moyen de récupérer le contenu de l'en-tête de demande pour les MediaTailor journaux. ``` fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId | filter eventType = "MAKING_ADS_REQUEST" | sort @timestamp asc ``` La requête suivante permet de récupérer les publicités MediaTailor insérées pour une session donnée. ``` fields @timestamp, sessionId, requestId, @message | filter eventType = "FILLED_AVAIL" | sort @timestamp asc ``` La requête suivante permet de récupérer le suivi URLs qui MediaTailor a été appelé au nom du joueur. ``` 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 requête suivante récupère des informations pour une session de lecture spécifique, en filtrant les résultats par `sessionId`. ``` fields @timestamp, eventType, sessionId, requestId, @message | filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195" | sort @timestamp asc ``` La requête suivante récupère des informations pour une seule demande, en filtrant les résultats par `requestId`. ``` fields @timestamp, eventType, sessionId, requestId, @message | filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d" | sort @timestamp asc ``` La requête suivante récupère un nombre d'entrées de journal pour chaque type d'événement qui a été consigné. ``` fields eventType | stats count() as @eventCount by eventType ``` La requête suivante récupère l'ID de diffusion et la liste des publicités ignorées pour toutes les diffusions avec des publicités ignorées. ``` fields avail.availId | parse @message '"skippedAds":[*]' as @skippedAdsList | filter ispresent(@skippedAdsList) ``` # Contrôle du volume des AWS Elemental MediaTailor journaux MediaTailor les journaux des sessions d'insertion de publicités sont parfois détaillés. Pour réduire les coûts de journalisation, vous pouvez définir le pourcentage de journaux de session MediaTailor envoyés à Amazon CloudWatch Logs. Par exemple, si votre configuration de lecture comporte 1 000 sessions d'insertion de publicités et que vous définissez un pourcentage activé de`60`, MediaTailor envoie les journaux de 600 sessions à CloudWatch Logs. MediaTailor décide au hasard pour laquelle des sessions envoyer des journaux. Si vous souhaitez consulter les journaux d'une session spécifique, vous pouvez utiliser le [mode journal de débogage](debug-log-mode.md). Lorsque vous définissez un pourcentage de journalisation, vous créez MediaTailor automatiquement un rôle lié à un service qui accorde MediaTailor les autorisations nécessaires pour écrire CloudWatch des journaux sur votre compte. Pour plus d'informations sur l' MediaTailor utilisation des rôles liés à un service, consultez. [Utilisation de rôles liés à un service pour MediaTailor](using-service-linked-roles.md) ## Création d'une configuration de journal Pour contrôler le pourcentage de journaux de session écrits MediaTailor dans CloudWatch Logs, vous devez créer une *configuration de journal* pour votre configuration de lecture. Lorsque vous créez une configuration de journal, vous spécifiez un *nom de configuration de lecture* et une valeur de *pourcentage activée*. ------ #### [ Console ] **Pour créer une configuration de journal pour une configuration de lecture *existante*** 1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Dans le volet **de configuration** de la lecture, sélectionnez la configuration de lecture pour laquelle vous souhaitez définir la configuration du journal. 1. Choisissez **Modifier**. 1. Sous **Configuration du journal**, spécifiez une valeur de **pourcentage activée**. **Pour créer une configuration de journal pour une *nouvelle* configuration de lecture** + Suivez la procédure décrite dans [Configuration du journal](configurations-create.md#configurations-log-configurations). ------ #### [ AWS Command Line Interface (AWS CLI) ] **Pour créer une configuration de journal pour une configuration de lecture *existante*** Pour créer une configuration de journal à l'aide de AWS CLI, exécutez la commande [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) et spécifiez les valeurs appropriées pour les paramètres requis. Cet exemple est formaté pour Linux, macOS ou Unix et utilise le caractère de continuation de ligne barre oblique inverse (\$1) pour améliorer la lisibilité. ``` $ aws mediatailor configure-logs-for-playback-configuration \ --percent-enabled 10 \ --playback-configuration-name MyPlaybackConfiguration ``` Cet exemple est formaté pour Microsoft Windows et utilise le caractère de continuation de ligne caret (^) pour améliorer la lisibilité. ``` C:\> aws mediatailor configure-logs-for-playback-configuration ^ --percent-enabled 10 ^ --playback-configuration-name MyPlaybackConfiguration ``` Où : + `percent-enabled`est le pourcentage de journaux de session de configuration de lecture MediaTailor envoyés à CloudWatch Logs. + `playback-configuration-name`est le nom de la configuration de lecture pour laquelle définir les paramètres de configuration du journal. Si la commande s'exécute correctement, vous recevez une sortie similaire à ce qui suit. ``` { "PercentEnabled": 10, "PlaybackConfigurationName": "MyPlaybackConfiguration" } ``` **Pour créer une configuration de journal pour une *nouvelle* configuration de lecture** + Utilisez l'`configure-logs-for-playback-configuration`option pour la [put-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html)commande. ------ ## Désactivation d'une configuration de journal Une fois que vous avez créé une configuration de journal, vous ne pouvez pas la supprimer, vous pouvez uniquement la *désactiver*. Pour désactiver la configuration du journal, définissez la valeur du **pourcentage activé** sur **0** avec la MediaTailor console ou l'API. Cela désactive tous les enregistrements de session pour cette configuration de lecture. Si vous souhaitez supprimer le rôle lié au service MediaTailor utilisé pour les configurations de journal de votre compte, vous devez d'abord désactiver toutes vos configurations de journal. Pour plus d'informations sur la façon de supprimer le rôle lié à un service, consultez. [Utilisation de rôles liés à un service pour MediaTailor](using-service-linked-roles.md) ------ #### [ Console ] **Pour désactiver la configuration du journal dans une configuration de lecture** 1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Dans le volet **de configuration** de la lecture, sélectionnez la configuration de lecture pour laquelle vous souhaitez désactiver la configuration du journal. 1. Choisissez **Modifier**. 1. Sous **Configuration du journal**, définissez la valeur du **pourcentage activé** sur`0`. Cela désactive toute journalisation de session pour cette configuration de lecture. 1. Cliquez sur **Enregistrer**. ------ #### [ AWS Command Line Interface (AWS CLI) ] **Pour désactiver une configuration de journal** + Définissez la `percent-enabled` valeur à `0` l'aide de la commande [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html). ------ # Filtrage AWS Elemental MediaTailor des journaux et des événements Les journaux émis par une configuration de lecture MediaTailor incluent des informations sur diverses activités qui se produisent pendant la session de lecture. Ces activités sont identifiées dans le type d'événement des journaux. De nombreux événements sont enregistrés par défaut. Pour aider à contrôler le coût des journaux sur Amazon CloudWatch, vous pouvez spécifier les journaux qui sont MediaTailor émis. MediaTailor vous permet de contrôler le filtrage des journaux afin que vous puissiez effectuer les opérations suivantes : + Spécifiez les événements de journal que vous souhaitez exclure des journaux + Activer l'enregistrement des réponses brutes depuis le serveur de décision publicitaire (ADS) Vous pouvez définir ces préférences de filtrage des journaux indépendamment pour chaque session de lecture, ou par défaut pour toutes les sessions de lecture pour une configuration de lecture. + Pour filtrer les journaux par session, incluez les paramètres de requête dans la demande d'initialisation de la session de lecture. + Pour filtrer les journaux par configuration de lecture, utilisez la MediaTailor console ou l'API pour indiquer vos préférences dans les paramètres de configuration de lecture. Les sections suivantes fournissent des instructions pour activer le filtrage des journaux sur les sessions et les configurations de lecture. # Filtres de journal par session Pour définir un niveau personnalisé de détails du journal pour chaque session, ajoutez les paramètres suivants à votre demande initiale de session de lecture côté serveur ou côté client. Ajoutez des valeurs aux paramètres pour représenter les événements que vous souhaitez inclure ou exclure, dans un format délimité par des virgules : + `aws.adsInteractionLogPublishOptInEventTypes`pour recevoir des journaux pour des interactions spécifiques avec le serveur de décision publicitaire (ADS). + `aws.adsInteractionLogExcludeEventTypes`pour arrêter de recevoir des journaux pour des interactions ADS spécifiques. + `aws.manifestServiceLogExcludeEventTypes`pour arrêter de recevoir des journaux pour des interactions spécifiques avec le service de manifeste. Pour obtenir la liste des types de journaux et d'événements qui MediaTailor émettent, voir [Journaux du manifeste](log-types.md)[journaux ADS](ads-log-format.md), et[Journaux de transcodage](tm-log-format.md). Si vous ne transmettez aucun paramètre de requête pour le filtrage des journaux, MediaTailor écrit tous les journaux sur votre destination de livraison. **Example initialisation de session côté serveur avec filtres de journalisation** Pour exclure `GENERATED_MANIFEST` `PARSING_ERROR` des événements de vos journaux de manifeste et `MAKING_ADS_REQUEST` des journaux ADS, la demande d'initialisation de session devrait ressembler à ceci : ``` GET /v1/master///index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST ``` Pour activer les journaux bruts à partir de votre ADS, incluez la `RAW_ADS_RESPONSE` valeur du `AdsInteractionPublishOptInEventType` paramètre : ``` GET /v1/master///index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE ``` **Example initialisation de session côté client avec des filtres de journal** Pour exclure les événements de journalisation lors de l'initialisation de la session côté client, incluez `availSuppression` et enregistrez les paramètres dans la requête POST de votre client à. MediaTailor Pour plus d'informations sur la création d'une demande de session de lecture côté client, consultez [Suivi des publicités côté client](ad-reporting-client-side.md). L'exemple suivant exclut `CONFIG_SECURITY_ERROR` des `PARSING_ERROR` événements de vos journaux de manifeste et `MAKING_ADS_REQUEST` des journaux ADS. ``` POST parent.m3u8 { "adsInteractionLog": { ... "excludeEventTypes": [ "MAKING_ADS_REQUEST" ] }, "manifestServiceLog": { ... "excludeEventTypes": [ "GENERATED_MANIFEST", "PARSING_ERROR" ] }, "logMode": "DEBUG" } ``` Pour activer les journaux bruts à partir de votre ADS, incluez la `RAW_ADS_RESPONSE ` valeur du `publishOptInEventTypes` paramètre : ``` POST parent.m3u8 { "adsInteractionLog": { "publishOptInEventTypes": ["RAW_ADS_RESPONSE"], "excludeEventTypes": [ "MAKING_ADS_REQUEST" ] }, "manifestServiceLog": { ... "excludeEventTypes": [ "GENERATED_MANIFEST", "PARSING_ERROR" ] }, "logMode": "DEBUG" } ``` # Filtres du journal de configuration par lecture Utilisez les paramètres de la configuration de lecture pour définir les types d'événements de journal MediaTailor émis par défaut à partir de cette configuration de lecture. MediaTailor utilise ces paramètres de filtrage de journal par défaut pour toutes les sessions qui n'incluent pas de paramètres de requête de filtrage dans la demande d'initialisation de session. Vous pouvez choisir d'effectuer les opérations suivantes : + Recevez des journaux pour des interactions spécifiques avec le serveur de décision publicitaire (ADS). + Exclure les journaux pour des interactions ADS spécifiques. + Excluez les journaux pour des interactions spécifiques avec le service de manifeste. Pour définir ces paramètres depuis la MediaTailor console, voir[Création d'une configuration](configurations-create.md). Pour l' MediaTailor API, voir [https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html)la *référence de l'AWS Elemental MediaTailor API*. Pour obtenir la liste des types de journaux et d'événements qui MediaTailor émettent, voir [Journaux du manifeste](log-types.md)[journaux ADS](ads-log-format.md), et[Journaux de transcodage](tm-log-format.md). # Génération de AWS Elemental MediaTailor journaux de débogage Utilisez les journaux de débogage pour résoudre les problèmes liés aux sessions de lecture MediaTailor et d'insertion de publicités. Pour générer des journaux de débogage, définissez le mode journal sur debug dans la demande du joueur sur. MediaTailor Pour les rapports côté serveur, définissez le mode journal dans la demande de *lecture*. Pour les rapports côté client, définissez le mode journal dans la demande d'*initialisation de session*. Lorsque le mode journal est défini sur Debug, MediaTailor écrit tous les types d'événements de journal dans CloudWatch Logs. Les journaux fournissent des informations sur les événements suivants. Pour une liste complète des données produites dans les journaux de débogage, consultez la section Champs des journaux de [débogage](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html#debug-log-mode-fields). + **Interaction avec l'origine** : détails sur MediaTailor les interactions avec le serveur d'origine. Par exemple, la réponse au manifeste d'origine, le type de manifeste et l'URL d'origine. + **Manifeste généré** : détails sur la réponse de la session de lecture à partir de MediaTailor. Par exemple, le manifeste qui MediaTailor génère. + **Session initialisée** : détails de l'initialisation de la session, tels que l'ID de session. Pour personnaliser les types d'événements de journal que vous recevez par session, consultez[Filtrage des journaux et des événements](logs-filter.md). ## Conditions préalables Pour configurer le mode journal sur Debug, vous devez d'abord MediaTailor autoriser l'envoi de journaux CloudWatch, si ce n'est déjà fait. Une fois que vous avez accordé l'autorisation MediaTailor d'accès CloudWatch, vous êtes prêt à activer le mode journal de débogage. Pour plus d'informations sur la façon d'accorder MediaTailor l'autorisation d'accès, CloudWatch consultez [Configuration des autorisations pour Amazon CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-permissions.html). ## Comment configurer le mode journal pour le débogage Cette section explique comment configurer le mode journal pour le débogage pour les rapports côté serveur et côté client. ### Rapports côté serveur Pour les rapports côté serveur, incluez le paramètre et la valeur de la `?aws.logMode=DEBUG` requête dans la demande de `GET HTTP` lecture envoyée par votre joueur au point de terminaison HLS ou DASH. MediaTailor Pour des informations générales sur les rapports côté serveur, voir Rapports côté [serveur](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-server-side.html). **Important** La valeur `DEBUG` est sensible à la casse. Une demande de lecture qui inclut `?aws.logMode=DEBUG` ressemble à ce qui suit : **Example Demande de lecture vers un point de terminaison HLS** ``` GET /v1/master///?aws.logMode=DEBUG ``` Après avoir défini le mode journal sur le débogage, nous vous recommandons de vérifier que la session de journalisation du débogage est active. Pour vérifier que la session de débogage est active, vérifiez s'il existe des CloudWatch journaux pour l'ID de session. L'ID de session est inclus dans le point de terminaison de lecture qui MediaTailor fournit. Pour de plus amples informations, veuillez consulter [Verify that the debug log mode is active for your playback session](#debug-active). ### Rapports côté client Pour les rapports côté client, incluez la `logMode` clé et la `DEBUG` valeur dans le corps de la demande d'initialisation de `POST HTTP` session de votre client au point de terminaison /v1/session. MediaTailor Pour des informations générales sur les rapports côté client, voir Rapports côté [client](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-client-side.html). **Important** La valeur `DEBUG` est sensible à la casse. Après avoir défini le mode journal sur Debug, nous vous recommandons de vérifier que la session de débogage est active. Pour vérifier que la session de débogage est active, vérifiez qu'un `SESSION_INITIALIZED` événement est associé à l'ID de session dans les CloudWatch journaux. L'ID de session est inclus dans le point de terminaison de lecture qui MediaTailor fournit. Pour de plus amples informations, veuillez consulter [Verify that the debug log mode is active for your playback session](#debug-active). ## Nombre maximum de sessions de débogage actives Vous pouvez avoir un maximum de 10 sessions de journal de débogage actives. Lorsque votre lecteur envoie sa demande d'initialisation de session ou de lecture à MediaTailor, MediaTailor vérifie si la limite a été atteinte. Si c'est le cas, MediaTailor vérifie s'il existe des sessions périmées. Une session est périmée si elle n'a pas été consultée pendant un certain laps de temps. Pour les diffusions en direct, cette durée est de 10 minutes, pour les diffusions VOD, elle est de 30 minutes. Si la limite maximale de sessions de journal de débogage actives est atteinte, les journaux de débogage ne sont pas écrits dans CloudWatch les journaux de votre session. Si les journaux de débogage ne figurent pas dans CloudWatch les journaux de votre session, vous avez peut-être atteint cette limite. Pour vérifier si la limite a été atteinte, consultez[Verify that the debug log mode is active for your playback session](#debug-active). ## Champs du journal de débogage Le tableau suivant répertorie les champs du journal de débogage qui MediaTailor écrivent dans. CloudWatch | Champ | Description | | --- | --- | | awsAccountId | Votre Compte AWS identifiant. | | customerId | Votre numéro de MediaTailor client. | | eventTimestamp | L'horodatage ISO 8601 associé à l'événement du journal de débogage. | | eventType | Type d'événement du journal de débogage. Valeurs :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/debug-log-mode.html) | | originRequestUrl | URL de votre serveur d'origine qui est récupérée pour cette demande. | | mediaTailorPath | Le MediaTailor point de terminaison qui a été appelé, y compris les paramètres transmis MediaTailor dans la demande de manifeste initiale. | | requestId | L'ID d'une requête HTTP spécifique adressée à MediaTailor. | | responseBody | Le manifeste contenu dans le corps de la réponse à partir de MediaTailor. Il s'agit soit du manifeste d'origine brut, soit du manifeste généré par MediaTailor. | | sessionId | ID de session de lecture. | | sessionType | Type de session de lecture. Valeurs: `HLS`, `DASH` | ## Lire les journaux de débogage MediaTailor écrit les journaux de débogage dans Amazon CloudWatch Logs. Les frais de CloudWatch journalisation habituels s'appliquent. Utilisez CloudWatch Insights pour lire les journaux de débogage. Pour plus d'informations sur l'utilisation de CloudWatch Logs Insights, consultez [Analyser les données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) dans le *guide de l'utilisateur d'AWS CloudWatch Logs*. **Note** L'affichage des journaux de débogage peut prendre quelques minutes. CloudWatch Si les journaux ne s'affichent pas, attendez quelques minutes et réessayez. Si les journaux ne s'affichent toujours pas, cela signifie peut-être que vous avez atteint le nombre maximal de sessions de journal de débogage actives. Pour vérifier si tel est le cas, exécutez une CloudWatch requête pour savoir si une session de débogage a été initialisée pour votre session de lecture. Pour de plus amples informations, veuillez consulter [Verify that the debug log mode is active for your playback session](#debug-active). ### Exemples Cette section contient des exemples de requêtes que vous pouvez utiliser pour lire les données du journal de MediaTailor débogage. **Example 1 : Vérifiez que le mode journal de débogage est actif pour votre session de lecture** ``` 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 : Afficher les réponses de votre origine** ``` fields @timestamp, responseBody, @message, mediaTailorPath | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90" ``` **Example 3 : Afficher le manifeste généré par MediaTailor pour une session donnée** ``` fields @timestamp, responseBody, @message | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90" ``` **Example 4 : Afficher tous les événements pour une donnée `requestId`** Utilisez cette requête pour afficher le manifeste d'origine et le manifeste généré par MediaTailor. ``` fields @timestamp, responseBody, @message, mediaTailorPath | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4" ``` # Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon Vous pouvez surveiller les AWS Elemental MediaTailor métriques à l'aide de CloudWatch. CloudWatch collecte des données brutes sur les performances du service et traite ces données en indicateurs lisibles en temps quasi réel. Ces statistiques sont enregistrées pour une durée de 15 mois ; par conséquent, vous pouvez accéder aux informations historiques et acquérir un meilleur point de vue de la façon dont votre service ou application web s’exécute. Vous pouvez également définir des alarmes qui surveillent certains seuils et envoient des notifications ou prennent des mesures lorsque ces seuils sont atteints. Pour plus d'informations, consultez le [guide de CloudWatch l'utilisateur Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). Les métriques peuvent être utiles lorsque vous étudiez des manifestes périmés. Pour de plus amples informations, veuillez consulter [Utilisation de métriques pour diagnostiquer les manifestes périmés](stale-manifest-diagnose.md). Les métriques sont d’abord regroupées par espace de noms de service, puis par les différentes combinaisons de dimension au sein de chaque espace de noms. **Pour afficher les métriques à l'aide de la CloudWatch console** 1. Ouvrez la CloudWatch console à l'adresse[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, sélectionnez ‎**Métriques**. 1. Sous **Toutes les métriques**, choisissez l'espace de **MediaTailor**noms. 1. Sélectionnez la dimension de métrique pour afficher les métriques (par exemple, pour **originID**). 1. Spécifiez la période que vous souhaitez afficher. **Pour afficher les métriques à l'aide du AWS Command Line Interface (AWS CLI)** + À partir d'une invite de commande, utilisez la commande suivante : ``` aws cloudwatch list-metrics --namespace "AWS/MediaTailor" ``` ## AWS Elemental MediaTailor CloudWatch métriques L' AWS Elemental MediaTailor espace de noms inclut les métriques suivantes. Ces métriques sont publiées par défaut sur votre compte. ### Métriques de l'assemblage des canaux (CA) Dans le tableau suivant, toutes les mesures sont disponibles par canal ou par canal de sortie. | Métrique | Description | | --- | --- | | 4xxErrorCount | Le nombre d'`4xx`erreurs. | | 5xxErrorCount | Le nombre d'`5xx`erreurs. | | RequestCount | Nombre total de demandes . Le nombre de transactions dépend largement de la fréquence à laquelle les joueurs demandent des manifestes mis à jour et du nombre de joueurs. Chaque demande de lecteur est comptabilisée comme une transaction. | | TotalTime | Temps nécessaire au serveur d'applications pour traiter la demande, y compris le temps nécessaire pour recevoir des octets et écrire des octets vers le client et le réseau. | #### Métriques d'insertion publicitaire (SSAI) côté serveur Le tableau suivant répertorie les mesures d'insertion de publicités côté serveur. | Métrique | Description | | --- | --- | | AdDecisionServer.Ads | Le nombre de publicités incluses dans les réponses du serveur de décision publicitaire (ADS) au cours de la CloudWatch période que vous avez spécifiée. | | AdDecisionServer.Duration | Durée totale, en millisecondes, de toutes les publicités MediaTailor reçues de l'ADS pendant la CloudWatch période que vous avez spécifiée. Cette durée peut être supérieure à celle `Avail.Duration` que vous avez spécifiée. | | AdDecisionServer.Errors | Le nombre de réponses par code d'état autres que le HTTP 200, de réponses vides et de réponses périmées MediaTailor reçues de l'ADS au cours de la CloudWatch période que vous avez spécifiée. | | AdDecisionServer.FillRate | Moyenne simple de la vitesse à laquelle les réponses de l'ADS ont rempli les diffusions de publicités individuelles correspondantes pour la période que vous avez spécifiée. Pour obtenir la moyenne pondérée, calculez `AdDecisionServer.Duration` sous forme de pourcentage de `Avail.Duration`. Pour plus d'informations sur les moyennes simples et pondérées, consultez [Moyennes simples et pondérées](#metrics-simple-average). | | AdDecisionServer.Latency | Temps de réponse en millisecondes pour les demandes adressées MediaTailor à l'ADS. | | AdDecisionServer.Timeouts | Le nombre de demandes d'expiration adressées à l'ADS au cours de la CloudWatch période que vous avez spécifiée. | | AdNotReady | Nombre de fois où l'ADS a pointé vers une publicité non encore transcodée par le service de transcodeur interne dans la période que vous avez spécifiée. Une valeur élevée pour cette métrique peut contribuer à un `Avail.FillRate` d'ensemble faible. | | AdsBilled | Nombre d'annonces facturées aux clients MediaTailor en fonction de leur insertion. | | Avail.Duration | Nombre total prévu de millisecondes de disponibilité publicitaire au cours de la période. CloudWatch Le total prévu est basé sur les durées de disponibilité indiquées dans le manifeste d'origine. | | Avail.FilledDuration | Le nombre prévu de millisecondes de temps de disponibilité des publicités qui MediaTailor seront diffusées au cours de cette période. CloudWatch | | Avail.FillRate | La moyenne simple planifiée des taux auxquels les annonces MediaTailor seront disponibles dans les CloudWatch délais impartis. Pour obtenir la moyenne pondérée, calculez `Avail.FilledDuration` sous forme de pourcentage de `Avail.Duration`. Pour plus d'informations sur les moyennes simples et pondérées, consultez [Moyennes simples et pondérées](#metrics-simple-average). Le `Avail.FillRate` maximal que MediaTailor peut atteindre est délimité par `AdDecisionServer.FillRate`. Si `Avail.FillRate` est faible, comparez-le à `AdDecisionServer.FillRate`. Si `AdDecisionServer.FillRate` est faible, votre ADS peut ne pas renvoyer suffisamment de publicités pour les durées de diffusion. | | Avail.Impression | Le nombre d'annonces associées à des événements de suivi des impressions qui MediaTailor sont affichées lors du balisage côté serveur (et non le nombre d'impressions). | | Avail.ObservedDuration | Nombre total de millisecondes d'utilisation publicitaire observé au cours de cette période. CloudWatch `Avail.ObservedDuration`est émis à la fin de la diffusion de la publicité et est basé sur la durée des segments signalés dans le manifeste pendant la diffusion de la publicité. | | Avail.ObservedFilledDuration | Nombre observé de millisecondes de temps de disponibilité des publicités MediaTailor pendant cette période. CloudWatch | | Avail.ObservedFillRate | La moyenne simple observée des taux auxquels les annonces individuelles MediaTailor remplies sont disponibles au cours de la CloudWatch période. Émis uniquement pour les manifestes HLS, au premier `CUE-IN` tag. S'il n'y a pas de `CUE-IN` balise, MediaTailor n'émet pas cette métrique. | | Avail.ObservedSlateDuration | Nombre total observé de millisecondes d'ardoise insérées au cours de la période. CloudWatch | | GetManifest.Age | Âge total du manifeste en millisecondes. Mesuré depuis le moment où l'origine crée le manifeste jusqu'au moment où il MediaTailor envoie le manifeste personnalisé. Pour plus d'informations sur les métriques permettant de mesurer l'âge du manifeste, voir[Utilisation de métriques pour diagnostiquer les manifestes périmés](stale-manifest-diagnose.md). | | GetManifest.Errors | Le nombre d'erreurs reçues lors MediaTailor de la génération des manifestes au cours de la CloudWatch période que vous avez spécifiée. | | GetManifest.Latency | Temps de MediaTailor réponse en millisecondes pour la demande de génération de manifestes. Pour plus d'informations sur les métriques permettant de mesurer l'âge du manifeste, voir[Utilisation de métriques pour diagnostiquer les manifestes périmés](stale-manifest-diagnose.md). | | GetManifest.MediaTailorAge | Durée pendant laquelle le manifeste a été stocké MediaTailor en millisecondes. Mesuré depuis le moment où il MediaTailor reçoit une réponse d'origine jusqu'au moment où il MediaTailor envoie le manifeste personnalisé. Pour plus d'informations sur les métriques permettant de mesurer l'âge du manifeste, voir[Utilisation de métriques pour diagnostiquer les manifestes périmés](stale-manifest-diagnose.md). | | Origin.Age | Durée pendant laquelle l'origine affiche le manifeste, en millisecondes. Mesuré entre le moment où l'origine crée le manifeste et le moment où MediaTailor envoie la demande d'origine. Toutes les `origin.*` métriques sont émises pour les demandes traitées directement depuis l'origine. Ils ne sont pas émis pour les réponses d'origine mises en cache. Pour plus d'informations sur les métriques permettant de mesurer l'âge du manifeste, voir[Utilisation de métriques pour diagnostiquer les manifestes périmés](stale-manifest-diagnose.md). | | Origin.Errors | Le nombre de réponses par code d'état autres que HTTP 200 et de réponses expirées MediaTailor reçues du serveur d'origine au cours de la CloudWatch période que vous avez spécifiée. Toutes les `origin.*` métriques sont émises pour les demandes traitées directement depuis l'origine. Ils ne sont pas émis pour les réponses d'origine mises en cache. | | Origin.ManifestFileSizeBytes | Taille du fichier du manifeste d'origine en octets pour HLS et DASH. Généralement, cette métrique est utilisée conjointement avec`Origin.ManifestFileSizeTooLarge`. Toutes les `origin.*` métriques sont émises pour les demandes traitées directement depuis l'origine. Ils ne sont pas émis pour les réponses d'origine mises en cache. | | Origin.ManifestFileSizeTooLarge | Le nombre de réponses provenant de l'origine dont la taille du manifeste est supérieure à la quantité configurée. Généralement, cette métrique est utilisée conjointement avec`Origin.ManifestFileSizeBytes`. Toutes les `origin.*` métriques sont émises pour les demandes traitées directement depuis l'origine. Ils ne sont pas émis pour les réponses d'origine mises en cache. | | Origin.Timeouts | Le nombre de demandes dont le délai d'expiration a expiré adressées au serveur d'origine au cours de la CloudWatch période que vous avez spécifiée. Toutes les `origin.*` métriques sont émises pour les demandes traitées directement depuis l'origine. Ils ne sont pas émis pour les réponses d'origine mises en cache. | | Requests | Le nombre de transactions simultanées par seconde pour tous les types de demandes. Le nombre de transactions dépend principalement du nombre de joueurs et de la fréquence à laquelle les joueurs demandent des manifestes mis à jour. Chaque demande de lecteur est comptabilisée comme une transaction. | | SkippedReason.DurationExceeded | Le nombre d'annonces qui n'ont pas été insérées dans un avail parce que l'ADS a renvoyé une durée d'annonces supérieure à la durée de disponibilité spécifiée. Une valeur élevée pour cette métrique peut contribuer à un écart entre la `AdDecisionServer.Ads` métrique `Avail.Ads` et. Pour plus d'informations sur les raisons pour lesquelles les publicités n'ont pas été publiées, consultez[Résolution des problèmes liés au non-respect des publicités](troubleshooting-ad-skipping-overview.md). | | SkippedReason.EarlyCueIn | Le nombre d'annonces ignorées en raison d'un retard. `CUE-IN` | | SkippedReason.ImportError | Nombre d'annonces ignorées en raison d'une erreur lors de l'importation. | | SkippedReason.ImportInProgress | Nombre d'annonces ignorées en raison d'une tâche d'importation active existante. | | SkippedReason.InternalError | Le nombre d'annonces ignorées en raison d'une erreur MediaTailor interne. | | SkippedReason.NewCreative | Le nombre d'annonces qui n'ont pas été insérées dans un fichier car c'était la première fois qu'un client en faisait la demande. Une valeur élevée pour cette métrique peut contribuer temporairement à un faible niveau global`Avail.FillRate`, jusqu'à ce que les actifs puissent être correctement transcodés. | | SkippedReason.NoVariantMatch | Le nombre d'annonces ignorées en raison de l'absence de correspondance entre l'annonce et le contenu. | | SkippedReason.PersonalizationThresholdExceeded | Durée des publicités dépassant le **seuil de personnalisation défini** dans cette configuration. | | SkippedReason.ProfileNotFound | Le nombre d'annonces ignorées en raison de l'impossibilité de trouver le profil de transcodage. | | SkippedReason.TranscodeError | Nombre d'annonces ignorées en raison d'une erreur de transcodage. | | SkippedReason.TranscodeInProgress | Le nombre d'annonces qui n'ont pas été insérées dans un fichier Avail parce que l'annonce n'avait pas encore été transcodée. Une valeur élevée pour cette métrique peut contribuer temporairement à un faible niveau global`Avail.FillRate`, jusqu'à ce que les actifs puissent être correctement transcodés. | | GetAssets.Requests | Le nombre de demandes de liste d'actifs reçues pour les sessions HLS Interstitials au cours de cette période. CloudWatch Utilisez cet indicateur pour surveiller le volume de décisions publicitaires contraignantes en retard et comprendre l'ampleur de l'utilisation des interstitiels HLS. | | GetAssets.Latency | Temps de réponse pour les demandes de liste d'actifs en millisecondes pour les sessions HLS Interstitials. Surveillez cet indicateur pour garantir des performances optimales en matière de prise de décision publicitaire et identifier les obstacles potentiels au flux de travail lié aux obligations tardives. | **Note** Pour les sessions HLS Interstitials, certains indicateurs se comportent différemment en raison de la nature contraignante tardive de la prise de décision publicitaire : `Avail.ObservedFilledDuration`correspond `Avail.FilledDuration` car il MediaTailor n'est pas possible d'observer le comportement réel de lecture côté client. `Avail.ObservedSlateDuration`indique la durée planifiée de la liste à partir des réponses à la liste des ressources plutôt que de la lecture observée. Les métriques préfixées par « Observé » fournissent des valeurs estimées pour les sessions HLS Interstitials. ### Moyennes simples et pondérées Vous pouvez récupérer la moyenne simple et la moyenne pondérée des réponses de l'ADS aux demandes d'annonces provenant des utilisateurs MediaTailor et du taux MediaTailor de disponibilité des annonces : + Les *moyennes simples* sont fournies dans `AdDecisionServer.FillRate` et `Avail.FillRate`. Il s'agit des moyennes des pourcentages de taux de remplissage pour les diffusions de publicités individuelles pour la période. Les moyennes simples ne prennent pas en compte les différences entre les durées des diffusions de publicités individuelles. + Les *moyennes pondérées* sont les pourcentages de taux de remplissage correspondant à la somme de toutes les durées de diffusion. Elles sont calculées sous la forme de (`AdDecisionServer.Duration` \$1 100)/`Avail.Duration` et (`Avail.FilledDuration` \$1 100)/`Avail.Duration`. Ces moyennes reflètent les différences de durée de chaque diffusion de publicités, en privilégiant celles qui ont une durée plus longue. Dans le cas d'une période qui contient une seule diffusion de publicités, la moyenne simple fournie par `AdDecisionServer.FillRate` est égale à la moyenne pondérée fournie par (`AdDecisionServer.Duration` \$1 100)/`Avail.Duration`. La moyenne simple fournie par `Avail.FillRate` est égale à la moyenne pondérée fournie par (`Avail.FilledDuration` \$1 100)/`Avail.Duration`. **Exemple** Supposons que la période que vous avez spécifiée inclut les deux diffusions de publicités suivantes : + La première diffusion de publicités a une durée de 90 secondes : + La réponse ADS pour la diffusion fournit 45 secondes de publicités (50 % remplis). + MediaTailor correspond à 45 secondes du temps publicitaire disponible (rempli à 50 %). + La seconde diffusion de publicités a une durée de 120 secondes : + La réponse ADS pour la diffusion fournit 120 secondes de publicités (100 % remplis). + MediaTailor correspond à 90 secondes du temps d'annonce disponible (rempli à 75 %). Les métriques sont les suivantes : + `Avail.Duration` est égal à 210, la somme des deux durées de diffusion de publicités : 90 \$1 120. + `AdDecisionServer.Duration` est égal à 165, la somme des deux durées de réponse : 45 \$1 120. + `Avail.FilledDuration` est égal à 135, la somme des deux durées remplies : 45 \$1 90. + `AdDecisionServer.FillRate` est égal à 75 %, la moyenne des pourcentages remplis pour chaque diffusion : (50 % \$1 100 %) / 2. Il s'agit de la moyenne simple. + La moyenne pondérée pour les taux de remplissage ADS est égale à 78,57 %, ce qui correspond à `AdDecisionServer.Duration` en tant que pourcentage de `Avail.Duration` : (165 \$1 100) / 210. Ce calcul tient compte des différences de durées. + `Avail.FillRate` est égal à 62,5 %, la moyenne des pourcentages remplis pour chaque diffusion : (50 % \$1 75 %) / 2. Il s'agit de la moyenne simple. + La moyenne pondérée des taux de MediaTailor remplissage disponibles est de 64,29 %, soit le `Avail.FilledDuration` pourcentage de `Avail.Duration` : (135\$1 100)/210. Ce calcul tient compte des différences de durées. Le maximum `Avail.FillRate` que l' MediaTailor on peut atteindre pour n'importe quel avantage publicitaire est de 100 %. L'ADS peut renvoyer plus temps de publicité que ce qui est disponible dans la diffusion, mais MediaTailor peut remplir seulement le temps disponible. ## AWS Elemental MediaTailor CloudWatch dimensions Vous pouvez filtrer les AWS Elemental MediaTailor données à l'aide de la dimension suivante. | Dimension | Description | | --- | --- | | `Configuration Name` | Indique la configuration à laquelle la métrique appartient. | # Utilisation de métriques pour diagnostiquer les manifestes périmés provenant de AWS Elemental MediaTailor Un manifeste périmé est un manifeste qui n'a pas été récemment mis à jour. Les différents flux de travail d'insertion d'annonces peuvent avoir une tolérance variable quant au temps qui doit s'écouler avant qu'un manifeste ne soit considéré comme périmé, en fonction de divers facteurs (tels que les exigences relatives aux systèmes en aval). Vous pouvez utiliser les CloudWatch métriques Amazon pour identifier les manifestes qui dépassent la tolérance d'obsolescence de votre flux de travail, et pour aider à identifier la cause des retards dans les mises à jour des manifestes. Les indicateurs suivants permettent d'identifier les manifestes périmés et leurs causes. Pour plus d'informations sur toutes les MediaTailor métriques émises, consultez[AWS Elemental MediaTailor CloudWatch métriques](monitoring-cloudwatch-metrics.md#metrics). | Métrique | Définition | Utilisation | | --- | --- | --- | | GetManifest.Age | Mesure l'âge total du manifeste, y compris les deux `GetManifest.MediaTailorAge` et `Origin.Age` pour cette configuration. | Vous pouvez utiliser cette métrique pour identifier les manifestes qui dépassent votre seuil de mise à jour et qui sont périmés. Définissez des alarmes sur cette métrique afin d'être alerté lorsque des manifestes périmés sont servis. Pour plus d'informations sur les alarmes, consultez la [section Alarmes relatives aux métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) dans le *guide de CloudWatch l'utilisateur Amazon.* Lorsque vous recevez une alarme, utilisez `Origin.Age` et `GetManifest.MediaTailorAge` pour identifier si MediaTailor l'origine est à l'origine de l'obsolescence. | | Origin.Age | Mesure la durée pendant laquelle l'origine possède le manifeste avant de l'envoyer MediaTailor pour cette configuration.Cette métrique n'est pas émise lorsque la réponse provient d'un réseau de diffusion de contenu (CDN). La réponse doit provenir de l'origine `Origin.Age` pour être émise. | Lorsque vous identifiez des manifestes périmés avec`GetManifest.Age`, vous pouvez analyser la `Origin.Age` métrique et la `GetManifest.MediaTailorAge` métrique pour déterminer ce qui contribue à l'obsolescence des manifestes. Si vous constatez que ce délai de traitement `Origin.Age` est plus long que vos délais habituels à l'origine, c'est probablement le système en amont qui est à l'origine du problème et vous devez vous concentrer sur les diagnostics. | | GetManifest.MediaTailorAge | Mesure la durée pendant MediaTailor laquelle ce manifeste est stocké pour cette configuration. | Lorsque vous identifiez des manifestes périmés avec`GetManifest.Age`, vous pouvez analyser la `GetManifest.MediaTailorAge` métrique et la `Origin.Age` métrique pour déterminer ce qui contribue à l'obsolescence des manifestes. Si le délai de personnalisation du manifeste `GetManifest.MediaTailorAge` est plus long que d'habitude MediaTailor, il MediaTailor est probable que cela soit à l'origine du problème et vous devez vous concentrer sur les diagnostics. `GetManifest.Latency`peut mieux identifier le temps nécessaire MediaTailor à la création d'un manifeste personnalisé. | | GetManifest.Latency | Mesure le temps nécessaire MediaTailor au traitement de la demande et crée un manifeste personnalisé pour cette configuration. | Lorsque vous comparez `Origin.Age` `GetManifest.MediaTailorAge` et déterminez que MediaTailor c'est la cause du retard de livraison du manifeste, vous pouvez analyser la `GetManifest.Latency` métrique pour déterminer si le processus de personnalisation du manifeste contribue à l'obsolescence du manifeste. `GetManifest.MediaTailorAge`mesure la durée totale pendant laquelle le manifeste est stocké MediaTailor. `GetManifest.Latency`mesure la part de cette durée de stockage consacrée à la MediaTailor personnalisation du manifeste en réponse à une demande. | # Enregistrement des appels AWS Elemental MediaTailor d'API AWS Elemental MediaTailor est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dans MediaTailor. CloudTrail capture tous les appels d'API MediaTailor sous forme d'événements. Les appels capturés incluent des appels provenant de la MediaTailor console et des appels de code vers les opérations de l' MediaTailor API. Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris les événements pour MediaTailor. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans **Historique des événements**. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite MediaTailor, l'adresse IP à partir de laquelle la demande a été faite, qui a fait la demande, quand elle a été faite et des détails supplémentaires. Pour en savoir plus CloudTrail, consultez le [guide de AWS CloudTrail l'utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html). ## AWS Elemental MediaTailor informations dans CloudTrail CloudTrail est activé sur votre AWS compte lorsque vous le créez. Lorsqu'une activité se produit dans AWS Elemental MediaTailor, cette activité est enregistrée dans un CloudTrail événement avec d'autres événements de AWS service dans **l'historique des événements**. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre AWS compte. Pour plus d'informations, consultez la section [Affichage des événements avec l'historique des CloudTrail événements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Pour un enregistrement continu des événements de votre AWS compte, y compris des événements pour AWS Elemental MediaTailor, créez un parcours. Un *suivi* permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un parcours dans la console, celui-ci s'applique à toutes les AWS régions. Le journal enregistre les événements de toutes les régions de la AWS partition et transmet les fichiers journaux au compartiment Amazon S3 que vous spécifiez. En outre, vous pouvez configurer d'autres AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour plus d’informations, consultez les ressources suivantes : + [Création d'un parcours pour votre AWS compte](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [AWS intégrations de services avec journaux CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configuration des notifications Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html) + [Réception de fichiers CloudTrail journaux de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [réception de fichiers CloudTrail journaux de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Toutes les AWS Elemental MediaTailor actions sont enregistrées CloudTrail et documentées dans la [référence de l'AWS Elemental MediaTailor API](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html). Par exemple, les appels aux opérations `PutPlaybackConfiguration` et `ListPlaybackConfigurations` génèrent des entrées dans les fichiers journaux CloudTrail. Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants : + Si la demande a été faite avec les informations d'identification de l'utilisateur root ou Gestion des identités et des accès AWS (IAM) + Si la demande a été effectuée avec des informations d’identification de sécurité temporaires pour un rôle ou un utilisateur fédéré + Si la demande a été faite par un autre AWS service Pour de plus amples informations, veuillez consulter [Élément CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Comprendre les entrées du fichier AWS Elemental MediaTailor journal Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande individuelle à partir d'une source quelconque et comprend des informations sur l'action demandée, sur tous les paramètres, les paramètres de la demande, etc. Les fichiers journaux CloudTrail ne sont pas des séries ordonnées retraçant les appels d'API publics. Ils ne suivent aucun ordre précis. L'exemple suivant montre une entrée de CloudTrail journal qui illustre l'`PutPlaybackConfiguration`action : ``` { "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" } ``` L'exemple suivant montre une entrée de CloudTrail journal qui illustre l'`GetPlaybackConfiguration`action : ``` { "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" } ``` # Réception d'alertes d'assemblage de AWS Elemental MediaTailor canaux MediaTailor crée des alertes en cas de problèmes actuels ou potentiels liés à vos ressources d'assemblage de chaînes. L'alerte décrit le problème, le moment où il s'est produit et les ressources concernées. Vous pouvez consulter les alertes dans le AWS Management Console, le AWS Command Line Interface (AWS CLI) ou par programmation à l'aide de l' MediaTailor [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API. AWS SDKs **Important** Les alertes ne sont disponibles que pour les ressources d'assemblage de chaînes créées le 14 juillet 2021 ou après cette date. **Alertes d'assemblage de canaux** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/channel-assembly-alerts.html) ## Résolution des alertes liées aux manifestes Lorsque vous recevez des alertes liées au manifeste`UNPARSABLE_MANIFEST`, telles que, ou `VARIANT_DURATION_MISMATCH``TARGET_DURATION_MISMATCH`, vérifiez les points suivants : 1. **Vérifiez les exigences relatives à la source** : assurez-vous que votre contenu répond aux exigences décrites dans[Intégration d'une source de contenu pour l'insertion d' MediaTailor annonces](integrating-origin.md). 1. **Consulter les journaux des manifestes** : pour une analyse détaillée des erreurs manifestes et des types d'événements, voir[AWS Elemental MediaTailor description des journaux manifestes et types d'événements](log-types.md). 1. **Vérifier les codes d'erreur** : pour une analyse détaillée des erreurs, voir[Résolution des problèmes MediaTailor](troubleshooting.md). 1. **Vérifiez le format du manifeste** : vérifiez que votre manifeste respecte les spécifications de format correctes pour votre protocole de streaming (HLS ou DASH). ## Afficher les alertes Vous pouvez consulter les alertes pour n'importe quelle ressource d'assemblage de MediaTailor canaux. Lorsque vous consultez les alertes relatives aux chaînes et aux programmes, cela MediaTailor inclut toutes les ressources associées contenues dans la chaîne ou le programme. Par exemple, lorsque vous consultez les alertes d'un programme spécifique, vous voyez également des alertes relatives à l'emplacement de la source et aux sources de VOD contenues dans le programme. Pour consulter les alertes, procédez comme suit. ------ #### [ Console ] **Pour afficher les alertes dans la console** 1. Ouvrez la MediaTailor console à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Choisissez la ressource pour laquelle vous souhaitez consulter les alertes. 1. Sélectionnez l'onglet **Alertes** pour afficher les alertes. ------ #### [ AWS Command Line Interface (AWS CLI) ] Pour répertorier les alertes relatives à une ressource d'assemblage de canaux, vous avez besoin du [nom de ressource Amazon (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) de la ressource. Vous pouvez utiliser la `describe-resource_type` commande dans le AWS Command Line Interface (AWS CLI) pour obtenir l'ARN de la ressource. Par exemple, exécutez la commande [describe-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/describe-channel.html) pour obtenir l'ARN d'un canal spécifique : ``` aws mediatailor describe-channel --channel-name MyChannelName ``` Utilisez ensuite la commande [aws mediatailor list-alerts pour répertorier les alertes](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/list-alerts.html) associées à la ressource : ``` aws mediatailor list-alerts --resource-arn arn:aws:mediatailor:region:aws-account-id:resource-type/resource-name ``` ------ #### [ API ] Pour répertorier les alertes relatives à une ressource d'assemblage de canaux, vous avez besoin du [nom de ressource Amazon (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) de la ressource. Vous pouvez utiliser l'`DescribeResource`opération dans l' MediaTailor API pour obtenir l'ARN de la ressource. Par exemple, utilisez l'[DescribeChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeChannel.html)opération pour obtenir l'ARN d'un canal spécifique. Utilisez ensuite l'[ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API pour répertorier les alertes relatives à la ressource. ------ ## Gestion des alertes Lorsqu'une alerte se produit, visualisez les alertes dans l' AWS Management Console API MediaTailor Alerts ou utilisez l'API AWS Command Line Interface (AWS CLI) ou Alerts pour déterminer les sources possibles du problème. AWS SDKs Une fois le problème résolu, l' MediaTailor alerte est supprimée. # Ressources de balisage AWS Elemental MediaTailor Une *balise* est une étiquette de métadonnées que vous attribuez ou que vous AWS attribuez à une AWS ressource. Chaque balise se compose d’une *clé* et d’une *valeur*. Pour les balises que vous attribuez, vous définissez la clé et la valeur. Par exemple, vous pouvez définir la clé sur `stage` et la valeur pour une ressource sur `test`. Les balises vous permettent d’effectuer les actions suivantes : + Identifiez et organisez vos AWS ressources. De nombreux AWS services prennent en charge le balisage. Vous pouvez donc attribuer le même tag aux ressources de différents services pour indiquer que les ressources sont liées. Par exemple, vous pouvez attribuer la même balise à un AWS Elemental MediaPackage canal et à un point de terminaison que celle que vous attribuez à une AWS Elemental MediaTailor configuration. + Suivez vos AWS coûts. Vous activez ces balises sur le AWS Billing and Cost Management tableau de bord. AWS utilise les balises pour classer vos coûts et vous fournir un rapport mensuel de répartition des coûts. Pour plus d’informations, consultez [Utilisation des balises de répartition des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dans le [Guide de l’utilisateur AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/). + Contrôlez l'accès à vos AWS ressources. Pour de plus amples informations, veuillez consulter [Contrôle de l'accès à l'aide d'identifications](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) dans le [Guide de l'utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html). Les sections suivantes fournissent plus d'informations sur les balises pour AWS Elemental MediaTailor. ## Ressources prises en charge dans AWS Elemental MediaTailor Les ressources suivantes prennent en AWS Elemental MediaTailor charge le balisage : + Canaux + Configurations + SourceLocations + VodSources ## Restrictions liées aux balises Les restrictions de base suivantes s'appliquent aux balises sur les AWS Elemental MediaTailor ressources : + Nombre maximum d'étiquettes que vous pouvez attribuer à une ressource – 50 + Longueur de clé maximale : 128 caractères Unicode + Longueur de valeur maximale : 256 caractères Unicode + Caractères valides pour les clés et valeurs – a-z, A-Z, 0-9, espace et les caractères suivants : \$1 . : / = \$1 - et @ + Les clés et les valeurs font la distinction majuscules/minuscules + N'utilisez pas `aws:` comme préfixe pour les clés ; seul AWS peut utiliser cette valeur ## Gestion des balises dans AWS Elemental MediaTailor Vous définissez des balises en tant que propriétés sur une ressource. Vous pouvez ajouter, modifier et supprimer des balises via l' AWS Elemental MediaTailor API ou le AWS Command Line Interface (AWS CLI). Pour plus d’informations, consultez la [Référence des API AWS Elemental MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html). # Surveillance des services AWS multimédias avec un moniteur de flux de travail Le moniteur de flux de travail est un outil de découverte, de visualisation et de surveillance des flux de travail AWS multimédia. Le moniteur de flux de travail est disponible dans la AWS console et dans l'API. Vous pouvez utiliser le moniteur de flux de travail pour découvrir et créer des mappages visuels des ressources de votre flux de travail, appelés *cartes de signaux*. Vous pouvez créer et gérer des modèles CloudWatch d'alarme Amazon et de EventBridge règles Amazon pour surveiller les ressources mappées. Les modèles de surveillance que vous créez sont transformés en AWS CloudFormation modèles déployables pour permettre la répétabilité. AWS les modèles d'alarme recommandés fournissent une surveillance prédéfinie basée sur les meilleures pratiques. **Découvrez** Utilisez des cartes de signaux pour découvrir automatiquement les AWS ressources interconnectées associées à votre flux de travail multimédia. La découverte peut commencer par n'importe quelle ressource de service prise en charge et crée un end-to-end mappage du flux de travail. Les cartes de signaux peuvent être utilisées comme outils de visualisation autonomes ou améliorées à l'aide de modèles de surveillance. ![\[Composants de découverte du moniteur de flux de travail.\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/workflowmonitor-discovery.png) Surveiller Vous pouvez créer des modèles CloudWatch d'alarme et de EventBridge règles personnalisés pour surveiller l'état et l'état de vos flux de travail multimédia. Des modèles d'alarme conformes aux meilleures pratiques peuvent être importés dans votre environnement de surveillance des flux de travail. Vous pouvez utiliser les modèles d'alarme conformes aux meilleures pratiques tels quels ou les modifier pour mieux les adapter à votre flux de travail. Tous les modèles que vous créez sont transformés en CloudFormation modèles pour un déploiement reproductible. ![\[Composants de surveillance du flux de travail.\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/workflowmonitor-monitoring.png) **Note** L'utilisation du moniteur de flux de travail n'entraîne aucun coût direct. Cependant, certains coûts sont associés aux ressources créées et utilisées pour surveiller votre flux de travail. Lorsque la surveillance est déployée, Amazon CloudWatch et EventBridge des ressources Amazon sont créées. Lorsque vous utilisez la console de AWS gestion, avant de déployer la surveillance sur une carte de signaux, vous serez informé du nombre de ressources qui seront créées. Pour plus d'informations sur la tarification, voir : [CloudWatchtarification](https://aws.amazon.com/cloudwatch/pricing/) et [EventBridge tarification](https://aws.amazon.com/eventbridge/pricing/). Workflow Monitor utilise des AWS CloudFormation modèles pour déployer les EventBridge ressources CloudWatch et. Ces modèles sont stockés dans un bucket Amazon Simple Storage Service de classe standard créé en votre nom, par Workflow Monitor, pendant le processus de déploiement et qui entraînera des frais de stockage d'objets et de rappel. Pour plus d'informations sur la tarification, consultez : [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/). Les aperçus générés dans la carte des signaux du moniteur de flux de travail pour les AWS Elemental MediaPackage canaux sont fournis depuis le point de terminaison MediaPackage Origin et entraînent des frais de transfert de données sortantes. Pour les tarifs, voir : [MediaPackagetarification](https://aws.amazon.com/mediapackage/pricing/). ## Composants du moniteur de flux de travail Le moniteur de flux de travail comporte quatre composants principaux : + CloudWatch modèles d'alarme - Définissez les conditions que vous souhaitez surveiller à l'aide CloudWatch. Vous pouvez créer vos propres modèles d'alarme ou importer des modèles prédéfinis créés par AWS. Pour plus d'informations, voir : [CloudWatch groupes d'alarmes et modèles pour surveiller votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-alarms.md) + EventBridge modèles de règles - Définissez le mode d' EventBridge envoi des notifications lorsqu'une alarme est déclenchée. Pour plus d'informations, voir : [EventBridge groupes de règles et modèles pour surveiller votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-notifications.md) + Cartes de signaux - Utilisez un processus automatisé pour créer des cartes de flux de travail AWS élémentaires à l'aide des AWS ressources existantes. Les cartes de signaux peuvent être utilisées pour découvrir les ressources de votre flux de travail et déployer une surveillance sur ces ressources. Pour plus d'informations, voir : [Cartes des signaux du moniteur de flux de travail](monitor-with-workflow-monitor-configure-signal-maps.md) + Vue d'ensemble - La page de présentation vous permet de surveiller directement l'état de plusieurs cartes de signaux à partir d'un seul endroit. Passez en revue les métriques, les journaux et les alarmes de vos flux de travail. Pour plus d'informations, voir : [Présentation du moniteur de flux de travail](monitor-with-workflow-monitor-operate-overview.md) ## Services pris en charge Le moniteur de flux de travail prend en charge la découverte automatique et le mappage des signaux des ressources associées aux services suivants : + AWS Elemental MediaConnect + AWS Elemental MediaLive + AWS Elemental MediaPackage + AWS Elemental MediaTailor + Amazon S3 + Amazon CloudFront **Topics** + [Composants du moniteur de flux de travail](#monitor-with-workflow-monitor-components) + [Services pris en charge](#monitor-with-workflow-monitor-supported-services) + [Configuration du moniteur de flux de travail pour surveiller AWS les services multimédias](monitor-with-workflow-monitor-configure.md) + [Utilisation du moniteur de flux de travail](monitor-with-workflow-monitor-operate.md) # Configuration du moniteur de flux de travail pour surveiller AWS les services multimédias Pour configurer le moniteur de flux de travail pour la première fois, vous créez les modèles d'alarme et d'événement, et vous découvrez les cartes de signaux utilisées pour surveiller vos flux de travail multimédia. Le guide suivant décrit les étapes nécessaires pour configurer les rôles IAM de niveau administrateur et opérateur, créer des ressources de surveillance des flux de travail et déployer la surveillance dans vos flux de travail. **Topics** + [Commencer à utiliser le moniteur de flux de travail](monitor-with-workflow-monitor-configure-getting-started.md) + [Groupes et modèles de surveillance des flux de travail](monitor-with-workflow-monitor-configure-templates.md) + [Cartes des signaux du moniteur de flux de travail](monitor-with-workflow-monitor-configure-signal-maps.md) + [Quotas de surveillance des workflows](monitor-with-workflow-monitor-configure-quotas.md) # Commencer à utiliser le moniteur de flux de travail Les étapes suivantes fournissent un aperçu de base de la première utilisation du moniteur de flux de travail. 1. Configurer les autorisations IAM de surveillance du flux de travail pour les rôles d'administrateur et d'opérateur : [Politiques IAM de surveillance des flux de travail](monitor-with-workflow-monitor-configure-getting-started-IAM.md) 1. Créez des modèles d'alarme ou importez des modèles prédéfinis créés par AWS : [Alarmes CloudWatch](monitor-with-workflow-monitor-configure-alarms.md) 1. Créez des événements de notification qui seront diffusés par EventBridge : [EventBridge règles ](monitor-with-workflow-monitor-configure-notifications.md) 1. Découvrez des cartes de signalisation à l'aide de vos ressources AWS élémentaires existantes : [Cartes des signaux ](monitor-with-workflow-monitor-configure-signal-maps.md) 1. Joignez les modèles d'alarme et les règles de notification à votre carte des signaux : [Joindre des modèles](monitor-with-workflow-monitor-configure-signal-maps-attach.md) 1. Déployez les modèles pour commencer à surveiller la carte des signaux : [Déploiement de modèles de surveillance](monitor-with-workflow-monitor-configure-deploy.md) 1. Surveillez et passez en revue les ressources de surveillance de votre flux de travail à l'aide de la section de présentation de la AWS console : [Présentation de ](monitor-with-workflow-monitor-operate-overview.md) ![\[Les différentes étapes de configuration du moniteur de flux de travail. Commencez par créer les rôles IAM. Créez ensuite des modèles pour les alarmes et les événements. Ensuite, découvrez une carte de signalisation et associez vos modèles à la carte. Une fois que des modèles sont joints à une carte de signaux, ceux-ci doivent être déployés. La dernière étape consiste à effectuer la surveillance à l'aide des modèles et des ressources de présentation.\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/workflowmonitor-overview-steps.png) # Politiques IAM de surveillance des flux de travail Le moniteur de flux de travail interagit avec plusieurs AWS services pour créer des cartes de signaux, des builds, EventBridge des ressources CloudWatch et des CloudFormation modèles. Étant donné que le moniteur de flux de travail interagit avec un large éventail de services, des politiques spécifiques Gestion des identités et des accès AWS (IAM) doivent être attribuées à ces services. Les exemples suivants indiquent les politiques IAM nécessaires pour les rôles IAM d'administrateur et d'opérateur. ## Politique IAM de l'administrateur L'exemple de politique suivant concerne une stratégie IAM de surveillance des flux de travail au niveau de l'administrateur. Ce rôle permet de créer et de gérer les ressources du moniteur de flux de travail et les ressources de service prises en charge qui interagissent avec le moniteur de flux de travail. ------ #### [ 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": "*" } ] } ``` ------ ## Politique IAM de l'opérateur L'exemple de politique suivant concerne une stratégie IAM de surveillance des flux de travail au niveau de l'opérateur. Ce rôle permet un accès limité et en lecture seule aux ressources du moniteur de flux de travail et aux ressources de service prises en charge qui interagissent avec le moniteur de flux de travail. ------ #### [ 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": "*" } ] } ``` ------ # Groupes et modèles de surveillance des flux de travail Avant de déployer la surveillance du flux de travail sur une carte des signaux, vous devez créer les groupes et les modèles pour les CloudWatch alarmes et EventBridge les notifications. Les CloudWatch modèles définissent les scénarios et les seuils qui seront utilisés pour déclencher les alarmes. Les EventBridge modèles détermineront la manière dont ces alarmes vous seront signalées. Si vous souhaitez uniquement des mappages de vos ressources connectées et que vous ne souhaitez pas utiliser les fonctionnalités des modèles de surveillance de Workflow Monitor, les cartes de signaux peuvent être utilisées sans CloudWatch les EventBridge modèles. Pour plus d'informations sur l'utilisation des cartes de signaux, voir : [Cartes des signaux ](monitor-with-workflow-monitor-configure-signal-maps.md) **Topics** + [CloudWatch groupes d'alarmes et modèles pour surveiller votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-alarms.md) + [EventBridge groupes de règles et modèles pour surveiller votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-notifications.md) # CloudWatch groupes d'alarmes et modèles pour surveiller votre flux de travail AWS multimédia Les alarmes de surveillance du flux de travail vous permettent d'utiliser CloudWatch les métriques existantes comme base des alarmes pour vos cartes de signaux. Vous pouvez créer un groupe de modèles d'alarmes pour trier et classer les types d'alarmes importants pour votre flux de travail. Au sein de chaque groupe de modèles d'alarme, vous créez des modèles d'alarme avec CloudWatch des mesures et des paramètres spécifiques que vous souhaitez surveiller. Vous pouvez créer vos propres modèles d'alarme ou importer des modèles d'alarme recommandés créés par AWS. Après avoir créé un groupe de modèles d'alarme et des modèles d'alarme au sein de ce groupe, vous pouvez associer un ou plusieurs de ces groupes de modèles d'alarme à une carte des signaux. Vous devez d'abord créer un groupe de modèles d'alarmes. Après avoir créé un groupe de modèles d'alarme, vous pouvez créer vos propres modèles ou utiliser les modèles recommandés créés par AWS. Si vous souhaitez créer vos propres modèles d'alarme, continuez sur cette page. Pour plus d'informations sur l'importation de modèles recommandés, voir : [Modèles recommandés](monitor-with-workflow-monitor-configure-alarms-recommended-templates.md) Cette section traite de la création d' CloudWatch alarmes à l'aide du moniteur de flux de travail. Pour plus d'informations sur la façon dont le CloudWatch service gère les alarmes et pour en savoir plus sur les composants des alarmes, consultez : [Utilisation des CloudWatch alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) dans le *guide de CloudWatch l'utilisateur Amazon* ## Création de groupes de modèles d'alarmes Les groupes de modèles d'alarmes vous permettent de trier et de classer les types d'alarmes importants pour votre flux de travail. **Pour créer un groupe de modèles d'alarmes** 1. Dans le volet de navigation de la console Workflow Monitor, sélectionnez les **modèles CloudWatch d'alarme**. 1. Sélectionnez **Créer un groupe de modèles d'alarme**. 1. Donnez au groupe de modèles d'alarme un **nom de groupe** unique et une **description** facultative. 1. Sélectionnez **Créer**. Vous serez redirigé vers la page de détails du groupe de modèles d'alarmes nouvellement créé. ## Création de modèles d'alarme Vous pouvez créer des modèles d'alarme avec les CloudWatch métriques et les paramètres que vous souhaitez surveiller. **Pour créer un modèle d'alarme** 1. Sur la page de détails du groupe de modèles d'alarme, sélectionnez **Créer un modèle d'alarme**. 1. Donnez au modèle d'alarme un **nom de modèle** unique et une **description** facultative. 1. Dans la section **Choisir une métrique** : 1. Sélectionnez un **type de ressource cible**. Le type de ressource cible est une ressource pour le service concerné, telle qu'un canal pour MediaLive MediaPackage et/ou un flux pour MediaConnect. 1. Sélectionnez un **nom de métrique**. Il s'agit de la CloudWatch métrique qui sert de base à l'alarme. La liste des mesures changera en fonction du **type de ressource cible** sélectionné. 1. Dans la section **Paramètres de l'alarme** : **Note** Pour plus d'informations sur la façon dont le CloudWatch service gère les alarmes et pour en savoir plus sur les composants des alarmes, consultez : [Utilisation des CloudWatch alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) dans le *guide de CloudWatch l'utilisateur Amazon* 1. Sélectionnez la **statistique.** Il s'agit d'une valeur telle qu'une **somme** ou une **moyenne** qui sera utilisée pour surveiller la métrique. 1. Sélectionnez l'**opérateur de comparaison**. Ce champ fait référence au **seuil** que vous avez défini à l'étape suivante. 1. Définissez un **seuil**. Il s'agit d'une valeur numérique que l'**opérateur de comparaison** utilise pour déterminer une valeur supérieure, inférieure ou égale au statut. 1. Définissez une **période**. Il s'agit d'une valeur temporelle, en secondes. La **période** est la durée pendant laquelle la **statistique**, l'**opérateur de comparaison** et le **seuil** interagissent pour déterminer si l'alarme est déclenchée. 1. Définissez les points de **données.** Cette valeur détermine le nombre de points de données nécessaires pour déclencher l'alarme. 1. Sélectionnez le mode de **traitement des données manquantes**. Cette sélection détermine la façon dont cette alarme réagit aux données manquantes. 1. Sélectionnez **Créer** pour terminer le processus. Un exemple de modèle d'alarme terminé peut comporter les paramètres suivants : Un **type de ressource cible** de MediaConnect flux est surveillé pour le **nom de la métrique** de déconnexions. La valeur **statistique** est définie sur Somme avec un **opérateur de comparaison** « supérieur ou égal à » et un **seuil** de 10. La **période** est fixée à 60 secondes et ne nécessite qu'un point de **données sur 1.** **Traiter les données manquantes** est défini sur « ignorer ». Le résultat de ces paramètres est le suivant : le moniteur du flux de travail surveillera les déconnexions sur le flux. Si 10 déconnexions ou plus se produisent dans les 60 secondes, l'alarme se déclenche. 10 déconnexions ou plus en 60 secondes ne doivent se produire qu'une seule fois pour que l'alarme se déclenche. # Modèles d'alarme recommandés pour surveiller votre flux de travail AWS multimédia Les modèles recommandés par Workflow Monitor sont une sélection organisée de métriques de service AWS Elemental avec des paramètres d'alarme prédéfinis adaptés à la métrique. Si vous ne souhaitez pas créer de modèles d'alarme personnalisés, les modèles recommandés vous fournissent des modèles de surveillance conformes aux meilleures pratiques créés par AWS. Le moniteur de flux de travail contient des groupes de modèles recommandés pour chaque service pris en charge. Ces groupes sont conçus pour appliquer la surveillance des meilleures pratiques à des types de flux de travail spécifiques. Chaque groupe de modèles contient une sélection organisée d'alarmes configurées à partir de métriques spécifiques au service. Par exemple, un groupe de modèles recommandé pour un flux de travail MediaLive multiplex comportera un ensemble de mesures préconfigurées différent de celui d'un flux de travail MediaConnect CDI. **Pour utiliser les modèles d'alarme recommandés** 1. Suivez les étapes pour [créer un groupe de modèles d'alarmes](monitor-with-workflow-monitor-configure-alarms.md#monitor-with-workflow-monitor-alarms-groups-create) ou sélectionnez-en un existant. 1. Dans la section **Modèles d'alarme**, sélectionnez **Importer**. Vous devrez importer les modèles AWS recommandés dans votre groupe de modèles. 1. Utilisez le menu déroulant **des groupes de modèles d'CloudWatch alarme** pour sélectionner un groupe AWS recommandé. Ces groupes contiennent des alarmes sélectionnées pour des services spécifiques. 1. Sélectionnez les modèles à importer à l'aide des cases à cocher. Chaque modèle répertorie ses métriques, ses valeurs de surveillance préconfigurées et fournit une description de la métrique. Lorsque vous avez terminé de sélectionner les modèles, cliquez sur le bouton **Ajouter**. 1. Les modèles sélectionnés seront déplacés vers la section **Modèles d'alarme à importer**. Passez en revue vos choix et sélectionnez **Importer**. 1. Une fois l'importation terminée, les modèles sélectionnés seront ajoutés au groupe de modèles. Si vous souhaitez ajouter d'autres modèles, répétez le processus d'importation. 1. Les modèles importés peuvent être personnalisés après l'importation. Les paramètres d'alarme peuvent être modifiés pour répondre à vos besoins en matière d'alarme. # EventBridge groupes de règles et modèles pour surveiller votre flux de travail AWS multimédia CloudWatch utilise les EventBridge règles d'Amazon pour envoyer des notifications. Vous commencez par créer un groupe de modèles d'événements. Dans ce groupe de modèles d'événements, vous créez des modèles d'événements qui déterminent quelles conditions créent une notification et qui est averti. Cette section traite de la création de EventBridge règles à l'aide du moniteur de flux de travail. Pour plus d'informations sur la manière dont le EventBridge service utilise les règles, consultez : [EventBridge règles](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) dans le *guide de EventBridge l'utilisateur Amazon* ## Création de groupes de modèles d'événements Les groupes de modèles d'événements vous permettent de trier et de classer les événements en fonction de votre cas d'utilisation. **Pour créer un groupe de modèles d'événements** 1. Dans le volet de navigation de la console Workflow Monitor, sélectionnez des **modèles de EventBridge règles**. 1. Sélectionnez **Créer un groupe de modèles d'événements**. 1. Donnez au groupe de modèles d'alarme un **nom de groupe** unique et une **description** facultative. 1. Sélectionnez **Créer**. Vous serez redirigé vers la page de détails du groupe de modèles d'alarmes nouvellement créé. ## Création de modèles d'événements Vous pouvez envoyer des notifications en fonction des modèles d'événements que vous créez. **Pour créer un modèle d'événement** 1. Sur la page de détails du groupe de modèles d'événements, sélectionnez **Créer un modèle d'événement**. 1. Donnez au modèle d'événement un **nom de modèle** unique et une **description** facultative. 1. Dans la section **Paramètres des règles** : 1. Sélectionnez un **type d'événement**. Lorsque vous sélectionnez un type d'événement, vous pouvez choisir entre plusieurs événements créés par AWS ou sélectionner **Signal map active alarm** pour utiliser une alarme créée par un modèle d'alarme. 1. Sélectionnez un **service cible**. Cela détermine la manière dont vous souhaitez être informé de cet événement. Vous pouvez sélectionner Amazon Simple Notification Service ou CloudWatch les journaux. 1. **Après avoir sélectionné un service cible, sélectionnez-en un.** Il s'agira d'une rubrique Amazon SNS ou d'un groupe de CloudWatch journaux, selon le service cible que vous avez sélectionné. 1. Sélectionnez **Créer** pour terminer le processus. # Cartes des signaux du moniteur de flux de travail Les cartes de signaux sont des mappages visuels des AWS ressources de votre flux de travail multimédia. Vous pouvez utiliser le moniteur de flux de travail pour démarrer la découverte de la carte des signaux sur tous les types de ressources pris en charge. Au cours du processus de découverte, le moniteur de flux de travail mappera automatiquement et récursivement toutes les AWS ressources connectées. Une fois la carte des signaux créée, vous pouvez utiliser la console de surveillance du flux de travail pour déployer des modèles de surveillance, consulter les métriques et afficher les détails des ressources mappées. **Topics** + [Création de cartes de signaux pour les flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-signal-maps-create.md) + [Visualisation des cartes de signaux des flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-signal-maps-view.md) + [Joindre des modèles d'alarme et d'événement à la carte des signaux de votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-signal-maps-attach.md) + [Déploiement de modèles sur la carte des signaux de votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-deploy.md) + [Mise à jour de la carte des signaux de votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-signal-maps-update.md) + [Suppression de la carte des signaux de votre flux de travail AWS multimédia](monitor-with-workflow-monitor-configure-signal-maps-delete.md) # Création de cartes de signaux pour les flux de travail AWS multimédia Vous pouvez utiliser les cartes de signaux du moniteur de flux de travail pour créer une cartographie visuelle de toutes les AWS ressources connectées de votre flux de travail multimédia. **Pour créer une carte des signaux** 1. Dans le volet de navigation de la console Workflow Monitor, sélectionnez **Signal maps**. 1. Sélectionnez **Créer une carte des signaux**. 1. Donnez un **nom** et une **description** à la carte des signaux. 1. Dans la section **Découvrir une nouvelle carte des signaux**, les ressources du compte courant et de la région sélectionnée sont affichées. Sélectionnez une ressource pour commencer la découverte de la carte des signaux. La ressource sélectionnée sera le point de départ de la découverte. 1. Sélectionnez **Créer**. Attendez quelques instants pour que le processus de découverte soit terminé. Une fois le processus terminé, la nouvelle carte des signaux vous sera présentée. **Note** Les aperçus générés dans la carte des signaux du moniteur de flux de travail pour les AWS Elemental MediaPackage canaux sont fournis depuis le point de terminaison MediaPackage Origin et entraînent des frais de transfert de données sortantes. Pour les tarifs, voir : [MediaPackagetarification](https://aws.amazon.com/mediapackage/pricing/). # Visualisation des cartes de signaux des flux de travail AWS multimédia Les cartes de signaux du moniteur de flux de travail vous permettent de visualiser une cartographie visuelle de toutes les AWS ressources connectées de votre flux de travail multimédia. **Vues de la carte des signaux** Après avoir sélectionné une carte des signaux, vous disposez de deux vues qui peuvent être utilisées pour surveiller ou configurer la carte des signaux. **Surveiller la carte** des **signaux et configurer la carte** des signaux est un bouton contextuel situé dans le coin supérieur droit de la section console de carte des signaux. Si vous sélectionnez la carte des signaux à l'aide de la section **Cartes des signaux** du volet de navigation, votre carte des signaux sera affichée dans la vue de configuration. La vue de configuration vous permet d'apporter des modifications aux groupes de modèles attachés à cette carte de signaux, de déployer les modèles joints et d'afficher les détails de base et les balises de la carte de signaux. Si vous sélectionnez la carte des signaux à l'aide de la section **Vue d'ensemble** du volet de navigation, votre carte des signaux sera affichée dans la vue de surveillance. La vue de surveillance affiche les CloudWatch alarmes, EventBridge les règles, les alertes, les journaux et les mesures de cette carte de signaux. La vue peut être modifiée à tout moment en sélectionnant le bouton **Monitor/Configure signal map** en haut à droite. La vue de configuration nécessite des autorisations IAM de niveau administrateur. Les autorisations IAM requises peuvent être consultées ici : [Politiques IAM de surveillance des flux de travail](monitor-with-workflow-monitor-configure-getting-started-IAM.md) **Naviguer sur la carte des signaux** Une carte des signaux contiendra des nœuds pour chaque ressource AWS prise en charge découverte par le moniteur de flux de travail. Certaines ressources, telles que les MediaLive chaînes et les MediaPackage points de terminaison, peuvent afficher des aperçus miniatures du contenu, si des aperçus miniatures sont disponibles. En sélectionnant un nœud de ressource, puis en sélectionnant **Afficher les détails des ressources sélectionnées** dans le menu déroulant **Actions**, vous accédez à la page de détails du service associé. Par exemple, si vous sélectionnez un MediaLive canal et sélectionnez **Afficher les détails des ressources sélectionnées**, la page de détails de la MediaLive console correspondant à ce canal s'ouvre. La sélection d'un nœud de ressource filtrera la liste des alarmes actives uniquement sur ce nœud. Si vous sélectionnez l'**ARN cible** de la ressource dans l'alarme active, vous serez redirigé vers la page de détails du service associé, avec la ressource sélectionnée ouverte. # Joindre des modèles d'alarme et d'événement à la carte des signaux de votre flux de travail AWS multimédia Après avoir créé des modèles d'alarme et d'événement, vous devez les joindre à une carte des signaux. Tous les modèles d'alarme et d'événement que vous avez créés peuvent être joints à toutes les cartes de signaux découvertes. **Pour joindre des modèles d'alarme et d'événement à votre carte des signaux** 1. Dans le volet de navigation de la console du moniteur de flux de travail, sélectionnez **Signal maps** et sélectionnez la carte des signaux avec laquelle vous souhaitez travailler. 1. Dans le coin supérieur droit de la page de carte des signaux, dans l'onglet **Groupes de modèles CloudWatch d'alarmes, sélectionnez Joindre des groupes** **de modèles CloudWatch d'alarme**. 1. Dans la nouvelle section qui s'ouvre, choisissez tous les groupes de modèles d'alarme que vous souhaitez appliquer à cette carte de signaux, puis sélectionnez **Ajouter**. Cela entraînera le déplacement des groupes de modèles d'alarme sélectionnés vers la section **Groupes de modèles CloudWatch d'alarme joints**. 1. Sélectionnez **Enregistrer pour** enregistrer vos modifications et revenir à la page de la carte des signaux. 1. À droite de la page de la carte des signaux, sélectionnez l'onglet **Groupes de modèles de EventBridge règles**, puis sélectionnez **Attacher des groupes de modèles de EventBridge règles**. 1. Dans la nouvelle section qui s'ouvre, choisissez tous les groupes de modèles d'événements que vous souhaitez appliquer à cette carte de signaux, puis sélectionnez **Ajouter**. Cela entraînera le déplacement des groupes de modèles de règles sélectionnés vers la section **Groupes de modèles de EventBridge règles attachés**. 1. Sélectionnez **Enregistrer pour** enregistrer vos modifications et revenir à la page de la carte des signaux. 1. Vous avez attribué des modèles CloudWatch d'alarme et de EventBridge règles à la carte des signaux, mais la surveillance n'est pas encore déployée. La section suivante traitera du déploiement des ressources de surveillance. # Déploiement de modèles sur la carte des signaux de votre flux de travail AWS multimédia Après avoir joint les modèles d'alarme et d'événement à votre carte des signaux, vous devez déployer la surveillance. Tant que le déploiement n'est pas terminé, la surveillance de votre carte de signaux ne sera pas active. Le moniteur de flux de travail ne déploie que les alarmes pertinentes pour la carte de signaux sélectionnée. Par exemple, le groupe de modèles d'alarme joint peut contenir des alarmes pour plusieurs services MediaLive, tels que MediaPackage, et MediaConnect. Si la carte de signal sélectionnée ne contient que des MediaLive ressources, aucune alarme ne sera déployée MediaPackage ou aucune MediaConnect alarme ne sera déployée. **Pour déployer les modèles de surveillance** 1. Après avoir joint des groupes de modèles d'alarmes et d'événements à votre carte de signaux et enregistré vos modifications, sélectionnez **Déployer le moniteur** dans le menu déroulant **Actions**. 1. Il vous sera demandé de confirmer le déploiement et le nombre de ressources qui seront créées ainsi que le nombre CloudWatch de EventBridge ressources qui seront créées vous seront présentés. Si vous souhaitez continuer, sélectionnez **Déployer**. **Note** L'utilisation du moniteur de flux de travail n'entraîne aucun coût direct. Cependant, certains coûts sont associés aux ressources créées et utilisées pour surveiller votre flux de travail. Lorsque la surveillance est déployée, Amazon CloudWatch et EventBridge des ressources Amazon sont créées. Lorsque vous utilisez la console de AWS gestion, avant de déployer la surveillance sur une carte de signaux, vous serez informé du nombre de ressources qui seront créées. Pour plus d'informations sur la tarification, voir : [CloudWatchtarification](https://aws.amazon.com/cloudwatch/pricing/) et [EventBridge tarification](https://aws.amazon.com/eventbridge/pricing/). Workflow Monitor utilise des AWS CloudFormation modèles pour déployer les EventBridge ressources CloudWatch et. Ces modèles sont stockés dans un bucket Amazon Simple Storage Service de classe standard créé en votre nom, par Workflow Monitor, pendant le processus de déploiement et qui entraînera des frais de stockage d'objets et de rappel. Pour plus d'informations sur la tarification, consultez : [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/). 1. L'état du déploiement est affiché à côté du nom de la carte des signaux. L'état du déploiement est également visible dans la section **Stacks** de la CloudFormation console. Après quelques instants de création et de déploiement des ressources, la surveillance de votre carte des signaux commencera. # Mise à jour de la carte des signaux de votre flux de travail AWS multimédia Si une modification est apportée à votre flux de travail, vous devrez peut-être redécouvrir la carte des signaux et redéployer les ressources de surveillance. Le moniteur de flux de travail est un outil de visualisation et de surveillance qui n'est pas en mesure d'apporter des modifications à votre flux de travail. Les cartes de signaux représentent une point-in-time visualisation de votre flux de travail. Si vous ajoutez, supprimez ou modifiez de manière significative des parties de votre flux de travail multimédia, nous vous recommandons de redécouvrir la carte des signaux. Si des ressources de surveillance sont associées à la carte des signaux, nous vous recommandons de redéployer la surveillance après le processus de redécouverte. **Pour redécouvrir une carte des signaux** 1. Dans le volet de navigation de la console du moniteur de flux de travail, sélectionnez **Signal maps** et sélectionnez la carte des signaux avec laquelle vous souhaitez travailler. 1. Vérifiez que vous êtes dans la vue de la **carte de configuration des signaux**. Pour plus d'informations sur la modification des vues, voir : [Visualisation des cartes de signalisation ](monitor-with-workflow-monitor-configure-signal-maps-view.md) 1. Dans le coin supérieur droit de la page de la carte des signaux, sélectionnez le menu déroulant **Actions**. Sélectionnez **Redécouvrir**. 1. L'écran de redécouverte vous sera présenté. Sélectionnez une ressource faisant partie du flux de travail que vous êtes en train de redécouvrir. Sélectionnez le bouton **Redécouvrir**. 1. La carte des signaux sera reconstruite conformément au flux de travail actuel. Si vous devez redéployer des ressources de surveillance, restez sur la page de cette carte des signaux. Tous les modèles de surveillance précédemment joints resteront attachés, mais devront être redéployés. **Pour redéployer des modèles de surveillance après la redécouverte d'une carte de signaux** 1. Après la redécouverte, vous serez dirigé vers la carte des signaux mise à jour. Pour redéployer les modèles de surveillance, sélectionnez **Déployer le moniteur** dans le menu déroulant **Actions**. 1. Il vous sera demandé de confirmer le déploiement et le nombre de EventBridge ressources qui seront créées vous sera présenté. CloudWatch Si vous souhaitez continuer, sélectionnez **Déployer**. 1. L'état du déploiement est affiché à côté du nom de la carte des signaux. Après quelques instants de création et de déploiement des ressources, la surveillance de votre carte des signaux commencera. # Suppression de la carte des signaux de votre flux de travail AWS multimédia Si vous n'avez plus besoin d'une carte des signaux, elle peut être supprimée. Si vous avez déployé des modèles de surveillance sur la carte des signaux, le processus de suppression vous demandera de supprimer toutes CloudWatch les EventBridge ressources déployées sur cette carte des signaux. La suppression des ressources déployées n'affecte pas les modèles qui les ont créées. Cette suppression de ressources vise à garantir que vous ne disposez pas CloudWatch de EventBridge ressources déployées mais non utilisées. **Pour supprimer un mappage de signaux** 1. Dans le volet de navigation de la console du moniteur de flux de travail, sélectionnez **Signal maps** et sélectionnez le bouton radio à côté de la carte des signaux que vous souhaitez supprimer. 1. Sélectionnez le bouton **Supprimer**. Il vous sera demandé de confirmer la suppression des ressources de surveillance. Sélectionnez **Supprimer** pour lancer le processus de suppression des ressources de surveillance. 1. La colonne **Surveiller le déploiement** affichera l'état actuel. Lorsque le statut est passé à **DELETE\$1COMPLETE**, sélectionnez à nouveau le bouton **Supprimer**. 1. Il vous sera demandé de confirmer la suppression de la carte des signaux. Sélectionnez **Supprimer** pour continuer et supprimer le mappage des signaux. # Quotas de surveillance des workflows La section suivante contient les quotas pour les ressources de surveillance des flux de travail. Chaque quota est calculé « par compte ». Si vous devez augmenter le quota de votre compte, vous pouvez utiliser la [console AWS Service Quotas](https://console.aws.amazon.com/servicequotas/home) pour demander une augmentation, sauf indication contraire dans le tableau suivant. **Quotas** | Type de ressource | Quota | | --- | --- | | CloudWatch groupes de modèles d'alarme | 20 | | CloudWatch modèles d'alarme | 200 | | EventBridge groupes de modèles de règles | 20 | | EventBridge modèles de règles | 200 | | Cartes des signaux | 30 | | Cartes de signaux : groupes de modèles CloudWatch d'alarmes attachés à une seule carte de signaux | 5Vous ne pouvez pas augmenter ce quota. | | Cartes de signaux : groupes de modèles de EventBridge règles attachés à une seule carte de signaux | 5Vous ne pouvez pas augmenter ce quota. | # Utilisation du moniteur de flux de travail Utilisez les sections de **présentation** et de **cartographie des signaux** de la console de surveillance des flux de travail pour consulter l'état actuel des flux de travail et les alarmes, mesures et journaux associés. **Topics** + [Présentation du moniteur de flux de travail](monitor-with-workflow-monitor-operate-overview.md) + [Vue d'ensemble des journaux et des mesures pour le suivi des flux de travail](monitor-with-workflow-monitor-operate-logs-metrics.md) + [Utilisation des cartes de signaux du moniteur de flux de travail](monitor-with-workflow-monitor-operate-signal-maps.md) # Présentation du moniteur de flux de travail La section **Vue d'ensemble** de la console Workflow Monitor est un tableau de bord qui fournit des at-a-glance informations sur vos cartes de signaux. Dans la section d'aperçu, vous pouvez voir l'état actuel de la surveillance de chaque carte de signaux, ainsi que CloudWatch les métriques et les CloudWatch journaux associés. Vous pouvez sélectionner n'importe quelle carte de signaux à afficher sur cette page de console de cartes de signaux. **Vue d'ensemble du filtrage** À l'aide de la barre de **recherche** dans la section d'aperçu, vous pouvez filtrer la liste des cartes de signaux à l'aide de contraintes contextuelles. Après avoir sélectionné la barre de recherche, une liste de **propriétés** à filtrer s'affichera. La sélection d'une propriété affichera des **opérateurs** tels que égal, contient, n'est pas égal et ne contient pas. La sélection d'un opérateur créera une liste de ressources à partir du type de propriété sélectionné. En sélectionnant l'une de ces ressources, la liste des cartes de signaux n'affichera que les cartes de signaux correspondant à la contrainte que vous avez définie. # Vue d'ensemble des journaux et des mesures pour le suivi des flux de travail Pour consulter CloudWatch les métriques et les journaux d'une carte de signaux, sélectionnez le bouton radio à côté du nom de la carte de signaux. Une interface à onglets pour les métriques et les journaux apparaîtra sous la liste de la carte des signaux. **CloudWatch Métriques** CloudWatch les métriques de la carte de signal sélectionnée seront sensibles au contexte et n'afficheront que les métriques associées aux services utilisés dans ce flux de travail de cartes de signaux. Vous pouvez utiliser les outils de mesure à l'écran pour personnaliser les périodes métriques et les plages de temps affichées. **CloudWatch Journaux** Si vous avez associé un groupe de CloudWatch journaux à la carte des signaux, ce groupe sera affiché ici. # Utilisation des cartes de signaux du moniteur de flux de travail Dans la section **d'aperçu** de la console, vous pouvez sélectionner une carte de signal spécifique pour afficher plus d'informations sur cette carte de signaux et les ressources de surveillance associées. Après avoir sélectionné une carte des signaux, vous verrez apparaître la carte des signaux et un certain nombre de sections à onglets contenant plus d'informations : + CloudWatch alarmes + EventBridge règles + AWS Alertes élémentaires + Métriques + Journaux + Détails de base **Naviguer sur la carte des signaux** Une carte des signaux contiendra des nœuds pour chaque ressource AWS prise en charge découverte par le moniteur de flux de travail. Certaines ressources, telles que les MediaLive chaînes et les MediaPackage points de terminaison, peuvent afficher des aperçus miniatures du contenu, si des aperçus miniatures sont disponibles. En sélectionnant un nœud de ressource, puis en sélectionnant **Afficher les détails des ressources sélectionnées** dans le menu déroulant **Actions**, vous accédez à la page de détails du service associé. Par exemple, si vous sélectionnez un MediaLive canal et sélectionnez **Afficher les détails des ressources sélectionnées**, la page de détails de la MediaLive console correspondant à ce canal s'ouvre. La sélection d'un nœud de ressource filtrera la liste des alarmes actives uniquement sur ce nœud. Si vous sélectionnez l'**ARN cible** de la ressource dans l'alarme active, vous serez redirigé vers la page de détails du service associé, avec la ressource sélectionnée ouverte.