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 sous forme de mesures 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 examinez 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 statistiques à 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 MediaTailor noms.

  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 afficher 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'espace de AWS Elemental MediaTailor noms inclut les métriques suivantes. Ces métriques sont publiées par défaut sur votre compte.

Métriques de Channel Assembly (CA)

Dans le tableau suivant, toutes les mesures sont disponibles par canal ou par sortie de canal.

Métrique Description
4xxErrorCount

Le nombre d'4xxerreurs.

5xxErrorCount

Le nombre d'5xxerreurs.

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

Le temps nécessaire au serveur d'applications pour traiter la demande, y compris le temps nécessaire pour recevoir des octets en provenance du client et du réseau et pour écrire des octets dans ces derniers.

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 d'annonces 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 (pas de dimensions)

AdDecisionServer.Duration

Durée totale, en millisecondes, de toutes les publicités MediaTailor reçues de l'ADS au cours de 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 non HTTP 200, de réponses vides et de réponses expiré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 adressées à l'ADS avec un délai d'expiration 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 pour lesquelles les clients MediaTailor sont facturés en fonction de leur insertion.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

Avail.Duration

Le nombre total prévu de millisecondes d'annonce disponible au cours de cette 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 (pas de dimensions)

Avail.FilledDuration

Le nombre prévu de millisecondes de temps de disponibilité des publicités qui MediaTailor seront remplies d'annonces au cours de cette période. CloudWatch

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

Avail.FillRate

La moyenne simple prévue des taux auxquels les annonces individuelles MediaTailor seront traitées sera disponible au cours de la CloudWatch période.

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

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 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) (voirAvail.Complete).

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

Avail.Complete

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

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

Avail.ObservedDuration

Nombre total observé de millisecondes de diffusion d'annonces survenues au cours de la CloudWatch période. Avail.ObservedDurationest émis à la fin de la diffusion de l'annonce et est basé sur la durée des segments indiqués dans le manifeste pendant la diffusion de l'annonce.

Dimensions : ConfigurationName

Avail.ObservedFilledDuration

Le nombre observé de millisecondes de temps de disponibilité des publicités qui ont été MediaTailor remplies au cours de cette période. CloudWatch

Dimensions : ConfigurationName

Avail.ObservedFillRate

La moyenne simple observée des taux auxquels une annonce individuelle MediaTailor remplie est disponible au cours de la CloudWatch période.

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

Dimensions : ConfigurationName

Avail.ObservedSlateDuration

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

Dimensions : ConfigurationName

GetManifest.Age

L'âge total du manifeste en millisecondes. Mesuré entre le moment où l'origine crée le manifeste et le moment où le manifeste personnalisé est MediaTailor envoyé.

Pour plus d'informations sur les mesures permettant de mesurer l'âge des manifestes, consultezUtilisation 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 mesures permettant de mesurer l'âge des manifestes, consultezUtilisation 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é entre le moment où MediaTailor reçoit une réponse d'origine et le moment où le manifeste personnalisé est MediaTailor envoyé.

Pour plus d'informations sur les mesures permettant de mesurer l'âge des manifestes, consultezUtilisation de métriques pour diagnostiquer les manifestes périmés.

Dimensions : ConfigurationName

Origin.Age

Durée pendant laquelle l'origine possède le manifeste, en millisecondes. Mesuré entre le moment où l'origine crée le manifeste et le moment où MediaTailor la demande d'origine est envoyé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.

Pour plus d'informations sur les mesures permettant de mesurer l'âge des manifestes, consultezUtilisation de métriques pour diagnostiquer les manifestes périmés.

Dimensions : ConfigurationName

Origin.Errors

Le nombre de réponses par code d'état non 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 expirées 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 (pas de dimensions)

SkippedReason.DurationExceeded

Le nombre d'annonces qui n'ont pas été insérées dans une offre car 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 annonces ont été ignorées, consultezRésolution des problèmes liés à l'omission d'annonces.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.EarlyCueIn

Le nombre d'annonces ignorées en raison d'une annonce CUE-IN anticipée.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.ImportError

Le nombre d'annonces ignorées en raison d'une erreur lors de la tâche d'importation.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.ImportInProgress

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

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.InternalError

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

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.NewCreative

Le nombre d'annonces qui n'ont pas été insérées en vain car c'était la première fois que l'actif était demandé par un client. Une valeur élevée pour cette métrique peut temporairement contribuer à une baisse globaleAvail.FillRate, jusqu'à ce que les actifs puissent être transcodés avec succès.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.NoVariantMatch

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

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.PersonalizationThresholdExceeded

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

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.ProfileNotFound

Le nombre d'annonces ignorées car le profil de transcodage n'a pas été trouvé.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.TranscodeError

Le nombre de publicités ignorées en raison d'une erreur de transcodage.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

SkippedReason.TranscodeInProgress

Le nombre d'annonces qui n'ont pas été insérées en vain car l'annonce n'avait pas encore été transcodée. Une valeur élevée pour cette métrique peut temporairement contribuer à une baisse globaleAvail.FillRate, jusqu'à ce que les actifs puissent être transcodés avec succès.

Dimensions :

  • ConfigurationName

  • Account-level (pas de dimensions)

Note

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

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

  • Avail.ObservedSlateDurationindique la durée de l'ardoise planifiée à partir des réponses de la liste des actifs 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 de cycle de vie. Aucune configuration d'opt-in ou de journalisation n'est requise.

Hook-level métriques  : un point de données par exécution d'un hook de cycle de vie :

Métrique Description
PreSessionInitHook.Invocations

Le nombre de fois que le hook d'initialisation de pré-session a été invoqué.

Dimensions : ConfigurationName

PreSessionInitHook.Errors

Le nombre d'exécutions de hooks d'initialisation de pré-session qui ont entraîné une erreur.

Dimensions : ConfigurationName

PreSessionInitHook.Latency

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

Dimensions : ConfigurationName

PreAdsRequestHook.Invocations

Le nombre de fois que le hook de demande préalable à la publicité a été invoqué.

Dimensions : ConfigurationName

PreAdsRequestHook.Errors

Le nombre d'exécutions de hooks de requêtes antérieures à la publicité qui ont entraîné une erreur.

Dimensions : ConfigurationName

PreAdsRequestHook.Latency

Temps d'exécution en millisecondes du hook de requête préalable à la 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) qui vous permettent d'identifier quelle fonction spécifique 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 d'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 émanant de MediaTailor et pour connaître la manière dont MediaTailor les annonces sont utilisées :

  • 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 remplit 45 secondes de la durée de diffusion de l'annonce (50 % de remplissage).

  • 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 remplit 90 secondes de la durée de diffusion de l'annonce (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 MediaTailor de remplissage disponibles est de 64,29 %, soit un 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 toute annonce disponible 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.