

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 AWS Elemental MediaConvert
<a name="monitoring-overview"></a>

Puoi tenere traccia dei progressi di un lavoro, inclusi lo stato, la fase e la percentuale di completamento. Per informazioni, consulta [Monitoraggio dei progressi MediaConvert del lavoro](how-mediaconvert-jobs-progress.md).

Puoi monitorare *lo stato* dei tuoi lavori e la loro percentuale di completamento nei seguenti luoghi:

**AWS Elemental MediaConvert pagina delle offerte di lavoro**  
La [MediaConvert console](https://console.aws.amazon.com/mediaconvert) mostra i seguenti dettagli sui lavori: **Job ID**, **Queue**, **Status**, **Submit time, **Start Time****, **Transcode duration**, **Job percent complete**, **Finish time**, **Warnings**, **Inputs**, **First input file name, First input file** path, **First input file path**, **Output groups e **First** output group** destination.  
****Facoltativamente, puoi filtrare i lavori in base allo stato o alla coda.****

**Amazon EventBridge**  
Con EventBridge, puoi ottenere informazioni più dettagliate sullo stato dei tuoi lavori, tra cui eventuali chiamate API, percentuale di completamento delle fasi di verifica, transcodifica e caricamento. AWS Elemental MediaConvert invia questi eventi al bus eventi predefinito del servizio. EventBridge È possibile creare regole per il monitoraggio MediaConvert programmatico utilizzando altri AWS servizi. Per ulteriori informazioni, consulta [Usare Amazon EventBridge con MediaConvert](eventbridge_events.md).

MediaConvert emette dati su metriche, eventi e avvisi (se applicabile) al completamento di un lavoro. È possibile utilizzare questi dati per valutare il successo di un lavoro, anche se viene completato senza errori. I dati che possono essere utilizzati per valutare un lavoro, o anche l'andamento di più lavori, sono disponibili nei seguenti luoghi:

**MediaConvert Pagina delle offerte di lavoro**  
Nella MediaConvert console, puoi vedere lo stato di completamento del processo e visualizzare eventuali avvisi che potrebbero essersi verificati durante la transcodifica. Per informazioni più granulari, come le statistiche sulla qualità video QVBR, usa invece. EventBridge

**MediaConvert API**  
Tramite l' MediaConvert API, puoi richiedere un elenco di lavori, stato del lavoro e dettagli del lavoro. Per ulteriori informazioni, consulta [Jobs](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html) in the *AWS Elemental MediaConvert API Reference*. 

**Amazon EventBridge**  
Con EventBridge, puoi ottenere informazioni più dettagliate sul risultato dei tuoi lavori completati. MediaConvert fornisce questi dati tramite gli eventi a cui invia EventBridge. Puoi iscriverti a questi eventi per ricevere notifiche di lavoro in modo programmatico o tramite Amazon SNS e intraprendere azioni basate su di essi.  
Per ulteriori informazioni sull'utilizzo degli eventi, consulta. [Utilizzo EventBridge con AWS Elemental MediaConvert](eventbridge_events.md)

** CloudWatch Metriche Amazon**  
Con Amazon CloudWatch, puoi visualizzare le tendenze nelle statistiche di transcodifica dei lavori completati, inclusa la qualità video QVBR. MediaConvert emette statistiche di transcodifica alla fine di CloudWatch ogni lavoro.  
Per ulteriori informazioni sull'utilizzo MediaConvert con le CloudWatch metriche, consulta. [Utilizzo CloudWatch con MediaConvert](cloudwatch_metrics.md)

**AWS CloudTrail**  
Con CloudTrail, puoi ottenere informazioni dettagliate su quando esegui un' MediaConvert azione tramite una chiamata API o la MediaConvert console.  
Per ulteriori informazioni sull'utilizzo CloudTrail, consulta[Registrazione delle chiamate AWS Elemental MediaConvert API utilizzando AWS CloudTrail](logging-using-cloudtrail.md).

**Topics**
+ [Utilizzo EventBridge con AWS Elemental MediaConvert](eventbridge_events.md)
+ [Utilizzo CloudWatch con MediaConvert](cloudwatch_metrics.md)
+ [Registrazione delle chiamate AWS Elemental MediaConvert API utilizzando AWS CloudTrail](logging-using-cloudtrail.md)

# Utilizzo EventBridge con AWS Elemental MediaConvert
<a name="eventbridge_events"></a>

Puoi usare Amazon EventBridge per monitorare i tuoi AWS Elemental MediaConvert lavori. Ecco alcuni esempi di cosa puoi fare con EventBridge:

**Ottieni dettagli sui risultati del tuo lavoro**  
AWS Elemental MediaConvert fornisce dettagli sui risultati dei lavori nella notifica relativa all'`COMPLETE`evento. Queste informazioni includono l'ubicazione e i nomi dei file multimediali e dei manifest del processo. Per informazioni dettagliate, vedi [Eventi con stato COMPLETO](ev_status_complete.md).  
Per informazioni sulle metriche relative alle offerte di lavoro inviate ad Amazon CloudWatch, consulta[Utilizzo CloudWatch con MediaConvert](cloudwatch_metrics.md).

**Imposta notifiche e-mail per le modifiche allo stato del lavoro**  
Per impostare una regola di EventBridge evento, consulta[Tutorial: impostazione delle notifiche e-mail per i lavori non riusciti](setting-up-cloudwatch-event-rules.md#mediaconvert_sns_tutorial).  
Per un elenco di tutte le notifiche di modifica dello stato del processo per cui si configurano regole di evento, consulta [Elenco degli MediaConvert EventBridge eventi](mediaconvert_event_list.md).

**Monitora lo stato di avanzamento del tuo lavoro**  
Gli eventi `STATUS_UPDATE` forniscono informazioni sulle fasi in cui si trova il processo (`PROBING`, `TRANSCODING` e `UPLOADING`). Per alcuni lavori, MediaConvert fornisce una stima dell'avanzamento del lavoro. Questa stima viene mostrata come percentuale del tempo totale trascorso da quando il lavoro lascia la coda a quando i file di output vengono visualizzati nel bucket Amazon S3 di output.  
Per ulteriori informazioni sugli eventi `STATUS_UPDATE`, consulta la tabella dei tipi di evento in [Elenco degli MediaConvert EventBridge eventi](mediaconvert_event_list.md).  
Per ulteriori informazioni sulla regolazione della frequenza degli aggiornamenti dello stato, consulta [Regola l'intervallo di aggiornamento dello stato](adjusting-the-status-update-interval.md).

**Avvia automaticamente la post-elaborazione con una funzione AWS Lambda **  
È possibile configurare EventBridge in modo che una AWS Lambda funzione avvii il codice di post-elaborazione al termine del lavoro. Per ulteriori informazioni sull'utilizzo di AWS Lambda with AWS Elemental MediaConvert, consulta una di queste risorse:  
+ Per architetti cloud esperti, guarda il [video on demand AWS](https://aws.amazon.com/solutions/video-on-demand-on-aws/) pubblicato sul blog *AWS Answers*.
+ Per gli sviluppatori alle prime armi MediaConvert con Lambda, consulta il tutorial [Automating jobs MediaConvert with Lambda](https://github.com/aws-samples/aws-media-services-simple-vod-workflow/blob/master/7-MediaConvertJobLambda/README.md) su. GitHub

**Ottieni dettagli sui lavori che crei o su altre operazioni MediaConvert **  
Per impostazione predefinita, MediaConvert non emette un EventBridge evento per i nuovi lavori creati o per qualsiasi altra MediaConvert operazione eseguita. Per ricevere EventBridge eventi in questi casi, devi prima creare un AWS CloudTrail trail.   
Per ulteriori informazioni, consulta [Lavorare con i CloudTrail sentieri](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html). 

**Nota**  
EventBridge consegna ogni evento dal flusso MediaConvert degli eventi almeno una volta.  
MediaConvert non richiede autorizzazioni aggiuntive per la distribuzione degli eventi. EventBridge

**Topics**
+ [Impostazione delle regole EventBridge](setting-up-cloudwatch-event-rules.md)
+ [Monitoraggio dei progressi MediaConvert del lavoro](how-mediaconvert-jobs-progress.md)
+ [Elenco degli MediaConvert EventBridge eventi](mediaconvert_event_list.md)

# Impostazione delle regole EventBridge
<a name="setting-up-cloudwatch-event-rules"></a>

Per configurare EventBridge le regole Amazon: crea una regola che colleghi l'evento da AWS Elemental MediaConvert e il servizio di destinazione che risponde alla modifica dello stato del tuo lavoro, ad esempio Amazon Simple Notification Service (Amazon SNS) o. AWS Lambda

Per un tutorial sulla configurazione di una EventBridge regola con AWS Elemental MediaConvert, consulta. [Tutorial: impostazione delle notifiche e-mail per i lavori non riusciti](#mediaconvert_sns_tutorial)

Per un elenco degli eventi MediaConvert inviati nel flusso di EventBridge eventi, consulta[Elenco degli MediaConvert EventBridge eventi](mediaconvert_event_list.md).

Per informazioni più generali sull'utilizzo EventBridge, consulta la [Amazon EventBridge User Guide](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

Per informazioni sulla risoluzione dei problemi, consulta [Troubleshooting Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) nella *Amazon EventBridge User Guide*. 

**Topics**
+ [Tutorial: impostazione delle notifiche e-mail per i lavori non riusciti](#mediaconvert_sns_tutorial)
+ [Fase 1: creare un argomento in Amazon SNS](#mediaconvert_sns_create_topic)
+ [Fase 2: Specificare uno schema di eventi in una regola EventBridge](#mediaconvert_sns_rule_event_source)
+ [Passaggio 3: aggiungi l'argomento Amazon SNS e completa la regola](#add-target-and-finish-rule)
+ [Fase 4: Test della regola](#mediaconvert_sns_test_rule)

## Tutorial: impostazione delle notifiche e-mail per i lavori non riusciti
<a name="mediaconvert_sns_tutorial"></a>

In questo tutorial, configuri una regola di EventBridge evento che acquisisce gli eventi quando lo stato di un lavoro cambia `ERROR` e quindi ti avvisa dell'evento. Per fare ciò, devi prima creare un argomento in Amazon SNS che ti invierà una notifica e-mail sul processo non riuscito. Successivamente, crei una regola EventBridge definendo un'origine dell'evento e facendo riferimento all'argomento Amazon SNS (la «destinazione»).

## Fase 1: creare un argomento in Amazon SNS
<a name="mediaconvert_sns_create_topic"></a>

La prima parte della configurazione di una EventBridge regola consiste nella preparazione dell'obiettivo della regola. In questo caso, ciò significa creare e sottoscrivere un argomento di Amazon SNS.

**Come creare un argomento Amazon SNS**

1. [Apri la console Amazon SNS nella versione v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)

1. Nel riquadro di navigazione scegliere **Argomenti**, quindi **Crea nuovo argomento**.

1. Per **Tipo**, scegliere **Standard**.

1. **Per **Nome**, inserisci**MediaConvertJobErrorAlert**, quindi scegli Crea argomento.**

1. Scegli il **nome** dell'argomento che hai appena creato per visualizzare **i dettagli dell'argomento**.

1. Nella pagina dei **dettagli dell'**MediaConvertJobErrorAlert**argomento**, nella sezione **Sottoscrizioni**, scegli **Crea abbonamento**. 

1. Per **Protocollo**, scegli **E-mail**. Per **Endpoint**, inserisci l'indirizzo e-mail a cui desideri che Amazon SNS invii la notifica.

1. Scegli **Create Subscription** (Crea sottoscrizione).

1. Riceverai un'e-mail di notifica da Amazon SNS. Quando la ricevi, scegli il collegamento **Confirm subscription** (Conferma sottoscrizione) nell'e-mail. 

## Fase 2: Specificare uno schema di eventi in una regola EventBridge
<a name="mediaconvert_sns_rule_event_source"></a>

Questo passaggio mostra come specificare il modello di evento in una EventBridge regola. Questa regola acquisirà gli eventi inviati da MediaConvert quando lo stato di un lavoro cambia in`ERROR`. 

**Per impostare uno schema di eventi in una EventBridge regola**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel riquadro di navigazione, scegli **Regole**. Mantieni il **bus Event** **predefinito**, quindi scegli **Crea regola**.

1. Per **Nome**, immettete**MediaConvertJobStateError**, quindi scegliete **Avanti**.

1. Nella sezione **Schema dell'evento**, a partire da **Origine dell'evento**, scegliete le seguenti impostazioni:
   + **Fonte dell'evento**: **AWS services**
   + **AWS servizio**: **MediaConvert**
   + **Tipo di evento**: **MediaConvert Job State Change**
   + **Tipo di evento, stato/i specifico/i**: **ERROR**

1. Una casella **del modello di evento** sarà simile all'esempio seguente. 

   ```
   {
     "source": ["aws.mediaconvert"],
     "detail-type": ["MediaConvert Job State Change"],
     "detail": {
       "status": ["ERROR"]
     }
   }
   ```

   Questo codice definisce una regola di EventBridge evento che corrisponde a qualsiasi evento in cui lo stato del lavoro cambia`ERROR`. Per ulteriori informazioni sui modelli di [eventi, consulta Events and event pattern](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html) nella *Amazon CloudWatch User Guide*.

1. Scegli **Next (Successivo)**.

## Passaggio 3: aggiungi l'argomento Amazon SNS e completa la regola
<a name="add-target-and-finish-rule"></a>

Aggiungi l'argomento Amazon SNS che hai creato nel passaggio 1 alla EventBridge regola che hai iniziato nel passaggio 2.

**Per aggiungere l'argomento Amazon SNS e completare la regola EventBridge**

1. Nella sezione **Seleziona target (s)**, in **Seleziona un target**, scegli l'argomento **SNS**.

1. Per **Argomento**, scegli **MediaConvertJobErrorAlert**.

1. Scegli **Next (Successivo)**.

1. Facoltativamente, aggiungi tag. Quindi scegli **Successivo**.

1. Verificare le impostazioni. Quindi scegli **Create rule** (Crea regola). 

## Fase 4: Test della regola
<a name="mediaconvert_sns_test_rule"></a>

Per testare la regola, invia un processo che genererà sicuramente un errore. Ad esempio, specifica una posizione di input che non esiste. Se la regola dell'evento è configurata correttamente, riceverai un'e-mail con il messaggio di testo dell'evento in pochi minuti. 

**Per testare la regola**

1. Apri la AWS Elemental MediaConvert console in [https://console.aws.amazon.com/mediaconvert.](https://console.aws.amazon.com/mediaconvert)

1. Invia un nuovo lavoro. MediaConvert Per ulteriori informazioni, consulta [Tutorial: Configurazione delle impostazioni del lavoro](setting-up-a-job.md).

1. Controlla l'account e-mail che hai specificato al momento della configurazione dell'argomento Amazon SNS. Verifica di aver ricevuto una notifica tramite e-mail per l'errore del processo.

# Monitoraggio dei progressi MediaConvert del lavoro
<a name="how-mediaconvert-jobs-progress"></a>

MediaConvert fornisce informazioni sullo stato di ogni lavoro che crei. È possibile monitorare lo stato di un lavoro per determinare cosa sta succedendo al lavoro, monitorarne lo stato di avanzamento o risolvere i problemi.

**Topics**
+ [Stati del processo](#job-statuses)
+ [Come trovare lo stato di un lavoro](#finding-job-status)
+ [Fasi del lavoro](#job-phase)

## Stati del processo
<a name="job-statuses"></a>

Ogni lavoro inviato passerà attraverso una serie di diversi stati possibili. I lavori riusciti terminano con uno `COMPLETE` status, mentre i lavori non riusciti terminano con uno status `ERROR` o`CANCELED`.

**Lavori di successo**  
Un processo di successo comporta la scrittura di tutti i relativi output nel tuo bucket Amazon S3. L'elenco seguente contiene dettagli sui diversi stati a cui sono sottoposti i lavori di successo:  

1. `SUBMITTED`: Lavori creati nella MediaConvert console o tramite un'[https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-http-methods](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-http-methods)operazione di cui l'elaborazione MediaConvert non è stata avviata.

1. `INPUT_INFORMATION`: MediaConvert leggi i dettagli sui tuoi input.

1. `PROGRESSING`: MediaConvert ha iniziato a elaborare il tuo lavoro.

1. `STATUS_UPDATE`: MediaConvert sta elaborando il tuo lavoro da almeno un minuto o più. I lavori con questo stato attraversano tre diverse *fasi lavorative*. Per ulteriori informazioni, consulta [Fasi del lavoro](#job-phase).

1. `COMPLETE`: hai MediaConvert completato il tuo lavoro e tutti i tuoi output sono stati salvati nel tuo bucket Amazon S3.
I lavori di successo possono includere [`NEW_WARNING`](ev_status_new_warning.md)anche i nostri status. [`QUEUE_HOP`](ev_status_new_warning.md)

**Lavori infruttuosi**  
Un processo non riuscito non comporta la scrittura di alcun output nel bucket Amazon S3, sebbene inizialmente il processo possa procedere in modo simile a quello di un processo riuscito. I lavori non riusciti hanno uno dei due stati seguenti:  
+ `ERROR`: si è MediaConvert verificato un problema durante l'elaborazione del tuo lavoro. Per ulteriori informazioni, consulta [Codici di errore](mediaconvert_error_codes.md).
+ `CANCELED`: Hai annullato un lavoro nella MediaConvert console o tramite un'`CancelJob`operazione.

## Come trovare lo stato di un lavoro
<a name="finding-job-status"></a>

Per visualizzare un elenco di tutti gli stati dei lavori nella regione corrente, apri la pagina [Lavori](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) nella MediaConvert console. Oppure invia un'`GetJob``ListJobs`operazione.

AWS CloudTrail registra i dettagli di ogni richiesta di creazione di lavoro effettuata. CloudTrail emette un EventBridge evento per i `SUBMITTED` lavori solo se crei anche un CloudTrail trail. Per ulteriori informazioni, consulta [Lavorare con i CloudTrail percorsi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html) e [Accesso agli eventi AWS di servizio tramite AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).

MediaConvert emette un EventBridge evento quando un lavoro inizia l'elaborazione e quindi ogni volta che il suo stato cambia, ad esempio se passa da `PROGRESSING` a `COMPLETE` o`ERROR`. Per un elenco degli EventBridge eventi, vedere[Elenco degli MediaConvert EventBridge eventi](mediaconvert_event_list.md).

## Fasi del lavoro
<a name="job-phase"></a>

Se lo stato di un lavoro dura più `PROGRESSING` di un minuto, MediaConvert emette un `STATUS_UPDATE` evento con la *fase* lavorativa corrente. Una fase di lavoro fornisce dettagli su ciò che sta accadendo con un lavoro. Le fasi del Job procedono secondo l'ordine seguente:

1. `PROBING`: Quando il processo è in `PROBING` fase, MediaConvert legge le informazioni dai file di input necessarie al servizio per la transcodifica.

1. `TRANSCODING`: Quando il lavoro è in `TRANSCODING` fase, il servizio demuxa, decodifica, codifica e remux i contenuti. In alcuni processi, in questa fase il servizio inizia il caricamento degli output nel bucket Amazon S3 di output. La fase termina quando tutta la transcodifica viene completata.

1. `UPLOADING`: Quando il processo è in `UPLOADING` fase di completamento, il servizio carica gli output transcodificati nel bucket di output Amazon S3. Nel caso di output che il servizio inizia a caricare durante la `TRANSCODING` fase, la fase inizia al termine della transcodifica`UPLOADING`. Continua fino al termine di tutti i caricamenti.

Per visualizzare la fase di un lavoro, apri la pagina [Lavori](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) nella MediaConvert console, controlla l'[`STATUS_UPDATE` EventBridgeevento](ev_status_status_update.md) o invia un'`ListJobs`operazione `GetJob` OR.

# Elenco degli MediaConvert EventBridge eventi
<a name="mediaconvert_event_list"></a>

AWS Elemental MediaConvert invia un evento ad Amazon EventBridge quando lo stato di un lavoro cambia. Puoi creare [EventBridgeregole](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) per ognuno di questi eventi. 

La maggior parte dei lavori emetterà solo alcuni di questi eventi, i più comuni dei quali sono:`INPUT_INFORMATION`,`PROGRESSING`, e`COMPLETE`.

Per ulteriori informazioni su ciascun tipo di evento, scegli il link nella colonna **Evento**.


**MediaConvert eventi**  

| Event | Inviato quando | Contiene | 
| --- | --- | --- | 
|  [INPUT\$1INFORMATION](ev_status_input_information.md)  |  Subito dopo MediaConvert inizia l'elaborazione del lavoro.  |  Informazioni sui supporti, ad esempio altezza e larghezza dei fotogrammi, frequenza dei fotogrammi e codec.  MediaConvert Informazioni provenienti da tutti gli input in un singolo evento.  | 
|  [PROGREDENDO](ev_status_progressing.md)  |  Un processo passa dallo stato `SUBMITTED` allo stato `PROGRESSING`.   |  Dettagli di base sul lavoro.  | 
| [STATUS\$1UPDATE](ev_status_status_update.md) | Circa un minuto dopo l' MediaConvert inizio dell'elaborazione del lavoro. Successivamente viene inviato all'incirca ogni minuto, fino al completamento del lavoro o alla comparsa di un errore. | Avanzamento del processo espresso nel numero di fotogrammi transcodificati dall'inizio del processo. | 
|  [COMPLETA](ev_status_complete.md)  |  Un lavoro viene completato e MediaConvert scrive correttamente tutti gli output senza errori.  |  Avvisi e informazioni di output sul processo completato.  | 
| [CANCELED (ANNULLATO)](ev_status_canceled.md) | Un lavoro viene annullato. | Dettagli di base del lavoro. | 
|  [ERRORE](ev_status_error.md)  |  Si è verificato un errore in un processo. Almeno un output include un errore.  |  Il codice o i codici di errore e gli eventuali messaggi. Include qualsiasi altra informazione temporanea sul lavoro relativo allo stato di errore del lavoro.   | 
|  [NEW\$1WARNING](ev_status_new_warning.md)  |  Si verifica una condizione di avviso.  |  Il codice o i codici di avviso e gli eventuali messaggi di avviso.  | 
|  [QUEUE\$1HOP](ev_status_queue_hop.md)  |  Quando un lavoro salta in coda.  |   ARNs Per entrambe le code e per la priorità del lavoro all'interno della coda.   | 

**Nota**  
MediaConvert non emette alcun evento. `SUBMITTED` Per ricevere un EventBridge evento ogni volta che si effettua una chiamata API, incluse le chiamate dalla MediaConvert console, è necessario creare un AWS CloudTrail percorso. Per ulteriori informazioni, vedere [Accesso agli eventi AWS di servizio tramite AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) e [Utilizzo dei CloudTrail percorsi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html).

Quando MediaConvert invia un evento a EventBridge, nel JSON risultante sono presenti i seguenti campi.
+ **versione** — Attualmente 0 (zero) per tutti gli eventi.
+ **id** — Un UUID di quarta versione generato per ogni evento.
+ **tipo di dettaglio** — Il tipo di evento inviato.
+ **origine** — Identifica il servizio che ha originato l'evento.
+ **account**: l' Account AWS ID a 12 cifre che ha eseguito il processo.
+ **time** (Ora): momento in cui si è verificato l'evento.
+ **regione**: identifica il processo Regione AWS .
+ **resources**: un array JSON che contiene l'Amazon Resource Name (ARN) del job.
+ **dettaglio**: un oggetto JSON che contiene informazioni sul lavoro.

Le seguenti sezioni contengono i dettagli dei messaggi di evento, le risposte JSON e i modelli di eventi per ogni EventBridge evento generato MediaConvert .

**Topics**
+ [Eventi con stato INPUT\$1INFORMATION](ev_status_input_information.md)
+ [Eventi con stato PROGRESSIVO](ev_status_progressing.md)
+ [Eventi con stato STATUS\$1UPDATE](ev_status_status_update.md)
+ [Eventi con stato COMPLETO](ev_status_complete.md)
+ [Eventi con stato ANNULLATO](ev_status_canceled.md)
+ [Eventi con stato di ERRORE](ev_status_error.md)
+ [Eventi con stato NEW\$1WARNING](ev_status_new_warning.md)
+ [Eventi con stato QUEUE\$1HOP](ev_status_queue_hop.md)

# Eventi con stato INPUT\$1INFORMATION
<a name="ev_status_input_information"></a>

MediaConvert invia l'evento `INPUT_INFORMATION` dopo l'inizio dell'elaborazione di un processo e dopo la MediaConvert lettura delle informazioni sull'input. L'evento contiene principalmente informazioni multimediali sull'input, come l'altezza e la larghezza dei frame, la frequenza dei fotogrammi e il codec.

 MediaConvert include informazioni su tutti gli input in un singolo evento.

Il seguente codice JSON è un esempio di evento contenente lo `INPUT_INFORMATION` stato di un lavoro con un singolo input.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:07:12Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671476818694-phptj0"
    ],
    "detail": {
        "timestamp": 1671476832075,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671476818694-phptj0",
        "status": "INPUT_INFORMATION",
        "userMetadata": {},
        "inputDetails": [
            {
                "id": 1,
                "uri": "s3://amzn-s3-demo-bucket/file/file.mp4",
                "audio": [
                    {
                        "channels": 2,
                        "codec": "AAC",
                        "language": "UND",
                        "sampleRate": 44100,
                        "streamId": 2
                    }
                ],
                "video": [
                    {
                        "bitDepth": 8,
                        "codec": "H_264",
                        "colorFormat": "YUV_420",
                        "fourCC": "avc1",
                        "frameRate": 24,
                        "height": 1080,
                        "interlaceMode": "PROGRESSIVE",
                        "sar": "1:1",
                        "standard": "UNSPECIFIED",
                        "streamId": 1,
                        "width": 1920
                    }
                ]
            }
        ]
    }
}
```

È possibile utilizzare il codice JSON di esempio seguente per creare un modello di EventBridge eventi per lavori con uno stato di. `INPUT_INFORMATION`

```
{
  "source": ["aws.mediaconvert"],
  "detail-type": ["MediaConvert Job State Change"],
  "detail": {
    "status": ["INPUT_INFORMATION"]
  }
}
```

# Eventi con stato PROGRESSIVO
<a name="ev_status_progressing"></a>

MediaConvert invia l'evento per `PROGRESSING` quando un lavoro si sposta da `SUBMITTED` uno stato all'`PROGRESSING`altro.

**Nota**  
Dopo che un job è rimasto nello `PROGRESSING` stato per 48 ore, il servizio lo imposta in uno `ERROR` stato e smette di funzionare. Non vengono fatturati processi che terminano in uno stato `ERROR`.

Il seguente codice JSON è un esempio di evento contenente lo `PROGRESSING` stato di un lavoro.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:20:21Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
    ],
    "detail": {
        "timestamp": 1671477621654,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671477617078-2886ye",
        "status": "PROGRESSING",
        "userMetadata": {}
    }
}
```

È possibile utilizzare il codice JSON di esempio seguente per creare un modello di EventBridge eventi per lavori con uno stato di. `PROGRESSING`

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["PROGRESSING"]
    }
}
```

# Eventi con stato STATUS\$1UPDATE
<a name="ev_status_status_update"></a>

MediaConvert invia l'evento per `STATUS_UPDATE` circa un minuto dopo l'inizio dell'elaborazione di un processo. Per impostazione predefinita, gli aggiornamenti vengono inviati circa ogni minuto a partire da quel momento, finché il servizio termina la transcodifica o rileva un errore.

È anche possibile specificare una frequenza di aggiornamento diversa nel processo, con l'impostazione **Status update interval (Intervallo aggiornamento di stato)**. Per aggiornamenti più frequenti, puoi scegliere 10, 12, 15, 20 o 30 secondi. Per un numero inferiore di aggiornamenti, puoi scegliere da 2 a 10 minuti, con incrementi di un minuto. Per ulteriori informazioni, consulta [Regola l'intervallo di aggiornamento dello stato](adjusting-the-status-update-interval.md).

Un `STATUS_UPDATE` evento contiene informazioni sulla fase attuale del tuo lavoro. Se disponibile, contiene la percentuale di completamento del lavoro e della fase.

Le fasi del processo sono le seguenti:
+ Durante`PROBING`, il servizio legge le informazioni sull'input mentre si prepara alla transcodifica. 
+ Nella fase `TRANSCODING`, il servizio demoltiplica, decodifica, codifica e rimoltiplica i contenuti. In alcuni lavori, il servizio inizia a caricare gli output nel bucket Amazon S3 di output anche durante questa fase. La fase termina quando tutta la transcodifica viene completata.
+ Nella fase `UPLOADING`, il servizio carica i rimanenti output transcodificati nel bucket Amazon S3.

Il seguente codice JSON è un esempio di evento contenente lo stato di un lavoro. `STATUS_UPDATE`

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:21:21Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
    ],
    "detail": {
        "timestamp": 1671477681737,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671477617078-2886ye",
        "status": "STATUS_UPDATE",
        "userMetadata": {},
        "framesDecoded": 353,
        "jobProgress": {
            "phaseProgress": {
                "PROBING": {
                    "status": "COMPLETE",
                    "percentComplete": 100
                },
                "TRANSCODING": {
                    "status": "PROGRESSING",
                    "percentComplete": 2
                },
                "UPLOADING": {
                    "status": "PENDING",
                    "percentComplete": 0
                }
            },
            "jobPercentComplete": 7,
            "currentPhase": "TRANSCODING",
            "retryCount": 0
        }
    }
}
```

È possibile utilizzare il codice JSON di esempio seguente per creare un modello di EventBridge eventi per lavori con uno stato di. `STATUS_UPDATE`

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["STATUS_UPDATE"]
    }
}
```

# Regola l'intervallo di aggiornamento dello stato
<a name="adjusting-the-status-update-interval"></a>

Per impostazione predefinita, AWS Elemental MediaConvert invia `STATUS_UPDATE` eventi ad Amazon all' EventBridge incirca una volta al minuto. Questi aggiornamenti di stato forniscono informazioni sull'avanzamento del tuo lavoro. È possibile modificare l'intervallo di aggiornamento dello stato specificando una frequenza di aggiornamento diversa nel lavoro.

**Per specificare la frequenza STATUS\$1UPDATE**

1. Nella pagina **Crea lavoro**, nel riquadro **Job** a sinistra, nella sezione **Impostazioni lavoro**, scegli **AWS integrazione**.

1. Nella sezione di **AWS integrazione** a destra, per **Intervallo di aggiornamento dello stato (sec)**, scegli **l'intervallo, in secondi, tra gli** aggiornamenti.

Se utilizzi l'API o un SDK, puoi trovare questa impostazione nel file JSON del tuo lavoro. Il nome dell'impostazione è. [statusUpdateInterval](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-createjobrequest-statusupdateinterval)

# Eventi con stato COMPLETO
<a name="ev_status_complete"></a>

MediaConvert invia l'evento per `COMPLETE` quando tutti gli output vengono scritti su Amazon S3 senza errori. Contiene sia avvisi che informazioni di output per il lavoro completato. Per ulteriori informazioni sui nomi e i percorsi dei file di output, vedere[Nomi e percorsi dei file di output](output-file-names-and-paths.md).

Il seguente codice JSON è un esempio di evento contenente lo `COMPLETE` stato di un lavoro.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2022-12-19T19:07:12Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2::jobs/1671476818694-phptj0"
    ],
    "detail": {
        "timestamp": 1671476832124,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1671476818694-phptj0",
        "status": "COMPLETE",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/file/file.mp4"
                        ],
                        "durationInMs": 30041,
                        "videoDetails": {
                            "widthInPx": 1920,
                            "heightInPx": 1080,
                            "qvbrAvgQuality": 7.38,
                            "qvbrMinQuality": 7,
                            "qvbrMaxQuality": 8,
                            "qvbrMinQualityLocation": 2168,
                            "qvbrMaxQualityLocation": 25025
                        }
                    }
                ],
                "type": "FILE_GROUP"
            }
        ],
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ]
    }
}
```

`COMPLETE`gli eventi contengono informazioni aggiuntive sul lavoro e sui risultati. La tabella seguente elenca e descrive le diverse proprietà disponibili nei dettagli dei messaggi relativi agli eventi di lavoro.


**DETTAGLI COMPLETI del messaggio dell'evento**  

| Proprietà | Tipo di dati | Informazioni | 
| --- | --- | --- | 
|  `paddingInserted`  |  intero  | La durata totale dei frame vuoti MediaConvert inseriti in tutti gli output del lavoro, in millisecondi. La spaziatura interna video inserisce cornici vuote per aiutare a mantenere allineate le durate audio e video. `paddingInserted`I valori elevati indicano che sono state inserite più cornici vuote. Questi valori mostrano anche fino a che punto le tracce audio in ingresso iniziano tardi, finiscono presto o entrambe le cose. | 
|  `qvbrAvgQuality`  |  virgola mobile  |  La qualità video media dell'uscita QVBR (Quality-Defined Variable Bitrate). Inclusa solo per le uscite QVBR.  | 
|  `qvbrMinQuality`  |  virgola mobile  |  La qualità video minima rilevata nell'uscita QVBR.  Inclusa solo per le uscite QVBR.  | 
|  `qvbrMaxQuality`  |  virgola mobile  |  La massima qualità video rilevata nell'uscita QVBR. Inclusa solo per le uscite QVBR.  | 
|  `qvbrMinQualityLocation`  |  intero  |  La posizione dell'output in cui `qvbrMinQuality` è stata rilevata, in millisecondi. È possibile utilizzarlo `qvbrMinQualityLocation` durante la revisione della qualità del video in uscita e dell'utilizzo della larghezza di banda. Incluso solo per le uscite QVBR.  | 
|  `qvbrMaxQualityLocation`  |  intero  |  La posizione dell'output in cui `qvbrMaxQuality` è stata rilevata, in millisecondi. È possibile utilizzarlo `qvbrMaxQualityLocation` durante la revisione della qualità del video in uscita e dell'utilizzo della larghezza di banda. Incluso solo per le uscite QVBR.  | 
|  `warnings`  code  count  |  array intero intero  |  Tutti i codici di avviso visualizzati nel lavoro e il numero di volte in cui si sono verificati. Per ulteriori informazioni, consulta [Codici di avviso](warning_codes.md).  | 
|  `blackVideoDetected`  |  intero  |  La durata totale dei fotogrammi video neri nelle uscite, presenti anche negli ingressi, in millisecondi. `blackVideoDetected`non include i fotogrammi neri inseriti da. MediaConvert  | 
|  `blackVideoSegments`  `start`  `end`  |  array intero intero  |  La posizione o le posizioni dell'output in cui sono stati rilevati i fotogrammi video neri. Ogni segmento di video nero nell'output viene mostrato con un inizio e una fine diversi. `blackVideoSegments`non include le cornici nere inserite da MediaConvert.  | 
|  `averageBitrate`  |  intero  |  Il bitrate medio dell'uscita video, calcolato dividendo la durata per i bit totali.  | 

È possibile utilizzare il codice JSON di esempio seguente per creare un pattern di EventBridge eventi per lavori con uno stato di. `COMPLETE`

```
{
  "source": ["aws.mediaconvert"],
  "detail-type": ["MediaConvert Job State Change"],
  "detail": {
    "status": ["COMPLETE"]
  }
}
```

# Nomi e percorsi dei file di output
<a name="output-file-names-and-paths"></a>

La `COMPLETE` notifica di EventBridge lavoro include dettagli sull'output in JSON. Queste informazioni includono i nomi dei file e i percorsi per gli output del job, inclusi i manifesti e le risorse multimediali.

I file AWS Elemental MediaConvert creati dipendono dai gruppi di output impostati nel lavoro. Ad esempio, i pacchetti DASH ISO contengono un manifest .mpd e file di frammenti multimediali .mp4.

È possibile trovare informazioni sul nome e sul percorso del file di output nelle seguenti proprietà:

`playlistFilePaths`  
Un elenco dei percorsi dei file Amazon S3 alle playlist multivarianti.

`outputFilePaths`  
Il percorso del file multimediale o manifest, a seconda del tipo di gruppo di output.

`type`  
Il tipo di gruppo di output, che determina quali file sono elencati in `playlistFilePaths` e in `outputFilePaths`.

La tabella seguente riepiloga i valori di queste proprietà, in funzione del tipo di gruppo di output.


| Tipo | playlistFilePaths | outputFilePaths | 
| --- | --- | --- | 
| FILE\$1GROUP (output standard) | non restituiti |  Nome e percorso del file multimediale. Ad esempio: `s3://amzn-s3-demo-bucket/file/file.mp4`  | 
| FILE\$1GROUP (con output di acquisizione di frame aggiuntivo) | non restituiti |  Nome e percorso dell'immagine finale acquisita. Ad esempio: `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`  | 
| HLS\$1GROUP |  Nome del file e percorso della playlist multivariante. Ad esempio: `s3://amzn-s3-demo-bucket/hls/main.m3u8`  |  Nome del file e percorso dei manifesti per i singoli output. Esempi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/mediaconvert/latest/ug/output-file-names-and-paths.html)  | 
| DASH\$1ISO\$1GROUP |  Nome del file e percorso del manifesto. Ad esempio: `s3://amzn-s3-demo-bucket/dash/1.mpd`  | non restituiti | 
| CMAF\$1GROUP |  Nome e percorso del file per ciascuno dei manifesti di primo livello. Esempi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/mediaconvert/latest/ug/output-file-names-and-paths.html)  | non restituiti | 
| MS\$1SMOOTH\$1GROUP |  Nome e percorso del manifesto sul lato server. Ad esempio: `s3://amzn-s3-demo-bucket/smooth/1.ism`  |  Nome del file e percorso dei manifesti video per ciascuna delle singole uscite. Esempi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/mediaconvert/latest/ug/output-file-names-and-paths.html)  | 

Per risposte di esempio in JSON per ogni tipo di gruppo di output, consultare gli argomenti seguenti:

**Topics**
+ [Gruppo di file](file-group.md)
+ [Gruppo di file con un output di acquisizione dei fotogrammi](file-group-with-frame-capture-output.md)
+ [Gruppo Apple HLS](apple-hls-group.md)
+ [Gruppo ISO DASH](dash-iso-group.md)
+ [Gruppo CMAF](cmaf-group.md)
+ [Gruppo Microsoft Smooth Streaming](microsoft-smooth-streaming-group.md)

# Gruppo di file
<a name="file-group"></a>

Di seguito è riportato un EventBridge esempio di evento Amazon per un lavoro con uno `COMPLETE` stato. L'esempio include informazioni sul percorso del file di output per un gruppo di file.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            "start": 0,
            "end": 10
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/file/file.mp4"
                        ],
                        "durationInMs": 180041,
                        "videoDetails": {
                            "averageBitrate": 200000,
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "qvbrAvgQuality": 7.38,
                            "qvbrMinQuality": 7,
                            "qvbrMaxQuality": 8,
                            "qvbrMinQualityLocation": 2168,
                            "qvbrMaxQualityLocation": 25025
                        },
                    }
                ],
                "type": "FILE_GROUP"
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ],
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**Nota**  
Le statistiche QVBR sono disponibili solo quando l'uscita video utilizza il controllo della velocità QVBR (Quality-Defined Variable Bitrate).

# Gruppo di file con un output di acquisizione dei fotogrammi
<a name="file-group-with-frame-capture-output"></a>

Questa guida fornisce un EventBridge esempio di evento Amazon per un lavoro con uno `COMPLETE` status. Mostra anche le informazioni sul percorso del file di output per un gruppo di file con un output di acquisizione dei frame. 

Un'*uscita di acquisizione di fotogrammi* è un'uscita configurata per creare immagini fisse di video. L'impostazione è simile a quella di un normale **gruppo di output File** group. Tuttavia, rimuovete il componente audio, scegliete **Nessun contenitore** per il contenitore, quindi scegliete **Frame capture to JPEG** per il codec video.

**Nota**  
Potete creare uscite di acquisizione di fotogrammi solo in lavori che dispongono anche di un'uscita audio e video normale. MediaConvert non supporta lavori che consistono solo in un'uscita di acquisizione di fotogrammi.

Quando create un output di acquisizione di frame, lo `COMPLETE` stato include la `outputFilePaths` proprietà. Questo indica il nome del file e il percorso dell'immagine finale acquisita. 

**Suggerimento**  
Poiché il servizio include la numerazione automatica nei nomi di file dell'acquisizione di frame, è possibile desumere tutti i nomi delle immagini da quella definitiva. Ad esempio, se il tuo valore `outputFilePaths` è `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`, puoi desumere che ci sono 35 altre immagini nella stessa posizione, denominate `file.0000001`, `file.0000002` e così via.

Di seguito è riportato un EventBridge esempio di evento per un lavoro con uno `COMPLETE` stato. Include informazioni sul percorso del file di output per un gruppo di file con un output di acquisizione di frame. 

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
                {
                    "start": 0,
                    "end": 10
                }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg"
                        ],
                        "durationInMs": 185000,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720
                        }
                    }
                ],
                "type": "FILE_GROUP"
            },
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/file/file.mp4"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "FILE_GROUP"
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**Nota**  
Le statistiche QVBR (Quality-Defined Variable Bitrate) sono disponibili solo quando l'uscita video utilizza il controllo della velocità QVBR.

