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.
# 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).