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à.
# Monitoraggio e etichettatura delle risorse AWS Elemental MediaTailor
Il monitoraggio è una parte importante per mantenere l'affidabilità, la disponibilità e le prestazioni delle altre soluzioni AWS Elemental MediaTailor . AWS AWS fornisce i seguenti strumenti di monitoraggio per osservare MediaTailor, segnalare quando qualcosa non va e intraprendere azioni automatiche quando necessario:
+ *Amazon CloudWatch* monitora AWS le tue risorse e le applicazioni su cui esegui AWS in tempo reale. È possibile raccogliere e tenere traccia dei parametri, creare pannelli di controllo personalizzati e impostare allarmi per inviare una notifica o intraprendere azioni quando un parametro specificato raggiunge una determinata soglia. Ad esempio, puoi tenere CloudWatch traccia dell'utilizzo della CPU o di altri parametri delle tue istanze Amazon EC2 e avviare automaticamente nuove istanze quando necessario. Per ulteriori informazioni, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
+ *Amazon CloudWatch Logs* ti consente di monitorare, archiviare e accedere ai tuoi file di registro da tutte le interazioni con il tuo Ad Decision Server (ADS). AWS Elemental MediaTailor emette log per richieste di annunci, reindirizzamenti, risposte e segnalazione di richieste e risposte. Gli errori provenienti dai server ADS e di origine vengono inoltre emessi nei gruppi di log in Amazon CloudWatch. MediaTailor fornisce anche informazioni sugli annunci ignorati e sui motivi per cui sono stati ignorati. Per ulteriori informazioni, consulta [Risoluzione dei problemi relativi ai salti degli annunci](troubleshooting-ad-skipping-overview.md). Puoi inoltre archiviare i dati del log in storage estremamente durevole. Per informazioni generali, consulta la [Amazon CloudWatch Logs User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). Per informazioni sui log ADS e su come accedervi per l'analisi tramite Amazon CloudWatch Logs Insights, consulta. [AWS Elemental MediaTailor Analisi dei log ADS in Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)
**Topics**
+ [
# Visualizzazione dei log AWS Elemental MediaTailor
](monitoring-through-logs.md)
+ [
# Monitoraggio AWS Elemental MediaTailor con CloudWatch parametri Amazon
](monitoring-cloudwatch-metrics.md)
+ [
# Registrazione delle chiamate API AWS Elemental MediaTailor
](logging-using-cloudtrail.md)
+ [
# Ricezione di avvisi AWS Elemental MediaTailor sull'assemblaggio dei canali
](channel-assembly-alerts.md)
+ [
# AWS Elemental MediaTailor Taggare le risorse
](tagging.md)
+ [
# Monitoraggio AWS dei servizi multimediali con Workflow Monitor
](monitor-with-workflow-monitor.md)
# Visualizzazione dei log AWS Elemental MediaTailor
MediaTailor emette registri che descrivono una serie di traguardi e attività nei canali e nelle configurazioni di riproduzione. È possibile utilizzare questi registri per ottenere visibilità sul flusso di lavoro e risolvere i problemi relativi al servizio. I seguenti argomenti descrivono i log e le opzioni di registrazione.
**Topics**
+ [Registri ADS](ads-log-format.md)
+ [registri del manifesto](log-types.md)
+ [Registri di transcodifica](tm-log-format.md)
+ [Utilizzo dei registri venduti](vended-logs.md)
+ [Scrittura di log su Logs CloudWatch](monitoring-cw-logs.md)
+ [Controllo del volume dei log delle sessioni di inserimento degli annunci](log-configuration.md)
+ [Filtraggio di registri ed eventi](logs-filter.md)
+ [Generazione di registri di debug](debug-log-mode.md)
# AWS Elemental MediaTailor Descrizione dei log ADS e tipi di eventi
Le sezioni seguenti descrivono i log che vengono MediaTailor emessi per descrivere gli eventi con l'ad decision server (ADS). Si tratta di registri`AdDecisionServerInteractions`.
**Topics**
+ [
## Eventi AdDecisionServerInteractions
](#log-types-adsinteraction)
+ [
## Descrizione del registro ADS
](#ads-log-description)
+ [
## Schema JSON del registro ADS
](#ads-log-json-schema)
## Eventi AdDecisionServerInteractions
I seguenti eventi vengono emessi durante MediaTailor le interazioni con l'ad decision server (ADS).
| Log | Description |
| --- | --- |
| AD\$1MARKER\$1FOUND | MediaTailor ha trovato un indicatore pubblicitario nel manifesto. |
| BEACON\$1FIRED | È stato attivato un segnale di tracciamento per segnalare gli eventi pubblicitari. Nella modalità di segnalazione lato server (impostazione predefinita), MediaTailor attiva il beacon. Nella modalità di segnalazione lato client, il dispositivo di riproduzione attiva il beacon. |
| EMPTY\$1VAST\$1RESPONSE | L'ADS ha restituito una risposta VAST vuota contenente zero annunci. |
| EMPTY\$1VMAP\$1RESPONSE | L'ADS ha restituito una risposta VMAP vuota. |
| ERROR\$1ADS\$1INVALID\$1RESPONSE | L'ADS ha restituito un codice di stato diverso da 200. |
| ERROR\$1ADS\$1IO | MediaTailor si è verificato un errore durante il tentativo di comunicare con l'ADS. |
| ERROR\$1ADS\$1RESPONSE\$1PARSE | MediaTailor ha riscontrato un errore durante l'analisi della risposta ADS. |
| ERROR\$1ADS\$1RESPONSE\$1UNKNOWN\$1ROOT\$1ELEMENT | La risposta ADS contiene un elemento root non valido. |
| ERROR\$1ADS\$1TIMEOUT | La MediaTailor richiesta all'ADS è scaduta. |
| ERROR\$1DISALLOWED\$1HOST | L'host ADS non è consentito. |
| ERROR\$1FIRING\$1BEACON\$1FAILED | MediaTailor non è riuscito a far scattare il segnale di tracciamento. |
| ERROR\$1PERSONALIZATION\$1DISABLED | L'inserimento degli annunci è disabilitato per questa sessione. |
| ERROR\$1UNKNOWN | MediaTailor ha riscontrato un errore sconosciuto durante la richiesta ADS. |
| ERROR\$1UNKNOWN\$1HOST | L'host ADS è sconosciuto. |
| ERROR\$1VAST\$1INVALID\$1MEDIA\$1FILE | Il VAST Ad presenta un MediaFile elemento non valido o mancante. |
| ERROR\$1VAST\$1INVALID\$1VAST\$1AD\$1TAG\$1URI | La risposta VAST contiene un messaggio non VASTAdTagURI valido. |
| ERROR\$1VAST\$1MISSING\$1CREATIVES | Il VAST Ad contiene zero o più Creatives elementi. È richiesto esattamente un Creatives elemento. |
| ERROR\$1VAST\$1MISSING\$1IMPRESSION | Il Ad VAST contiene zero Impression elementi. È richiesto almeno un Impression elemento. |
| ERROR\$1VAST\$1MISSING\$1MEDIAFILES | Il Ad VAST contiene zero o più MediaFiles elementi. È richiesto esattamente un MediaFiles elemento. |
| ERROR\$1VAST\$1MISSING\$1OVERLAYS | MediaTailor non ho ricevuto alcuna creatività non lineare dall'ad server. |
| ERROR\$1VAST\$1MULTIPLE\$1LINEAR | Il VAST Ad contiene più Linear elementi. |
| ERROR\$1VAST\$1MULTIPLE\$1TRACKING\$1EVENTS | Il Ad VAST contiene più TrackingEvents elementi. |
| ERROR\$1VAST\$1REDIRECT\$1EMPTY\$1RESPONSE | La richiesta di reindirizzamento VAST ha restituito una risposta vuota. |
| ERROR\$1VAST\$1REDIRECT\$1FAILED | La richiesta di reindirizzamento VAST ha rilevato un errore. |
| ERROR\$1VAST\$1REDIRECT\$1MULTIPLE\$1VAST | La richiesta di reindirizzamento VAST ha restituito più annunci. |
| FILLED\$1AVAIL | MediaTailor ha riempito con successo il risultato. |
| FILLED\$1OVERLAY\$1AVAIL | MediaTailor ha riempito con successo la disponibilità dell'overlay. |
| INTERSTITIAL\$1VOD\$1FAILURE | La richiesta o la risposta ADS ha riscontrato un problema durante la compilazione delle schede interstiziali per la playlist VOD. Non verrà inserito alcun annuncio. |
| INTERSTITIAL\$1VOD\$1SUCCESS | MediaTailor file interstiziali compilati con successo per la playlist VOD. |
| MAKING\$1ADS\$1REQUEST | MediaTailor richiede annunci pubblicitari all'ADS. |
| MODIFIED\$1TARGET\$1URL | MediaTailor ha modificato l'URL di destinazione in uscita. |
| NON\$1AD\$1MARKER\$1FOUND | MediaTailor ha trovato un indicatore pubblicitario non utilizzabile nel manifesto. |
| RAW\$1ADS\$1RESPONSE | MediaTailor ha ricevuto una risposta ADS non elaborata. |
| REDIRECTED\$1VAST\$1RESPONSE | MediaTailor ha ricevuto una risposta VAST dopo aver seguito il reindirizzamento VAST. |
| VAST\$1REDIRECT | La risposta all'annuncio VAST contiene un reindirizzamento. |
| VAST\$1RESPONSE | MediaTailor ha ricevuto una risposta VAST. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1SUCCESS | MediaTailor ha creato con successo un piano di disponibilità basato sul tempo per il modello VOD. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1VAST\$1RESPONSE\$1FOR\$1OFFSET | MediaTailor sta creando un piano di disponibilità basato sul tempo per il modello VOD. MediaTailor ha ricevuto una risposta VAST per l'offset temporale. |
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1WARNING\$1NO\$1ADVERTISEMENTS | La richiesta o la risposta ADS ha riscontrato un problema durante la creazione di un piano di disponibilità basato sul tempo per il modello VOD. Non verrà inserito alcun annuncio. |
| WARNING\$1NO\$1ADVERTISEMENTS | MediaTailor ha riscontrato un problema durante la compilazione della richiesta. Non viene inserita alcuna pubblicità. |
| WARNING\$1URL\$1VARIABLE\$1SUBSTITUTION\$1FAILED | MediaTailor non può sostituire variabili dinamiche nell'URL ADS. Controlla la configurazione dell'URL. |
| WARNING\$1VPAID\$1AD\$1DROPPED | Un annuncio VPAID è stato eliminato a causa di una lista mancante oppure la sessione utilizza la reportistica lato server. |
## Descrizione del registro ADS
Questa sezione descrive la struttura e i contenuti della descrizione del log ADS. Per esplorare in modo autonomo in un editor JSON, utilizza l'elenco in [Schema JSON del registro ADS](#ads-log-json-schema).
Ogni evento nel registro ADS contiene i campi standard generati dai CloudWatch registri. Per informazioni, consulta [Analizzare i dati di registro con CloudWatch Logs Insights.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)
### Proprietà dei log ADS
Questa sezione descrive le proprietà dei log ADS.
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| adsRequestUrl | stringa | false | L'URL completo della richiesta ADS effettuata da MediaTailor. |
| avail | Oggetto di tipo [disponibilità](#ads-logs-avail) | false | Informazioni su un'offerta che si MediaTailor riempie di annunci. Attualmente, per il tipo di FILLED\$1AVAIL evento, questo è il piano creato la prima MediaTailor volta che ne riscontra i vantaggi. Il modo in cui la disponibilità viene raggiunta può variare da questo piano, a seconda della modalità di riproduzione dei contenuti. |
| awsAccountId | stringa | true | L'ID dell'account AWS per la MediaTailor configurazione utilizzata per la sessione. |
| customerId | stringa | true | La versione con hash dell'ID dell'account AWS, che puoi utilizzare per correlare più voci di log. |
| eventDescription | stringa | true | Una breve descrizione dell'evento che ha attivato questo messaggio di registro, fornita dal MediaTailor servizio. Per impostazione predefinita, è vuota. Esempio: Got VAST response. |
| eventTimestamp | stringa | true | La data e l'ora dell'evento |
| eventType | stringa | true | Il codice per l'evento che ha attivato questo messaggio di log. Esempio: VAST\$1RESPONSE. |
| originId | stringa | true | Il nome della configurazione risultante dalla MediaTailor configurazione. Questo è diverso dall'origine dei contenuti video, che fa anche parte della configurazione. |
| prefetchScheduleName | stringa | false | Il nome della pianificazione di prefetch associata a questo evento pubblicitario. |
| requestHeaders | array di tipo [requestheaders](#ads-logs-requestheaders) | false | Le intestazioni MediaTailor incluse nella richiesta ADS. In genere, i log le includono quando una richiesta all'ADS non riesce, per facilitare la risoluzione dei problemi. |
| requestId | stringa | true | L'ID della MediaTailor richiesta, che puoi utilizzare per correlare più voci di registro per la stessa richiesta. |
| sessionId | stringa | true | L'identificatore numerico univoco MediaTailor assegnato alla sessione del giocatore. Tutte le richieste effettuate da un giocatore per una sessione hanno lo stesso ID sessione. Esempio: e039fd39-09f0-46b2-aca9-9871cc116cde. |
| sessionType | string (valori ammessi: [DASH, HLS]) | true | Il tipo di flusso del giocatore. |
| vastAd | Oggetto di tipo [vastAd](#ads-logs-vastAd) | false | Informazioni su un singolo annuncio analizzato dalla risposta VAST. |
| vastResponse | Oggetto di tipo [vastResponse](#ads-logs-vastResponse) | false | Informazioni sulla risposta VAST MediaTailor ricevuta dall'ADS. |
| vodCreativeOffsets | Oggetto di tipo [vodCreativeOffsets](#ads-logs-vodCreativeOffsets) | false | Una mappa che indica gli spostamenti temporali nel manifesto in cui MediaTailor verranno inseriti gli avail, in base alla risposta VMAP. |
| vodVastResponseTimeOffset | numero | false | La differenza di orario specifica VMAP per l'inserimento di annunci VOD. |
### adContent
Questa sezione descrive le proprietà di adContent dei log ADS.
**Proprietà di adContent dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| adPlaylistUris | Oggetto di tipo [adPlaylistUris](#ads-logs-adPlaylistUris) | false | La mappatura dal manifest di origine per una variante al manifest di annunci per la variante. Per DASH, questo contiene una singola voce, perché tutte le varianti sono rappresentate in un singolo manifest DASH. |
### adPlaylistUris
Questa sezione descrive le proprietà dei registri adPlaylistUris ADS.
**Proprietà dei registri adPlaylistUris ADS**
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| | stringa | false | L'URL del manifest di annunci per la variante specifica. |
### disponibilità
Questa sezione descrive le proprietà di avail dei log ADS.
**Proprietà di avail dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| availId | stringa | true | L'identificatore univoco di questa disponibilità. Per HLS, questo è il numero di sequenza multimediale in cui inizia la disponibilità. Per DASH, questo è l'ID punto. |
| creativeAds | array di tipo [creativeAd](#ads-logs-creativeAd) | true | Gli annunci che sono MediaTailor stati inseriti nella pagina. |
| fillRate | numero | true | La frequenza con cui gli annunci raggiungono la durata di disponibilità, da 0,0 (per 0%) a 1,0 (per 100%). |
| filledDuration | numero | true | La somma delle durate di tutti gli annunci inseriti nella disponibilità. |
| numAds | numero | true | Il numero di annunci MediaTailor inseriti nell'avail. |
| originAvailDuration | numero | true | La durata della disponibilità come specificato nel flusso di contenuti dall'origine (CUE\$1OUT o SCTE). |
| skippedAds | array di tipo [skippedAd](#ads-logs-skippedAd) | false | Gli annunci che MediaTailor non sono stati inseriti, per motivi come TRANSCODE\$1IN\$1PROGRESS eTRANSCODE\$1ERROR. Per un elenco dei motivi per cui l'annuncio è stato ignorato, consulta[Risoluzione dei problemi relativi ai salti degli annunci](troubleshooting-ad-skipping-overview.md). |
| slateAd | Oggetto di tipo [slateAd](#ads-logs-slateAd) | true | Informazioni sull'annuncio Slate, MediaTailor utilizzato per riempire tutti i segmenti vuoti disponibili. |
### creativeAd
Questa sezione descrive le proprietà di creativeAd dei log ADS.
**Proprietà di creativeAd dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| adContent | Oggetto di tipo [adContent](#ads-logs-adContent) | true | Informazioni sul contenuto dell'annuncio inserito. |
| creativeUniqueId | stringa | true | L'identificatore univoco per l'annuncio, utilizzato come chiave per la transcodifica. Questo è il campo ID per la creatività nella risposta VAST, se disponibile. In caso contrario, è l'URL in formato intermedio dell'annuncio. |
| trackingEvents | Oggetto di tipo [trackingEvents](#ads-logs-trackingEvents) | true | Il beacon di tracciamento URLs per i vari eventi di tracciamento dell'annuncio. Le chiavi sono i nomi degli eventi e i valori sono un elenco di beacon. URLs |
| transcodedAdDuration | numero | true | La durata dell'annuncio, calcolata dall'asset transcodificato. |
| uri | stringa | true | L'URL della versione intermedia dell'annuncio, ovvero l'input per il transcodificatore. |
| vastDuration | numero | true | La durata dell'annuncio, come analizzato dalla risposta VAST. |
### requestheaders
Questa sezione descrive le proprietà dei requestheader dei log ADS.
**Proprietà dei requestheader dei log ADS.**
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| name | stringa | true | Il nome dell'intestazione |
| value | stringa | true | Il valore dell'intestazione. |
### skippedAd
Questa sezione descrive le proprietà di skippedAd dei log ADS.
**Proprietà di skippedAd dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| adMezzanineUrl | stringa | true | L'URL intermedio dell'annuncio ignorato. |
| creativeUniqueId | stringa | true | L'identificatore univoco per l'annuncio, utilizzato come chiave per la transcodifica. Questo è il campo ID per la creatività nella risposta VAST, se disponibile. In caso contrario, è l'URL in formato intermedio dell'annuncio. |
| skippedReason | stringa | true | Il codice che indica il motivo per cui l'annuncio non è stato inserito. Esempio: TRANSCODE\$1IN\$1PROGRESS. Per un elenco dei motivi degli annunci ignorati, consulta. [Risoluzione dei problemi relativi ai salti degli annunci](troubleshooting-ad-skipping-overview.md) |
| transcodedAdDuration | numero | false | La durata dell'annuncio, calcolata dall'asset transcodificato. |
| vastDuration | numero | true | La durata dell'annuncio, come analizzato dalla risposta VAST. |
### slateAd
Questa sezione descrive le proprietà di slateAd dei log ADS.
**Proprietà di slateAd dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| adContent | Oggetto di tipo [adContent](#ads-logs-adContent) | true | Informazioni sul contenuto dell'annuncio inserito. |
| creativeUniqueId | stringa | true | L'identificatore univoco per l'annuncio, utilizzato come chiave per la transcodifica. Questo è il campo ID per la creatività nella risposta VAST, se disponibile. In caso contrario, è l'URL in formato intermedio dell'annuncio. |
| transcodedAdDuration | numero | true | La durata dell'annuncio, calcolata dall'asset transcodificato. |
| uri | stringa | true | L'URL della versione intermedia dell'annuncio, ovvero l'input per il transcodificatore. |
### trackingEvents
Questa sezione descrive le proprietà di trackingEvents dei log ADS.
**Proprietà di trackingEvents dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| | array di tipo string | false | L'elenco dei beacon URLs per l'evento di tracciamento specificato (impression, complete e così via) |
### vastAd
Questa sezione descrive le proprietà di vastAd dei log ADS.
**Proprietà di vastAd dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| adSystem | stringa | true | Il valore del tag AdSystem nella risposta VAST. |
| adTitle | stringa | true | I file multimediali disponibili per l'annuncio nella risposta VAST. |
| creativeAdId | stringa | true | Il valore dell'attributo adId del tag Creative nella risposta VAST. |
| creativeId | stringa | true | Il valore dell'attributo id del tag Creative nella risposta VAST. |
| duration | numero | true | La durata approssimativa dell'annuncio, in base al tag duration nell'elemento linear della risposta VAST. |
| trackingEvents | Oggetto di tipo [trackingEvents](#ads-logs-trackingEvents) | true | Il beacon di tracciamento URLs per i vari eventi di tracciamento dell'annuncio. Le chiavi sono i nomi degli eventi e i valori sono un elenco di beacon. URLs |
| vastAdId | stringa | true | Il valore dell'attributo id del tag Ad nella risposta VAST |
| vastAdTagUri | stringa | false | L'URI di reindirizzamento specifico di VMAP per un annuncio. |
| vastMediaFiles | array di tipo [vastMediaFile](#ads-logs-vastMediaFile) | true | L'elenco dei file multimediali disponibili per l'annuncio nella risposta VAST. |
### vastMediaFile
Questa sezione descrive le proprietà dei registri vastMediaFile ADS.
**Proprietà dei registri vastMediaFile ADS**
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| apiFramework | stringa | true | Il framework API necessario per gestire il file multimediale. Esempio: VPAID. |
| bitrate | numero | true | Il bitrate del file multimediale. |
| delivery | stringa | true | Il protocollo utilizzato per il file multimediale, impostato su progressivo o streaming. |
| height | numero | true | L'altezza in pixel del file multimediale. |
| id | stringa | true | Il valore dell'attributo id del tag MediaFile. |
| type | stringa | true | Il tipo MIME del file multimediale, preso dall'attributo di tipo del tag MediaFile. |
| uri | stringa | true | L'URL della versione intermedia dell'annuncio, ovvero l'input per il transcodificatore. |
| width | numero | true | La larghezza in pixel del file multimediale. |
### vastResponse
Questa sezione descrive le proprietà di vastResponse dei log ADS.
**Proprietà di vastResponse dei log ADS**
| Proprietà | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| errors | array di tipo string | true | L'errore è URLs stato analizzato dai Error tag nella risposta VAST. |
| vastAds | array di tipo [vastAd](#ads-logs-vastAd) | true | Gli annunci analizzati dalla risposta VAST. |
| version | stringa | true | La versione della specifica VAST, analizzata dall'attributo version del tag VAST nella risposta. |
### vodCreativeOffsets
Questa sezione descrive le proprietà dei registri vodCreativeOffsets ADS.
**Proprietà dei registri vodCreativeOffsets ADS**
| Proprietà | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| | array di tipo [vodCreativeOffset](#ads-logs-vodCreativeOffset) | false | Una mappatura da un offset temporale nel manifest a un elenco di annunci da inserire in questo momento. |
### vodCreativeOffset
Questa sezione descrive le proprietà dei registri vodCreativeOffset ADS.
**Proprietà dei registri vodCreativeOffset ADS**
| Proprietà | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| adContent | Oggetto di tipo [adContent](#ads-logs-adContent) | true | Informazioni sul contenuto dell'annuncio inserito. |
| creativeUniqueId | stringa | true | L'identificatore univoco per l'annuncio, utilizzato come chiave per la transcodifica. Questo è il campo ID per la creatività nella risposta VAST, se disponibile. In caso contrario, è l'URL in formato intermedio dell'annuncio. |
| trackingEvents | Oggetto di tipo [trackingEvents](#ads-logs-trackingEvents) | true | Il beacon di tracciamento URLs per i vari eventi di tracciamento dell'annuncio. Le chiavi sono i nomi degli eventi e i valori sono un elenco di beacon. URLs |
| transcodedAdDuration | numero | true | La durata dell'annuncio, calcolata dall'asset transcodificato. |
| uri | stringa | true | L'URL della versione intermedia dell'annuncio, ovvero l'input per il transcodificatore. |
| vastDuration | numero | true | La durata dell'annuncio, come analizzato dalla risposta VAST. |
## Schema JSON del registro ADS
Di seguito è riportato lo schema JSON per il registro AWS Elemental MediaTailor ADS.
```
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "http://amazon.com/elemental/midas/mms/adsLogSchema.json",
"type": "object",
"title": "AWS Elemental MediaTailor ADS Log JSON Schema",
"required": [
"eventType",
"eventTimestamp",
"requestId",
"sessionType",
"eventDescription",
"awsAccountId",
"customerId",
"originId",
"sessionId"
],
"additionalProperties": false,
"properties": {
"eventType": {
"$id": "#/properties/eventType",
"type": "string",
"description": "The code for the event that triggered this log message. Example: VAST_RESPONSE.",
"examples": [
"FILLED_AVAIL"
]
},
"eventTimestamp": {
"$id": "#/properties/eventTimestamp",
"type": "string",
"description": "The date and time of the event.",
"examples": [
"1970-01-01T00:00:00Z"
],
"format": "date-time"
},
"requestId": {
"$id": "#/properties/requestId",
"type": "string",
"description": "The MediaTailor request ID, which you can use to correlate multiple log entries for the same request.",
"examples": [
"c7c7ae8c-a61e-44e0-8efd-7723995337a1"
],
"pattern": "^(.*)$"
},
"sessionType": {
"$id": "#/properties/sessionType",
"type": "string",
"enum": [
"HLS",
"DASH"
],
"description": "The player's stream type."
},
"eventDescription": {
"$id": "#/properties/eventDescription",
"type": "string",
"description": "A short description of the event that triggered this log message, provided by the MediaTailor service. By default, this is empty. Example: Got VAST response.",
"default": "",
"examples": [
"Got VAST response"
],
"pattern": "^(.*)$"
},
"awsAccountId": {
"$id": "#/properties/awsAccountId",
"type": "string",
"description": "The AWS account ID for the MediaTailor configuration that was used for the session."
},
"customerId": {
"$id": "#/properties/customerId",
"type": "string",
"description": "The hashed version of the AWS account ID, which you can use to correlate multiple log entries.",
"pattern": "^(.*)$"
},
"originId": {
"$id": "#/properties/originId",
"type": "string",
"description": "The configuration name from the MediaTailor configuration. This is different from the video content source, which is also part of the configuration.",
"examples": [
"external-canary-dash-serverside-reporting-onebox"
],
"pattern": "^(.*)$"
},
"sessionId": {
"$id": "#/properties/sessionId",
"type": "string",
"description": "The unique numeric identifier that MediaTailor assigned to the player session. All requests that a player makes for a session have the same session ID. Example: e039fd39-09f0-46b2-aca9-9871cc116cde.",
"examples": [
"120b9873-c007-40c8-b3db-0f1bd194970b"
],
"pattern": "^(.*)$"
},
"avail": {
"$id": "#/properties/avail",
"type": "object",
"title": "avail",
"description": "Information about an avail that MediaTailor fills with ads. Currently, for the FILLED_AVAIL event type, this is the plan created by MediaTailor when it first encounters the avail. How the avail is eventually filled may vary from this plan, depending on how the content plays out. ",
"required": [
"creativeAds",
"originAvailDuration",
"filledDuration",
"fillRate",
"driftMillisecondsAtAvailStart",
"numAds",
"slateAd",
"availId"
],
"additionalProperties": false,
"properties": {
"originAvailDuration": {
"$id": "#/properties/avail/originAvailDuration",
"type": "number",
"description": "The duration of the avail as specified in the content stream from the origin (CUE_OUT or SCTE)."
},
"filledDuration": {
"$id": "#/properties/avail/filledDuration",
"type": "number",
"description": "The sum of the durations of all the ads inserted into the avail."
},
"fillRate": {
"$id": "#/properties/avail/fillRate",
"type": "number",
"description": "The rate at which the ads fill the avail duration, from 0.0 (for 0%) to 1.0 (for 100%)."
},
"driftMillisecondsAtAvailStart": {
"$id": "#/properties/avail/driftMillisecondsAtAvailStart",
"type": "number",
"description": "The cumulative drift at the beginning of this avail. A positive value implies that we are moving away from the live edge, a negative value implies that we are moving towards the live edge."
},
"creativeAds": {
"$id": "#/properties/avail/creativeAds",
"type": "array",
"description": "The ads that MediaTailor inserted into the avail.",
"items": {
"type": "object",
"title": "creativeAd",
"description": "Information about a single inserted ad.",
"required": [
"uri",
"creativeUniqueId",
"adSystem",
"adContent",
"trackingEvents",
"vastDuration",
"transcodedAdDuration"
],
"additionalProperties": false,
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adSystem": { "$ref": "#/definitions/adSystem" },
"adContent": { "$ref": "#/definitions/adContent" },
"trackingEvents": { "$ref": "#/definitions/trackingEvents" },
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
}
}
},
"numAds": {
"$id": "#/properties/avail/numAds",
"type": "number",
"description": "The number of ads that MediaTailor inserted into the avail."
},
"slateAd": {
"$id": "#/properties/avail/slateAd",
"type": ["object", "null"],
"title": "slateAd",
"description": "Information about the slate ad, which MediaTailor uses to fill any unfilled segments in the avail.",
"additionalProperties": false,
"required": [
"uri",
"creativeUniqueId",
"adContent",
"transcodedAdDuration"
],
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adContent": { "$ref": "#/definitions/adContent" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
}
},
"availId": {
"$id": "#/properties/avail/availId",
"type": "string",
"description": "The unique identifier for this avail. For HLS, this is the media sequence number where the avail begins. For DASH, this is the period ID."
},
"skippedAds": {
"$id": "#/properties/avail/skippedAds",
"type": "array",
"description": "The ads that MediaTailor didn't insert, for reasons like TRANSCODE_IN_PROGRESS and TRANSCODE_ERROR.",
"items": {
"type": "object",
"title": "skippedAd",
"description": "Information about a single skipped ad.",
"required": [
"creativeUniqueId",
"adMezzanineUrl",
"skippedReason",
"vastDuration"
],
"additionalProperties": false,
"properties": {
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"adMezzanineUrl": {
"type": "string",
"description": "The mezzanine URL of the skipped ad."
},
"skippedReason": {
"type": "string",
"description": "The code that indicates why the ad wasn't inserted. Example: TRANSCODE_IN_PROGRESS."
},
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
"targetVariant": {
"type": "object",
"title": "targetVariant",
"description": "The target variant of the source content. This key is present when an ad wasn't inserted due to the source content containing a variant that could not match to any variants present in this ad.",
"required": [
"mediaProtocol",
"mediaType",
"bitrate",
"mediaResolution",
"codecs"
],
"additionalProperties": false,
"properties": {
"mediaProtocol": {
"type": "string",
"description": "The media protocol of this variant, such as HLS.",
"enum": [
"HLS",
"DASH"
]
},
"mediaType": {
"type": "array",
"description": "The media type of this variant, such as VIDEO.",
"items": {
"type": "string",
"enum": [
"VIDEO",
"AUDIO",
"SUBTITLES",
"TRICK_PLAY"
],
"description": "Media type, such as VIDEO."
}
},
"bitrate": {
"$ref": "#/definitions/bitrate"
},
"mediaResolution": {
"type": "object",
"title": "mediaResolution",
"description": "The media resolution of this variant.",
"required": [
"width",
"height"
],
"additionalProperties": false,
"properties": {
"width": {
"$ref": "#/definitions/width"
},
"height": {
"$ref": "#/definitions/height"
}
}
},
"codecs": {
"type": "array",
"description": "The codecs of this variant.",
"items": {
"type": "string",
"description": "Codec, such as avc1."
}
}
}
}
}
}
},
"adBreakTrackingEvents": {
"$id": "#properties/avail/adBreakTrackingEvents",
"type": "object",
"title": "adBreakTrackingEvents",
"description": "VMAP/ad break tracking events and corresponding URL",
"properties": {
"items": {
"$ref": "#/definitions/adBreakTrackingEvents"
}
}
}
}
},
"vastResponse": {
"$id": "#/properties/vastResponse",
"type": "object",
"title": "vastResponse",
"description": "Information about the VAST response that MediaTailor received from the ADS.",
"required": [
"version",
"vastAds",
"errors",
"nonLinearAdsList"
],
"additionalProperties": false,
"properties": {
"version": {
"$id": "#/properties/vastResponse/version",
"type": "string",
"description": "The VAST specification version, parsed from the version attribute of the VAST tag in the response.",
"examples": [
"3.0"
],
"pattern": "^(.*)$"
},
"vastAds": {
"$id": "#/properties/vastResponse/vastAds",
"type": "array",
"description": "The ads parsed from the VAST response.",
"items": {
"$ref": "#/definitions/vastAd"
}
},
"errors": {
"$id": "#/properties/vastResponse/errors",
"type": "array",
"description": "The error URLs parsed from the Error tags in the VAST response.",
"items": {
"type": "string",
"description": "A single error URL."
}
},
"nonLinearAdsList": {
"$id": "#/properties/vastResponse/nonLinearAds",
"type": "array",
"description": "A list of NonLinearAds as they are read from the VAST response.",
"items": {
"$ref": "#/definitions/nonLinearAds"
}
}
}
},
"vastAd": {
"$ref": "#/definitions/vastAd"
},
"vodVastResponseTimeOffset": {
"$id": "#/properties/vodVastResponseTimeOffset",
"type": "number",
"description": "The VMAP specific time offset for VOD ad insertion.",
"examples": [
5.0
]
},
"vodCreativeOffsets": {
"$id": "#/properties/vodCreativeOffsets",
"type": "object",
"title": "vodCreativeOffsets",
"description": "A map that indicates the time offsets in the manifest where MediaTailor will insert avails, based on the VMAP response.",
"additionalProperties": {
"type": "array",
"$id": "#/properties/vodCreativeOffsets/entry",
"description": "A mapping from a time offset in the manifest to a list of ads to insert at this time.",
"items": {
"type": "object",
"$id": "#/properties/vodCreativeOffsets/entry/items",
"title": "vodCreativeOffset",
"description": "The list of ads to insert at the specified time offset.",
"additionalProperties": false,
"required": [
"uri",
"creativeUniqueId",
"vastDuration",
"transcodedAdDuration",
"adContent",
"trackingEvents"
],
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
"vastDuration": { "$ref": "#/definitions/vastDuration" },
"transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
"adContent": { "$ref": "#/definitions/adContent" },
"trackingEvents": { "$ref": "#/definitions/trackingEvents" }
}
}
}
},
"adsRequestUrl": {
"$id": "#/properties/adsRequestUrl",
"type": "string",
"description": "The full URL of the ADS request made by MediaTailor."
},
"adMarkers": {
"$id": "#/properties/adMarkers",
"type": "string",
"description": "Found Ad Marker in the Manifest."
},
"segmentationUpid": {
"$id": "#/properties/segmentationUpid",
"type": "string",
"description": "Value of segmentation upid parsed from ad markers in manifest."
},
"segmentationTypeId": {
"$id": "#/properties/segmentationTypeId",
"type": "integer",
"description": "Value of segmentation typeId parsed from ad markers in manifest."
},
"requestHeaders": {
"$id": "#/properties/requestHeaders",
"type": "array",
"description": "The headers that MediaTailor included with the ADS request. Typically, the logs include these when a request to the ADS fails, to help with troubleshooting.",
"items": {
"type": "object",
"title": "requestheaders",
"description": "The name and value for a single header included in the ADS request.",
"required": [
"name",
"value"
],
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"description": "The name of the header."
},
"value": {
"type": "string",
"description": "The value of the header."
}
}
}
},
"originalTargetUrl": {
"$id": "#/properties/originalTargetUrl",
"type": "string",
"description": "The old URL to which MediaTailor was going to make a request."
},
"prefetchScheduleName": {
"$id": "#/properties/prefetchScheduleName",
"type": "string",
"description": "The name of the prefetch schedule associated with this ad event.",
"examples": [
"PrefetchScheduleName"
],
"pattern": "^(.*)$"
},
"updatedTargetUrl": {
"$id": "#/properties/updatedTargetUrl",
"type": "string",
"description": "The new URL to which MediaTailor is making a request."
},
"rawAdsResponse": {
"$id": "#/properties/rawAdsResponse",
"type": "string",
"description": "Paginated ADS response as it's exactly returned to MediaTailor."
},
"rawAdsResponseIndex": {
"$id": "#/properties/rawAdsResponseIndex",
"type": "integer",
"description": "Integer value denoting this rawAdsResponse's index into the full ADS response. This value is used to order the paginated messages for this ADS response."
}
},
"__COMMENT_oneOf": "The oneOf section defines subtypes for our events. Subtypes can have different rules, including which fields are required. For more information, see https://json-schema.org/understanding-json-schema/reference/combining.html#oneof ",
"oneOf": [
{ "$ref": "#/definitions/eventAdMarkersFound" },
{ "$ref": "#/definitions/eventNonAdMarkerFound" },
{ "$ref": "#/definitions/eventMakingAdsRequest" },
{ "$ref": "#/definitions/eventModifiedTargetUrl" },
{ "$ref": "#/definitions/eventRawAdsResponse" },
{ "$ref": "#/definitions/eventVastResponse" },
{ "$ref": "#/definitions/eventFilledAvail" },
{ "$ref": "#/definitions/eventFilledOverlayAvail" },
{ "$ref": "#/definitions/eventErrorFiringBeaconFailed" },
{ "$ref": "#/definitions/eventWarningNoAdvertisements" },
{ "$ref": "#/definitions/eventUnknownHost" },
{ "$ref": "#/definitions/eventErrorAdsTimeout" },
{ "$ref": "#/definitions/eventErrorVastMissingOverlays" },
{ "$ref": "#/definitions/eventPlannedAvail" },
{ "$ref": "#/definitions/eventEmptyVastResponse" },
{ "$ref": "#/definitions/eventEmptyVmapResponse" },
{ "$ref": "#/definitions/eventErrorUnknown" },
{ "$ref": "#/definitions/eventVastRedirect" },
{ "$ref": "#/definitions/eventRedirectedVastResponse" },
{ "$ref": "#/definitions/eventErrorAdsMissingImpression" },
{ "$ref": "#/definitions/eventErrorAdsResponseParse" },
{ "$ref": "#/definitions/eventErrorAdsInvalidResponse" },
{ "$ref": "#/definitions/eventErrorDisallowedHost"},
{ "$ref": "#/definitions/eventPersonalizationDisabled"},
{ "$ref": "#/definitions/eventWarningDynamicVariableSubFailed"},
{ "$ref": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset" },
{ "$ref": "#/definitions/eventVodTimeBasedAvailPlanSuccess" }
],
"definitions": {
"eventAdMarkersFound": {
"$id": "#/definitions/eventAdMarkersFound",
"required": [
"eventType",
"adMarkers"
],
"properties": {
"eventType": {
"type": "string",
"const": "AD_MARKER_FOUND"
}
}
},
"eventNonAdMarkerFound": {
"$id": "#/definitions/eventNonAdMarkerFound",
"required": [
"eventType",
"adMarkers"
],
"properties": {
"eventType": {
"type": "string",
"const": "NON_AD_MARKER_FOUND"
}
}
},
"eventMakingAdsRequest": {
"$id": "#/definitions/eventMakingAdsRequest",
"required": [
"eventType",
"adsRequestUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "MAKING_ADS_REQUEST"
}
}
},
"eventModifiedTargetUrl": {
"$id": "#/definitions/eventModifiedTargetUrl",
"required": [
"eventType",
"originalTargetUrl",
"updatedTargetUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "MODIFIED_TARGET_URL"
}
}
},
"eventRawAdsResponse": {
"$id": "#/definitions/eventRawAdsResponse",
"required": [
"eventType",
"rawAdsResponse",
"rawAdsResponseIndex"
],
"properties": {
"eventType": {
"type": "string",
"const": "RAW_ADS_RESPONSE"
}
}
},
"eventVastResponse": {
"$id": "#/definitions/eventVastResponse",
"_comment": "NOTE: the vastResponse property should ideally be marked as a required field for this event, but unfortunately, in the case of an empty vast response, we currently emit an EMPTY_VAST_RESPONSE followed by a VAST_RESPONSE, and the vastResponse property is not present in the latter. We need to fix this so that we don't emit both of those events in the empty response case, and update this schema to flag vastResponse as required for VAST_RESPONSE.",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "VAST_RESPONSE"
}
}
},
"eventFilledAvail": {
"$id": "#/definitions/eventFilledAvail",
"required": [
"eventType",
"avail"
],
"properties": {
"eventType": {
"type": "string",
"const": "FILLED_AVAIL"
}
}
},
"eventFilledOverlayAvail": {
"$id": "#/definitions/eventFilledOverlayAvail",
"required": [
"eventType",
"avail"
],
"properties": {
"eventType": {
"type": "string",
"const": "FILLED_OVERLAY_AVAIL"
}
}
},
"eventErrorVastMissingOverlays": {
"$id": "#/definitions/eventErrorVastMissingOverlays",
"required": [
"eventType",
"adsRequestUrl",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_VAST_MISSING_OVERLAYS"
}
}
},
"eventErrorFiringBeaconFailed": {
"$id": "#/definitions/eventErrorFiringBeaconFailed",
"required": [
"eventType",
"error",
"beaconInfo"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_FIRING_BEACON_FAILED"
}
}
},
"eventWarningNoAdvertisements": {
"$id": "#/definitions/eventWarningNoAdvertisements",
"required": [
"eventType"
],
"_comment": "We should really have a more descriptive error field for these events",
"properties": {
"eventType": {
"type": "string",
"const": "WARNING_NO_ADVERTISEMENTS"
}
}
},
"eventUnknownHost": {
"$id": "#/definitions/eventUnknownHost",
"required": [
"eventType",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_UNKNOWN_HOST"
}
}
},
"eventErrorAdsTimeout": {
"$id": "#/definitions/eventErrorAdsTimeout",
"required": [
"eventType",
"adsRequestUrl",
"requestHeaders"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_TIMEOUT"
}
}
},
"eventPlannedAvail": {
"$id": "#/definitions/eventPlannedAvail",
"required": [
"eventType"
],
"_comment": "TODO: Flesh this out as we implement it",
"properties": {
"eventType": {
"type": "string",
"const": "PLANNED_AVAIL"
}
}
},
"eventEmptyVastResponse": {
"$id": "#/definitions/eventEmptyVastResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "EMPTY_VAST_RESPONSE"
}
}
},
"eventEmptyVmapResponse": {
"$id": "#/definitions/eventEmptyVmapResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "EMPTY_VMAP_RESPONSE"
}
}
},
"eventErrorUnknown": {
"$id": "#/definitions/eventErrorUnknown",
"required": [
"eventType"
],
"_comment": "TODO: we should have a field for the exception message or something",
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_UNKNOWN"
}
}
},
"eventVastRedirect": {
"$id": "#/definitions/eventVastRedirect",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "VAST_REDIRECT"
}
}
},
"eventRedirectedVastResponse": {
"$id": "#/definitions/eventRedirectedVastResponse",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "REDIRECTED_VAST_RESPONSE"
}
},
"_comment": "NOTE that the property vastResponse is not required because empty vast responses do not contain a vastResponse."
},
"eventErrorAdsResponseParse": {
"$id": "#/definitions/eventErrorAdsResponseParse",
"required": [
"eventType"
],
"_comment": "We should have a field with an error message here",
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_RESPONSE_PARSE"
}
}
},
"eventErrorAdsInvalidResponse": {
"$id": "#/definitions/eventErrorAdsInvalidResponse",
"required": [
"eventType",
"additionalInfo"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_ADS_INVALID_RESPONSE"
}
}
},
"eventErrorAdsMissingImpression": {
"$id": "#/definitions/eventErrorAdsMissingImpression",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_VAST_MISSING_IMPRESSION"
}
}
},
"eventErrorDisallowedHost": {
"$id": "#/definitions/eventErrorDisallowedHost",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_DISALLOWED_HOST"
}
}
},
"eventPersonalizationDisabled": {
"$id": "#/definitions/eventPersonalizationDisabled",
"required": [
"eventType"
],
"properties": {
"eventType": {
"type": "string",
"const": "ERROR_PERSONALIZATION_DISABLED"
}
}
},
"eventWarningDynamicVariableSubFailed": {
"$id": "#/definitions/eventWarningDynamicVariableSubFailed",
"required": [
"eventType",
"adsRequestUrl"
],
"properties": {
"eventType": {
"type": "string",
"const": "WARNING_URL_VARIABLE_SUBSTITUTION_FAILED"
}
}
},
"eventVodTimeBasedAvailPlanVastResponseForOffset": {
"$id": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset",
"required": [
"eventType",
"vastResponse"
],
"properties": {
"eventType": {
"type": "string",
"const": "VOD_TIME_BASED_AVAIL_PLAN_VAST_RESPONSE_FOR_OFFSET"
}
}
},
"eventVodTimeBasedAvailPlanSuccess": {
"$id": "#/definitions/eventVodTimeBasedAvailPlanSuccess",
"required": [
"eventType",
"vodCreativeOffsets"
],
"properties": {
"eventType": {
"type": "string",
"const": "VOD_TIME_BASED_AVAIL_PLAN_SUCCESS"
}
}
},
"creativeUniqueId": {
"type": "string",
"description": "The unique identifier for the ad, used as a key for transcoding. This is the ID field for the creative in the VAST response, if available. Otherwise, it's the mezzanine URL of the ad. "
},
"adSystem": {
"type": "string",
"description": "The value of the AdSystem tag in the VAST response. "
},
"vastDuration": {
"type": "number",
"description": "The duration of the ad, as parsed from the VAST response."
},
"transcodedAdDuration": {
"type": "number",
"description": "The duration of the ad, calculated from the transcoded asset."
},
"adContent": {
"$id": "#/properties/adContent",
"type": ["object", "null"],
"title": "adContent",
"description": "Information about the content of the inserted ad.",
"additionalProperties": false,
"properties": {
"adPlaylistUris": {
"$id": "#/properties/adContent/adPlaylistUris",
"type": "object",
"title": "adPlaylistUris",
"description": "The mapping from the origin manifest for a variant to the ad manifest for the variant. For DASH, this contains a single entry, because all variants are represented in a single DASH manifest. ",
"additionalProperties": {
"$id": "#/properties/adContent/adPlaylistUris/adPlaylistUri",
"type": "string",
"description": "The URL of the ad manifest for the specific variant."
}
}
}
},
"adMezzanineUri": {
"type": "string",
"description": "The URL of the mezzanine version of the ad, which is the input to the transcoder."
},
"bitrate": {
"type": "integer",
"examples": [
533
],
"description": "The bitrate."
},
"width": {
"type": "integer",
"examples": [
1280
],
"description": "Width in pixels."
},
"height": {
"type": "integer",
"examples": [
720
],
"description": "Height in pixels."
},
"trackingEvents": {
"type": "object",
"title": "trackingEvents",
"description": "The tracking beacon URLs for the various tracking events for the ad. The keys are the event names, and the values are a list of beacon URLs.",
"additionalProperties": {
"type": "array",
"description": "The list of beacon URLs for the specified tracking event (impression, complete, and so on)",
"items": {
"type": "string",
"description": "The beacon URLs for this tracking event."
}
}
},
"nonLinearAds": {
"$id": "#/properties/nonLinearAds",
"type": "object",
"title": "nonLinearAds",
"description": "A NonLinearAds as it appears in the VAST response.",
"required": [
"nonLinearAdList",
"nonLinearTrackingEvents"
],
"properties": {
"nonLinearAdList": {
"type": "array",
"description": "List of non linear ads as they exist within one NonLinearAds.",
"items": {
"type": "object",
"title": "nonLinearAdList",
"description": "List of NonLinearAd as they are parsed from its parent NonLinearAds.",
"properties": {
"nonLinearAdId": {
"type": "string",
"description": "Ad ID of this non linear ad."
},
"nonLinearAdSystem": {
"type": "string",
"description": "Ad system of this non linear ad's parent Inline ad."
},
"nonLinearAdTitle": {
"type": "string",
"description": "Ad title of this non linear ad's parent Inline ad."
},
"nonLinearCreativeId": {
"type": "string",
"description": "Creative ID of this non linear ad's parent Creative ad."
},
"nonLinearCreativeAdId": {
"type": "string",
"description": "Creative ad ID of this non linear ad."
},
"nonLinearCreativeSequence": {
"type": "string",
"description": "Creative sequence of this non linear ad."
},
"nonLinearWidth": {
"type": "string",
"description": "Width of this non linear ad."
},
"nonLinearHeight": {
"type": "string",
"description": "Height of this non linear ad."
},
"nonLinearExpandedWidth": {
"type": "string",
"description": "Expanded width of this non linear ad."
},
"nonLinearExpandedHeight": {
"type": "string",
"description": "Expanded height of this non linear ad."
},
"nonLinearScalable": {
"type": "boolean",
"description": "Boolean denoting if this non linear ad is scalable."
},
"nonLinearMaintainAspectRatio": {
"type": "boolean",
"description": "Boolean denoting if aspect ratio should be maintained for this non linear ad."
},
"nonLinearMinSuggestedDuration": {
"type": "string",
"description": "Min suggested duration for this non linear ad."
},
"nonLinearApiFramework": {
"type": "string",
"description": "API framework for this non linear ad's parent Inline ad."
},
"nonLinearStaticResource": {
"type": "string",
"description": "Static resource for this non linear ad."
},
"nonLinearStaticResourceCreativeType": {
"type": "string",
"description": "Static Resource creative type for this non linear ad."
},
"nonLinearIFrameResource": {
"type": "string",
"description": "I-Frame resource for this non linear ad."
},
"nonLinearHtmlResource": {
"type": "string",
"description": "HTML resource for this non linear ad."
},
"nonLinearAdParameters": {
"type": "string",
"description": "Ad parameters for this non linear ad."
},
"nonLinearClickThrough": {
"type": "string",
"description": "Click Through data for this non linear ad."
},
"nonLinearClickTracking": {
"type": "string",
"description": "Click Tracking data for this non linear ad."
},
"nonLinearClickTrackingId": {
"type": "string",
"description": "Click Tracking ID for this non linear ad."
}
}
}
},
"nonLinearTrackingEvents": { "$ref": "#/definitions/trackingEvents" },
"extensions": {
"$id": "#/properties/nonLinearAds/extensions",
"type": "array",
"description": "Extensions that exist for this NonLinearAds.",
"items": {
"$id": "#/properties/nonLinearAds/extensions/items",
"type": "object",
"title": "Extensions",
"description": "Extensions found in non linear ads",
"additionalProperties": false,
"properties": {
"extensionType": {
"$id": "#/properties/nonLinearAds/extensions/extensionType",
"type": "string",
"description": "The value of the extension type attribute of the Extensions tag.",
"examples": [
"FreeWheel"
]
},
"extensionContent": {
"$id": "#/properties/nonLinearAds/extensions/extensionContent",
"type": "string",
"description": "The extension content attribute of the Extensions tag.",
"examples": [
"progressive"
]
}
}
}
}
}
},
"adBreakTrackingEvents": {
"$id": "#/properites/adBreakTrackingEvents",
"type": "object",
"title": "adBreakTrackingEvents",
"description": "These are all VMAP ad break tracking events.",
"additionalProperties": {
"type": "array",
"description": "VMAP/ad break tracking events and corresponding URL",
"items": {
"type": "string",
"description": "The beacon URLs for this tracking event."
}
}
},
"vastAd": {
"$id": "#/properties/vastAd",
"type": "object",
"title": "vastAd",
"description": "Information about a single ad parsed from the VAST response.",
"required": [
"vastAdId",
"adSystem",
"adTitle",
"creativeId",
"creativeAdId",
"duration",
"vastMediaFiles",
"trackingEvents"
],
"additionalProperties": false,
"properties": {
"vastAdId": {
"$id": "#/properties/vastAd/vastAdId",
"type": "string",
"description": "The value of the id attribute of the Ad tag in the VAST response",
"examples": [
"ad1"
]
},
"adSystem": {"$ref": "#/definitions/adSystem" } ,
"adTitle": {
"$id": "#/properties/vastAd/adTitle",
"type": "string",
"description": "The media files that are available for the ad in the VAST response.",
"examples": [
"External NCA1C1L1 LinearInlineSkippable"
]
},
"creativeId": {
"$id": "#/properties/vastAd/creativeId",
"type": "string",
"description": "The value of the id attribute of the Creative tag in the VAST response.",
"examples": [
"creative1"
]
},
"creativeAdId": {
"$id": "#/properties/vastAd/creativeAdId",
"type": "string",
"description": "The value of the adId attribute of the Creative tag in the VAST response."
},
"duration": {
"$id": "#/properties/vastAd/duration",
"type": "number",
"description": "The approximate duration of the ad, based on the duration tag in the linear element of the VAST response.",
"examples": [
30,
30.0
]
},
"vastMediaFiles": {
"$id": "#/properties/vastAd/vastMediaFiles",
"type": "array",
"description": "The list of available media files for the ad in the VAST response.",
"items": {
"$id": "#/properties/vastAd/vastMediaFiles/items",
"type": "object",
"title": "vastMediaFile",
"description": "Information about a media file for the ad.",
"required": [
"uri",
"id",
"delivery",
"type",
"apiFramework",
"width",
"height",
"bitrate"
],
"additionalProperties": false,
"properties": {
"uri": { "$ref": "#/definitions/adMezzanineUri" },
"id": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/id",
"type": "string",
"description": "The value of the id attribute of the MediaFile tag.",
"examples": [
"GDFP"
]
},
"delivery": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/delivery",
"type": "string",
"description": "The protocol used for the media file, set to either progressive or streaming.",
"examples": [
"progressive"
]
},
"type": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/type",
"type": "string",
"description": "The MIME type of the media file, taken from the type attribute of the MediaFile tag.",
"examples": [
"video/mp4"
]
},
"apiFramework": {
"$id": "#/properties/vastAd/vastMediaFiles/items/properties/apiFramework",
"type": "string",
"description": "The API framework needed to manage the media file. Example: VPAID."
},
"width": {
"$ref": "#/definitions/width"
},
"height": {
"$ref": "#/definitions/height"
},
"bitrate": {
"$ref": "#/definitions/bitrate"
}
}
}
},
"trackingEvents": { "$ref": "#/definitions/trackingEvents" },
"vastAdTagUri": {
"$id": "#/properties/vastAd/vastAdTagUri",
"type": "string",
"description": "The VMAP-specific redirect URI for an ad.",
"examples": [
"https://ads.redirect.com/redirect1"
]
}
}
}
}
}
```
# AWS Elemental MediaTailor i registri manifest, la descrizione e i tipi di eventi.
Le sezioni seguenti descrivono i log che vengono MediaTailor emessi per descrivere gli eventi con il server di origine durante la richiesta e la ricezione di un manifesto. Questi sono registri. `ManifestService`
**Topics**
+ [
## Eventi ManifestService
](#log-types-origininteraction)
+ [
## Proprietà dei registri del manifesto
](#manifest-logs-main)
## Eventi ManifestService
I seguenti eventi vengono emessi durante MediaTailor le interazioni con l'origine.
| Log | Description |
| --- | --- |
| CONFIG\$1SECURITY\$1ERROR | La MediaTailor configurazione presenta un problema di sicurezza. |
| CONFIG\$1SYNTAX\$1ERROR | L'origine e il percorso della risorsa generano un URL non valido. |
| CONNECTION\$1ERROR | La MediaTailor connessione all'origine è stata rifiutata o non riuscita. |
| GENERATED\$1MANIFEST | MediaTailor ha generato un manifesto. È necessario che la modalità di debug sia abilitata per ricevere questi registri. Per informazioni sulla modalità di registro di debug, incluso come abilitarla, vedere. [Generazione di registri di debug](debug-log-mode.md) |
| HOST\$1DISALLOWED | MediaTailor non consente richieste HTTP a questo host. |
| INCOMPATIBLE\$1HLS\$1VERSION | Il manifesto utilizza una versione HLS incompatibile. MediaTailor richiede la versione 3 o successiva. |
| INVALID\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Il manifesto DASH a periodo singolo non è valido. MediaTailor sta passando attraverso un manifesto DASH a periodo singolo. |
| IO\$1ERROR | MediaTailor ha rilevato un errore di I/O durante la comunicazione con l'origine. |
| LAST\$1PERIOD\$1MISSING\$1AUDIO | Nell'ultimo periodo del manifesto DASH manca tutto l'audio a AdaptationSets causa del disallineamento dell'audio o del video di origine. Per evitare problemi di riproduzione, rimanda la pubblicazione dell'ultimo periodo almeno alla richiesta successiva. |
| LAST\$1PERIOD\$1MISSING\$1AUDIO\$1WARNING | Nell'ultimo periodo del manifesto DASH manca tutto l'audio a AdaptationSets causa del disallineamento dell'audio o del video di origine. Scelta di pubblicare (non ritardare) l'ultimo periodo. L'audio mancante potrebbe causare problemi di riproduzione. |
| MANIFEST\$1ERROR | La richiesta del MediaTailor manifesto non è riuscita. |
| NO\$1MASTER\$1OR\$1MEDIA\$1PLAYLIST | La risposta di origine non contiene una playlist principale o una playlist multimediale. |
| NO\$1MASTER\$1PLAYLIST | La risposta di origine non contiene la playlist principale prevista. |
| NO\$1MEDIA\$1PLAYLIST | La risposta di origine non contiene la playlist multimediale prevista. |
| ORIGIN\$1MANIFEST | MediaTailor ha recuperato un manifesto di origine. È necessario che la modalità di debug sia abilitata per ricevere questi registri. Per informazioni sulla modalità di registro di debug, incluso come abilitarla, vedere. [Generazione di registri di debug](debug-log-mode.md) |
| PARSING\$1ERROR | L'origine non è in grado di analizzare la richiesta del manifesto. |
| SCTE35\$1PARSING\$1ERROR | MediaTailor non è in grado di analizzare l'Signal Binaryelemento nel manifesto. |
| SESSION\$1INITIALIZED | È stata inizializzata una sessione. È necessario che la modalità di debug sia abilitata per ricevere questi registri. Per informazioni sulla modalità di registro di debug, incluso come abilitarla, vedere. [Generazione di registri di debug](debug-log-mode.md) |
| TIMEOUT\$1ERROR | La richiesta del MediaTailor manifesto è scaduta. |
| TRACKING\$1RESPONSE | MediaTailor ha fornito una risposta di tracciamento. È necessario che la modalità di debug sia abilitata per ricevere questi registri. Per informazioni sulla modalità di registro di debug, incluso come abilitarla, vedere. [Generazione di registri di debug](debug-log-mode.md) |
| UNKNOWN\$1ERROR | MediaTailor ha riscontrato un errore sconosciuto. |
| UNKNOWN\$1HOST | L'host è sconosciuto. |
| UNSUPPORTED\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Il manifesto DASH a periodo singolo non è supportato. MediaTailor sta passando attraverso un manifesto DASH a periodo singolo. |
## Proprietà dei registri del manifesto
Questa sezione descrive le proprietà dei registri del manifesto.
| Proprietà | Tipo | Richiesto |
| --- | --- | --- |
| awsAccountId | stringa | true |
| eventTimestamp | stringa | true |
| originId | stringa | true |
| customerId | stringa | false |
| eventType | stringa | false |
| sessionId | stringa | false |
| originRequestUrl | stringa | false |
| mediaTailorPath | stringa | false |
| requestId | stringa | false |
| responseBody | stringa | false |
| sessionType | string (valori ammessi: [DASH, HLS]) | false |
| requestNextToken | stringa | false |
| eventDescription | stringa | false |
| assetPath | stringa | false |
| originFullUrl | stringa | false |
| originPrefixUrl | stringa | false |
| additionalInfo | stringa | false |
| cause | stringa | false |
| response | stringa | false |
| httpCode | stringa | false |
| errorMessage | stringa | false |
| adAdsResponse | stringa | false |
| adAdsRawResponse | stringa | false |
| adAdsRequest | stringa | false |
| adNumNewAvails | stringa | false |
| generatedMediaPlaylist | stringa | false |
| requestStartTime | stringa | false |
| requestEndTime | stringa | false |
| requestStartTimeEpochMillis | stringa | false |
| requestEndTimeEpochMillis | stringa | false |
# AWS Elemental MediaTailor transcode, log, descrizione e tipi di eventi.
Le sezioni seguenti descrivono i log che MediaTailor vengono generati per descrivere gli eventi con il servizio di transcode durante la preparazione delle creatività per l'ad stitching. Si tratta di log. `TranscodeService`
**Topics**
+ [
## Eventi TranscodeService
](#log-types-tminteraction)
+ [
## Transcodifica le proprietà dei registri
](#transcode-logs-main)
## Eventi TranscodeService
I seguenti eventi vengono emessi durante le MediaTailor interazioni durante la transcodifica degli annunci.
| Log | Description |
| --- | --- |
| IMPORT\$1ERROR | MediaTailor ha riscontrato un errore interno durante un processo di importazione (per annunci precondizionati). Utilizzo di un set di annunci vuoto. |
| INITIALIZED | MediaTailor ha inizializzato un processo di transcodifica o un processo di importazione (per annunci precondizionati). |
| INTERNAL\$1ERROR | MediaTailor ha riscontrato un errore interno. Utilizzo di un set vuoto di annunci. |
| MISSING\$1VARIANTS | MediaTailor impossibile transcodificare l'annuncio a causa della mancanza di varianti. Utilizzando un set di annunci vuoto. |
| PROFILE\$1NOT\$1FOUND | MediaTailor non è riuscito a transcodificare l'annuncio a causa di un profilo mancante da transcodificare. Utilizzando un set di annunci vuoto. |
| TRANSCODE\$1COMPLETED | La transcodifica video è completa. L'annuncio può essere utilizzato per l'inserimento di annunci. |
| TRANSCODE\$1ERROR | MediaTailor ha riscontrato un errore interno durante un processo di transcodifica. Utilizzo di un set di annunci vuoto. |
| TRANSCODE\$1IN\$1PROGRESS | La transcodifica video è in corso. Il video transcodificato non è pronto. Utilizzo di un set di annunci vuoto. |
## Transcodifica le proprietà dei registri
Questa sezione descrive le proprietà dei registri di transcodifica.
| Proprietà | Tipo | Campo obbligatorio | Descrizione |
| --- | --- | --- | --- |
| awsAccountId | stringa | true | L'ID AWS dell'account per la MediaTailor configurazione utilizzata per la sessione. |
| eventTimestamp | stringa | true | La data e l'ora dell'evento |
| originId | stringa | true | Il nome della configurazione risultante dalla MediaTailor configurazione. Questo è diverso dall'origine dei contenuti video, che fa anche parte della configurazione. |
| eventType | stringa | false | Il codice per l'evento che ha attivato questo messaggio di log. Esempio: TRANSCODE\$1ERROR. |
| eventDescription | stringa | false | Una breve descrizione dell'evento che ha attivato questo messaggio di registro, fornita dal MediaTailor servizio. Per impostazione predefinita, è vuota. |
| sessionId | stringa | false | L'identificatore numerico univoco MediaTailor assegnato alla sessione del giocatore. Tutte le richieste effettuate da un giocatore per una sessione hanno lo stesso ID sessione. Esempio: e039fd39-09f0-46b2-aca9-9871cc116cde. |
| creativeUniqueId | stringa | false | L'identificatore univoco della creatività pubblicitaria che viene transcodificata. |
| profileName | stringa | false | |
| adUri | stringa | false | L'URI per la creatività pubblicitaria. |
| transcodeRequestId | stringa | false | L'identificatore univoco per questa richiesta di transcodifica. |
| cacheStatus | stringa | false | Indica se l'annuncio transcodificato è MediaTailor stato memorizzato nella cache. |
# Utilizzo dei log venduti per inviare i log AWS Elemental MediaTailor
È possibile utilizzare i registri venduti per una maggiore flessibilità e controllo su dove distribuire i registri emessi dalla configurazione di riproduzione. MediaTailor
Con i registri venduti, MediaTailor invia tutte le attività di log associate a una configurazione ad Amazon CloudWatch Logs. CloudWatch Logs invia quindi la percentuale di log specificata alla destinazione prescelta. Le destinazioni supportate sono un gruppo di log Amazon CloudWatch Logs, un bucket Amazon S3 o un flusso Amazon Data Firehose.
Poiché i log venduti sono disponibili a prezzi scontati, è possibile ottenere risparmi sui costi rispetto all'invio dei log direttamente a Logs. CloudWatch [Per informazioni sui prezzi, *consulta Vending Logs* nella scheda **Logs** di Amazon Pricing. CloudWatch ](https://aws.amazon.com/cloudwatch/pricing/)
Per utilizzare i registri venduti, devi fare quanto segue:
1. [Aggiunta di autorizzazioni](#vended-logs-perms).
1. [Creare destinazioni di consegna dei log](#vended-logs-destinations).
1. [Configura la consegna dei log in CloudWatch Logs](#vended-logs-delivery).
1. [Abilita i log venduti MediaTailor](#vended-logs-config).
Per ulteriori informazioni sui log venduti, consulta [Abilitare la registrazione dai AWS servizi nella guida per](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) l'utente di Logs. CloudWatch MediaTailor supporta la versione 2 dei log forniti.
## Passaggio 1: aggiungere le autorizzazioni per la consegna dei log MediaTailor
La persona che sta configurando i registri forniti deve disporre delle autorizzazioni per creare la destinazione di consegna, configurare la consegna dei log e abilitare i registri forniti. MediaTailor Utilizza le seguenti politiche per assicurarti di disporre delle autorizzazioni appropriate per configurare i registri venduti.
**Politiche per i CloudWatch registri e le destinazioni di consegna**
Le seguenti sezioni della *Amazon CloudWatch Logs User Guide* forniscono le politiche che ti consentono di utilizzare i log in CloudWatch Logs e le tue destinazioni di consegna. Se invii log a più sedi, puoi combinare le dichiarazioni politiche in un'unica politica invece di creare più politiche.
+ [Registri inviati a Logs CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs)
+ [Registri inviati ad Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-S3)
+ [Log inviati a Firehose](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-Firehose)
**Politica per la configurazione dalla console**
Se stai configurando la consegna dei log venduti tramite la console anziché tramite l'API oppure AWS CLI, devi disporre delle seguenti autorizzazioni aggiuntive nella tua politica.
**Politica per i log in forniti MediaTailor**
Per creare, visualizzare o modificare la consegna dei log venduti MediaTailor, è necessario disporre delle seguenti autorizzazioni nella politica.
Per informazioni sull'aggiunta di autorizzazioni e sull'utilizzo delle politiche, consulta. [Identity and Access Management per AWS Elemental MediaTailor](security-iam.md)
## Fase 2: Creare destinazioni di consegna per i registri MediaTailor
Crea le risorse a cui verranno inviati i log. Registrare l'ARN della risorsa da utilizzare nella configurazione della consegna del registro in un passaggio successivo.
**CloudWatch Registra la destinazione di consegna del gruppo di log**
Utilizza una delle seguenti opzioni per facilitare la creazione di un gruppo di log.
+ Per la console, consulta [Creare un gruppo di log in CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) nella *Amazon CloudWatch Logs User* Guide.
+ Per l'API, [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)consulta *Amazon CloudWatch Logs API Reference.*
+ Per l' SDKs interfaccia a riga di comando e CLI, consulta [Utilizzo `CreateLogGroup` con un AWS SDK o AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) nella *Amazon CloudWatch Logs* User Guide.
**Destinazione di consegna dei bucket Amazon S3**
Utilizza una delle seguenti opzioni per facilitare la creazione di un bucket.
+ Per la console e la CLI SDKs, consulta [Create a bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella *Amazon Simple Storage Service* User Guide.
+ Per l'API, consulta il *riferimento [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)all'API di Amazon Simple Storage Service*.
**Destinazione di consegna dello stream Firehose**
Per informazioni sulla creazione di uno stream, consulta [Create a Firehose stream da console](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) nella *Amazon Data Firehose* Developer Guide.
## Passaggio 3: abilitare i log forniti per la configurazione di riproduzione MediaTailor
Crea o aggiorna la configurazione di riproduzione che invierà i log alla destinazione di consegna creata nel passaggio precedente. Registrate il nome della configurazione da utilizzare nella configurazione della consegna dei log in un passaggio successivo.
+ **Per abilitare i log forniti tramite la console, utilizzare [Creazione di una configurazione](configurations-create.md) o [Modifica delle impostazioni di configurazione](configurations-edit.md) modificare una configurazione per accedere alle impostazioni di registrazione.** **Per le **strategie di registrazione**, scegli Registri venduti.**
+ Per abilitare i log venduti tramite l'API, è necessario disporre di una configurazione esistente. Utilizzare `ConfigureLogsForPlaybackConfiguration` per aggiungere la strategia di registrazione. `Vended logs`
Se utilizzi la strategia di MediaTailor registrazione precedente che prevede l'invio dei log direttamente a CloudWatch Logs e desideri migrare ai log forniti, consulta. [Migrazione della strategia di registrazione](vended-logs-migrate.md)
**Importante**
Se modifichi la strategia di registro da Legacy CloudWatch a vended logs, MediaTailor apporterà questa modifica non appena salverai gli aggiornamenti. Smetterai di ricevere i log finché non avrai configurato completamente la registrazione venduta.
## Fase 4: Configurare la consegna dei log in Logs CloudWatch
In CloudWatch Logs, è necessario creare tre elementi per rappresentare le parti della consegna dei log. Questi elementi sono descritti in dettaglio [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)nell'*Amazon CloudWatch Logs API Reference*. I passaggi di alto livello per configurare la consegna con l'API CloudWatch Logs sono i seguenti.
**Per configurare la consegna dei log in CloudWatch Logs (API)**
1. Si usa [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)per aggiungere l'origine dei log.
A `DeliverySource` rappresenta la configurazione di riproduzione che genera i registri. È necessario il nome della configurazione di riproduzione per creare il. `DeliverySource`
1. Utilizzare [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)per aggiungere la destinazione in cui verranno scritti i log.
A `DeliveryDestination` rappresenta la destinazione di consegna. È necessario l'ARN del gruppo di log, del bucket o dello stream per creare il. `DeliveryDestination`
1. Utilizzalo [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)se stai distribuendo log tra account.
Se la destinazione di consegna si trova in un account diverso dalla configurazione di riproduzione, è necessario un. `DeliveryDestinationPolicy` Questa politica consente a CloudWatch Logs di inviare i log a. `DeliveryDestination`
1. Utilizzare [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)per collegare il `DeliverySource` a. `DeliveryDestination`
A `Delivery` rappresenta la connessione tra `DeliverySource` e`DeliveryDestination`.
# Migrazione della strategia di AWS Elemental MediaTailor registrazione
Se modifichi la strategia di registrazione da Legacy CloudWatch a vended logs, MediaTailor apporterà questa modifica non appena salverai gli aggiornamenti. Per evitare interruzioni nel flusso di lavoro di registrazione, utilizzate i seguenti passaggi per migrare la strategia di registrazione.
1. Segui i passaggi descritti in [Utilizzo dei registri venduti](vended-logs.md). **Per[Abilita i log venduti MediaTailor](vended-logs.md#vended-logs-config), selezionate *entrambe le* strategie di registrazione (**Vented** logs e Legacy). CloudWatch**
MediaTailor invierà i log sia tramite i registri venduti che direttamente a Logs. CloudWatch
1. Apportate le modifiche necessarie al flusso di lavoro che dipendono dalla strategia di registrazione e dalla destinazione di consegna.
1. Rivisita [Abilita i log venduti MediaTailor](vended-logs.md#vended-logs-config) e rimuovi **Legacy CloudWatch** dalle strategie di **registrazione**.
# 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)
```
# Controllo del volume dei log AWS Elemental MediaTailor
MediaTailor i registri delle sessioni di inserimento degli annunci sono talvolta dettagliati. Per ridurre i costi di registrazione, puoi definire la percentuale di log di sessione MediaTailor da inviare ad Amazon CloudWatch Logs. Ad esempio, se la configurazione di riproduzione prevede 1000 sessioni di inserimento di annunci e imposti un valore percentuale abilitato pari a`60`, MediaTailor invia i log per 600 sessioni a Logs. CloudWatch MediaTailor decide a caso per quale sessione inviare i log. Se si desidera visualizzare i log di una sessione specifica, è possibile utilizzare la modalità di registro di [debug](debug-log-mode.md).
Quando imposti una percentuale di registrazione, crea MediaTailor automaticamente un ruolo collegato al servizio che concede le autorizzazioni necessarie per scrivere i log MediaTailor sul tuo account. CloudWatch Per informazioni sull'utilizzo MediaTailor dei ruoli collegati ai servizi, consulta. [Utilizzo di ruoli collegati ai servizi per MediaTailor](using-service-linked-roles.md)
## Creazione di una configurazione di registro
Per controllare la percentuale di registri di sessione che vengono MediaTailor scritti CloudWatch nei registri, create una configurazione di *registro per la configurazione* di riproduzione. *Quando create una configurazione di registro, specificate un *nome di configurazione di riproduzione* e un valore di percentuale abilitata.*
------
#### [ Console ]
**Per creare una configurazione di registro per una configurazione di riproduzione *esistente***
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 riquadro di **configurazione della riproduzione**, seleziona la configurazione di riproduzione per la quale desideri impostare la configurazione del registro.
1. Scegli **Modifica**.
1. In **Configurazione del registro**, specificate un valore **percentuale abilitato**.
**Per creare una configurazione di registro per una *nuova* configurazione di riproduzione**
+ Segui la procedura riportata in [Configurazione dei log](configurations-create.md#configurations-log-configurations).
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Per creare una configurazione di registro per una configurazione di riproduzione *esistente***
Per creare una configurazione di registro utilizzando AWS CLI, eseguite il comando [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) e specificate 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-playback-configuration \
--percent-enabled 10 \
--playback-configuration-name MyPlaybackConfiguration
```
Questo esempio è formattato per Microsoft Windows e utilizza il carattere di continuazione di riga (^) per migliorare la leggibilità.
```
C:\> aws mediatailor configure-logs-for-playback-configuration ^
--percent-enabled 10 ^
--playback-configuration-name MyPlaybackConfiguration
```
Dove:
+ `percent-enabled`è la percentuale di registri delle sessioni di configurazione di riproduzione inviati a Logs. MediaTailor CloudWatch
+ `playback-configuration-name`è il nome della configurazione di riproduzione per cui impostare le impostazioni di configurazione del registro.
Se eseguirai il comando correttamente, riceverai un output simile al seguente.
```
{
"PercentEnabled": 10,
"PlaybackConfigurationName": "MyPlaybackConfiguration"
}
```
**Per creare una configurazione di registro per una *nuova* configurazione di riproduzione**
+ Utilizzate l'`configure-logs-for-playback-configuration`opzione per il [put-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html)comando.
------
## Disattivazione di una configurazione di registro
*Dopo aver creato una configurazione di registro, non è possibile eliminarla, ma solo disattivarla.* Per disattivare la configurazione del registro, imposta il valore della **percentuale abilitata** su **0** con la console o l' MediaTailor API. Questa operazione disattiva la registrazione di tutte le sessioni per quella configurazione di riproduzione.
Se desideri eliminare il ruolo collegato al servizio MediaTailor utilizzato per le configurazioni di registro nel tuo account, devi prima disattivare tutte le configurazioni di registro. Per informazioni su come eliminare il ruolo collegato al servizio, consulta. [Utilizzo di ruoli collegati ai servizi per MediaTailor](using-service-linked-roles.md)
------
#### [ Console ]
**Per disattivare la configurazione del registro su una configurazione di riproduzione**
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 riquadro di **configurazione della riproduzione**, seleziona la configurazione di riproduzione su cui desideri disattivare la configurazione del registro.
1. Scegli **Modifica**.
1. In **Configurazione del registro**, imposta il valore della **percentuale abilitata** su. `0` Questa operazione disattiva la registrazione di tutte le sessioni per questa configurazione di riproduzione.
1. Seleziona **Salva**.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Per disattivare una configurazione di registro**
+ Imposta il `percent-enabled` valore sull'`0`utilizzo del comando [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html).
------
# Filtraggio di AWS Elemental MediaTailor log ed eventi
I registri emessi da una configurazione di riproduzione 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. Per impostazione predefinita, molti eventi vengono registrati. Per aiutare a controllare il costo dei log in Amazon CloudWatch, puoi specificare i log che MediaTailor vengono emessi.
MediaTailor ti consente di controllare il filtraggio dei log in modo da poter effettuare le seguenti operazioni:
+ Specificate gli eventi di registro che desiderate escludere dai registri
+ Abilita la registrazione delle risposte non elaborate dall'ad decision server (ADS)
Puoi impostare queste preferenze di filtraggio dei registri indipendentemente per ogni sessione di riproduzione o come impostazione predefinita per tutte le sessioni di riproduzione per una configurazione di riproduzione.
+ Per filtrare i log in base alla sessione, includete i parametri di interrogazione nella richiesta di inizializzazione della sessione di riproduzione.
+ Per filtrare i log in base alla configurazione di riproduzione, usa la MediaTailor console o l'API per indicare le tue preferenze nelle impostazioni di configurazione della riproduzione.
Le seguenti sezioni forniscono istruzioni per abilitare il filtraggio dei registri sulle sessioni e sulle configurazioni di riproduzione.
# Filtri di registro per sessione
Per definire un livello personalizzato di dettaglio del registro per ogni sessione, aggiungi i seguenti parametri alla richiesta iniziale di sessione di riproduzione lato server o lato client. Aggiungi valori ai parametri per rappresentare gli eventi che desideri includere o escludere, in un formato delimitato da virgole:
+ `aws.adsInteractionLogPublishOptInEventTypes`per ricevere registri per interazioni specifiche con l'Ad Decision Server (ADS).
+ `aws.adsInteractionLogExcludeEventTypes`per interrompere la ricezione dei log per interazioni ADS specifiche.
+ `aws.manifestServiceLogExcludeEventTypes`per interrompere la ricezione dei log per interazioni specifiche con il servizio manifest.
Per un elenco dei tipi di log ed eventi che vengono MediaTailor emessi, consulta [registri del manifesto](log-types.md)[Registri ADS](ads-log-format.md), e. [Registri di transcodifica](tm-log-format.md)
Se non utilizzi alcun parametro di query per il filtraggio dei log, MediaTailor scrive tutti i log nella destinazione di consegna.
**Example inizializzazione della sessione lato server con filtri di registro**
Per escludere `GENERATED_MANIFEST` `PARSING_ERROR` eventi dai registri del manifesto e `MAKING_ADS_REQUEST` dai registri ADS, la richiesta di inizializzazione della sessione avrebbe il seguente aspetto:
```
GET /v1/master///index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST
```
Per abilitare i log non elaborati del tuo ADS, includi il `RAW_ADS_RESPONSE` valore del parametro: `AdsInteractionPublishOptInEventType`
```
GET /v1/master///index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE
```
**Example 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 client a. MediaTailor Per ulteriori informazioni su come costruire una richiesta di sessione di riproduzione lato client, vedere [Monitoraggio degli annunci lato client](ad-reporting-client-side.md). 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 del tuo ADS, includi il `RAW_ADS_RESPONSE ` valore del parametro: `publishOptInEventTypes`
```
POST parent.m3u8
{
"adsInteractionLog": {
"publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
}
```
# Filtri di registro di configurazione per riproduzione
Utilizzate le impostazioni della configurazione di riproduzione per definire i tipi di eventi di registro che vengono MediaTailor emessi di default da questa configurazione di riproduzione. MediaTailor utilizza queste impostazioni di filtraggio dei log predefinite per tutte le sessioni che non includono i parametri di filtraggio delle interrogazioni sulla richiesta di avvio della sessione.
Puoi scegliere di fare quanto segue:
+ Ricevi registri per interazioni specifiche con l'Ad Decision Server (ADS).
+ Escludi i log per interazioni ADS specifiche.
+ Escludi i log per interazioni specifiche con il servizio manifest.
Per configurare queste impostazioni dalla MediaTailor console, consulta[Creazione di una configurazione](configurations-create.md). Per l' MediaTailor API, [https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html)consulta l'*AWS Elemental MediaTailor API Reference*.
Per un elenco dei tipi di log e di eventi che MediaTailor emette, consulta [registri del manifesto](log-types.md)[Registri ADS](ads-log-format.md), e[Registri di transcodifica](tm-log-format.md).
# Generazione di registri di AWS Elemental MediaTailor debug
Utilizza i log di debug per risolvere i problemi relativi alla sessione di riproduzione di inserzioni MediaTailor pubblicitarie. Per generare registri di debug, imposta la modalità di registro su debug nella richiesta del player. MediaTailor *Per la segnalazione lato server, imposta la modalità di registro nella richiesta di riproduzione.* *Per i report lato client, imposta la modalità di registro nella richiesta di inizializzazione della sessione.*
Quando la modalità di registro è impostata su debug, MediaTailor scrive tutti i tipi di eventi di registro in Logs. CloudWatch I log forniscono informazioni sui seguenti eventi. [Per un elenco completo dei dati prodotti nei log di debug, consultate Debug log fields.](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html#debug-log-mode-fields)
+ **Interazione con l'origine**: dettagli sulle MediaTailor interazioni con il server di origine. Ad esempio, la risposta del manifesto di origine, il tipo di manifesto e l'URL di origine.
+ **Manifesto generato**: dettagli sulla risposta della sessione di riproduzione da MediaTailor. Ad esempio, il manifesto che MediaTailor genera.
+ **Sessione inizializzata**: dettagli di inizializzazione della sessione, come l'ID della sessione.
Per personalizzare i tipi di eventi di registro che ricevi per sessione, consulta. [Filtraggio di registri ed eventi](logs-filter.md)
## Prerequisiti
Per impostare la modalità di registro su debug, devi prima concedere l' MediaTailor autorizzazione a inviare i log CloudWatch, se non l'hai già fatto. Dopo aver concesso l'autorizzazione MediaTailor all'accesso CloudWatch, sei pronto per abilitare la modalità di registro di debug. Per informazioni su come concedere l' MediaTailor autorizzazione all'accesso, CloudWatch consulta [Configurazione delle autorizzazioni per Amazon CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-permissions.html).
## Come impostare la modalità di registro per il debug
Questa sezione spiega come impostare la modalità di registro per il debug per il reporting lato server e il reporting lato client.
### Reportistica lato server
Per i report lato server, includi il parametro e il valore della `?aws.logMode=DEBUG` query nella richiesta di `GET HTTP` riproduzione del lettore all'endpoint HLS o DASH. MediaTailor [Per informazioni generali sulla reportistica lato server, consulta Server-side Reporting.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-server-side.html)
**Importante**
Il valore `DEBUG` prevede la distinzione tra lettere maiuscole e minuscole.
Una richiesta di riproduzione che include `?aws.logMode=DEBUG` è simile alla seguente:
**Example Richiesta di riproduzione su un endpoint HLS**
```
GET /v1/master///?aws.logMode=DEBUG
```
Dopo aver impostato la modalità di registro su debug, si consiglia di verificare che la sessione di registrazione di debug sia attiva. Per verificare che la sessione di debug sia attiva, controlla se ci sono CloudWatch registri per l'ID della sessione. L'ID di sessione è incluso nell'endpoint di riproduzione che lo fornisce. MediaTailor Per ulteriori informazioni, consulta [Verify that the debug log mode is active for your playback session](#debug-active).
### Reportistica lato client
Per i report lato client, includi la `logMode` chiave e il `DEBUG` valore nel corpo della richiesta di inizializzazione della `POST HTTP` sessione del client all'endpoint /v1/session. MediaTailor [Per informazioni generali sui report lato client, consulta Client-Side Reporting.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-client-side.html)
**Importante**
Il valore `DEBUG` prevede la distinzione tra lettere maiuscole e minuscole.
Dopo aver impostato la modalità di registro su debug, si consiglia di verificare che la sessione di debug sia attiva. Per verificare che la sessione di debug sia attiva, verifica che nei registri sia presente un `SESSION_INITIALIZED` evento associato all'ID di sessione. CloudWatch L'ID di sessione è incluso nell'endpoint di riproduzione che fornisce. MediaTailor Per ulteriori informazioni, consulta [Verify that the debug log mode is active for your playback session](#debug-active).
## Numero massimo di sessioni di debug attive
È possibile avere un massimo di 10 sessioni di registro di debug attive. Quando il lettore invia la richiesta di inizializzazione della sessione o di riproduzione a MediaTailor, MediaTailor verifica se il limite è stato raggiunto. In caso affermativo, MediaTailor controlla se ci sono sessioni obsolete. Una sessione è obsoleta se non vi si accede entro un certo periodo di tempo. Per i live streaming questo periodo di tempo è di 10 minuti, per gli stream VOD è di 30 minuti.
Se è stato raggiunto il limite massimo di sessioni di registro di debug attive, i log di debug non vengono scritti nei registri della sessione. CloudWatch Se non vedi i log di debug nei CloudWatch log della tua sessione, potresti aver raggiunto questo limite. Per confermare se il limite è stato raggiunto, consulta. [Verify that the debug log mode is active for your playback session](#debug-active)
## Campi di registro di debug
La tabella seguente elenca i campi del registro di debug in cui è possibile MediaTailor scrivere. CloudWatch
| Campo | Description |
| --- | --- |
| awsAccountId | Il tuo Account AWS ID. |
| customerId | Il tuo ID MediaTailor cliente. |
| eventTimestamp | Il timestamp ISO 8601 associato all'evento del registro di debug. |
| eventType | Il tipo di evento del registro di debug. Valori:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/mediatailor/latest/ug/debug-log-mode.html) |
| originRequestUrl | L'URL del server di origine recuperato per questa richiesta. |
| mediaTailorPath | L' MediaTailor endpoint che è stato chiamato, inclusi tutti i parametri passati MediaTailor nella richiesta manifesta iniziale. |
| requestId | L'ID di una richiesta HTTP specifica a MediaTailor. |
| responseBody | Il manifesto nel corpo della risposta da MediaTailor. Questo è il manifesto di origine non elaborato o il manifesto generato da MediaTailor. |
| sessionId | L'ID della sessione di riproduzione. |
| sessionType | Il tipo di sessione di riproduzione. Valori: `HLS`, `DASH` |
## Leggi i log di debug
MediaTailor scrive i log di debug su Amazon CloudWatch Logs. Si applicano le tariffe tipiche CloudWatch dei log. Usa CloudWatch Insights per leggere i log di debug. Per informazioni su come utilizzare CloudWatch Logs Insights, consulta [Analyzing Log Data with CloudWatch Logs Insights nella * CloudWatch AWS* Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) User Guide.
**Nota**
La visualizzazione dei log di debug può richiedere alcuni minuti. CloudWatch Se non vedi i log, attendi qualche minuto e riprova. Se continui a non visualizzare i log, è possibile che tu abbia raggiunto il numero massimo di sessioni di registro di debug attive. Per verificare se questo è il caso, esegui una CloudWatch query per vedere se è stata inizializzata una sessione di debug per la sessione di riproduzione. Per ulteriori informazioni, consulta [Verify that the debug log mode is active for your playback session](#debug-active).
### Esempi
Questa sezione include interrogazioni di esempio che è possibile utilizzare per leggere MediaTailor i dati del registro di debug.
**Example 1: Verificate che la modalità di registro di debug sia attiva per la sessione di riproduzione**
```
fields @timestamp, @message
| filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
| filter eventType = "SESSION_INITIALIZED" # client-side reporting
or mediaTailorPath like “/v1/master" # server-side reporting HLS
or mediaTailorPath like “/v1/dash" # server-side reporting DASH
```
**Example 2: Visualizza le risposte dalla tua origine**
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
```
**Example 3: Visualizza il manifesto generato da MediaTailor per una determinata sessione**
```
fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
```
**Example 4: Visualizza tutti gli eventi per una determinata `requestId`**
Usa questa query per visualizzare il manifesto di origine e il manifesto generato da MediaTailor.
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
```
# Monitoraggio AWS Elemental MediaTailor con CloudWatch parametri Amazon
Puoi monitorare le AWS Elemental MediaTailor metriche utilizzando. CloudWatch CloudWatch raccoglie dati grezzi sulle prestazioni del servizio e li elabora in metriche leggibili e quasi in tempo reale. Queste statistiche vengono conservate per un periodo di 15 mesi, per permettere l'accesso alle informazioni storiche e offrire una prospettiva migliore sulle prestazioni del servizio o dell'applicazione web. È anche possibile impostare allarmi che controllano determinate soglie e inviare notifiche o intraprendere azioni quando queste soglie vengono raggiunte. Per ulteriori informazioni, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
Le metriche possono essere utili quando analizzi i manifesti obsoleti. Per ulteriori informazioni, consulta [Utilizzo di metriche per diagnosticare manifesti obsoleti](stale-manifest-diagnose.md).
I parametri vengono raggruppati prima in base allo spazio dei nomi del servizio e successivamente in base alle diverse combinazioni di dimensioni all'interno di ogni spazio dei nomi.
**Per visualizzare le metriche 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, seleziona **Parametri**.
1. In **Tutte le metriche**, scegli lo **MediaTailor**spazio dei nomi.
1. Selezionare la dimensione per visualizzare i parametri, ad esempio **originID**.
1. Specificare il periodo da visualizzare.
**Per visualizzare le metriche utilizzando () AWS Command Line Interface AWS CLI**
+ Al prompt dei comandi, utilizza il comando seguente:
```
aws cloudwatch list-metrics --namespace "AWS/MediaTailor"
```
## AWS Elemental MediaTailor CloudWatch metriche
Il AWS Elemental MediaTailor namespace include le seguenti metriche. Questi parametri vengono pubblicati per impostazione predefinita nel tuo account.
### Metriche di Channel Assembly (CA)
Nella tabella seguente, tutte le metriche sono disponibili per canale o per canale di output.
| Metrica | Description |
| --- | --- |
| 4xxErrorCount | Il numero di `4xx` errori. |
| 5xxErrorCount | Il numero di `5xx` errori. |
| RequestCount | Il numero totale di richieste . Il numero di transazioni dipende in gran parte dalla frequenza con cui i giocatori richiedono manifesti aggiornati e dal numero di giocatori. Ogni richiesta di un lettore conta come una transazione. |
| TotalTime | Il tempo impiegato dal server delle applicazioni per elaborare la richiesta, incluso il tempo impiegato per ricevere byte e scrivere byte sul client e sulla rete. |
#### Metriche di inserimento degli annunci sul lato server (SSAI)
La tabella seguente elenca le metriche relative all'inserimento degli annunci sul lato server.
| Metrica | Description |
| --- | --- |
| AdDecisionServer.Ads | Il numero di annunci inclusi nelle risposte dell'Ad Decision Server (ADS) entro il CloudWatch periodo di tempo specificato. |
| AdDecisionServer.Duration | La durata totale, in millisecondi, di tutti gli annunci MediaTailor ricevuti dall'ADS nel periodo di CloudWatch tempo specificato. Questa durata può essere superiore a `Avail.Duration` quella specificata. |
| AdDecisionServer.Errors | Il numero di risposte con codice di stato non HTTP 200, risposte vuote e risposte scadute MediaTailor ricevute da ADS entro il periodo di CloudWatch tempo specificato. |
| AdDecisionServer.FillRate | La media semplice delle frequenze con cui le risposte dell’ADS hanno riempito i singoli spazi pubblicitari corrispondenti per il periodo di tempo specificato. Per ottenere la media ponderata, calcolare `AdDecisionServer.Duration` come percentuale di `Avail.Duration`. Per ulteriori informazioni sulle medie semplici e ponderate, consulta [Medie semplici e ponderate](#metrics-simple-average). |
| AdDecisionServer.Latency | Il tempo di risposta in millisecondi per le richieste effettuate dall'ADS. MediaTailor |
| AdDecisionServer.Timeouts | Il numero di richieste di timeout inviate all'ADS nel periodo di CloudWatch tempo specificato. |
| AdNotReady | Il numero di volte in cui l'ADS ha puntato a un annuncio che non era ancora stato transcodificato dal servizio di transcodifica interno nel periodo di tempo specificato. Un valore elevato per questo parametro può contribuire a un basso valore `Avail.FillRate` complessivo. |
| AdsBilled | Il numero di annunci per i quali vengono MediaTailor fatturate ai clienti in base all'inserimento. |
| Avail.Duration | Il numero totale pianificato di millisecondi di annuncio viene utilizzato entro il periodo di tempo. CloudWatch Il totale pianificato si basa sulla durata di disponibilità dell'annuncio nel manifesto di origine. |
| Avail.FilledDuration | Il numero pianificato di millisecondi di tempo di utilizzo dell'annuncio che MediaTailor verrà riempito con gli annunci entro il periodo di tempo. CloudWatch |
| Avail.FillRate | La media semplice pianificata delle tariffe alle quali MediaTailor verranno pubblicati i singoli annunci è valida entro il periodo di tempo. CloudWatch Per ottenere la media ponderata, calcolare `Avail.FilledDuration` come percentuale di `Avail.Duration`. Per ulteriori informazioni sulle medie semplici e ponderate, consulta [Medie semplici e ponderate](#metrics-simple-average). Il valore massimo di `Avail.FillRate` che MediaTailor può raggiungere è delimitato da `AdDecisionServer.FillRate`. Se `Avail.FillRate` è basso, confrontalo con `AdDecisionServer.FillRate`. Se `AdDecisionServer.FillRate` è basso, è possibile che ADS non stia restituendo un numero sufficiente di annunci per sfruttare la durata dello spazio pubblicitario. |
| Avail.Impression | Il numero di annunci con eventi di tracciamento delle impressioni visualizzati MediaTailor durante il beaconing lato server (non il numero di impressioni). |
| Avail.ObservedDuration | Il numero totale osservato di millisecondi di utilizzo degli annunci che si sono verificati nel periodo di tempo. CloudWatch `Avail.ObservedDuration`viene emesso al termine della pubblicazione dell'annuncio e si basa sulla durata dei segmenti riportati nel manifesto durante la pubblicazione dell'annuncio. |
| Avail.ObservedFilledDuration | Il numero di millisecondi di tempo di fruizione dell'annuncio registrato durante il periodo di tempo in cui sono stati riempiti gli MediaTailor annunci. CloudWatch |
| Avail.ObservedFillRate | Media semplice osservata delle percentuali di fruizione degli annunci individuali MediaTailor compilati nel periodo di tempo. CloudWatch Emesso solo per i manifesti HLS, al primo tag. `CUE-IN` Se non è presente alcun `CUE-IN` tag, MediaTailor non emette questa metrica. |
| Avail.ObservedSlateDuration | Il numero totale osservato di millisecondi di ardesia che è stata inserita nel periodo. CloudWatch |
| GetManifest.Age | L'età totale del manifesto in millisecondi. Misurata da quando l'origine crea il manifesto a quando MediaTailor invia il manifesto personalizzato. Per ulteriori informazioni sulle metriche per la misurazione dell'età del manifesto, consulta[Utilizzo di metriche per diagnosticare manifesti obsoleti](stale-manifest-diagnose.md). |
| GetManifest.Errors | Il numero di errori ricevuti durante MediaTailor la generazione dei manifesti si riferisce al periodo di CloudWatch tempo specificato. |
| GetManifest.Latency | Il tempo di MediaTailor risposta in millisecondi impiegato dalla richiesta per generare manifesti. Per ulteriori informazioni sulle metriche per la misurazione dell'età del manifesto, consulta. [Utilizzo di metriche per diagnosticare manifesti obsoleti](stale-manifest-diagnose.md) |
| GetManifest.MediaTailorAge | La quantità di tempo in cui il manifesto è stato archiviato, MediaTailor in millisecondi. Misurato da quando MediaTailor riceve una risposta di origine a quando MediaTailor invia il manifesto personalizzato. Per ulteriori informazioni sulle metriche per la misurazione dell'età del manifesto, consulta[Utilizzo di metriche per diagnosticare manifesti obsoleti](stale-manifest-diagnose.md). |
| Origin.Age | La quantità di tempo in cui l'origine conserva il manifesto, in millisecondi. Misurato da quando l'origine crea il manifesto a quando MediaTailor invia la richiesta di origine. Tutte le `origin.*` metriche vengono emesse per le richieste soddisfatte direttamente dall'origine. Non vengono emesse per le risposte di origine memorizzate nella cache. Per ulteriori informazioni sulle metriche per la misurazione dell'età manifesta, vedere. [Utilizzo di metriche per diagnosticare manifesti obsoleti](stale-manifest-diagnose.md) |
| Origin.Errors | Il numero di risposte con codice di stato non HTTP 200 e di risposte con timeout MediaTailor ricevute dal server di origine nel periodo di CloudWatch tempo specificato. Tutte le `origin.*` metriche vengono emesse per le richieste soddisfatte direttamente dall'origine. Non vengono emesse per le risposte di origine memorizzate nella cache. |
| Origin.ManifestFileSizeBytes | La dimensione del file del manifesto di origine in byte sia per HLS che per DASH. In genere questa metrica viene utilizzata insieme a. `Origin.ManifestFileSizeTooLarge` Tutte le `origin.*` metriche vengono emesse per le richieste soddisfatte direttamente dall'origine. Non vengono emesse per le risposte di origine memorizzate nella cache. |
| Origin.ManifestFileSizeTooLarge | Il numero di risposte dall'origine che hanno una dimensione del manifesto maggiore della quantità configurata. In genere questa metrica viene utilizzata insieme a. `Origin.ManifestFileSizeBytes` Tutte le `origin.*` metriche vengono emesse per le richieste soddisfatte direttamente dall'origine. Non vengono emesse per le risposte di origine memorizzate nella cache. |
| Origin.Timeouts | Il numero di richieste di timeout al server di origine nel periodo di CloudWatch tempo specificato. Tutte le `origin.*` metriche vengono emesse per le richieste soddisfatte direttamente dall'origine. Non vengono emesse per le risposte di origine memorizzate nella cache. |
| Requests | Il numero di transazioni simultanee al secondo per tutti i tipi di richiesta. Il numero di transazioni dipende principalmente dal numero di giocatori e dalla frequenza con cui i giocatori richiedono manifesti aggiornati. Ogni richiesta di un lettore conta come una transazione. |
| SkippedReason.DurationExceeded | Il numero di annunci che non sono stati inseriti in una pubblicazione perché l'ADS ha restituito una durata degli annunci superiore alla durata di disponibilità specificata. Un valore elevato per questa metrica potrebbe contribuire a una discrepanza tra la metrica e. `Avail.Ads` `AdDecisionServer.Ads` Per ulteriori informazioni sui motivi per cui l'annuncio è stato ignorato, consulta. [Risoluzione dei problemi relativi ai salti degli annunci](troubleshooting-ad-skipping-overview.md) |
| SkippedReason.EarlyCueIn | Il numero di annunci ignorati a causa di un anticipo. `CUE-IN` |
| SkippedReason.ImportError | Il numero di annunci ignorati a causa di un errore nel processo di importazione. |
| SkippedReason.ImportInProgress | Il numero di annunci ignorati a causa di un processo di importazione attivo esistente. |
| SkippedReason.InternalError | Il numero di annunci ignorati a causa di un errore MediaTailor interno. |
| SkippedReason.NewCreative | Il numero di annunci che non sono stati inseriti tra quelli disponibili perché era la prima volta che la risorsa veniva richiesta da un cliente. Un valore elevato per questa metrica potrebbe temporaneamente contribuire a un calo complessivo`Avail.FillRate`, fino a quando le risorse non saranno transcodificate correttamente. |
| SkippedReason.NoVariantMatch | Il numero di annunci è stato ignorato perché non vi è alcuna corrispondenza di variante tra l'annuncio e il contenuto. |
| SkippedReason.PersonalizationThresholdExceeded | La durata degli annunci che supera l'impostazione della **soglia di personalizzazione** in questa configurazione. |
| SkippedReason.ProfileNotFound | Il numero di annunci ignorati perché il profilo di transcodifica non è stato trovato. |
| SkippedReason.TranscodeError | Il numero di annunci ignorati a causa di un errore di transcodifica. |
| SkippedReason.TranscodeInProgress | Il numero di annunci che non sono stati inseriti in una pubblicazione perché l'annuncio non era ancora stato transcodificato. Un valore elevato per questa metrica potrebbe temporaneamente contribuire a un calo complessivo`Avail.FillRate`, fino a quando le risorse non saranno transcodificate correttamente. |
| GetAssets.Requests | Il numero di richieste di Asset List ricevute per le sessioni di HLS Interstitials nel periodo di tempo. CloudWatch Utilizzate questa metrica per monitorare il volume dei processi decisionali e di rilegatura tardiva e comprendere la portata dell'utilizzo di HLS Interstitials. |
| GetAssets.Latency | Il tempo di risposta per le richieste di Asset List in millisecondi per le sessioni HLS Interstitials. Monitora questa metrica per garantire prestazioni decisionali ottimali in materia di annunci e identificare potenziali rallentamenti nel flusso di lavoro con rilegatura tardiva. |
**Nota**
Per le sessioni di HLS Interstitials, alcune metriche si comportano in modo diverso a causa della natura tardiva del processo decisionale relativo agli annunci:
`Avail.ObservedFilledDuration`matches poiché non è possibile osservare l'effettivo comportamento di riproduzione sul lato client. `Avail.FilledDuration` MediaTailor
`Avail.ObservedSlateDuration`riporta la durata pianificata dello slate in base alle risposte dell'Asset List anziché alla riproduzione osservata.
Le metriche con il prefisso «Osservato» forniscono valori stimati per le sessioni di HLS Interstitials.
### Medie semplici e ponderate
Puoi recuperare la media semplice e la media ponderata delle risposte dell'ADS alle richieste di annunci MediaTailor e il modo MediaTailor in cui l'annuncio viene utilizzato:
+ Le *medie semplici* vengono fornite in `AdDecisionServer.FillRate` e `Avail.FillRate`. Si tratta delle medie per le percentuali delle frequenze di riempimento per i singoli spazi pubblicitari in un periodo di tempo specificato. La media semplice non considera le differenze tra le durate dei singoli spazi pubblicitari.
+ Le *medie ponderate* corrispondono alle percentuali delle frequenze di riempimento della somma di tutte le durate dello spazio pubblicitario. Queste vengono calcolate come (`AdDecisionServer.Duration`\$1100)/`Avail.Duration` e (`Avail.FilledDuration`\$1100)/`Avail.Duration`. Queste medie riflettono le differenze in termini di durata per ogni spazio pubblicitario, evidenziando quelli di durata più lunga.
Per un periodo di tempo che contiene un solo spazio pubblicitario, la media semplice fornita da `AdDecisionServer.FillRate` è pari alla media ponderata fornita da (`AdDecisionServer.Duration`\$1100)/`Avail.Duration`. La media semplice fornita da `Avail.FillRate` è pari alla media ponderata fornita da (`Avail.FilledDuration`\$1100)/`Avail.Duration`.
**Esempio**
Supponiamo che il periodo di tempo specificato contenga i due spazi pubblicitari seguenti:
+ Il primo spazio pubblicitario dura 90 secondi:
+ La risposta ADS per lo spazio fornisce 45 secondi di annunci (50% di riempimento).
+ MediaTailor occupa 45 secondi del tempo pubblicitario disponibile (riempito al 50%).
+ Il secondo dura 120 secondi:
+ La risposta ADS per lo spazio fornisce 120 secondi di annunci (100% di riempimento).
+ MediaTailor riempie 90 secondi del tempo disponibile per l'annuncio (riempito al 75%).
I parametri sono i seguenti:
+ `Avail.Duration` è 210, ovvero la somma delle durate dei due spazi pubblicitari: 90\$1120.
+ `AdDecisionServer.Duration` è 165, ovvero la somma delle due durate delle risposte: 45\$1120.
+ `Avail.FilledDuration` è 135, ovvero la somma delle durate riempite: 45\$190.
+ `AdDecisionServer.FillRate` è il 75%, ovvero la media delle percentuali di riempimento per ogni spazio: (50%\$1100%)/2. Questa è la media semplice.
+ La media ponderata per le frequenze di riempimento di ADS è 78,57%, che corrisponde a `AdDecisionServer.Duration` come percentuale di `Avail.Duration`: (165\$1100)/210. Questo calcolo tiene conto delle differenze delle durate.
+ `Avail.FillRate` è il 62.5%, ovvero la media delle percentuali di riempimento per ogni spazio: (50%\$175%)/2. Questa è la media semplice.
+ La media ponderata dei tassi di MediaTailor riempimento disponibili è del 64,29%, ossia la `Avail.FilledDuration` percentuale di`Avail.Duration`: (135\$1100)/210. Questo calcolo tiene conto delle differenze delle durate.
Il massimo `Avail.FillRate` che si MediaTailor può raggiungere per ogni annuncio pubblicitario è del 100%. L’ADS può restituire un tempo per gli annunci maggiore di quello disponibile nello spazio pubblicitario, ma MediaTailor può riempire solo il tempo disponibile.
## AWS Elemental MediaTailor CloudWatch dimensioni
È possibile filtrare i AWS Elemental MediaTailor dati utilizzando la seguente dimensione.
| Dimensione | Description |
| --- | --- |
| `Configuration Name` | Indica la configurazione a cui appartiene il parametro. |
# Utilizzo di metriche per diagnosticare manifesti obsoleti da AWS Elemental MediaTailor
Un manifesto obsoleto è un manifesto che non è stato aggiornato di recente. Flussi di lavoro di inserimento di annunci diversi potrebbero avere una tolleranza diversa rispetto al tempo che deve trascorrere prima che un manifesto venga considerato obsoleto, in base a una serie di fattori (come i requisiti per i sistemi a valle). Puoi utilizzare i CloudWatch parametri di Amazon per identificare i manifesti che superano la tolleranza di inattività per il tuo flusso di lavoro e aiutare a identificare la causa dei ritardi negli aggiornamenti dei manifesti.
Le seguenti metriche aiutano a identificare i manifesti obsoleti e le relative cause.
Per informazioni su tutte le metriche emesse, consulta. MediaTailor [AWS Elemental MediaTailor CloudWatch metriche](monitoring-cloudwatch-metrics.md#metrics)
| Metrica | Definizione | Utilizzo |
| --- | --- | --- |
| GetManifest.Age | Misura l'età totale del manifesto, inclusi entrambi `GetManifest.MediaTailorAge` e `Origin.Age` per questa configurazione. | Puoi utilizzare questa metrica per identificare i manifesti che hanno superato la soglia di aggiornamento e sono obsoleti. Imposta allarmi in base a questa metrica in modo da essere avvisato quando vengono pubblicati manifesti obsoleti. *Per informazioni sugli allarmi, consulta [Alarming on metrics nella](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) Amazon User Guide. CloudWatch * Quando ricevi un allarme, usa `Origin.Age` e `GetManifest.MediaTailorAge` per identificare se MediaTailor o l'origine è la causa dell'allarme. |
| Origin.Age | Misura per quanto tempo l'origine conserva il file manifest prima di inviarlo MediaTailor per questa configurazione.Questa metrica non viene emessa quando la risposta proviene da una rete per la distribuzione di contenuti (CDN). La risposta deve provenire dall'origine per `Origin.Age` essere emessa. | Quando identifichi i manifesti obsoleti con`GetManifest.Age`, puoi analizzare la `Origin.Age` metrica e la `GetManifest.MediaTailorAge` metrica per determinare quale contribuisce alla stagnazione manifesta. Se ritieni che `Origin.Age` i tempi di elaborazione siano più lunghi rispetto ai tempi di elaborazione tipici all'origine, è probabile che il problema sia causato dal sistema a monte e dovresti concentrare la diagnostica su questo punto. |
| GetManifest.MediaTailorAge | Misura per quanto tempo MediaTailor è stato archiviato questo manifesto per questa configurazione. | Quando si identificano i manifesti obsoleti con`GetManifest.Age`, è possibile analizzare la `GetManifest.MediaTailorAge` metrica e la `Origin.Age` metrica per determinare quale fattore contribuisce a tale fenomeno. Se `GetManifest.MediaTailorAge` è più lungo del normale periodo di personalizzazione del manifesto MediaTailor, è probabile che sia questa la causa del problema e dovresti concentrare MediaTailor la diagnostica su questo punto. `GetManifest.Latency`può identificare ulteriormente il tempo necessario per MediaTailor creare un manifesto personalizzato. |
| GetManifest.Latency | Misura il tempo necessario per MediaTailor elaborare la richiesta e creare un manifesto personalizzato per questa configurazione. | Quando si confronta `Origin.Age` `GetManifest.MediaTailorAge` e si determina che questa MediaTailor è la causa del ritardo nella consegna del manifesto, è possibile analizzare la `GetManifest.Latency` metrica per determinare se il processo di personalizzazione del manifesto sta contribuendo all'indisponibilità manifesta. `GetManifest.MediaTailorAge`misura il tempo totale di archiviazione del manifesto. MediaTailor `GetManifest.Latency`misura la quantità di quel tempo di archiviazione necessaria MediaTailor per personalizzare il manifest in risposta a una richiesta. |
# Registrazione delle chiamate API AWS Elemental MediaTailor
AWS Elemental MediaTailor è integrato con AWS CloudTrail, un servizio che fornisce un registro delle azioni intraprese da un utente, ruolo o AWS servizio in MediaTailor. CloudTrail acquisisce tutte le chiamate API MediaTailor come eventi. Le chiamate acquisite includono chiamate dalla MediaTailor console e chiamate di codice alle operazioni MediaTailor API. Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per. MediaTailor Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli **eventi**. Utilizzando le informazioni raccolte da CloudTrail, è possibile determinare a quale richiesta è stata inviata MediaTailor, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e dettagli aggiuntivi.
Per ulteriori informazioni CloudTrail, consulta la [Guida AWS CloudTrail per l'utente](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## AWS Elemental MediaTailor informazioni in CloudTrail
CloudTrail è abilitato sul tuo AWS account al momento della creazione dell'account. Quando si verifica un'attività in AWS Elemental MediaTailor, tale attività viene registrata in un CloudTrail evento insieme ad altri eventi AWS di servizio nella **cronologia degli eventi**. Puoi visualizzare, cercare e scaricare gli eventi recenti nel tuo AWS account. Per ulteriori informazioni, consulta [Visualizzazione degli eventi con cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Per una registrazione continua degli eventi nel tuo AWS account, inclusi gli eventi di AWS Elemental MediaTailor, crea un percorso. Un *trail* consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando crei un percorso nella console, il percorso si applica a tutte le AWS regioni. Il trail registra gli eventi di tutte le regioni della AWS partizione e consegna i file di log al bucket Amazon S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei log. CloudTrail Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [Creare un percorso per il tuo account AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [AWS integrazioni di servizi con log CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurazione delle notifiche Amazon SNS per CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Ricezione di file di CloudTrail registro da più regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [ricezione di file di CloudTrail registro da](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) più account
Tutte AWS Elemental MediaTailor le azioni vengono registrate CloudTrail e documentate nel riferimento [AWS Elemental MediaTailor API](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html). Ad esempio, tutte le chiamate alle operazioni `PutPlaybackConfiguration` e `ListPlaybackConfigurations` generano voci nei file di log di CloudTrail.
Ogni evento o voce di log contiene informazioni sull’utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue:
+ Se la richiesta è stata effettuata con l'utente root o con le credenziali AWS Identity and Access Management (IAM)
+ Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato.
+ Se la richiesta è stata effettuata da un altro AWS servizio
Per ulteriori informazioni, consulta [Elemento userIdentity di CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Comprensione delle AWS Elemental MediaTailor voci dei file di registro
Un trail è una configurazione che consente la distribuzione di eventi come file di log in un bucket Amazon S3 specificato dall'utente. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta da qualsiasi sorgente e include informazioni sull'azione richiesta, la data e l'ora dell'operazione, i parametri della richiesta e così via. I file di log di CloudTrail non sono una traccia di stack ordinata delle chiamate API pubbliche, pertanto non vengono visualizzati in un ordine specifico.
L'esempio seguente mostra una voce di CloudTrail registro che illustra l'`PutPlaybackConfiguration`azione:
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:53:46Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "PutPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename",
"AdDecisionServerUrl": "http://exampleads.com"
},
"responseElements": {
"SessionInitializationEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/session/AKIAIOSFODNN7EXAMPLE/examplename/",
"DashConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/examplename/",
"MpdLocation": "EMT_DEFAULT"
},
"AdDecisionServerUrl": "http://exampleads.com",
"CdnConfiguration": {},
"PlaybackEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com",
"HlsConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/examplename/"
},
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename"
},
"requestID": "1a2b3c4d-1234-5678-1234-1a2b3c4d5e6f",
"eventID": "987abc65-1a2b-3c4d-5d6e-987abc654def",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
L'esempio seguente mostra una voce di CloudTrail registro che illustra l'`GetPlaybackConfiguration`azione:
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:52:37Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "GetPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"Name": "examplename"
},
"responseElements": null,
"requestID": "0z1y2x3w-0123-4567-9876-6q7r8s9t0u1v",
"eventID": "888ddd77-3322-eeww-uuii-abc123jkl343",
"readOnly": true,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
# Ricezione di avvisi AWS Elemental MediaTailor sull'assemblaggio dei canali
MediaTailor crea avvisi per problemi o potenziali problemi che si verificano con le risorse di assemblaggio del canale. L'avviso descrive il problema, quando si è verificato e le risorse interessate.
È possibile visualizzare gli avvisi in Console di gestione AWS, AWS Command Line Interface (AWS CLI) o a livello di codice utilizzando l'API. AWS SDKs MediaTailor [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)
**Importante**
Gli avvisi sono disponibili solo per le risorse di assemblaggio dei canali create a partire dal 14 luglio 2021.
**Avvisi di Channel Assembly**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/mediatailor/latest/ug/channel-assembly-alerts.html)
## Risoluzione dei problemi relativi agli avvisi relativi ai manifesti
Quando ricevi avvisi relativi ai manifesti come, o `UNPARSABLE_MANIFEST``VARIANT_DURATION_MISMATCH`, controlla quanto segue: `TARGET_DURATION_MISMATCH`
1. **Verifica i requisiti di origine**: assicurati che i tuoi contenuti soddisfino i requisiti indicati in. [Integrazione di una fonte di contenuti per l'inserimento di MediaTailor annunci](integrating-origin.md)
1. **Controlla i registri del manifesto**: per un'analisi dettagliata degli errori manifesti e dei tipi di eventi, consulta. [AWS Elemental MediaTailor i registri manifest, la descrizione e i tipi di eventi.](log-types.md)
1. **Controlla i codici di errore**: per un'analisi dettagliata degli errori, vedere[Risoluzione dei problemi MediaTailor](troubleshooting.md).
1. **Rivedi il formato del manifesto**: verifica che il file manifest segua le specifiche di formato corrette per il tuo protocollo di streaming (HLS o DASH).
## Visualizzazione degli avvisi
È possibile visualizzare gli avvisi per qualsiasi risorsa di assemblaggio dei MediaTailor canali. Quando si visualizzano gli avvisi per canali e programmi, MediaTailor include tutte le risorse correlate contenute nel canale o nel programma. Ad esempio, quando si visualizzano gli avvisi per un programma specifico, vengono visualizzati anche gli avvisi relativi alla posizione della fonte e alle sorgenti VOD contenute nel programma.
Per visualizzare gli avvisi, effettuate la procedura seguente.
------
#### [ Console ]
**Per visualizzare gli avvisi nella console**
1. Apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Scegli la risorsa per cui desideri visualizzare gli avvisi.
1. Seleziona la scheda **Avvisi** per visualizzare gli avvisi.
------
#### [ AWS Command Line Interface (AWS CLI) ]
Per elencare gli avvisi relativi a una risorsa Channel Assembly, è necessario l'[Amazon Resource Name (ARN) della risorsa](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html). È possibile utilizzare il `describe-resource_type` comando in AWS Command Line Interface (AWS CLI) per ottenere l'ARN della risorsa. Ad esempio, esegui il comando [describe-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/describe-channel.html) per ottenere l'ARN di un canale specifico:
```
aws mediatailor describe-channel --channel-name MyChannelName
```
Quindi usa il [comando aws mediatailor list-alerts per elencare gli avvisi associati](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/list-alerts.html) alla risorsa:
```
aws mediatailor list-alerts --resource-arn arn:aws:mediatailor:region:aws-account-id:resource-type/resource-name
```
------
#### [ API ]
Per elencare gli avvisi relativi a una risorsa Channel Assembly, è necessario l'[Amazon Resource Name (ARN) della risorsa](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html). Puoi utilizzare l'`DescribeResource`operazione nell' MediaTailor API per ottenere l'ARN della risorsa. Ad esempio, utilizzate l'[DescribeChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeChannel.html)operazione per ottenere l'ARN di un canale specifico.
Quindi utilizza l'[ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API per elencare gli avvisi per la risorsa.
------
## Gestione degli avvisi
Quando si verifica un avviso, visualizza gli avvisi o utilizza AWS Command Line Interface (AWS CLI) o l'API MediaTailor Alerts per determinare le possibili fonti del problema. Console di gestione AWS AWS SDKs
Dopo aver risolto il problema, MediaTailor cancella l'avviso.
# AWS Elemental MediaTailor Taggare le risorse
Un *tag* è un'etichetta di metadati che si assegna o che si assegna a AWS una risorsa. AWS Ciascun tag è formato da una *chiave* e da un *valore*, Per i tag assegnati da te, puoi definire la chiave e il valore. Ad esempio, potresti definire la chiave come `stage`e il valore di una risorsa come `test`.
I tag consentono di:
+ Identifica e organizza le tue risorse. AWS Molti AWS servizi supportano l'etichettatura, quindi puoi assegnare lo stesso tag a risorse di servizi diversi per indicare che le risorse sono correlate. Ad esempio, è possibile assegnare a un AWS Elemental MediaPackage canale e a un endpoint lo stesso tag assegnato a una configurazione. AWS Elemental MediaTailor
+ Tieni traccia dei costi. AWS Attivi questi tag sulla Gestione dei costi e fatturazione AWS dashboard. AWS utilizza i tag per classificare i costi e fornirti un rapporto mensile sull'allocazione dei costi. Per ulteriori informazioni, consulta la pagina sull'[utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella [AWS Billing Guida per l'utente](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Controlla l'accesso alle tue risorse. AWS Per ulteriori informazioni, consulta [Controllo degli accessi tramite tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) nella [Guida per l'utente di IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html).
Le seguenti sezioni forniscono ulteriori informazioni sui tag per AWS Elemental MediaTailor.
## Risorse supportate in AWS Elemental MediaTailor
Le seguenti risorse AWS Elemental MediaTailor supportano l'etichettatura:
+ Canali
+ Configurazioni
+ SourceLocations
+ VodSources
## Limitazioni applicate ai tag
Le seguenti restrizioni di base si applicano ai tag sulle AWS Elemental MediaTailor risorse:
+ Numero massimo di tag che è possibile assegnare a una risorsa: 50
+ Lunghezza massima della chiave: 128 caratteri Unicode
+ Lunghezza massima del valore: 256 caratteri Unicode
+ Caratteri validi per chiave e valore: a-z, A-Z, 0-9, spazi e i seguenti caratteri: \$1 . : / = \$1 - e @
+ Le chiavi e i valori fanno distinzione tra lettere maiuscole
+ Non utilizzare `aws:` come prefisso per le chiavi; l'utilizzo di questo prefisso è esclusivo di AWS.
## Gestione dei tag in AWS Elemental MediaTailor
È possibile impostare i tag come proprietà in una risorsa. Puoi aggiungere, modificare ed eliminare i tag tramite l' AWS Elemental MediaTailor API o AWS Command Line Interface (AWS CLI). Per ulteriori informazioni, consulta la [documentazione di riferimento delle API di AWS Elemental MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html).
# Monitoraggio AWS dei servizi multimediali con Workflow Monitor
Workflow monitor è uno strumento per l'individuazione, la visualizzazione e il monitoraggio dei flussi di lavoro AWS multimediali. Workflow Monitor è disponibile nella AWS console e nell'API. Puoi utilizzare Workflow Monitor per scoprire e creare mappature visive delle risorse del tuo flusso di lavoro, chiamate mappe dei *segnali*. Puoi creare e gestire modelli di CloudWatch allarmi e EventBridge regole Amazon per monitorare le risorse mappate. I modelli di monitoraggio che crei vengono trasformati in AWS CloudFormation modelli implementabili per consentire la ripetibilità. AWS i modelli di allarme consigliati forniscono un monitoraggio predefinito basato sulle migliori pratiche.
**Scopri**
Utilizza le mappe dei segnali per scoprire automaticamente le AWS risorse interconnesse associate al tuo flusso di lavoro multimediale. Discovery può iniziare da qualsiasi risorsa di servizio supportata e creare una end-to-end mappatura del flusso di lavoro. Le mappe dei segnali possono essere utilizzate come strumenti di visualizzazione autonomi o migliorate con modelli di monitoraggio.
![\[Componenti di rilevamento del monitoraggio del flusso di lavoro.\]](http://docs.aws.amazon.com/it_it/mediatailor/latest/ug/images/workflowmonitor-discovery.png)
**Monitor (Monitoraggio)**
È possibile creare modelli di CloudWatch allarmi e EventBridge regole personalizzati per monitorare lo stato e lo stato dei flussi di lavoro multimediali. Sono disponibili modelli di allarme basati sulle migliori pratiche da importare nell'ambiente di monitoraggio del flusso di lavoro. Puoi utilizzare i modelli di allarme basati sulle best practice così come sono o modificarli per adattarli meglio al tuo flusso di lavoro. Tutti i modelli creati vengono trasformati in CloudFormation modelli per un'implementazione ripetibile.
![\[Componenti di monitoraggio del monitoraggio del flusso di lavoro.\]](http://docs.aws.amazon.com/it_it/mediatailor/latest/ug/images/workflowmonitor-monitoring.png)
**Nota**
Non vi è alcun costo diretto per l'utilizzo di Workflow Monitor. Tuttavia, ci sono dei costi associati alle risorse create e utilizzate per monitorare il flusso di lavoro.
Quando viene implementato il monitoraggio, vengono create EventBridge risorse Amazon CloudWatch e Amazon. Quando utilizzi la console di AWS gestione, prima di implementare il monitoraggio su una mappa dei segnali, riceverai una notifica del numero di risorse che verranno create. Per ulteriori informazioni sui prezzi, consulta: [CloudWatchprezzi](https://aws.amazon.com/cloudwatch/pricing/) e [EventBridge prezzi](https://aws.amazon.com/eventbridge/pricing/).
Workflow Monitor utilizza AWS CloudFormation modelli per distribuire le EventBridge risorse CloudWatch e. Questi modelli sono archiviati in un bucket Amazon Simple Storage Service di classe standard creato per tuo conto da Workflow Monitor durante il processo di distribuzione e comportano costi di archiviazione e richiamo degli oggetti. Per ulteriori informazioni sui prezzi, consulta: Prezzi di [Amazon S3](https://aws.amazon.com/s3/pricing/).
Le anteprime generate nella mappa dei segnali di monitoraggio del flusso di lavoro per i AWS Elemental MediaPackage canali vengono fornite da MediaPackage Origin Endpoint e comportano costi di trasferimento dati in uscita. [Per i prezzi, consulta: prezzi. MediaPackage](https://aws.amazon.com/mediapackage/pricing/)
## Componenti del monitoraggio del flusso di lavoro
Il monitoraggio del flusso di lavoro ha quattro componenti principali:
+ CloudWatch modelli di allarme: definisci le condizioni che desideri monitorare utilizzando CloudWatch. Puoi creare i tuoi modelli di allarme o importare modelli predefiniti creati da AWS. Per ulteriori informazioni, consulta: [CloudWatch gruppi di allarmi e modelli per il monitoraggio del flusso di lavoro AWS multimediale](monitor-with-workflow-monitor-configure-alarms.md)
+ EventBridge modelli di regole: definiscono la modalità di EventBridge invio delle notifiche quando viene attivato un allarme. Per ulteriori informazioni, consulta: [EventBridge gruppi di regole e modelli per il monitoraggio del flusso di lavoro multimediale AWS](monitor-with-workflow-monitor-configure-notifications.md)
+ Mappe dei segnali: utilizza un processo automatizzato per creare mappe del flusso di lavoro AWS Elemental utilizzando AWS le risorse esistenti. Le mappe dei segnali possono essere utilizzate per scoprire le risorse del flusso di lavoro e implementare il monitoraggio di tali risorse. Per ulteriori informazioni, consulta: [Mappe dei segnali di monitoraggio del flusso di lavoro](monitor-with-workflow-monitor-configure-signal-maps.md)
+ Panoramica: la pagina di panoramica consente di monitorare direttamente lo stato di più mappe di segnali da un'unica posizione. Rivedi le metriche, i registri e gli allarmi per i tuoi flussi di lavoro. Per ulteriori informazioni, consulta: [Panoramica del monitoraggio del flusso di lavoro](monitor-with-workflow-monitor-operate-overview.md)
## Servizi supportati
Workflow Monitor supporta il rilevamento automatico e la mappatura dei segnali delle risorse associate ai seguenti servizi:
+ AWS Elemental MediaConnect
+ AWS Elemental MediaLive
+ AWS Elemental MediaPackage
+ AWS Elemental MediaTailor
+ Simple Storage Service (Amazon S3)
+ Amazon CloudFront
**Topics**
+ [
## Componenti del monitoraggio del flusso di lavoro
](#monitor-with-workflow-monitor-components)
+ [
## Servizi supportati
](#monitor-with-workflow-monitor-supported-services)
+ [
# Configurazione del monitor del flusso di lavoro per monitorare AWS i servizi multimediali
](monitor-with-workflow-monitor-configure.md)
+ [
# Utilizzo del monitoraggio del flusso di lavoro
](monitor-with-workflow-monitor-operate.md)
# Configurazione del monitor del flusso di lavoro per monitorare AWS i servizi multimediali
Per configurare il monitoraggio del flusso di lavoro per la prima volta, devi creare i modelli di allarmi ed eventi e scoprire le mappe dei segnali utilizzate per monitorare i flussi di lavoro multimediali. La seguente guida contiene i passaggi necessari per configurare i ruoli IAM a livello di amministratore e operatore, creare risorse per il monitoraggio del flusso di lavoro e implementare il monitoraggio nei flussi di lavoro.
**Topics**
+ [
# Guida introduttiva al monitoraggio del flusso di lavoro
](monitor-with-workflow-monitor-configure-getting-started.md)
+ [
# Gruppi e modelli di monitoraggio del flusso di lavoro
](monitor-with-workflow-monitor-configure-templates.md)
+ [
# Mappe dei segnali di monitoraggio del flusso di lavoro
](monitor-with-workflow-monitor-configure-signal-maps.md)
+ [
# Quote di monitoraggio del flusso di lavoro
](monitor-with-workflow-monitor-configure-quotas.md)
# Guida introduttiva al monitoraggio del flusso di lavoro
I passaggi seguenti forniscono una panoramica di base sull'utilizzo di Workflow Monitor per la prima volta.
1. Configura le autorizzazioni IAM per il monitoraggio del flusso di lavoro per i ruoli a livello di amministratore e operatore: [Il workflow monitora le politiche IAM](monitor-with-workflow-monitor-configure-getting-started-IAM.md)
1. Crea modelli di allarme o importa modelli predefiniti creati da: AWS[Allarmi CloudWatch](monitor-with-workflow-monitor-configure-alarms.md)
1. Crea eventi di notifica che verranno consegnati da EventBridge: [EventBridge regole ](monitor-with-workflow-monitor-configure-notifications.md)
1. Scopri le mappe dei segnali utilizzando le tue risorse AWS Elementali esistenti: [Mappe dei segnali ](monitor-with-workflow-monitor-configure-signal-maps.md)
1. Allega i modelli di allarme e le regole di notifica alla tua mappa dei segnali: [Allegare modelli](monitor-with-workflow-monitor-configure-signal-maps-attach.md)
1. Implementa i modelli per iniziare a monitorare la mappa dei segnali: [Implementazione di modelli di monitoraggio](monitor-with-workflow-monitor-configure-deploy.md)
1. Monitora e rivedi il flusso di lavoro, monitora le risorse utilizzando la sezione panoramica della AWS console: [Panoramica di ](monitor-with-workflow-monitor-operate-overview.md)
![\[Le singole fasi di configurazione del monitor del flusso di lavoro. Inizia creando i ruoli IAM. Successivamente, crea modelli per allarmi ed eventi. Successivamente, scopri una mappa dei segnali e allega i tuoi modelli alla mappa. Dopo che una mappa dei segnali ha dei modelli allegati, questi devono essere implementati. Il passaggio finale è il monitoraggio utilizzando i modelli e le risorse di panoramica.\]](http://docs.aws.amazon.com/it_it/mediatailor/latest/ug/images/workflowmonitor-overview-steps.png)
# Workflow monitora le politiche IAM
Workflow Monitor interagisce con più AWS servizi per creare mappe di segnali, build, EventBridge risorse CloudWatch e CloudFormation modelli. Poiché il monitoraggio del flusso di lavoro interagisce con un'ampia gamma di servizi, è necessario assegnare politiche specifiche AWS Identity and Access Management (IAM) a questi servizi. Gli esempi seguenti indicano le politiche IAM necessarie per i ruoli IAM di amministratore e operatore.
## Politica IAM dell'amministratore
La seguente policy di esempio riguarda una policy IAM per il monitoraggio del flusso di lavoro a livello di amministratore. Questo ruolo consente la creazione e la gestione delle risorse di monitoraggio del flusso di lavoro e delle risorse di servizio supportate che interagiscono con il monitoraggio del flusso di lavoro.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:List*",
"cloudwatch:Describe*",
"cloudwatch:Get*",
"cloudwatch:PutAnomalyDetector",
"cloudwatch:PutMetricData",
"cloudwatch:PutMetricAlarm",
"cloudwatch:PutCompositeAlarm",
"cloudwatch:PutDashboard",
"cloudwatch:DeleteAlarms",
"cloudwatch:DeleteAnomalyDetector",
"cloudwatch:DeleteDashboards",
"cloudwatch:TagResource",
"cloudwatch:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudformation:List*",
"cloudformation:Describe*",
"cloudformation:CreateStack",
"cloudformation:UpdateStack",
"cloudformation:DeleteStack",
"cloudformation:TagResource",
"cloudformation:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudfront:List*",
"cloudfront:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ec2:DescribeNetworkInterfaces"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"events:List*",
"events:Describe*",
"events:CreateEventBus",
"events:PutRule",
"events:PutTargets",
"events:EnableRule",
"events:DisableRule",
"events:DeleteRule",
"events:RemoveTargets",
"events:TagResource",
"events:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"logs:Describe*",
"logs:Get*",
"logs:TagLogGroup",
"logs:TagResource",
"logs:UntagLogGroup",
"logs:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediaconnect:List*",
"mediaconnect:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"medialive:*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage:List*",
"mediapackage:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackagev2:List*",
"mediapackagev2:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage-vod:List*",
"mediapackage-vod:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediatailor:List*",
"mediatailor:Describe*",
"mediatailor:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"resource-groups:ListGroups",
"resource-groups:GetGroup",
"resource-groups:GetTags",
"resource-groups:GetGroupQuery",
"resource-groups:GetGroupConfiguration",
"resource-groups:CreateGroup",
"resource-groups:UngroupResources",
"resource-groups:GroupResources",
"resource-groups:DeleteGroup",
"resource-groups:UpdateGroupQuery",
"resource-groups:UpdateGroup",
"resource-groups:Tag",
"resource-groups:Untag"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"s3:*"
],
"Resource": "arn:aws:s3:::workflow-monitor-templates*"
},
{
"Effect": "Allow",
"Action": [
"sns:TagResource",
"sns:UntagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"tag:Get*",
"tag:Describe*",
"tag:TagResources",
"tag:UntagResources"
],
"Resource": "*"
}
]
}
```
------
## Politica IAM dell'operatore
La seguente policy di esempio riguarda una policy IAM per il monitoraggio del flusso di lavoro a livello di operatore. Questo ruolo consente un accesso limitato e di sola lettura alle risorse di monitoraggio del flusso di lavoro e alle risorse di servizio supportate che interagiscono con il monitoraggio del flusso di lavoro.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:List*",
"cloudwatch:Describe*",
"cloudwatch:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudformation:List*",
"cloudformation:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudfront:List*",
"cloudfront:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ec2:DescribeNetworkInterfaces"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"events:List*",
"events:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"logs:Describe*",
"logs:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediaconnect:List*",
"mediaconnect:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"medialive:List*",
"medialive:Get*",
"medialive:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage:List*",
"mediapackage:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackagev2:List*",
"mediapackagev2:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediapackage-vod:List*",
"mediapackage-vod:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"mediatailor:List*",
"mediatailor:Describe*",
"mediatailor:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": "arn:aws:s3:::workflow-monitor-templates*"
},
{
"Effect": "Allow",
"Action": [
"tag:Get*",
"tag:Describe*"
],
"Resource": "*"
}
]
}
```
------
# Gruppi e modelli di monitoraggio del flusso di lavoro
Prima di poter implementare il monitoraggio del flusso di lavoro su una mappa dei segnali, è necessario creare i gruppi e i modelli per gli CloudWatch allarmi e EventBridge le notifiche. I CloudWatch modelli definiscono quali scenari e soglie verranno utilizzati per attivare gli allarmi. I EventBridge modelli determineranno il modo in cui questi allarmi ti verranno segnalati.
Se desideri solo la mappatura delle risorse connesse e non desideri utilizzare le funzionalità dei modelli di monitoraggio di Workflow Monitor, le mappe dei segnali possono essere utilizzate senza CloudWatch modelli e. EventBridge Per ulteriori informazioni sull'utilizzo delle mappe dei segnali, consulta: [Mappe dei segnali ](monitor-with-workflow-monitor-configure-signal-maps.md)
**Topics**
+ [
# CloudWatch gruppi di allarmi e modelli per il monitoraggio del flusso di lavoro AWS multimediale
](monitor-with-workflow-monitor-configure-alarms.md)
+ [
# EventBridge gruppi di regole e modelli per il monitoraggio del flusso di lavoro multimediale AWS
](monitor-with-workflow-monitor-configure-notifications.md)
# CloudWatch gruppi di allarmi e modelli per il monitoraggio del flusso di lavoro AWS multimediale
Gli allarmi di monitoraggio del flusso di lavoro consentono di utilizzare le CloudWatch metriche esistenti come base degli allarmi per le mappe dei segnali. Puoi creare un gruppo di modelli di avvisi per ordinare e classificare i tipi di allarmi importanti per il tuo flusso di lavoro. All'interno di ogni gruppo di modelli di avviso, crei modelli di avviso con CloudWatch metriche e parametri specifici che desideri monitorare. Puoi creare i tuoi modelli di avviso o importare modelli di avviso consigliati creati da AWS. Dopo aver creato un gruppo di modelli di avviso e dei modelli di avviso all'interno di quel gruppo, è possibile allegare uno o più di questi gruppi di modelli di avviso a una mappa di segnali.
È necessario prima creare un gruppo di modelli di avvisi. Dopo aver creato un gruppo di modelli di avviso, puoi creare i tuoi modelli o utilizzare i modelli consigliati creati da AWS. Se desideri creare i tuoi modelli di allarme, continua su questa pagina. Per ulteriori informazioni sull'importazione dei modelli consigliati, consulta: [Modelli consigliati](monitor-with-workflow-monitor-configure-alarms-recommended-templates.md)
Questa sezione riguarda la creazione di CloudWatch allarmi utilizzando Workflow Monitor. Per ulteriori informazioni su come il CloudWatch servizio gestisce gli allarmi e i dettagli dei componenti degli allarmi, consulta: [Uso degli CloudWatch allarmi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) nella *Amazon CloudWatch * User Guide
## Creazione di gruppi di modelli di allarme
I gruppi di modelli di allarmi consentono di ordinare e classificare i tipi di allarmi importanti per il flusso di lavoro.
**Per creare un gruppo di modelli di avvisi**
1. Dal pannello di navigazione della console di monitoraggio del flusso di lavoro, seleziona i **modelli di CloudWatch allarme**.
1. Seleziona **Crea gruppo di modelli di allarme**.
1. Assegna al gruppo di modelli di avviso un **nome di gruppo** univoco e una **descrizione** opzionale.
1. Seleziona **Crea**, verrai indirizzato alla pagina dei dettagli del gruppo di modelli di avvisi appena creato.
## Creazione di modelli di allarme
Puoi creare modelli di allarme con le CloudWatch metriche e i parametri che desideri monitorare.
**Per creare un modello di avviso**
1. Dalla pagina dei dettagli del gruppo di modelli di avviso, seleziona **Crea modello di avviso**.
1. Assegna al modello di avviso un **nome** univoco e una **descrizione** opzionale.
1. Nella sezione **Scegli la metrica**:
1. Seleziona un **tipo di risorsa di destinazione**. Il tipo di risorsa di destinazione è una risorsa per il rispettivo servizio, ad esempio un canale per MediaLive e MediaPackage o un flusso per MediaConnect.
1. Seleziona un **nome di metrica**. Questa è la CloudWatch metrica che funge da base per l'allarme. L'elenco delle metriche cambierà in base al tipo di **risorsa Target** selezionato.
1. Nella sezione **Impostazioni degli allarmi**:
**Nota**
Per ulteriori informazioni su come il CloudWatch servizio gestisce gli allarmi e i dettagli dei componenti degli allarmi, consulta: [Uso degli CloudWatch allarmi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) nella *Amazon CloudWatch * User Guide
1. **Seleziona la statistica.** Si tratta di un valore come una **somma** o una **media** che verrà utilizzato per monitorare la metrica.
1. Seleziona l'**operatore di confronto**. Questo campo fa riferimento alla **soglia** impostata nel passaggio successivo.
1. Imposta una **soglia**. Si tratta di un valore numerico che l'**operatore di confronto** utilizza per determinare uno stato maggiore, minore o uguale.
1. Imposta un **periodo**. Questo è un valore temporale, in secondi. Il **periodo** è il periodo di tempo in cui **Statistic**, **Comparison Operator** e **Threshold** interagiscono per determinare se l'allarme viene attivato.
1. **Imposta i datapoint.** Questo valore determina quanti punti dati sono necessari per attivare l'allarme.
1. Seleziona come **trattare** i dati mancanti. Questa selezione determina come l'allarme reagisce ai dati mancanti.
1. Seleziona **Crea** per completare il processo.
Un esempio di modello di avviso completato potrebbe avere i seguenti parametri: Un **tipo di risorsa Target** di MediaConnect flusso viene monitorato per il nome della **metrica** Disconnections. Il valore **statistico** è impostato su Sum con un **operatore di confronto** «maggiore o uguale a» e una **soglia** di 10. Il **periodo** è impostato su 60 secondi e richiede solo 1 **datapoint** su 1. L'**opzione Treat Missing Data** è impostata su «ignora».
Il risultato di queste impostazioni è: il monitor del flusso di lavoro monitorerà le disconnessioni nel flusso. Se si verificano 10 o più disconnessioni entro 60 secondi, l'allarme verrà attivato. È necessario che 10 o più disconnessioni in 60 secondi si verifichino una sola volta affinché l'allarme venga attivato.
# Modelli di allarme consigliati per il monitoraggio del flusso di lavoro multimediale AWS
I modelli consigliati da Workflow Monitor sono una selezione curata di metriche dei servizi AWS Elemental con impostazioni di allarme predefinite appropriate per la metrica. Se non desideri creare modelli di allarme personalizzati, i modelli consigliati forniscono modelli di monitoraggio basati sulle migliori pratiche creati da. AWS
Workflow Monitor contiene gruppi di modelli consigliati per ogni servizio supportato. Questi gruppi sono progettati per applicare il monitoraggio basato sulle migliori pratiche a tipi specifici di flussi di lavoro. Ogni gruppo di modelli contiene una selezione curata di allarmi configurati in base a metriche specifiche del servizio. Ad esempio, un gruppo di modelli consigliato per un flusso di lavoro MediaLive multiplex avrà un set diverso di metriche preconfigurate rispetto a un flusso di lavoro CDI. MediaConnect
**Per utilizzare i modelli di allarme consigliati**
1. Segui i passaggi per [creare un gruppo di modelli di avviso](monitor-with-workflow-monitor-configure-alarms.md#monitor-with-workflow-monitor-alarms-groups-create) o selezionane uno esistente.
1. Nella sezione **Modelli di allarme**, seleziona **Importa**. Dovrai importare i modelli AWS consigliati nel tuo gruppo di modelli.
1. Usa il menu a discesa **dei gruppi di modelli di CloudWatch avvisi** per selezionare un gruppo AWS consigliato. Questi gruppi contengono allarmi selezionati per servizi specifici.
1. Seleziona i modelli da importare utilizzando le caselle di controllo. Ogni modello elencherà le proprie metriche, i valori di monitoraggio preconfigurati e fornirà una descrizione della metrica. **Quando hai finito di selezionare i modelli, seleziona il pulsante Aggiungi.**
1. I modelli selezionati verranno spostati nella sezione dei **modelli di avviso da importare**. Controlla le tue scelte e seleziona **Importa**.
1. Una volta completata l'importazione, i modelli selezionati verranno aggiunti al gruppo di modelli. Se desideri aggiungere altri modelli, ripeti la procedura di importazione.
1. I modelli importati possono essere personalizzati dopo l'importazione. Le impostazioni degli allarmi possono essere modificate per soddisfare le vostre esigenze di allarme.
# EventBridge gruppi di regole e modelli per il monitoraggio del flusso di lavoro multimediale AWS
CloudWatch utilizza EventBridge le regole di Amazon per inviare notifiche. Inizi creando un gruppo di modelli di eventi. In quel gruppo di modelli di eventi, crei modelli di evento che determinano quali condizioni creano una notifica e chi riceve la notifica.
Questa sezione riguarda la creazione di EventBridge regole utilizzando Workflow Monitor. Per ulteriori informazioni su come il EventBridge servizio utilizza le regole, consulta: [EventBridge regole](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) nella *Amazon EventBridge User Guide*
## Creazione di gruppi di modelli di eventi
I gruppi di modelli di eventi consentono di ordinare e classificare gli eventi in base al caso d'uso.
**Per creare un gruppo di modelli di eventi**
1. Dal riquadro di navigazione della console di monitoraggio del flusso di lavoro, seleziona i **modelli di EventBridge regole**.
1. Seleziona **Crea gruppo di modelli di eventi**.
1. Assegna al gruppo di modelli di avviso un **nome di gruppo** univoco e una **descrizione** opzionale.
1. Seleziona **Crea**, verrai indirizzato alla pagina dei dettagli del gruppo di modelli di avvisi appena creato.
## Creazione di modelli di eventi
Puoi inviare notifiche in base ai modelli di eventi che crei.
**Per creare un modello di evento**
1. Dalla pagina dei dettagli del gruppo di modelli di eventi, seleziona **Crea modello di evento**.
1. Assegna al modello di evento un **nome di modello** univoco e una **descrizione** opzionale.
1. Nella sezione **Impostazioni delle regole**:
1. Seleziona un **tipo di evento**. Quando si seleziona un tipo di evento, è possibile scegliere tra diversi eventi creati da AWS o selezionare **Signal map active alarm** per utilizzare un allarme creato da un modello di avviso.
1. Seleziona un **servizio Target**. Questo determina il modo in cui desideri ricevere la notifica di questo evento. Puoi selezionare Amazon Simple Notification Service o CloudWatch i log.
1. Dopo aver selezionato un servizio di destinazione, seleziona un **Target**. Si tratterà di un argomento o di un gruppo di CloudWatch log di Amazon SNS, a seconda del servizio di destinazione selezionato.
1. Seleziona **Crea** per completare il processo.
# Mappe dei segnali di monitoraggio del flusso di lavoro
Le mappe dei segnali sono mappature visive delle AWS risorse del flusso di lavoro multimediale. È possibile utilizzare Workflow Monitor per avviare l'individuazione della mappa dei segnali su uno qualsiasi dei tipi di risorse supportati. Durante il processo di scoperta, Workflow Monitor mapperà automaticamente e ricorsivamente tutte le risorse AWS connesse. Dopo aver creato la mappa dei segnali, puoi utilizzare la console di monitoraggio del flusso di lavoro per eseguire operazioni come distribuire modelli di monitoraggio, visualizzare metriche e visualizzare i dettagli delle risorse mappate.
**Topics**
+ [
# Creazione di mappe di segnali per flussi di lavoro multimediali AWS
](monitor-with-workflow-monitor-configure-signal-maps-create.md)
+ [
# Visualizzazione delle mappe dei segnali dei flussi di lavoro AWS multimediali
](monitor-with-workflow-monitor-configure-signal-maps-view.md)
+ [
# Allegare modelli di allarmi ed eventi alla mappa dei segnali del flusso di lavoro multimediale AWS
](monitor-with-workflow-monitor-configure-signal-maps-attach.md)
+ [
# Implementazione di modelli nella mappa dei segnali del flusso di lavoro AWS multimediale
](monitor-with-workflow-monitor-configure-deploy.md)
+ [
# Aggiornamento della mappa dei segnali del flusso di lavoro AWS multimediale
](monitor-with-workflow-monitor-configure-signal-maps-update.md)
+ [
# Eliminazione della mappa dei segnali del flusso di lavoro AWS multimediale
](monitor-with-workflow-monitor-configure-signal-maps-delete.md)
# Creazione di mappe di segnali per flussi di lavoro multimediali AWS
È possibile utilizzare le mappe dei segnali di monitoraggio del flusso di lavoro per creare una mappatura visiva di tutte le AWS risorse connesse nel flusso di lavoro multimediale.
**Per creare una mappa dei segnali**
1. Dal riquadro di navigazione della console di monitoraggio del flusso di lavoro, seleziona **Signal maps**.
1. Seleziona **Crea mappa dei segnali**.
1. Assegna un **nome** e una **descrizione** alla mappa dei segnali.
1. Nella sezione **Scopri una nuova mappa dei segnali**, vengono visualizzate le risorse dell'account corrente e della regione selezionata. Seleziona una risorsa per iniziare la scoperta della mappa dei segnali. La risorsa selezionata sarà il punto di partenza per la scoperta.
1. Seleziona **Crea**. Attendi alcuni istanti per il completamento del processo di scoperta. Una volta completato il processo, ti verrà presentata la nuova mappa dei segnali.
**Nota**
Le anteprime generate nella mappa dei segnali di monitoraggio del flusso di lavoro per i AWS Elemental MediaPackage canali vengono fornite da MediaPackage Origin Endpoint e comportano costi per il trasferimento dei dati in uscita. [Per i prezzi, consulta: prezzi. MediaPackage](https://aws.amazon.com/mediapackage/pricing/)
# Visualizzazione delle mappe dei segnali dei flussi di lavoro AWS multimediali
Le mappe dei segnali di monitoraggio del flusso di lavoro consentono di visualizzare una mappatura visiva di tutte le AWS risorse connesse nel flusso di lavoro multimediale.
**Visualizzazioni della mappa dei segnali**
Dopo aver selezionato una mappa dei segnali, sono disponibili due visualizzazioni che possono essere utilizzate per monitorare o configurare la mappa dei segnali. **Monitora la mappa** dei **segnali e Configura la mappa** dei segnali sono un pulsante sensibile al contesto che si trova in alto a destra nella sezione della console della mappa dei segnali.
Se si seleziona la mappa dei segnali utilizzando la sezione **Mappe dei segnali** del pannello di navigazione, la mappa dei segnali verrà visualizzata nella visualizzazione di configurazione. La visualizzazione di configurazione consente di apportare modifiche ai gruppi di modelli allegati a questa mappa dei segnali, implementare i modelli allegati e visualizzare i dettagli e i tag di base della mappa dei segnali.
Se si seleziona la mappa dei segnali utilizzando la sezione **Panoramica** del pannello di navigazione, la mappa dei segnali verrà visualizzata nella visualizzazione di monitoraggio. La visualizzazione di monitoraggio mostra gli CloudWatch allarmi, le EventBridge regole, gli avvisi, i registri e le metriche per questa mappa dei segnali.
La visualizzazione può essere modificata in qualsiasi momento selezionando il pulsante **Monitora/Configura la mappa dei segnali** in alto a destra. La vista di configurazione richiede autorizzazioni IAM a livello di amministratore. Le autorizzazioni IAM richieste possono essere visualizzate qui: [Il workflow monitora le politiche IAM](monitor-with-workflow-monitor-configure-getting-started-IAM.md)
**Navigazione nella mappa dei segnali**
Una mappa dei segnali conterrà i nodi per ogni risorsa AWS supportata rilevata da Workflow Monitor. Alcune risorse, come MediaLive canali ed MediaPackage endpoint, possono visualizzare anteprime in miniatura del contenuto, se sono disponibili anteprime in miniatura.
Selezionando un nodo di risorse e selezionando **Visualizza i dettagli delle risorse selezionate** dal menu a discesa **Azioni** si accederà alla pagina dei dettagli del servizio associato. Ad esempio, selezionando un MediaLive canale e selezionando **Visualizza i dettagli delle risorse selezionate** si aprirà la pagina dei dettagli della MediaLive console relativa a quel canale.
La selezione di un nodo di risorse filtrerà l'elenco degli allarmi attivi solo in base a quel nodo. Se selezioni l'**ARN di destinazione** della risorsa nell'allarme attivo, verrai indirizzato alla pagina dei dettagli del servizio associato, con la risorsa selezionata aperta.
# Allegare modelli di allarmi ed eventi alla mappa dei segnali del flusso di lavoro multimediale AWS
Dopo aver creato i modelli di allarme ed evento, è necessario collegarli a una mappa dei segnali. Tutti i modelli di allarmi ed eventi che hai creato possono essere allegati a qualsiasi mappa dei segnali rilevata.
**Per allegare modelli di allarmi ed eventi alla mappa dei segnali**
1. Dal riquadro di navigazione della console di monitoraggio del flusso di lavoro, seleziona **Signal maps** e seleziona la mappa dei segnali su cui vuoi lavorare.
1. In alto a destra della pagina della mappa dei segnali, nella scheda **Gruppi di modelli di CloudWatch avvisi, seleziona Allega gruppi** **di modelli di CloudWatch allarme**.
1. **Nella nuova sezione che si apre, scegli tutti i gruppi di modelli di avvisi che desideri applicare a questa mappa di segnali, quindi seleziona Aggiungi.** Ciò farà sì che i gruppi di modelli di allarme selezionati si spostino nella sezione **Gruppi di modelli di CloudWatch allarme collegati**.
1. Selezionando **Salva** salverai le modifiche e tornerai alla pagina della mappa dei segnali.
1. A destra della pagina della mappa dei segnali, seleziona la scheda **Gruppi di modelli di EventBridge regole**, quindi seleziona **Allega gruppi di modelli di EventBridge regole**.
1. Nella nuova sezione che si apre, scegli tutti i gruppi di modelli di eventi che desideri applicare a questa mappa di segnali, quindi seleziona **Aggiungi**. In questo modo i gruppi di modelli di regole selezionati verranno spostati nella sezione **Gruppi di modelli di EventBridge regole allegati**.
1. Selezionando **Salva** salverai le modifiche e tornerai alla pagina della mappa dei segnali.
1. Hai assegnato modelli di CloudWatch allarmi e EventBridge regole alla mappa dei segnali, ma il monitoraggio non è ancora stato implementato. La prossima sezione tratterà l'implementazione delle risorse di monitoraggio.
# Implementazione di modelli nella mappa dei segnali del flusso di lavoro AWS multimediale
Dopo aver collegato i modelli di allarme ed evento alla mappa dei segnali, è necessario implementare il monitoraggio. Fino al completamento dell'implementazione, il monitoraggio della mappa dei segnali non sarà attivo.
Workflow Monitor distribuirà solo gli allarmi pertinenti alla mappa dei segnali selezionata. Ad esempio, il gruppo di modelli di allarme allegato potrebbe contenere allarmi per più servizi, come MediaLive, MediaPackage e. MediaConnect Se la mappa dei segnali selezionata contiene solo MediaLive risorse, non verrà attivato alcun MediaConnect allarme MediaPackage o verrà attivato.
**Per distribuire i modelli di monitoraggio**
1. Dopo aver collegato i gruppi di modelli di allarmi ed eventi alla mappa dei segnali e aver salvato le modifiche, seleziona **Deploy monitor** nel menu a discesa **Azioni**.
1. Ti verrà chiesto di confermare la distribuzione e ti verrà mostrato il numero di CloudWatch EventBridge risorse che verranno create. Se desideri procedere, seleziona **Deploy.**
**Nota**
Non vi è alcun costo diretto per l'utilizzo di Workflow Monitor. Tuttavia, ci sono dei costi associati alle risorse create e utilizzate per monitorare il flusso di lavoro.
Quando viene implementato il monitoraggio, vengono create EventBridge risorse Amazon CloudWatch e Amazon. Quando utilizzi la console di AWS gestione, prima di implementare il monitoraggio su una mappa dei segnali, riceverai una notifica del numero di risorse che verranno create. Per ulteriori informazioni sui prezzi, consulta: [CloudWatchprezzi](https://aws.amazon.com/cloudwatch/pricing/) e [EventBridge prezzi](https://aws.amazon.com/eventbridge/pricing/).
Workflow Monitor utilizza AWS CloudFormation modelli per distribuire le EventBridge risorse CloudWatch e. Questi modelli sono archiviati in un bucket Amazon Simple Storage Service di classe standard creato per tuo conto da Workflow Monitor durante il processo di distribuzione e comportano costi di archiviazione e richiamo degli oggetti. Per ulteriori informazioni sui prezzi, consulta: Prezzi di [Amazon S3](https://aws.amazon.com/s3/pricing/).
1. Lo stato della distribuzione viene visualizzato accanto al nome della mappa dei segnali. Lo stato di distribuzione è visibile anche nella sezione **Stacks** della CloudFormation console. Dopo alcuni istanti di creazione e distribuzione delle risorse, inizierà il monitoraggio della mappa dei segnali.
# Aggiornamento della mappa dei segnali del flusso di lavoro AWS multimediale
Se viene apportata una modifica al flusso di lavoro, potrebbe essere necessario riscoprire la mappa dei segnali e ridistribuire le risorse di monitoraggio. Workflow monitor è uno strumento di visualizzazione e monitoraggio che non è in grado di apportare modifiche al flusso di lavoro. Le mappe dei segnali rappresentano una point-in-time visualizzazione del flusso di lavoro. Se aggiungi, rimuovi o modifichi in modo significativo parti del tuo flusso di lavoro multimediale, ti consigliamo di riscoprire la mappa dei segnali. Se disponi di risorse di monitoraggio collegate alla mappa dei segnali, ti consigliamo di ridistribuire il monitoraggio dopo il processo di riscoperta.
**Per riscoprire una mappa dei segnali**
1. Dal pannello di navigazione della console di monitoraggio del flusso di lavoro, seleziona **Signal maps** e seleziona la mappa dei segnali con cui desideri lavorare.
1. Verifica di essere nella vista **Configura la mappa dei segnali**. Per ulteriori informazioni sulla modifica delle visualizzazioni, consulta: [Visualizzazione delle mappe dei segnali ](monitor-with-workflow-monitor-configure-signal-maps-view.md)
1. In alto a destra della pagina della mappa dei segnali, seleziona il menu a discesa **Azioni**. **Seleziona Riscopri.**
1. Ti verrà presentata la schermata di riscoperta. Seleziona una risorsa che faccia parte del flusso di lavoro che stai riscoprendo. Seleziona il pulsante **Riscopri**.
1. La mappa dei segnali verrà ricostruita in base al flusso di lavoro corrente. Se devi ridistribuire le risorse di monitoraggio, rimani sulla pagina di questa mappa dei segnali. Tutti i modelli di monitoraggio precedentemente allegati rimarranno allegati, ma dovranno essere ridistribuiti.
**Per ridistribuire i modelli di monitoraggio dopo la riscoperta di una mappa di segnale**
1. Dopo la riscoperta, verrai indirizzato alla mappa dei segnali aggiornata. **Per ridistribuire i modelli di monitoraggio, seleziona **Deploy monitor** dal menu a discesa Azioni.**
1. Ti verrà chiesto di confermare la distribuzione e ti verrà mostrato il numero di eventuali CloudWatch EventBridge risorse che verranno create. Se desideri procedere, seleziona **Deploy.**
1. Lo stato della distribuzione viene visualizzato accanto al nome della mappa dei segnali. Dopo alcuni istanti di creazione e distribuzione delle risorse, inizierà il monitoraggio della mappa dei segnali.
# Eliminazione della mappa dei segnali del flusso di lavoro AWS multimediale
Se non è più necessaria una mappa dei segnali, è possibile eliminarla. Se hai dei modelli di monitoraggio distribuiti sulla mappa dei segnali, il processo di cancellazione ti chiederà di eliminare tutte CloudWatch le EventBridge risorse che sono state distribuite su questa mappa dei segnali. L'eliminazione delle risorse distribuite non influisce sui modelli che le hanno create. Questa eliminazione delle risorse serve a garantire che non si disponga CloudWatch di EventBridge risorse distribuite ma non utilizzate.
**Per eliminare una mappa dei segnali**
1. Dal pannello di navigazione della console di monitoraggio del flusso di lavoro, seleziona **Signal maps** e seleziona il pulsante di opzione accanto alla mappa dei segnali che desideri eliminare.
1. Seleziona il pulsante **Elimina**. Ti verrà chiesto di confermare l'eliminazione delle risorse di monitoraggio. Seleziona **Elimina** per iniziare il processo di eliminazione delle risorse di monitoraggio.
1. La colonna **Monitora la distribuzione** mostrerà lo stato corrente. Quando lo stato è cambiato in **DELETE\$1COMPLETE**, selezionate nuovamente il pulsante **Elimina**.
1. Ti verrà chiesto di confermare l'eliminazione della mappa dei segnali. Seleziona **Elimina** per procedere ed eliminare la mappa dei segnali.
# Quote di monitoraggio del flusso di lavoro
La sezione seguente contiene le quote per le risorse di monitoraggio del flusso di lavoro. Ogni quota è calcolata «per account». Se devi aumentare una quota per il tuo account, puoi utilizzare la [console AWS Service Quotas](https://console.aws.amazon.com/servicequotas/home) per richiedere un aumento, se non diversamente indicato nella tabella seguente.
**Quote**
| Tipo di risorsa | Quota |
| --- | --- |
| CloudWatch gruppi di modelli di allarme | 20 |
| CloudWatch modelli di allarme | 200 |
| EventBridge gruppi di modelli di regole | 20 |
| EventBridge modelli di regole | 200 |
| mappe dei segnali | 30 |
| Mappe dei segnali: gruppi di modelli di CloudWatch allarme allegati a una singola mappa dei segnali | 5Non è possibile aumentare questa quota. |
| Mappe dei segnali: gruppi di modelli di EventBridge regole allegati a una singola mappa di segnali | 5Non è possibile aumentare questa quota. |
# Utilizzo del monitoraggio del flusso di lavoro
Utilizza le sezioni di **panoramica** e **mappe dei segnali** della console di monitoraggio del flusso di lavoro per esaminare lo stato corrente dei flussi di lavoro e tutti gli allarmi, le metriche e i registri associati.
**Topics**
+ [
# Panoramica del monitoraggio del flusso di lavoro
](monitor-with-workflow-monitor-operate-overview.md)
+ [
# Panoramica, registri e metriche per il monitoraggio del flusso di lavoro.
](monitor-with-workflow-monitor-operate-logs-metrics.md)
+ [
# Utilizzo delle mappe dei segnali di monitoraggio del flusso di lavoro
](monitor-with-workflow-monitor-operate-signal-maps.md)
# Panoramica del monitoraggio del flusso di lavoro
La sezione **Panoramica** della console di monitoraggio del flusso di lavoro è una dashboard che fornisce at-a-glance informazioni sulle mappe dei segnali. Nella sezione panoramica, puoi vedere lo stato attuale del monitoraggio di ciascuna mappa di segnali, nonché le CloudWatch metriche e gli eventuali CloudWatch registri associati. Puoi selezionare qualsiasi mappa dei segnali da portare alla pagina della console delle mappe dei segnali.
**Panoramica del filtraggio**
Utilizzando la barra **di ricerca** nella sezione panoramica, è possibile filtrare l'elenco delle mappe dei segnali utilizzando vincoli sensibili al contesto. Dopo aver selezionato la barra di ricerca, ti verrà presentato un elenco di **proprietà** in base alle quali filtrare. Selezionando una proprietà verranno **visualizzati operatori** come Uguale, Contiene, Non è uguale e Non contiene. La selezione di un operatore creerà un elenco di risorse dal tipo di proprietà selezionato. Selezionando una di queste risorse, nell'elenco delle mappe dei segnali verranno visualizzate solo le mappe dei segnali che soddisfano il vincolo definito.
# Panoramica, registri e metriche per il monitoraggio del flusso di lavoro.
Per visualizzare le CloudWatch metriche e i registri di una mappa dei segnali, seleziona il pulsante di opzione accanto al nome della mappa dei segnali. Sotto l'elenco delle mappe dei segnali verrà visualizzata un'interfaccia a schede per le metriche e i registri.
**CloudWatch Parametri**
CloudWatch le metriche per la mappa dei segnali selezionata saranno sensibili al contesto e mostreranno solo le metriche associate ai servizi utilizzati nel flusso di lavoro relativo alle mappe dei segnali. Puoi utilizzare gli strumenti di metrica sullo schermo per personalizzare i periodi e gli intervalli di tempo delle metriche visualizzati.
**CloudWatch Registri**
Se hai associato un gruppo di CloudWatch log alla mappa dei segnali, quel gruppo verrà visualizzato qui.
# Utilizzo delle mappe dei segnali di monitoraggio del flusso di lavoro
Dalla sezione **panoramica** della console, è possibile selezionare una mappa dei segnali specifica per visualizzare ulteriori informazioni su quella mappa dei segnali e sulle relative risorse di monitoraggio.
Dopo aver selezionato una mappa dei segnali, ti verranno presentate la mappa dei segnali e una serie di sezioni a schede contenenti ulteriori informazioni:
+ CloudWatch allarmi
+ EventBridge regole
+ AWS avvisi elementali
+ Metriche
+ Log
+ Dettagli di base
**Navigazione nella mappa dei segnali**
Una mappa dei segnali conterrà i nodi per ogni risorsa AWS supportata rilevata da Workflow Monitor. Alcune risorse, come MediaLive canali ed MediaPackage endpoint, possono visualizzare anteprime in miniatura del contenuto, se sono disponibili anteprime in miniatura.
Selezionando un nodo di risorse e selezionando **Visualizza i dettagli delle risorse selezionate** dal menu a discesa **Azioni** si accederà alla pagina dei dettagli del servizio associato. Ad esempio, selezionando un MediaLive canale e selezionando **Visualizza i dettagli delle risorse selezionate** si aprirà la pagina dei dettagli della MediaLive console relativa a quel canale.
La selezione di un nodo di risorse filtrerà l'elenco degli allarmi attivi solo in base a quel nodo. Se selezioni l'**ARN di destinazione** della risorsa nell'allarme attivo, verrai indirizzato alla pagina dei dettagli del servizio associato, con la risorsa selezionata aperta.