# Gruppo Apple HLS
<a name="apple-hls-group"></a>

Di seguito è riportato un EventBridge esempio di evento Amazon per un lavoro con uno `COMPLETE` stato. Include informazioni sul percorso del file di output per un gruppo Apple HLS.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/hls/mainv2.m3u8"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 426,
                            "heightInPx": 240,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    },
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/hls/mainv1.m3u8"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "HLS_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/hls/main.m3u8"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**Nota**  
Le statistiche QVBR (Quality-Defined Variable Bitrate) sono disponibili solo quando l'uscita video utilizza il controllo della velocità QVBR.

# Gruppo ISO DASH
<a name="dash-iso-group"></a>

Di seguito è riportato un EventBridge esempio di evento Amazon per un lavoro con uno `COMPLETE` stato. Include informazioni sul percorso del file di output per un gruppo ISO DASH.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "DASH_ISO_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/dash/1.mpd"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**Nota**  
Le statistiche QVBR (Quality-Defined Variable Bitrate) sono disponibili solo quando l'uscita video utilizza il controllo della velocità QVBR.

# Gruppo CMAF
<a name="cmaf-group"></a>

Di seguito è riportato un EventBridge esempio di evento per un lavoro con uno `COMPLETE` stato. Include informazioni sul percorso del file di output per un gruppo CMAF.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                            "durationInMs": 180041,
                            "blackVideoDurationInMs": 0,
                            "videoDetails": {
                                "widthInPx": 1280,
                                "heightInPx": 720,
                                "averageQVBRScore": 7.38,
                                "minimumQVBRScore": 7,
                                "maximumQVBRScore": 8,
                                "minimumQVBRScoreLocationInMs": 2168,
                                "maximumQVBRScoreLocationInMs": 25025
                            }
                    }
                ],
                "type": "CMAF_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/cmaf/1.mpd",
                    "s3://amzn-s3-demo-bucket/cmaf/1.m3u8"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**Nota**  
