View a markdown version of this page

Filtraggio AWS Elemental MediaTailor registri ed eventi - AWS Elemental MediaTailor

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Filtraggio AWS Elemental MediaTailor registri ed eventi

I log emessi da una configurazione di riproduzione in MediaTailor includono informazioni su una serie di attività che si svolgono durante la sessione di riproduzione. Queste attività sono identificate nel tipo di evento dei registri. Molti eventi vengono registrati per impostazione predefinita. Per aiutare a controllare il costo dei log in Amazon CloudWatch, puoi specificare i log che vengono MediaTailor emessi.

MediaTailor ti fornisce il controllo sul filtraggio dei log in modo da poter fare quanto segue:

  • Specifica gli eventi di registro che desideri escludere dai log

  • Abilita la registrazione delle risposte non elaborate dall'ad decision server (ADS)

Puoi impostare queste preferenze di filtro dei log in modo indipendente per ogni sessione di riproduzione o come predefinite per tutte le sessioni di riproduzione per una configurazione di riproduzione.

  • Per filtrare i log per sessione, includi i parametri di interrogazione nella richiesta di inizializzazione della sessione di riproduzione.

  • Per filtrare i log in base alla configurazione per riproduzione, utilizza la MediaTailor console o l'API per indicare le tue preferenze nelle impostazioni di configurazione della riproduzione.

Le sezioni seguenti forniscono istruzioni per abilitare il filtraggio dei log sulle sessioni e sulle configurazioni di riproduzione.

Per definire un livello personalizzato di dettagli del registro per ogni sessione, aggiungete i seguenti parametri alla richiesta iniziale della sessione di riproduzione lato server o lato client. Aggiungete valori ai parametri per rappresentare gli eventi da includere o escludere, in un formato delimitato da virgole:

  • aws.adsInteractionLogPublishOptInEventTypesper ricevere i log relativi a specifiche interazioni con AdDecision Server (ADS).

  • aws.adsInteractionLogExcludeEventTypesper interrompere la ricezione di registri per interazioni ADS specifiche.

  • aws.manifestServiceLogExcludeEventTypesper interrompere la ricezione dei log relativi a specifiche interazioni con il servizio manifest.

Per un elenco dei tipi di log ed eventi che MediaTailor emettono, vedere Log manifestLog ADS, eTranscodifica i log.

Se non trasmetti alcun parametro di interrogazione per il filtraggio dei log, MediaTailor scrive tutti i log nella destinazione di consegna.

Esempio inizializzazione della sessione lato server con filtri di log

Per escludere GENERATED_MANIFEST PARSING_ERROR gli eventi dai log del manifest e MAKING_ADS_REQUEST dai log ADS, la richiesta di inizializzazione della sessione sarà simile alla seguente:

GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST

Per abilitare i log non elaborati dai tuoi ADS, includi il RAW_ADS_RESPONSE valore del AdsInteractionPublishOptInEventType parametro:

GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE
Esempio inizializzazione della sessione lato client con filtri di registro

Per escludere gli eventi di registro durante l'inizializzazione della sessione lato client, includi availSuppression e digita i parametri di registro nella richiesta POST del cliente a. MediaTailor Per ulteriori informazioni su come costruire una richiesta di sessione di riproduzione lato client, vedere Client-side tracciamento degli annunci. L'esempio seguente esclude PARSING_ERROR gli eventi dai registri del manifesto CONFIG_SECURITY_ERROR e dai registri ADS. MAKING_ADS_REQUEST

POST parent.m3u8
   {
       "adsInteractionLog": {
           ...
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
      "logMode": "DEBUG"
   }

Per abilitare i log non elaborati dal tuo ADS, includi il RAW_ADS_RESPONSE valore del publishOptInEventTypes parametro: 

POST parent.m3u8
   {
       "adsInteractionLog": {
           "publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
       "logMode": "DEBUG"
   }

Utilizzate le impostazioni della configurazione di riproduzione per definire i tipi di eventi di registro MediaTailor emessi come impostazione predefinita da questa configurazione di riproduzione. MediaTailor utilizza queste impostazioni di filtro dei log predefinite per tutte le sessioni che non includono i parametri di filtraggio delle query nella richiesta di avvio della sessione.

Puoi scegliere di fare quanto segue:

  • Ricevi registri per interazioni specifiche con AdDecision Server (ADS).

  • Escludi i log per interazioni ADS specifiche.

  • Escludi i log per interazioni specifiche del servizio manifest.

Per configurare queste impostazioni dalla MediaTailor console, vedereCreazione di una configurazione. Per l' MediaTailor API, consulta PutPlaybackConfiguration l'AWS Elemental MediaTailor API Reference.

Per un elenco dei tipi di log ed eventi che MediaTailor emettono, vedi Log manifestLog ADS, eTranscodifica i log.