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.

# Contrôle AWS Elemental MediaTailor avec Amazon CloudWatch Metrics
<a name="monitoring-cloudwatch-metrics"></a>

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 consulter les statistiques à 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
<a name="metrics"></a>

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)
<a name="metrics.channel-assembly"></a>

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 en grande partie 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.  | 

#### Server-side Ad-insertion Métriques (SSAI)
<a name="metrics.server-side-ad-insertion"></a>

Le tableau suivant répertorie les mesures d'insertion de publicités côté serveur.


| Métrique | Description | 
| --- | --- | 
|  AdDecisionServer.Ads  | 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.<br />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.<br />Une valeur élevée pour cette métrique peut contribuer à un `Avail.FillRate` d'ensemble faible. | 
|  AdsBilled  | Le nombre d'annonces facturées aux MediaTailor clients 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.<br />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).<br />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.<br />Émis uniquement pour les manifestes HLS, à la première `CUE-IN` balise. 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é. <br />Pour plus d'informations sur les mesures permettant de mesurer l'âge du manifeste, consultez[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.<br />Pour plus d'informations sur les mesures permettant de mesurer l'âge du manifeste, consultez[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é. <br />Pour plus d'informations sur les mesures permettant de mesurer l'âge du manifeste, consultez[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. <br />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.<br />Pour plus d'informations sur les mesures permettant de mesurer l'âge du manifeste, consultez[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.<br />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`.<br />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`.<br />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.<br />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  | Le 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 de la liste planifiée à 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.

### Métriques des fonctions
<a name="metrics.functions"></a>

Les statistiques suivantes sont publiées lorsque vous utilisez [Functions](monetization-functions.html) avec vos configurations de lecture. Ces métriques sont toujours émises lorsqu'une fonction est configurée sur un hook du cycle de vie. Aucune configuration d'opt-in ou de journalisation n'est requise.

**Hook-level métriques** : un point de données par cycle de vie exécuté par un hook :


| Métrique | Description | 
| --- | --- | 
|  PreSessionInitHook.Invocations  | Le nombre de fois que le hook d'initialisation de pré-session a été invoqué. | 
|  PreSessionInitHook.Errors  | Nombre d'exécutions du hook d'initialisation avant session qui ont entraîné une erreur. | 
|  PreSessionInitHook.Latency  | Temps d'exécution en millisecondes pour le hook d'initialisation de pré-session. | 
|  PreAdsRequestHook.Invocations  | Le nombre de fois que le hook de demande de pré-publicité a été invoqué. | 
|  PreAdsRequestHook.Errors  | Le nombre d'exécutions de crochets de demande de pré-publicité qui ont entraîné une erreur. | 
|  PreAdsRequestHook.Latency  | Temps d'exécution en millisecondes pour le hook de demande de pré-publicité. | 

**Function-level métriques** : un point de données par exécution de fonction individuelle. Ces mesures incluent des dimensions supplémentaires (`FunctionId`,`FunctionType`,`HookType`) afin que vous puissiez identifier la fonction spécifique qui est lente ou défaillante :


| Métrique | Description | 
| --- | --- | 
|  Function.Invocations  | Le nombre de fois qu'une fonction individuelle a été exécutée. | 
|  Function.Errors  | Le nombre d'exécutions de fonctions individuelles qui ont entraîné une erreur. | 
|  Function.Latency  | Temps d'exécution en millisecondes pour une fonction individuelle. | 

### Moyennes simples et pondérées
<a name="metrics-simple-average"></a>

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` \* 100)/`Avail.Duration` et (`Avail.FilledDuration` \* 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` \* 100)/`Avail.Duration`. La moyenne simple fournie par `Avail.FillRate` est égale à la moyenne pondérée fournie par (`Avail.FilledDuration` \* 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 \+ 120.
+ `AdDecisionServer.Duration` est égal à 165, la somme des deux durées de réponse : 45 \+ 120.
+ `Avail.FilledDuration` est égal à 135, la somme des deux durées remplies : 45 \+ 90. 
+ `AdDecisionServer.FillRate` est égal à 75 %, la moyenne des pourcentages remplis pour chaque diffusion : (50 % \+ 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 \* 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 % \+ 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\* 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
<a name="dimensions"></a>

Vous pouvez filtrer les AWS Elemental MediaTailor données à l'aide des dimensions suivantes.


| Dimension | Description | 
| --- | --- | 
| `ConfigurationName` | Indique la configuration à laquelle la métrique appartient. Disponible pour tous les indicateurs. | 
| `FunctionId` | Identifiant de la fonction. Disponible uniquement `Function.*` pour les métriques. | 
| `FunctionType` | Type de fonction :`CUSTOM_OUTPUT`, `HTTP_REQUEST``SEQUENTIAL_EXECUTOR`, ou`CONCURRENT_EXECUTOR`. Disponible uniquement `Function.*` pour les métriques. | 
| `HookType` | Le hook du cycle de vie qui a déclenché la fonction : `PRE_SESSION_INITIALIZATION` ou`PRE_ADS_REQUEST`. Disponible uniquement `Function.*` pour les métriques. |