Le statistiche QVBR (Quality-Defined Variable Bitrate) sono disponibili solo quando l'uscita video utilizza il controllo della velocità QVBR.

# Gruppo Microsoft Smooth Streaming
<a name="microsoft-smooth-streaming-group"></a>

Di seguito è riportato un EventBridge esempio di evento per un lavoro con uno `COMPLETE` stato. Include informazioni sul percorso del file di output per un gruppo Microsoft Smooth Streaming.

```
{
    "detail": {
        "status": "COMPLETE",
        "paddingInserted": 0,
        "blackVideoDetected": 10,
        "blackSegments": [
            {
                "start": 0,
                "end": 10
            }
        ],
        "outputGroupDetails": [
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://amzn-s3-demo-bucket/smooth/1_va.ismv"
                        ],
                        "durationInMs": 180041,
                        "blackVideoDurationInMs": 0,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 534,
                            "averageQVBRScore": 7.38,
                            "minimumQVBRScore": 7,
                            "maximumQVBRScore": 8,
                            "minimumQVBRScoreLocationInMs": 2168,
                            "maximumQVBRScoreLocationInMs": 25025
                        }
                    }
                ],
                "type": "MS_SMOOTH_GROUP",
                "playlistFilePaths": [
                    "s3://amzn-s3-demo-bucket/smooth/1.ism"
                ]
            }
        ],
        "timestamp": 1536964380391,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1536964333549-opn151",
        "userMetadata": {},
        "warnings": [
            {
                "code": 000000,
                "count": 1
            }
        ]
    },
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-09-14T21:54:31Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
    ]
}
```

