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 MediaPackage con eventi CloudWatch
Amazon CloudWatch Events ti consente di automatizzare AWS i tuoi servizi e rispondere automaticamente a eventi di sistema come problemi di disponibilità delle applicazioni o condizioni di errore. AWS i servizi forniscono eventi a CloudWatch Events quasi in tempo reale. Puoi compilare regole semplici che indichino quali eventi sono considerati di interesse per te e quali azioni automatizzate intraprendere quando un evento corrisponde a una regola. Le azioni che possono essere attivate automaticamente includono le seguenti:
+ Invocare una funzione AWS Lambda
+ Invocare AWS Systems Manager il comando Run
+ Inoltro dell'evento a Amazon Kinesis Data Streams
+ Attivazione di una macchina a stati AWS Step Functions
Un esempio di utilizzo di CloudWatch Events with MediaPackage è la notifica a un argomento di Amazon SNS se si raggiunge il numero massimo di stream in ingresso. MediaPackage emette eventi con il massimo impegno possibile.
Per ulteriori informazioni sulla creazione di regole in CloudWatch Events, consulta la [Amazon CloudWatch Events User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/).
Per un elenco degli eventi che vengono MediaPackage generati, consulta[AWS Elemental MediaPackage eventi](cloudwatch-events-example.md).
# AWS Elemental MediaPackage eventi
AWS Elemental MediaPackage si integra con Amazon CloudWatch Events per informarti di determinati eventi che influiscono sui tuoi canali ed endpoint. Ogni evento è rappresentato in [JSON (JavaScript Object Notation)](http://json.org) e contiene il nome dell'evento, la data e l'ora in cui si è verificato l'evento, il canale o l'endpoint interessato e altro ancora. MediaPackage emette eventi con il massimo impegno possibile. Puoi utilizzare CloudWatch Events per raccogliere questi eventi e impostare regole che li indirizzino verso uno o più *target* come AWS Lambda funzioni, argomenti Amazon SNS, code Amazon SQS, flussi in Amazon Kinesis Data Streams o destinazioni integrate.
Per ulteriori informazioni sull'utilizzo di CloudWatch Events con altri tipi di eventi, consulta la [Amazon CloudWatch Events User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/).
I seguenti argomenti descrivono gli CloudWatch eventi che MediaPackage crea.
**Topics**
+ [Eventi di notifica di input](#input-state-events)
+ [Eventi chiave di notifica del provider](#key-provider-state-events)
+ [Eventi di notifica delle offerte di lavoro Harvest](#hj-status-events)
## Eventi di notifica di input
Ricevi gli eventi di notifica di input per i contenuti VOD (video on demand) live. Questi eventi ti avvisano quando succede qualcosa con l' MediaPackage ingest. Questi sono gli eventi di notifica di input che potresti ricevere:
+ Numero massimo di flussi di input superato
+ Cambio di input
+ Cambio dello stato dell'inserimento VOD
+ Preparazione alla riproduzione VOD
Nelle sezioni seguenti viene descritto ciascuno di questi eventi.
** Evento numero massimo di flussi di input superato **
Per i contenuti live, un canale MediaPackage supera la quota prevista per il numero di flussi di input. Per informazioni sulle quote, consulta [Quote in AWS Elemental MediaPackage](quotas.md).
**Example**
```
{
"id": "7bf73129-1428-4cd3-a780-95db273d1602",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage:us-west-2:aws_account_id:channels/262ff182d46d4b399fcabea1364df682"
],
"detail":{
"event": "MaxIngestStreamsError",
"message": "Parent Manifest [%s] has [23] streams, more than [20] allowed: (index_1.m3u8,index_2.m3u8,index_3.m3u8,index_4.m3u8,index_5.m3u8,index_6.m3u8,index_7.m3u8,index_8.m3u8,index_9.m3u8,index_10.m3u8,index_11.m3u8,index_12.m3u8,index_13.m3u8,index_14.m3u8,index_15.m3u8,index_16.m3u8,index_17.m3u8,index_18.m3u8,index_19.m3u8,index_20.m3u8,index_21.m3u8,index_22.m3u8,index_23.m3u8)"
}
}
```
**Evento cambio di input**
Per i contenuti live, MediaPackage cambia gli ingressi per uno dei tuoi endpoint.
Un evento viene inviato in un periodo di cinque minuti. Se l'input cambia più volte in cinque minuti (ad esempio, se MediaPackage passa a un ingresso e poi torna all'altro), si riceve un solo evento.
Per informazioni sulla ridondanza di input e su cosa provoca il cambio di input, consulta [Flusso di elaborazione della ridondanza AWS Elemental MediaPackage degli input in tempo reale](what-is-flow-ir.md).
**Example**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2018-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:origin_endpoints/82d6b9bc04cb4612b487963d6c8d0f1a"
],
"detail":{
"event": "InputSwitchEvent",
"message": "Origin endpoint experienced an Input Switch Event",
"EventDetails": {
"Channel": "channel name",
"PreviousIngestEndpoint": "endpoint uuid before input switch",
"CurrentIngestEndpoint": "endpoint uuid after input switch",
}
}
}
```
**Evento stato di inserimento VOD**
Per i contenuti video on demand (VOD), una risorsa in corso MediaPackage cambia lo stato di importazione. Ricevi notifiche per i seguenti eventi:
+ `IngestStart`
+ `IngestError`
+ `IngestComplete`
**Example**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-05-03T17:29:36Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_name"
],
"detail":{
"event": "IngestComplete",
"message": "message text"
}
}
```
**Evento di riproduzione VOD**
Per i contenuti VOD, MediaPackage è disponibile una risorsa per la riproduzione. Esiste un periodo di tempo tra il completamento dell'inserimento e il momento in cui l'asset può essere riprodotto. L'evento `VodAssetPlayable` significa che ora MediaPackage può soddisfare le richieste di riproduzione della risorsa.
Ottieni `VodAssetPlayable` eventi individuali per ogni configurazione di pacchetto nel tuo gruppo di pacchetti. Ad esempio, se il gruppo di pacchetti contiene una configurazione di pacchetto DASH e una configurazione di pacchetto HLS, riceverai due `VodAssetPlayable` eventi: uno per la configurazione di pacchetto DASH e uno per la configurazione di pacchetto HLS.
**Example**
```
{
"id": "81e896e4-d9e5-ec79-f82a-b4cf3246c567",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-11-03T21:46:00Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
],
"detail":{
"event": "VodAssetPlayable",
"message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
"packaging_configuration_id": "packaging_configuration_id",
"manifest_urls":[
"https://555555555555.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/b9cc115bf7f1a/b848dfb116920772aa69ba/a3c74b1cae6a451c/index.m3u8"
]
}
}
{
"id": "91e896e4-d9e5-ab80-f82a-b4cf3246c568",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-11-03T21:47:00Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
],
"detail":{
"event": "VodAssetPlayable",
"message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
"packaging_configuration_id": "packaging_configuration_id",
"manifest_urls":[
"https://111122223333.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/1234567890abc/021345abcdef6789012345/abcdef0123456789/index.mpd"
]
}
}
```
## Eventi chiave di notifica del provider
Ricevi eventi di notifica del fornitore di chiavi quando utilizzi la crittografia dei contenuti su un endpoint e non MediaPackage riesci a contattare il fornitore delle chiavi. Per ulteriori informazioni su DRM e crittografia, consulta [https://docs.aws.amazon.com/speke/latest/documentation/](https://docs.aws.amazon.com/speke/latest/documentation/).
**Example Evento di notifica in tempo reale del provider di chiavi**
```
{
"id": "7bf73129-1428-4cd3-a780-98ds273d1602",
"detail-type": "MediaPackage Key Provider Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage:us-west-2:aws_account_id:origin_endpoints/endpoint_id"
],
"detail":{
"event": "KeyProviderError",
"message": "message-text"
}
}
```
**Example Evento di notifica del provider di chiavi VOD**
```
{
"id": "7bf73129-1428-4cd3-a780-98ds273d1602",
"detail-type": "MediaPackage Key Provider Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configurations/packaging_group_name"
],
"detail":{
"event": "KeyProviderError",
"message": "message-text"
}
}
```
## Eventi di notifica delle offerte di lavoro Harvest
Quando esporti una clip da un live streaming per creare una live-to-VOD risorsa, ricevi gli eventi Harvest Job Status. MediaPackage crea notifiche quando il processo di raccolta ha esito positivo o negativo. Per informazioni sui lavori e sulle live-to-VOD risorse di raccolta, vedere[Creazione di live-to-VOD risorse con AWS Elemental MediaPackage](ltov.md).
**Example Evento di Harvest Job di successo**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage HarvestJob Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
],
"detail":{
"harvest_job": {
"id": "harvest_job_id",
"arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
"status": "SUCCEEDED",
"origin_endpoint_id": "endpoint_id",
"start_time": "2019-06-26T20:30:00-08:00",
"end_time": "2019-06-26T21:00:00-08:00",
"s3_destination": {
"bucket_name": "s3_bucket_name",
"manifest_key": "path/and/manifest_name/index.m3u8",
"role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
},
"created_at": "2019-06-26T21:03:12-08:00"
}
}
}
```
**Example Evento di raccolta non riuscito**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage HarvestJob Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
],
"detail":{
"harvest_job": {
"id": "harvest_job_id",
"arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
"status": "FAILED",
"origin_endpoint_id": "endpoint_id",
"start_time": "2019-06-26T20:30:00-08:00",
"end_time": "2019-06-26T21:00:00-08:00",
"s3_destination": {
"bucket_name": "s3_bucket_name",
"manifest_key": "path/and/manifest_name/index.m3u8",
"role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
},
"created_at": "2019-06-26T21:03:12-08:00"
},
"message": "Message text"
}
}
```
# Creazione di notifiche di eventi
Puoi utilizzare Amazon CloudWatch Events e Amazon Simple Notification Service (Amazon SNS) per avvisarti di nuovi eventi. In CloudWatch Events, la regola descrive gli eventi di cui ricevi notifiche. In Amazon SNS, l'argomento descrive che tipo di notifica ricevi. Questa sezione fornisce passaggi di alto livello per creare un argomento e una regola per gli eventi. AWS Elemental MediaPackage Per informazioni dettagliate su argomenti e regole, consulta quanto segue:
+ [Crea un argomento](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html#CreateTopic) e [iscriviti a un argomento](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html#SubscribeTopic) nella *Amazon Simple Notification Service Developer Guide*
+ [Inizia a usare Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html) nella *Guida per l'utente di Amazon CloudWatch Events*
**Per creare notifiche di CloudWatch eventi**
1. Accedi ad [Amazon SNS](https://console.aws.amazon.com/sns/v2/home) e crea un argomento. Assegna un nome descrittivo all'argomento riconoscibile in seguito.
1. Effettua la sottoscrizione all'argomento appena creato. Scegli che tipo di notifica ricevere e dove inviarla. Ad esempio, per le notifiche e-mail, scegli il protocollo **Email (E-mail)** e inserisci l'indirizzo e-mail per ricevere le notifiche per l'endpoint.
1. Accedi [CloudWatch agli eventi](https://console.aws.amazon.com/cloudwatch) e crea una regola che utilizza uno **schema di eventi personalizzato**. Nello spazio dell'anteprima del modello di eventi, immetti quanto segue:
```
{
"source": [
"aws.mediapackage"
],
"detail-type": [
"detail-type from event"
]
}
```
Per `detail-type`, immetti il valore per il campo `detail-type` dall'evento. Puoi utilizzare i seguenti valori per tipo di dettaglio:
+ **MediaPackage Input Notification**
+ **MediaPackage Key Provider Notification**
Per informazioni sui tipi di eventi, consulta [AWS Elemental MediaPackage eventi](cloudwatch-events-example.md).
**Example**
La regola di esempio seguente crea notifiche per tutti gli eventi in tutti i tipi di dettaglio.
```
{
"source": [
"aws.mediapackage"
],
"detail-type": [
"MediaPackage Input Notification",
"MediaPackage Key Provider Notification",
"MediaPackage HarvestJob Notification"
]
}
```
1. Aggiungi un target alla regola creata. Scegli **SNS topic (Argomento SNS)**, quindi seleziona l'argomento creato nella fase 1.
1. Configura i dettagli della regola e assegnale un nome descrittivo. Per iniziare a utilizzare la regola, assicurati di abilitarla, quindi salvala.