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à.
# Scrivere AWS Elemental MediaTailor i log direttamente su Amazon CloudWatch Logs
MediaTailor produce log che contengono informazioni dettagliate sull'attività della sessione e sulle interazioni con i server di decisione pubblicitaria e li scrive su Amazon CloudWatch. I log forniscono una descrizione sequenziale dell'attività che si verifica durante la sessione.
MediaTailor può anche utilizzare i registri venduti per garantire flessibilità nella consegna dei registri e ottenere prezzi scontati in base ai volumi. Per informazioni sui registri venduti, consulta. [Utilizzo dei registri venduti](vended-logs.md)
**Topics**
+ [Autorizzazioni per Amazon Logs CloudWatch](monitoring-permissions.md)
+ [Registro «As Run» per AWS Elemental MediaTailor Channel Assembly](as-run-log.md)
+ [AWS Elemental MediaTailor Analisi dei log ADS in Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)
# Autorizzazioni per Amazon Logs CloudWatch
Usa AWS Identity and Access Management (IAM) per creare un ruolo che dia AWS Elemental MediaTailor accesso ad Amazon CloudWatch. Devi eseguire questi passaggi per pubblicare CloudWatch i registri per il tuo account. CloudWatch pubblica automaticamente le metriche per il tuo account.
**Per consentire l'accesso MediaTailor a CloudWatch**
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel pannello di navigazione della console IAM, scegliere **Ruoli** e quindi **Crea ruolo**.
1. Scegli il tipo di ruolo **Altro AWS account**.
1. Per **Account ID**, inserisci l'ID AWS del tuo account.
1. Selezionare **Require external ID (Richiedi ID esterno)** e immetter **Midas**. Questa opzione aggiunge automaticamente una condizione alla policy di attendibilità che consente al servizio di assumere il ruolo solo se la richiesta include il corretto `sts:ExternalId`.
1. Scegli **Successivo: autorizzazioni**.
1. Aggiungere una policy di autorizzazione che specifichi le azioni che questo ruolo può eseguire. Selezionare una delle opzioni seguenti, quindi scegliere **Next: Review (Successivo: Esamina)**:
+ **CloudWatchLogsFullAccess**per fornire l'accesso completo ad Amazon CloudWatch Logs
+ **CloudWatchFullAccess**per fornire l'accesso completo ad Amazon CloudWatch
1. In **Role name (Nome ruolo)** immettere **MediaTailorLogger** e quindi selezionare **Create role (Crea ruolo)**.
1. Nella pagina **Roles (Ruoli)** scegliere il ruolo appena creato.
1. Per aggiornare l'entità principale, modificare la relazione di trust:
1. Nella pagina **Summary (Riepilogo)** del ruolo, selezionare la scheda **Trust relationship (Relazione di trust)**.
1. Seleziona **Modifica relazione di attendibilità**.
1. Nel documento relativo alla policy, modifica l'indirizzo principale del MediaTailor servizio. L'URL dovrebbe essere simile a questo:
```
"Principal": {
"Service": "mediatailor.amazonaws.com"
},
```
La policy intera dovrebbe risultare come segue:
1. Scegli **Update Trust Policy (Aggiorna policy di trust)**.
# Registro «As Run» per AWS Elemental MediaTailor Channel Assembly
Il registro *As Run*, nel gruppo dei CloudWatch `MediaTailor/Channel/AsRunLog` log, mostra informazioni sui programmi e sulle interruzioni pubblicitarie durante la riproduzione.
Quando si crea un canale, il registro As Run è disabilitato per impostazione predefinita. Utilizzando la Console o il AWS Command Line Interface (AWS CLI), puoi abilitare e disabilitare lo stato del registro As Run per ogni canale del tuo account.
Quando abiliti il registro As Run, crea MediaTailor automaticamente un ruolo collegato al servizio che consente di MediaTailor scrivere e gestire il log As Run nel tuo account CloudWatch Logs. Per ulteriori informazioni sui ruoli collegati al servizio, consulta [Utilizzo di ruoli collegati ai servizi per MediaTailor](using-service-linked-roles.md).
**Nota**
Attualmente As Run Log supporta solo il programma predefinito. Per ora non supporta AlternateMedia creato dalle regole del programma. Ciò significa che attualmente non genera il registro As Run per AlternateMedia.
**Topics**
+ [Abilitazione del registro As Run](enabling-as-run-log.md)
+ [Disattivazione del registro As Run](disabling-as-run-log.md)
# Abilitazione del registro As Run
Per abilitare il registro As Run, specifica il nome del canale e abilita il tipo di registro As *Run* per quel canale.
------
#### [ Console ]
**Per abilitare il registro As Run durante la creazione di un canale**
1. Accedi a Console di gestione AWS e apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Nel pannello di navigazione, scegli **Channel assembly > **Channels****.
1. Nella barra di navigazione, scegli **Crea canale**.
1. Nei riquadri **Imposta i dettagli del canale**, **Configura gli output** e **Access control**, configura il canale come desideri.
1. **Nel pannello di **controllo dell'accesso**, scegli Avanti.**
1. Nel riquadro **Registrazione**, in **Tipi di registro**, seleziona **Abilita come esegui** per abilitare il registro As Run.
**Per abilitare il registro As Run durante l'aggiornamento di un canale**
**Nota**
Se il canale è attualmente in esecuzione, è necessario interromperlo prima di poterlo aggiornare. Dopo aver interrotto il canale, puoi scegliere **Azioni** > **Modifica** per iniziare ad aggiornare il canale.
1. Accedi Console di gestione AWS e apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Nel pannello di navigazione, scegli **Channel assembly > **Channels****.
1. Scegliete il canale che desiderate aggiornare per abilitare il registro As Run.
1. Scegli **Operazioni** > **Modifica**.
1. Nei riquadri **Imposta i dettagli del canale**, **Configura le uscite** e **Controllo dell'accesso**, aggiorna la configurazione del canale come desideri.
1. **Nel pannello di **controllo dell'accesso**, scegli Avanti.**
1. Nel riquadro **Registrazione**, in **Tipi di registro**, seleziona **Abilita come esegui** per abilitare il registro As Run.
**Per abilitare il registro As Run dalla scheda **Logging****
**Nota**
Se il canale è attualmente in esecuzione, è necessario utilizzare la scheda **Registrazione** anziché scegliere **Azioni** > **Modifica** per abilitare il registro As Run.
1. Accedi Console di gestione AWS e apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Nel pannello di navigazione, scegli **Channel assembly > **Channels****.
1. Scegliete il canale per il quale desiderate abilitare il registro As Run.
1. Nella barra di navigazione sotto il nome del canale, scegli **Registrazione.**
1. In **Registrazione** > **Tipi di registro**, seleziona As **run** per abilitare il registro As Run.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Per abilitare il registro As Run**
Esegui il [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)comando e specifica i valori appropriati per i parametri richiesti.
Questo esempio è formattato per Linux, macOS o Unix e utilizza il carattere di continuazione di barra rovesciata (\$1) per migliorare la leggibilità.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types AS_RUN
```
Questo esempio è formattato per Microsoft Windows e utilizza il carattere di continuazione di riga (^) per migliorare la leggibilità.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types AS_RUN
```
Dove:
+ `MyChannel`è il nome del canale di cui sei proprietario e per cui desideri abilitare il registro As Run.
Se eseguirai il comando correttamente, riceverai un output simile al seguente.
```
{
"ChannelName": "MyChannel",
"LogTypes": [
"AS_RUN"
]
}
```
------
# Disattivazione del registro As Run
Per disabilitare il registro As Run per un canale che lo ha abilitato, specifica il nome del canale e disabilita il tipo di registro As *Run* per quel canale.
------
#### [ Console ]
**Per disabilitare il registro As Run durante l'aggiornamento di un canale**
**Nota**
Se il canale è attualmente in esecuzione, è necessario interromperlo prima di poterlo aggiornare. Dopo aver interrotto il canale, puoi scegliere **Azioni** > **Modifica** per iniziare ad aggiornare il canale.
1. Accedi Console di gestione AWS e apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Nel pannello di navigazione, scegli **Channel assembly > **Channels****.
1. Scegliete il canale che desiderate aggiornare per abilitare il registro As Run.
1. Scegli **Operazioni** > **Modifica**.
1. Nei riquadri **Imposta i dettagli del canale**, **Configura le uscite** e **Controllo dell'accesso**, aggiorna la configurazione del canale come desideri.
1. **Nel pannello di **controllo dell'accesso**, scegli Avanti.**
1. Nel riquadro **Registrazione**, in **Tipi di registro**, deseleziona **Abilita come esegui** per disabilitare il registro As Run.
**Per disabilitare il registro As Run dalla scheda **Logging****
**Nota**
Se il canale è attualmente in esecuzione, è necessario utilizzare la scheda **Registrazione** anziché scegliere **Azioni** > **Modifica** per disabilitare il registro As Run.
1. Accedi a Console di gestione AWS e apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Nel pannello di navigazione, scegli **Channel assembly > **Channels****.
1. Scegliete il canale per il quale desiderate disabilitare il registro As Run.
1. Nella barra di navigazione sotto il nome del canale, scegli **Registrazione.**
1. In **Registrazione** > **Tipi di registro**, deseleziona As **run** per disabilitare il registro As Run.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Per disabilitare il registro As Run**
Esegui il [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)comando e specifica i valori appropriati per i parametri richiesti.
Questo esempio è formattato per Linux, macOS o Unix e utilizza il carattere di continuazione di barra rovesciata (\$1) per migliorare la leggibilità.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types
```
Questo esempio è formattato per Microsoft Windows e utilizza il carattere di continuazione di riga (^) per migliorare la leggibilità.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types
```
Dove:
+ `MyChannel`è il nome del canale di cui sei proprietario e per cui desideri disabilitare il registro As Run.
Se eseguirai il comando correttamente, riceverai un output simile al seguente.
```
{
"ChannelName": "MyChannel",
"LogTypes": []
}
```
------
# AWS Elemental MediaTailor Analisi dei log ADS in Amazon CloudWatch Logs Insights
Puoi visualizzare e interrogare i log di AWS Elemental MediaTailor Ad Decision Server (ADS) utilizzando Amazon CloudWatch Logs Insights. MediaTailor invia i log degli eventi a CloudWatch per le normali condizioni di elaborazione e di errore. I log aderiscono a uno schema JSON. Tramite CloudWatch Logs Insights, è possibile selezionare i log per intervallo di tempo e quindi eseguire query su di essi.
Per informazioni generali, consulta [Analizzare i dati di log con CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) Logs Insights.
**Nota**
Per accedere ai log, hai bisogno delle autorizzazioni per accedere ad Amazon. CloudWatch Per istruzioni, consulta [Autorizzazioni per Amazon Logs CloudWatch](monitoring-permissions.md).
**Per visualizzare e interrogare i log ADS utilizzando la console CloudWatch**
1. Apri la CloudWatch console all'indirizzo[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Nel riquadro di navigazione, in **Logs**, (Log), scegli **Insights**.
1. Nella barra di ricerca, inserisci**AdDec**, quindi dall'elenco a discesa seleziona. `MediaTailor/AdDecisionServerInteractions`
1. (Facoltativo) Regolare il periodo di tempo che si desidera studiare.
1. (Facoltativo) Modificare la query nella finestra di dialogo. Per indicazioni generali, consulta la sintassi delle query di [CloudWatch Logs Insights.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) Per esempi di query per ADS MediaTailor, consulta [Interrogazione dei log ADS](querying-the-ads-logs.md).
1. Scegli **Esegui query**. La query potrebbe richiedere alcuni secondi, durante i quali viene visualizzato **Cancel (Annulla)** al posto di **Run query (Esegui query**).
1. (Facoltativo) Per esportare i risultati come file CSV, scegliere **Actions (Operazioni)**, quindi scegliere **Download query results (CSV) (Scarica risultati query (CSV))**.
**Nota**
La console limita il numero di record che restituisce nei risultati delle query e che esporta, quindi per dati di massa, usa l'API, il AWS Command Line Interface (AWS CLI) o un SDK.
**Topics**
+ [Interrogazione dei log ADS](querying-the-ads-logs.md)
# Interrogazione dei log ADS
CloudWatch Logs Insights offre un ricco set di opzioni per interrogare i log. [Per informazioni dettagliate sulla sintassi delle interrogazioni, vedi CloudWatch Sintassi delle query di Logs Insights.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) Questa sezione fornisce esempi di query comuni per iniziare a utilizzare le query dei log ADS. Tutte le query vengono eseguite sui log per l'impostazione dell'intervallo di tempo corrente.
La query seguente recupera tutte le informazioni dai log ADS.
```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```
La query seguente recupera tutte le richieste a ADS. Questa query mostra un modo per recuperare il contenuto dell'intestazione della richiesta per i log. MediaTailor
```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```
La seguente query recupera gli annunci MediaTailor inseriti per una determinata sessione.
```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```
La seguente query recupera il tracciamento URLs effettuato MediaTailor per conto del giocatore.
```
fields @timestamp, beaconInfo.trackingEvent, beaconInfo.beaconUri, beaconInfo.headers.0.value as @userAgent, beaconInfo.headers.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "BEACON_FIRED"
| sort @timestamp asc
```
La query seguente recupera le informazioni per una sessione di riproduzione specifica filtrando i risultati in base a `sessionId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```
La query seguente recupera le informazioni per una singola richiesta filtrando i risultati in base a `requestId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```
La query seguente recupera un conteggio delle voci di log per ogni tipo di evento registrato.
```
fields eventType
| stats count() as @eventCount by eventType
```
La query seguente recupera l'ID disponibilità e l'elenco di annunci ignorati per tutte le disponibilità che hanno ignorato gli annunci.
```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```