**Nota**  
Le statistiche QVBR (Quality-Defined Variable Bitrate) sono disponibili solo quando l'uscita video utilizza il controllo della velocità QVBR.

# Eventi con stato ANNULLATO
<a name="ev_status_canceled"></a>

MediaConvert invia l'evento per il momento in `CANCELED` cui il lavoro viene annullato. Contiene dettagli di base sul lavoro`timestamp`, tra cui`accountID`, `queue``jobId`, e. `userMetadata`

Il seguente codice JSON è un esempio di evento contenente lo `CANCELED` stato di un lavoro.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1515368087458-qnoxtd",
        "status": "CANCELED",
        "userMetadata": {}
    }
}
```

È possibile utilizzare il codice JSON di esempio seguente per creare un modello di EventBridge eventi per lavori con uno stato di. `CANCELED`

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["CANCELED"]
    }
}
```

# Eventi con stato di ERRORE
<a name="ev_status_error"></a>

MediaConvert invia l'evento per `ERROR` quando almeno un output presenta un errore. Contiene il codice o i codici di errore, i messaggi e gli avvisi o altre informazioni temporanee relative allo stato di errore del lavoro. Per ulteriori informazioni sui codici di errore, vedere. [Codici di errore](mediaconvert_error_codes.md)

Il seguente codice JSON è un esempio di evento contenente lo `ERROR` stato di un processo.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1515368087458-qnoxtd",
        "status": "ERROR",
        "errorCode": 1040,
        "errorMessage": "Example error message",
        "userMetadata": {}
    }
}
```

È possibile utilizzare il codice JSON di esempio seguente per creare un modello di EventBridge eventi per lavori con uno stato di. `ERROR`

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["ERROR"]
    }
}
```

