Contrôle du volume des journaux des sessions d'insertion de publicités

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é de60, 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.

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 des rôles liés aux services pour MediaTailor

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 au AWS Management Console et ouvrez la MediaTailor console à l'adresse https://console.aws.amazon.com/mediatailor/.

2. Dans le volet de configuration de la lecture, sélectionnez la configuration de lecture pour laquelle vous souhaitez définir la configuration du journal.

3. Choisissez Modifier.

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

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 du AWS CLI, exécutez la commande configure-logs-for-playback-configuration 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 (\) 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-enabledest le pourcentage de journaux de session de configuration de lecture MediaTailor envoyés à CloudWatch Logs.

• playback-configuration-nameest 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-configurationoption pour la put-playback-configurationcommande.

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 ouAPI. 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 des rôles liés aux services pour MediaTailor

Console

Pour désactiver la configuration du journal dans une configuration de lecture

1. Connectez-vous au AWS Management Console et ouvrez la MediaTailor console à l'adresse https://console.aws.amazon.com/mediatailor/.

2. Dans le volet de configuration de la lecture, sélectionnez la configuration de lecture pour laquelle vous souhaitez désactiver la configuration du journal.

3. Choisissez Modifier.

4. Sous Configuration du journal, définissez la valeur du pourcentage activé sur0. Cela désactive toute journalisation de session pour cette configuration de lecture.

5. Sélectionnez Save.

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.