View a markdown version of this page

Contrôle AWS Elemental MediaTailor avec Amazon CloudWatch Metrics - AWS Elemental MediaTailor

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

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.

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.

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'adressehttps://console.aws.amazon.com/cloudwatch/.

  2. Dans le panneau de navigation, sélectionnez ‎Métriques.

  3. Sous Toutes les métriques, choisissez l'espace de MediaTailornoms.

  4. Sélectionnez la dimension de métrique pour afficher les métriques (par exemple, pour originID).

  5. 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

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'4xxerreurs.

5xxErrorCount

Le nombre d'5xxerreurs.

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

Le 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)

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.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

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.

Dimensions : ConfigurationName

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.

Dimensions : ConfigurationName

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.

Dimensions : ConfigurationName

AdDecisionServer.Latency

Temps de réponse en millisecondes pour les demandes adressées MediaTailor à l'ADS.

Dimensions : ConfigurationName

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.

Dimensions : ConfigurationName

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.

Dimensions : ConfigurationName

AdsBilled

Le nombre d'annonces facturées aux MediaTailor clients en fonction de leur insertion.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

Avail.Duration

Le 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.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

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

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

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.

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.

Dimensions : ConfigurationName

Avail.Impression

Le nombre de publicités pour lesquelles des balises d'impression MediaTailor ont été déclenchées lors de la création de rapports côté serveur. MediaTailor émet un décompte pour chaque annonce comportant au moins un URI d'impression, que ces balises aient été diffusées ou non. Utilisez cette métrique comme dénominateur pour calculer le taux d'achèvement des vidéos (magnétoscope) (voir). Avail.Complete

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

Avail.Complete

Le nombre de publicités pour lesquelles des balises complètes MediaTailor ont été déclenchées lors de la création de rapports côté serveur. MediaTailor émet un décompte pour chaque annonce comportant au moins un URI de suivi complet, que ces balises aient été diffusées ou non. Pour calculer le taux d'achèvement des vidéos (magnétoscope), divisez la somme de Avail.Complete par la somme deAvail.Impression.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

Avail.ObservedDuration

Nombre total de millisecondes d'utilisation publicitaire observé au cours de cette période. CloudWatch Avail.ObservedDurationest é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é.

Dimensions : ConfigurationName

Avail.ObservedFilledDuration

Nombre observé de millisecondes de temps de disponibilité des publicités MediaTailor pendant cette période. CloudWatch

Dimensions : ConfigurationName

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.

Dimensions : ConfigurationName

Avail.ObservedSlateDuration

Nombre total observé de millisecondes d'ardoise insérées au cours de la période. CloudWatch

Dimensions : ConfigurationName

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, voirUtilisation de métriques pour diagnostiquer les manifestes périmés.

Dimensions : ConfigurationName

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.

Dimensions : ConfigurationName

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, voirUtilisation de métriques pour diagnostiquer les manifestes périmés.

Dimensions : ConfigurationName

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, voirUtilisation de métriques pour diagnostiquer les manifestes périmés.

Dimensions : ConfigurationName

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, voirUtilisation de métriques pour diagnostiquer les manifestes périmés.

Dimensions : ConfigurationName

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.

Dimensions : ConfigurationName

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 avecOrigin.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.

Dimensions : ConfigurationName

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 avecOrigin.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.

Dimensions : ConfigurationName

Origin.Timeouts

Le nombre de demandes d'expiration 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.

Dimensions : ConfigurationName

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.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

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 les AdDecisionServer.Ads métriques AdsBilled et. Pour plus d'informations sur les raisons pour lesquelles les publicités n'ont pas été publiées, consultezRésolution des problèmes liés au non-respect des publicités.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.EarlyCueIn

Le nombre d'annonces ignorées en raison d'un retard. CUE-IN

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.ImportError

Nombre d'annonces ignorées en raison d'une erreur lors de l'importation.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.ImportInProgress

Le nombre d'annonces ignorées en raison d'une tâche d'importation active existante.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.InternalError

Le nombre d'annonces ignorées en raison d'une erreur MediaTailor interne.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

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 globalAvail.FillRate, jusqu'à ce que les actifs puissent être correctement transcodés.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.NoVariantMatch

Le nombre d'annonces ignorées en raison de l'absence de correspondance entre l'annonce et le contenu.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.PersonalizationThresholdExceeded

Durée des publicités dépassant le seuil de personnalisation défini dans cette configuration.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.ProfileNotFound

Le nombre d'annonces ignorées en raison de l'impossibilité de trouver le profil de transcodage.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

SkippedReason.TranscodeError

Nombre d'annonces ignorées en raison d'une erreur de transcodage.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

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 globalAvail.FillRate, jusqu'à ce que les actifs puissent être correctement transcodés.

Dimensions :

  • ConfigurationName

  • Account-level (aucune dimension)

Note

Pour les sessions HLS Interstitials, certains indicateurs se comportent différemment en raison de la nature contraignante tardive des décisions publicitaires :

  • Avail.ObservedFilledDurationcorrespond Avail.FilledDuration car il MediaTailor n'est pas possible d'observer le comportement réel de lecture côté client.

  • Avail.ObservedSlateDurationindique 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.

Métriques des fonctions

Les statistiques suivantes sont publiées lorsque vous utilisez Functions 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é.

Dimensions : ConfigurationName

PreSessionInitHook.Errors

Nombre d'exécutions du hook d'initialisation avant session qui ont entraîné une erreur.

Dimensions : ConfigurationName

PreSessionInitHook.Latency

Temps d'exécution en millisecondes pour le hook d'initialisation de pré-session.

Dimensions : ConfigurationName

PreAdsRequestHook.Invocations

Le nombre de fois que le hook de demande de pré-publicité a été invoqué.

Dimensions : ConfigurationName

PreAdsRequestHook.Errors

Le nombre d'exécutions de crochets de demande de pré-publicité qui ont entraîné une erreur.

Dimensions : ConfigurationName

PreAdsRequestHook.Latency

Temps d'exécution en millisecondes pour le hook de demande de pré-publicité.

Dimensions : ConfigurationName

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.

Dimensions :

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

Function.Errors

Le nombre d'exécutions de fonctions individuelles qui ont entraîné une erreur.

Dimensions :

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

Function.Latency

Temps d'exécution en millisecondes pour une fonction individuelle.

Dimensions :

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

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 * 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

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_REQUESTSEQUENTIAL_EXECUTOR, ouCONCURRENT_EXECUTOR. Disponible uniquement Function.* pour les métriques.

HookType

Le hook du cycle de vie qui a déclenché la fonction : PRE_SESSION_INITIALIZATION ouPRE_ADS_REQUEST. Disponible uniquement Function.* pour les métriques.