# Eventi con stato NEW\$1WARNING
<a name="ev_status_new_warning"></a>

MediaConvert invia un evento per `NEW_WARNING` quando si verifica una condizione di avviso. Una condizione di avviso non impedisce l'esecuzione del processo. Contiene l'ARN della coda di invio, l'ID del lavoro e un messaggio di avviso. I messaggi di avviso informano l'utente sulle condizioni che non interrompono il processo, ma potrebbero indicare che il processo non procede come previsto.

Ad esempio, un lavoro impostato per saltare le code raggiunge il tempo di attesa specificato, ma non può saltare.

`NEW_WARNING`contiene solo il messaggio di avviso più recente. Non riporta gli avvisi precedenti, anche se tali condizioni di avviso sono ancora in vigore.

Per ulteriori informazioni sui messaggi di avviso, consulta[Codici di avviso](warning_codes.md).

Il seguente codice JSON è un esempio di evento contenente lo `NEW_WARNING` stato di un lavoro.

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "jobId": "1515368087458-qnoxtd",
        "status": "NEW_WARNING",
        "warningCode": "000000",
        "warningMessage": "Example warning message",
        "userMetadata": {}
    }
}
```

È possibile utilizzare il codice JSON di esempio seguente per creare un modello di EventBridge eventi per lavori con uno stato di. `NEW_WARNING`

```
{
  "source": ["aws.mediaconvert"],
  "detail-type": ["MediaConvert Job State Change"],
  "detail": {
    "status": ["NEW_WARNING"]
  }
}
```

# Eventi con stato QUEUE\$1HOP
<a name="ev_status_queue_hop"></a>

MediaConvert invia l'`QUEUE_HOP`evento quando un lavoro salta in coda. Contiene le informazioni ARNs relative a entrambe le code e la priorità del lavoro all'interno delle code.

Entrambi `priority` `previousPriority` saranno uguali a meno che la configurazione del queue hopping non specifichi una nuova priorità da assegnare al lavoro mentre salta le code.

Il codice JSON seguente è un esempio di evento contenente lo stato di un lavoro. `QUEUE_HOP`

```
{
    "version": "0",
    "id": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "detail-type": "MediaConvert Job State Change",
    "source": "aws.mediaconvert",
    "account": "111122223333",
    "time": "2018-01-07T23:35:20Z",
    "region": "us-west-2",
    "resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
    "detail": {
        "timestamp": 1515368120764,
        "accountId": "111122223333",
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
        "previousQueue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Alternate",
        "priority": 0,
        "previousPriority": 0,
        "jobId": "1515368087458-qnoxtd",
        "status": "QUEUE_HOP",
        "userMetadata": {}
    }
}
```

È possibile utilizzare il codice JSON di esempio seguente per creare un modello di EventBridge eventi per lavori con uno stato di. `QUEUE_HOP`

```
{
    "source": ["aws.mediaconvert"],
    "detail-type": ["MediaConvert Job State Change"],
    "detail": {
        "status": ["QUEUE_HOP"]
    }
}
```



# Utilizzo CloudWatch con MediaConvert
<a name="cloudwatch_metrics"></a>

Puoi usare Amazon CloudWatch per raccogliere metriche sui tuoi AWS Elemental MediaConvert lavori. Ecco alcuni esempi di cosa puoi fare con CloudWatch:

**Ottieni dettagli su richieste, code, lavori e risultati**  
Le metriche sono raggruppate in base alla dimensione, incluse le metriche Operation, le metriche Queue e le metriche Job.  
+ Le *metriche operative* includono tutti gli errori che si verificano quando si interagisce con. MediaConvert
+ Le *metriche di coda* includono dettagli su tutti i lavori in una determinata coda, come il numero totale di lavori o la durata totale degli output.
+ Le *metriche Job* includono dettagli sui risultati che puoi utilizzare per identificare tendenze, statistiche o potenziali problemi con il tuo flusso di lavoro video.
Per ulteriori informazioni, consulta [Elenco di metriche MediaConvert CloudWatch](metrics.md).

**Crea CloudWatch dashboard e allarmi**  
Puoi creare CloudWatch dashboard per tenere traccia degli elementi relativi a una coda di lavoro. Ad esempio, è possibile tenere traccia dei lavori di transcodifica completati o con errori. Puoi anche utilizzare metriche come la creazione di allarmi `StandbyTime` per rilevare se c'è un grosso arretrato per una coda di lavoro. Per ulteriori informazioni, consulta [Creazione di dashboard e allarmi per l'utilizzo di AWS Elemental MediaConvert Amazon](https://aws.amazon.com/blogs/media/creating-dashboards-and-alarms-for-aws-elemental-mediaconvert-using-amazon-cloudwatch/). CloudWatch

**Topics**
+ [Elenco di metriche MediaConvert CloudWatch](metrics.md)

# Elenco di metriche MediaConvert CloudWatch
<a name="metrics"></a>

AWS Elemental MediaConvert invia le seguenti metriche a CloudWatch alla fine di ogni lavoro.


| Nome parametro | Unità | Description | 
| --- | --- | --- | 
|  `Errors`  | Conteggio | Tiene traccia degli errori riscontrati durante una particolare chiamata API.Le operazioni includono: `CreateJob``GetJob`,`ListJobs`,`ListPresets`,`ListQueues`,`ListTagsForResource`, e `Subscribe` | 
|  `AudioOutputDuration`  | Millisecondi |  Il numero di millisecondi di uscita di solo audio per una coda.  | 
|  `SDOutputDuration`  | Millisecondi |  Il numero di millisecondi di uscita a definizione standard (SD) per una coda. [Per la definizione di ogni categoria di risoluzione video, consulta la pagina dei prezzi.AWS Elemental MediaConvert](https://aws.amazon.com/mediaconvert/pricing)  | 
|  `HDOutputDuration`  | Millisecondi |  Il numero di millisecondi di uscita ad alta definizione (HD) per una coda. [Per la definizione di ogni categoria di risoluzione video, consulta la pagina dei prezzi.AWS Elemental MediaConvert](https://aws.amazon.com/mediaconvert/pricing)  | 
|  `UHDOutputDuration`  | Millisecondi |  Il numero di millisecondi di uscita ultra-high-definition (UHD) per una coda. [Per la definizione di ogni categoria di risoluzione video, consulta la pagina dei prezzi.AWS Elemental MediaConvert](https://aws.amazon.com/mediaconvert/pricing)  | 
|  `8KOutputDuration`  | Millisecondi |  Il numero di millisecondi di output 8K per una coda. [Per la definizione di ogni categoria di risoluzione video, consulta la pagina dei prezzi.AWS Elemental MediaConvert](https://aws.amazon.com/mediaconvert/pricing)  | 
|  `JobsCompletedCount`  | Conteggio |  Il numero di lavori completati in una coda.  | 
|  `JobsCanceled`  | Conteggio |  Il numero di lavori annullati in una coda.  | 
|  `JobsErroredCount`  | Conteggio |  Il numero di processi non riusciti a causa di input non validi, ad esempio una richiesta di transcodifica di un file che non si trova nel bucket di input specificato.  | 
|  `StandbyTime`  | Millisecondi |  La quantità di tempo in cui un lavoro rimane in coda prima dell' MediaConvert inizio dell'elaborazione, in millisecondi.  | 
|  `TranscodingTime`  | Millisecondi |  Il numero di millisecondi necessari per completare la transcodifica. MediaConvert   | 
|  `BlackVideoDetected`  | Millisecondi |  La durata totale dei fotogrammi video neri in uscita, presenti anche nell'input, in millisecondi. `BlackVideoDetected`non include le cornici nere inserite da. MediaConvert  | 
|  `BlackVideoDetectedRatio`  | Ratio |  Il rapporto tra i fotogrammi video neri e la durata totale dell'output. I rapporti più alti mostrano le uscite con più cornici nere.  | 
|  `LongestBlackSegmentDetected`  | Millisecondi |  La posizione dell'output con il segmento continuo più lungo di fotogrammi video neri, in millisecondi.  | 
|  `VideoPaddingInserted`  | Millisecondi |  La durata totale dei fotogrammi vuoti MediaConvert inseriti in tutti gli output del lavoro, in millisecondi. La spaziatura interna video inserisce cornici vuote per aiutare a mantenere allineate le durate audio e video. `VideoPaddingInserted`I valori elevati indicano che sono state inserite più cornici vuote. Mostrano anche in che misura le tracce audio in ingresso iniziano tardi, finiscono presto o entrambe le cose.  | 
|  `VideoPaddingInsertedRatio`  | Ratio |  Il rapporto tra i fotogrammi vuoti MediaConvert inseriti e la durata complessiva dell'output. Rapporti più elevati possono segnalare problemi di sincronizzazione audio e video in ingresso.  | 
|  `AvgBitrateTop`  | Bit al secondo |  Il bitrate medio del bitrate di uscita più alto nel gruppo di output.  | 
|  `AvgBitrateBottom`  | Bit al secondo |  Il bitrate medio del bitrate di uscita più basso nel gruppo di output.  | 
|  `QVBRAvgQualityHighBitrate`  | Punteggio |  Il punteggio medio di qualità QVBR dell'output con bitrate più alto nel gruppo di output.  | 
|  `QVBRAvgQualityLowBitrate`  | Punteggio |  Il punteggio di qualità QVBR medio dell'uscita con bitrate più basso nel gruppo di output.  | 
|  `QVBRMinQualityHighBitrate`  | Punteggio |  Il punteggio di qualità QVBR minimo dell'output con bitrate più alto nel gruppo di output.  | 
|  `QVBRMinQualityLowBitrate`  | Punteggio |  Il punteggio di qualità QVBR minimo dell'uscita con bitrate più basso nel gruppo di output.  | 

# Registrazione delle chiamate AWS Elemental MediaConvert API utilizzando AWS CloudTrail
<a name="logging-using-cloudtrail"></a>

AWS Elemental MediaConvert si integra con AWS CloudTrail, un servizio che fornisce una registrazione delle operazioni eseguite da un utente, ruolo o AWS servizio. CloudTrail acquisisce tutte le operazioni (chiamate API) eseguite, incluse quelle dalla MediaConvert Console, come eventi. Gli eventi contengono informazioni sulle richieste MediaConvert, incluso l'indirizzo IP, chi ha effettuato la richiesta, quando è stata effettuata, l' MediaConvertoperazione e dettagli aggiuntivi. Per ulteriori informazioni sugli CloudTrail eventi, consulta [Cosa sono CloudTrail gli eventi?](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-events)

Alcuni esempi di ciò che CloudTrail può aiutarti a trovare includono: quando hai inviato una richiesta di creazione di lavoro, chi ha eliminato una coda o quali tag sono stati aggiunti a una risorsa.

Per un elenco completo di tutte le MediaConvert operazioni che puoi eseguire, consulta l'[MediaConvert API Reference.](https://docs.aws.amazon.com/mediaconvert/latest/apireference/resources.html)

Per saperne di più CloudTrail, consulta la [Guida AWS CloudTrail per l'utente](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).

**Topics**
+ [Ricerca di informazioni su MediaConvert in CloudTrail](#service-name-info-in-cloudtrail)
+ [Comprensione CloudTrail degli eventi di gestione per MediaConvert](#understanding-service-name-entries)

## Ricerca di informazioni su MediaConvert in CloudTrail
<a name="service-name-info-in-cloudtrail"></a>

Puoi visualizzare, cercare e scaricare gli eventi degli ultimi 90 giorni nella [Cronologia degli eventi](https://console.aws.amazon.com/cloudtrailv2/home?region=us-west-2#/events) nella CloudTrail console. Per ulteriori informazioni, consulta [Lavorare con la cronologia CloudTrail degli eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).

Per una registrazione continua degli CloudTrail eventi oltre gli ultimi 90 giorni, devi creare un archivio dati di eventi CloudTrail *trail* o CloudTrail Lake. 

**CloudTrail sentieri**  
Con CloudTrail trail, CloudTrail fornisce i file di log degli eventi a un bucket Amazon S3. Inoltre, puoi configurare altri AWS servizi per [analizzare ulteriormente e agire in base ai dati sugli eventi raccolti](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html). Quando crei un trail, CloudTrail [invia ogni evento anche ad Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html). Per ulteriori informazioni sui CloudTrail sentieri, consulta [Lavorare con i CloudTrail sentieri](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html).

**CloudTrail Archivi di dati sugli eventi del lago**  
Con CloudTrail Lake Event Data Stores, CloudTrail fornisce un archivio ricercabile di dati sugli eventi. Per ulteriori informazioni, consulta [Lavorare con CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).

## Comprensione CloudTrail degli eventi di gestione per MediaConvert
<a name="understanding-service-name-entries"></a>

[Gli eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) di gestione forniscono informazioni sulle operazioni di gestione eseguite sulle risorse dell'azienda Account AWS. Queste operazioni sono note anche come operazioni o MediaConvert operazioni del piano di controllo. Per impostazione predefinita, CloudTrail registra tutti gli eventi di gestione.

CloudTrail gli eventi di gestione rappresentano una singola richiesta da qualsiasi fonte. Includono informazioni su dove ha avuto origine una richiesta, chi ha effettuato la richiesta, quando è stata effettuata, sull' MediaConvert operazione e altri dettagli importanti. 

Per informazioni dettagliate sul contenuto di questi eventi, consulta il [contenuto dei CloudTrail record](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html). 

**Origin**  
Gli eventi includono l'indirizzo IP di origine in`sourceIPAddress`, AWS nella sezione `awsRegion` Regione e l'agente utente (informazioni sul browser o sul client) sotto `userAgent` per aiutarti a trovare l'origine di una richiesta.

**Identità**  
Gli eventi includono informazioni sull'identità, nella sezione`userIdentity`, per aiutarti a trovare chi ha effettuato la richiesta. Puoi utilizzare queste informazioni per determinare quanto segue:  
+ Se la richiesta è stata effettuata con le credenziali utente root o utente.
+ Se la richiesta è stata effettuata per conto di un utente del Centro identità 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 Servizio AWS.
Per ulteriori informazioni, incluso un elenco di campi pertinenti, vedete l'elemento [CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

**Orario**  
Gli eventi includono un timestamp, sotto. `eventTime` 

**MediaConvert operazione**  
Gli eventi includono l' MediaConvert operazione sotto`eventName`. Ad esempio, `CreateJob` quando invii un nuovo lavoro o `CreateQueue` quando richiedi una nuova coda.

**Altri dettagli importanti**  
Alcuni eventi includono dettagli specifici sulla MediaConvert richiesta riportata di `requestParameters` seguito e sulla risposta MediaConvert fornita dall'utente`responseElements`.   
Ad esempio, se invii una `CreateJob` richiesta, il `requestParameters` campo includerà il codice JSON per le impostazioni del lavoro che hai inviato. In caso di successo, l'evento include anche le impostazioni di lavoro complete e convalidate JSON, nonché l'ID del lavoro, sotto. `responseElements`  
Per un altro esempio, se invii una `CreateQueue` richiesta, il `requestParameters` campo includerà le impostazioni della coda che hai inviato. In caso di successo, l'evento includerà anche la coda in cui si trova l'`responseElements`ARN.

**Nota**  
MediaConvert supporta solo gli eventi di gestione della registrazione in CloudTrail, non supporta gli eventi relativi ai dati. Per informazioni dettagliate su questi tipi di eventi e sulle relative differenze, consulta [CloudTraili concetti](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html).

### Eventi di esempio
<a name="example-cloudtrail-events"></a>

Gli esempi seguenti mostrano un CloudTrail evento per le `TagResource` operazioni `CreateJob` `CreateQueue``DeleteQueue`,, e. CloudTrail registra anche tutte le altre [MediaConvert operazioni](https://docs.aws.amazon.com/mediaconvert/latest/apireference/resources.html), sebbene non siano mostrate qui.

**Evento di esempio: CreateJob**

```
{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AKIAIOSFODNN7EXAMPLE:example-admin",
        "arn": "arn:aws:sts::111122223333:assumed-role/admin/example-admin",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AKIAIOSFODNN7EXAMPLE",
                "arn": "arn:aws:iam::111122223333:role/admin",
                "accountId": "111122223333",
                "userName": "admin"
            },
            "attributes": {
                "creationDate": "2024-04-04T17:30:19Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2024-04-04T17:45:26Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "CreateJob",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
    "requestParameters": {
        "settings": {...},
        "accelerationSettings": {
            "mode": "DISABLED"
        },
        "role": "arn:aws:iam::111122223333:role/service-role/MediaConvert_Default_Role",
        "clientRequestToken": "1712252705233-zyxwvut",
        "statusUpdateInterval": "SECONDS_60",
        "billingTagsSource": "JOB",
        "priority": 0,
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default"
    },
    "responseElements": {
        "job": {
            "arn": "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1712252725875-defhgi",
            "id": "1712252725875-defhgi",
            "createdAt": 1712252726,
            "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
            "role": "arn:aws:iam::111122223333:role/service-role/MediaConvert_Default_Role",
            "settings": {...},
            "status": "SUBMITTED",
            "timing": {
                "submitTime": 1712252726
            },
            "billingTagsSource": "JOB",
            "accelerationSettings": {
                "mode": "DISABLED"
            },
            "statusUpdateInterval": "SECONDS_60",
            "priority": 0,
            "accelerationStatus": "NOT_APPLICABLE",
            "messages": {
                "info": [],
                "warning": []
            },
            "clientRequestToken": "1712252705233-abcDEF"
        }
    },
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "111122223333",
    "eventCategory": "Management"
}
```

**Evento di esempio: CreateQueue**

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "testUser",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2018-07-10T14:01:57Z"
            }
        },
        "invokedBy": "signin.amazonaws.com"
    },
    "eventTime": "2018-07-10T16:49:13Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "CreateQueue",
    "awsRegion": "eu-west-1",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "requestParameters": {
        "name": "QueueName",
        "description": "Example queue description.",
        "tags": {}
    },
    "responseElements": {
        "queue": {
            "arn": "arn:aws:mediaconvert:eu-west-1:111122223333:queues/QueueName",
            "createdAt": 1531241353,
            "lastUpdated": 1531241353,
            "type": "CUSTOM",
            "status": "ACTIVE",
            "description": "",
            "name": "QueueName",
            "submittedJobsCount": 0,
            "progressingJobsCount": 0
        }
    },
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```

**Evento di esempio: DeleteQueue**

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "testuser",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2018-07-10T14:01:57Z"
            }
        },
        "invokedBy": "signin.amazonaws.com"
    },
    "eventTime": "2018-07-10T15:36:29Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "DeleteQueue",
    "awsRegion": "eu-west-1",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "requestParameters": {
        "name": "QueueName"
    },
    "responseElements": null,
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```

**Evento di esempio: TagResource**

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "testuser"
    },
    "eventTime": "2018-07-10T18:44:27Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "TagResource",
    "awsRegion": "eu-west-1",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "requestParameters": {
        "arn": "arn:aws:mediaconvert:eu-west-1:111122223333:queues/ExampleQueue",
        "Tags": {
            "CostCenter": "Example-Tag"
        }
    },
    "responseElements": null,
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```