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à.
# Risoluzione dei problemi relativi al flusso di MediaTailor eventi
La comprensione del flusso di AWS Elemental MediaTailor eventi fornisce una solida base per la risoluzione dei problemi di inserimento degli annunci. Analizzando la sequenza, la tempistica e gli schemi degli eventi, puoi identificare rapidamente dove si verificano i problemi e implementare soluzioni mirate.
Questa sezione fornisce indicazioni pratiche per l'utilizzo dell'analisi del flusso di eventi per diagnosticare i problemi. Per comprendere i concetti di base sul flusso di eventi, vedere[Flusso degli eventi di inserimento degli annunci](mediatailor-event-flow.md).
## Identificazione di flussi di eventi incompleti
I flussi di eventi incompleti si verificano quando la sequenza di eventi prevista si interrompe prima di raggiungere la corretta personalizzazione del manifesto (il processo di MediaTailor inserimento di informazioni pubblicitarie personalizzate nel manifesto). Identificare dove si interrompe il flusso aiuta a individuare la causa principale degli errori di inserimento degli annunci.
### Schemi di flusso incompleti comuni
Punti di errore diversi nel flusso di eventi indicano tipi specifici di problemi, come i seguenti.
+ Il **flusso si interrompe dopo il rilevamento di un'opportunità pubblicitaria:** indica problemi relativi ai marcatori degli annunci o al manifesto stesso che MediaTailor impediscono di effettuare una richiesta ADS. Dopo l'invio della richiesta ADS si verificherebbero problemi di connettività, configurazione o timeout ADS.
+ Il **flusso si interrompe dopo la richiesta ADS:** suggerisce problemi di risposta ADS, problemi di analisi VAST, errori di elaborazione creativa, timeout ADS, errori di connettività o problemi di configurazione come ADS non valido URLs che vengono scoperti solo quando viene effettuata la richiesta.
+ **Beacon di tracciamento mancante:** potrebbe indicare problemi di configurazione del tracciamento, problemi di segnalazione lato server o lacune di implementazione sul lato client.
### CloudWatch interrogazioni per un'analisi del flusso incompleta
Usa queste query di Amazon CloudWatch Logs Insights per identificare flussi di eventi incompleti. Esegui queste query sui gruppi di log appropriati in base al tipo di analisi necessaria.
**Selezione del gruppo di log:**
+ **MediaTailor/AdDecisionServerInteractions**- Utilizzato per le query che analizzano le interazioni con il server decisionale pubblicitario, le opportunità pubblicitarie e gli errori relativi agli annunci.
+ **MediaTailor/TranscodeService**- Utilizzalo per analizzare i problemi in cui gli annunci non sono stati inseriti a causa di problemi di transcodifica, errori di elaborazione creativa o altri problemi non correlati agli annunci.
**Example identifica le opportunità pubblicitarie senza una personalizzazione del manifesto efficace**
**Gruppo di log:/** MediaTailorAdDecisionServerInteractions
La seguente query identifica le opportunità pubblicitarie che non hanno portato a una corretta personalizzazione del manifesto:
```
fields @timestamp, eventType, avail.availId, sessionId
| filter eventType = "AD_MARKER_FOUND"
| stats count() as total_opportunities by avail.availId
| join (
fields @timestamp, eventType, avail.availId
| filter eventType = "FILLED_AVAIL"
| stats count() as successful_fills by avail.availId
) on avail.availId
| where ispresent(total_opportunities) and not ispresent(successful_fills)
| sort total_opportunities desc
```
**Example analizza i tassi di completamento del flusso di eventi**
**Gruppo di log:** MediaTailor/AdDecisionServerInteractions
La seguente query analizza i tassi di completamento tra diversi tipi di eventi:
```
fields @timestamp, eventType, avail.availId
| filter eventType in ["AD_MARKER_FOUND", "MAKING_ADS_REQUEST", "VAST_RESPONSE", "FILLED_AVAIL", "BEACON_FIRED"]
| stats count() by eventType, avail.availId
| sort avail.availId, eventType
```
**Example trova sessioni con eventi beacon mancanti**
**Gruppo di log**:/ MediaTailorAdDecisionServerInteractions
La seguente query identifica le sessioni che hanno esaurito i posti disponibili ma non gli eventi beacon corrispondenti:
```
fields @timestamp, eventType, sessionId, avail.availId
| filter eventType = "FILLED_AVAIL"
| stats count() as filled_avails by sessionId
| join (
fields @timestamp, eventType, sessionId
| filter eventType = "BEACON_FIRED"
| stats count() as beacon_events by sessionId
) on sessionId
| where filled_avails > 0 and (not ispresent(beacon_events) or beacon_events = 0)
| sort filled_avails desc
```
**Example identifica gli errori di inserimento degli annunci relativi alla transcodifica**
**Gruppo di log** MediaTailor:/TranscodeService
La seguente query identifica i problemi di transcodifica che impediscono il corretto inserimento degli annunci:
```
fields @timestamp, eventType, sessionId, requestId
| filter eventType in ["TRANSCODE_IN_PROGRESS", "INTERNAL_ERROR", "MISSING_VARIANTS", "PROFILE_NOT_FOUND"]
| stats count() as transcode_issues by eventType, sessionId
| sort transcode_issues desc
```
## Analisi dei problemi relativi alla tempistica degli eventi
L'analisi della tempistica degli eventi aiuta a identificare gli ostacoli alle prestazioni e a ottimizzare i flussi di lavoro di inserimento degli annunci. Schemi temporali insoliti spesso indicano problemi di fondo che influiscono sull'esperienza degli spettatori.
### Soglie di tempistica delle prestazioni
Utilizzate queste soglie temporali per identificare potenziali problemi di prestazioni.
+ **Durata totale del flusso superiore a 5 secondi:** può influire sull'esperienza degli spettatori e può indicare problemi di prestazioni ADS, problemi del server di origine (come i timeout di recupero del manifesto) o problemi interni, inclusi MediaTailor problemi di infrastruttura con NAT Gateway, DynamoDB, EC2 o altri componenti del sistema.
+ Tempo di **risposta ADS superiore a 2 secondi: suggerisce problemi di prestazioni ADS o problemi di latenza** di rete.
+ **Personalizzazione del manifesto per più di 1 secondo:** può indicare ritardi di elaborazione creativa, problemi del server di origine (come i timeout di recupero del manifesto) o problemi interni del MediaTailor sistema, inclusi vincoli di infrastruttura con NAT Gateway, DynamoDB, EC2 o altri componenti.
### Interrogazioni di analisi temporale
Utilizza queste query per analizzare i modelli di temporizzazione degli eventi.
**Example misura la durata totale del flusso di eventi**
La seguente query misura la durata totale dei flussi di eventi e identifica quelli che superano i 5 secondi:
```
fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["AD_MARKER_FOUND", "FILLED_AVAIL"]
| sort @timestamp asc
| stats min(@timestamp) as start_time, max(@timestamp) as end_time by avail.availId
| eval duration_seconds = (end_time - start_time) / 1000
| where duration_seconds > 5
```
**Example analizza i tempi di risposta di ADS**
La seguente query analizza i tempi di risposta ADS e identifica quelli che superano i 2 secondi:
```
fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["MAKING_ADS_REQUEST", "VAST_RESPONSE"]
| sort @timestamp asc
| stats min(@timestamp) as request_time, max(@timestamp) as response_time by avail.availId
| eval ads_response_seconds = (response_time - request_time) / 1000
| where ads_response_seconds > 2
```
**Example identifica la personalizzazione lenta del manifesto**
La seguente query identifica i processi di personalizzazione dei manifesti che richiedono più di 1 secondo:
```
fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["VAST_RESPONSE", "FILLED_AVAIL"]
| sort @timestamp asc
| stats min(@timestamp) as response_time, max(@timestamp) as filled_time by avail.availId
| eval personalization_seconds = (filled_time - response_time) / 1000
| where personalization_seconds > 1
```
## Problemi e soluzioni comuni relativi al flusso di eventi
Questa sezione fornisce soluzioni per i problemi di flusso di eventi più frequenti, organizzate per tipo di problema e sintomi.
### Errori delle richieste del server decisionale pubblicitario
**Sintomi:** il flusso di eventi si interrompe dopo il rilevamento di un'opportunità pubblicitaria. Nessun evento di richiesta ADS registrato.
**Cause e soluzioni comuni**
+ **Errori di configurazione dell'URL ADS:** verifica che l'URL ADS nella configurazione di riproduzione sia corretto e accessibile. Nel registro delle interazioni con gli annunci, vedrai un evento di richiesta ADS (`MAKING_ADS_REQUEST`) ma nessuna risposta VAST corrispondente, spesso accompagnata da un evento di errore ` ERROR_UNKNOWN ` o simile.
+ **Problemi di connettività di rete:** verifica la connettività di rete tra MediaTailor e il tuo ADS, comprese le regole del firewall e la risoluzione DNS.
+ **Problemi con i certificati SSL/TLS:** assicurati che il tuo ADS utilizzi certificati SSL validi emessi da un'autorità di certificazione affidabile. In particolare, per Google Ad Manager, potrebbe essere necessario contattare [AWS Support](https://aws.amazon.com/premiumsupport/) per abilitare un flag di configurazione che accetti i certificati SSL di Google.
**Domanda diagnostica**
La seguente query aiuta a diagnosticare gli errori delle richieste ADS tracciando la sequenza degli eventi:
```
fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["AD_MARKER_FOUND", "MAKING_ADS_REQUEST", "ERROR_ADS_IO", "ERROR_UNKNOWN_HOST"]
| sort @timestamp asc
```
### Errori di risposta del server decisionale pubblicitario
**Sintomi:** le richieste ADS hanno esito positivo ma MediaTailor non ricevono risposta oppure si verificano errori di analisi.
**Cause e soluzioni comuni**
+ **Formato VAST non valido:** convalida le tue risposte ADS VAST rispetto agli standard delle specifiche VAST.
+ **Problemi di timeout ADS:** aumenta le impostazioni di timeout ADS o ottimizza i tempi di risposta ADS.
+ **Svuota l'inventario degli annunci:** verifica la disponibilità dell'inventario degli annunci e i criteri di targeting nella configurazione ADS.
**Domanda diagnostica**
La seguente query aiuta a diagnosticare gli errori di risposta ADS esaminando gli eventi di richiesta e risposta:
```
fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["MAKING_ADS_REQUEST", "VAST_RESPONSE", "EMPTY_VAST_RESPONSE", "ERROR_ADS_RESPONSE_PARSE", "ERROR_ADS_TIMEOUT"]
| sort @timestamp asc
```
### Manifesti errori di personalizzazione
**Sintomi:** sono state ricevute risposte VAST ma la personalizzazione del manifesto non riesce o gli annunci vengono ignorati.
**Cause e soluzioni comuni:**
+ **Problemi di transcodifica creativa:** verifica se l'annuncio è un file che richiede ` NEW_CREATIVE` la transcodifica prima dell'inserimento. Puoi anche verificare la presenza di errori di transcodifica esaminando il MediaTailor/TranscodeService registro alla ricerca di eventi di errore come, o. `INTERNAL_ERROR` `MISSING_VARIANTS,` `PROFILE_NOT_FOUND`
+ **Problemi di mancata corrispondenza della durata:** verifica che le durate degli annunci corrispondano alle durate delle interruzioni pubblicitarie disponibili.
+ **Problemi relativi alla soglia di personalizzazione:** rivedi le impostazioni delle soglie di personalizzazione nella configurazione di riproduzione.
**Domanda diagnostica**
La seguente query aiuta a diagnosticare gli errori di personalizzazione del manifesto esaminando le risposte VAST e gli avallamenti completi:
```
fields @timestamp, eventType, sessionId, skippedAds
| filter sessionId = "your-session-id"
| filter eventType in ["VAST_RESPONSE", "FILLED_AVAIL", "WARNING_NO_ADVERTISEMENTS"]
| sort @timestamp asc
```
**Query per motivi di annuncio ignorati**
La seguente query fornisce informazioni dettagliate sul motivo per cui gli annunci sono stati ignorati:
```
fields @timestamp, eventType, sessionId, skippedAds.reason, skippedAds.creativeUniqueId
| filter sessionId = "your-session-id"
| filter eventType = "WARNING_NO_ADVERTISEMENTS" or ispresent(skippedAds)
| sort @timestamp asc
```
**Interrogazione per motivi relativi all'annuncio ignorato e per motivi creativi unici IDs**
La seguente query fornisce informazioni dettagliate sugli annunci ignorati, compresi i motivi e la creatività unica IDs per i primi due annunci di ciascuna pubblicazione:
```
fields @timestamp, eventType
| filter sessionId = "your-session-id"
| filter eventType = "FILLED_AVAIL"
| fields avail.skippedAds.0.vastDuration as SkippedDur_Ad0, avail.skippedAds.0.skippedReason as Ad0_SkipReason, avail.skippedAds.0.creativeUniqueId as SkippedCreative0_UID
| fields avail.skippedAds.1.vastDuration as SkippedDur_Ad1, avail.skippedAds.1.skippedReason as Ad1_SkipReason, avail.skippedAds.1.creativeUniqueId as SkippedCreative1_UID
| sort @timestamp desc
```
### Monitoraggio degli errori dei beacon
**Sintomi:** personalizzazione del manifesto riuscita ma beacon di tracciamento mancanti o non riusciti.
**Cause e soluzioni comuni**
+ Problemi di **implementazione lato client: la maggior parte dei problemi relativi** ai beacon di tracciamento derivano da problemi di implementazione lato client, ad esempio la scarsa URLs frequenza del tracciamento dei sondaggi per il tracciamento lato client, o problemi di logica di attivazione dei beacon specifici giocatori.
+ **Monitoraggio dei problemi di accessibilità degli URL: verifica che il tracciamento nelle risposte VAST sia accessibile** e restituisci risposte appropriate. URLs I problemi possono verificarsi quando non URLs sono raggiungibili o quando si MediaTailor riscontrano problemi interni che impediscono il corretto invio delle risposte di tracciamento.
+ **Problemi relativi alla richiesta del segmento di giocatore:** possono verificarsi apparenti errori nel tracciamento dei beacon quando il giocatore client non richiede effettivamente alcun segmento. Ciò non comporta l'invio di beacon, il che sembra un errore di tracciamento ma in realtà è un problema di implementazione del giocatore piuttosto che un problema di beacon.
**Domanda diagnostica**
La seguente query aiuta a diagnosticare gli errori di tracciamento dei beacon esaminando gli avail pieni e gli eventi beacon:
```
fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["FILLED_AVAIL", "BEACON_FIRED", "ERROR_FIRING_BEACON_FAILED"]
| sort @timestamp asc
```
## Best practice per il monitoraggio del flusso di eventi
Implementa queste pratiche di monitoraggio per identificare e risolvere in modo proattivo i problemi relativi al flusso di eventi:
### Impostazione degli allarmi CloudWatch
Crea CloudWatch allarmi Amazon per monitorare le metriche chiave del flusso di eventi.
+ **Allarme sulla percentuale di completamento del flusso:** avvisa quando il rapporto tra la riuscita della personalizzazione del manifesto e le opportunità pubblicitarie scende al di sotto delle soglie accettabili.
+ **Allarme sui tempi di risposta ADS:** monitora i tempi di risposta medi di ADS e avvisa quando superano le soglie di performance.
+ **Allarme relativo al tasso di errore:** monitora la frequenza degli eventi di errore e segnala picchi insoliti di tipi di errore specifici.
### Interrogazioni di monitoraggio regolari
Esegui queste query regolarmente per mantenere la visibilità sullo stato del flusso di eventi:
**Example percentuale di successo del flusso di eventi giornaliero**
La seguente query fornisce una panoramica giornaliera delle percentuali di successo del flusso di eventi per tipo di evento:
```
fields @timestamp, eventType
| filter @timestamp > datefloor(@timestamp, 1d)
| stats count() as total_events by eventType
| sort total_events desc
```
**Example tendenza del tasso di errore orario**
La seguente query tiene traccia dei tassi di errore per ora per identificare i problemi di tendenza:
```
fields @timestamp, eventType
| filter eventType like /ERROR_/
| stats count() as error_count by datefloor(@timestamp, 1h) as hour
| sort hour desc
```
### Guida all'ottimizzazione delle prestazioni
Utilizza l'analisi del flusso di eventi per ottimizzare le prestazioni di inserimento degli annunci.
+ **Ottimizzazione ADS:** collabora con il tuo provider ADS per ottimizzare i tempi di risposta e ridurre la latenza.
+ **Preparazione creativa:** pre-transcodifica gli annunci creativi per adattarli ai tuoi profili di contenuto e ridurre i ritardi di elaborazione.
+ **Ottimizzazione della configurazione:** regola le impostazioni di timeout, le soglie di personalizzazione e altri parametri di configurazione in base all'analisi del flusso di eventi.
## Altre risorse per la risoluzione dei problemi
Per ulteriori indicazioni sulla risoluzione dei problemi oltre all'analisi del flusso di eventi:
+ Per informazioni dettagliate sul formato del registro e sulle specifiche tecniche, vedere[Visualizzazione dei log di ](monitoring-through-logs.md).
+ Per una risoluzione completa dei problemi più comuni relativi all'inserimento degli annunci, consulta[Risoluzione dei problemi comuni](monitoring-and-troubleshooting.md#troubleshooting-common-issues).
+ Per indicazioni sulla configurazione del monitoraggio e degli avvisi, consulta. [Monitoraggio AWS Elemental MediaTailor con CloudWatch parametri Amazon](monitoring-cloudwatch-metrics.md)
+ Per le procedure di registrazione del debug, vedere. [Generazione di registri di debug](debug-log-mode.md)