Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Überwachung AWS Elemental MediaPackage mit CloudWatch Ereignissen
Mit Amazon CloudWatch Events können Sie Ihre AWS Services automatisieren und automatisch auf Systemereignisse wie Probleme mit der Anwendungsverfügbarkeit oder Fehlerbedingungen reagieren. AWS Services stellen Ereignisse und CloudWatch Events nahezu in Echtzeit bereit. Sie können einfache Regeln schreiben, um anzugeben, welche Ereignisse für Sie interessant sind und welche automatisierten Aktionen durchgeführt werden sollen, wenn sich für ein Ereignis eine Übereinstimmung mit einer Regel ergibt. Die folgenden Aktionen können beispielsweise automatisch ausgelöst werden:
+ Eine AWS Lambda Funktion aufrufen
+ Run Command wird aufgerufen AWS Systems Manager
+ Weiterleiten des Ereignisses an Amazon Kinesis Data Streams
+ Aktivierung einer AWS Step Functions Zustandsmaschine
Ein Beispiel für die Verwendung von CloudWatch Events with MediaPackage ist die Benachrichtigung eines Amazon SNS SNS-Themas, wenn Sie die maximale Stream-Eingabe erreichen. MediaPackage sendet Ereignisse nach bestem Wissen aus.
Weitere Informationen zum Erstellen von Regeln in CloudWatch Events finden Sie im [Amazon CloudWatch Events-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/).
Eine Liste der Ereignisse, die MediaPackage ausgelöst werden, finden Sie unter[AWS Elemental MediaPackage Ereignisse](cloudwatch-events-example.md).
# AWS Elemental MediaPackage Ereignisse
AWS Elemental MediaPackage integriert sich in Amazon CloudWatch Events, um Sie über bestimmte Ereignisse zu informieren, die sich auf Ihre Kanäle und Endpunkte auswirken. Jedes Ereignis wird in [JSON (JavaScript Object Notation)](http://json.org) dargestellt und enthält den Namen des Ereignisses, Datum und Uhrzeit des Ereignisses, den betroffenen Kanal oder Endpunkt und vieles mehr. MediaPackage sendet Ereignisse nach bestem Wissen aus. Sie können CloudWatch Ereignisse verwenden, um diese Ereignisse zu sammeln und Regeln einzurichten, die sie an ein oder mehrere *Ziele* weiterleiten, z. B. an AWS Lambda Funktionen, Amazon SNS SNS-Themen, Amazon SQS SQS-Warteschlangen, Streams in Amazon Kinesis Data Streams oder integrierte Ziele.
Weitere Informationen zur Verwendung von CloudWatch Events mit anderen Arten von Veranstaltungen finden Sie im [Amazon CloudWatch Events-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/).
In den folgenden Themen werden die CloudWatch Ereignisse beschrieben, die MediaPackage erstellt werden.
**Topics**
+ [Ereignisse mit Eingabebenachrichtigungen](#input-state-events)
+ [Wichtige Ereignisse im Zusammenhang mit Benachrichtigungen von Anbietern](#key-provider-state-events)
+ [Ereignisse mit Jobbenachrichtigungen auswerten](#hj-status-events)
## Ereignisse mit Eingabebenachrichtigungen
Sie erhalten Eingabe-Benachrichtigungsereignisse für Live- und Video-on-Demand (VOD)-Inhalte. Diese Ereignisse benachrichtigen Sie, wenn bei der Aufnahme etwas passiert MediaPackage . Dies sind die Eingabe-Benachrichtigungsereignisse, die Sie möglicherweise erhalten:
+ Überschreiten der maximalen Zahl von Eingabe-Streams
+ Eingabewechsel
+ VOD-Aufnahmestatusänderung
+ VOD-Wiedergabebereitschaft
In den folgenden Abschnitten wird jedes dieser Ereignisse beschrieben.
** Ereignis "Überschreiten der maximalen Zahl von Eingabe-Streams" **
Bei Live-Inhalten MediaPackage überschreitet ein Kanaleingang das Kontingent für die Anzahl der Eingangsstreams. Hinweise zu Kontingenten finden Sie unter [Kontingente 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)"
}
}
```
**Ereignis "Wechsel der Eingabe"**
MediaPackage Schaltet bei Live-Inhalten die Eingänge für einen Ihrer Endpunkte um.
Alle fünf Minuten wird ein einzelnes Ereignis gesendet. Wenn der Eingang innerhalb von fünf Minuten mehrmals wechselt (z. B. wenn er zu einem Eingang MediaPackage wechselt und dann wieder zum anderen), erhalten Sie nur ein Ereignis.
Informationen zur Eingaberedundanz und zu den Ursachen, die zu einem Wechsel von Eingaben führen, finden Sie unter [Ablauf bei der AWS Elemental MediaPackage Verarbeitung von Redundanz bei der Eingabe in Echtzeit](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",
}
}
}
```
**VOD-Aufnahmestatusereignis**
Bei Video-on-Demand-Inhalten (VOD) MediaPackage ändert sich der Aufnahmestatus eines Assets. Sie erhalten Benachrichtigungen für die folgenden Ereignisse:
+ `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"
}
}
```
**VOD-Wiedergabeereignis**
Bei VOD-Inhalten steht ein Asset-In zur MediaPackage Wiedergabe zur Verfügung. Es gibt einen Zeitraum zwischen dem Abschluss der Aufnahme einer Komponente und dem Zeitpunkt, an dem die Komponente wiedergegeben werden kann. Das Ereignis `VodAssetPlayable` bedeutet, dass jetzt Wiedergabeanforderungen für das Asset erfüllt werden MediaPackage können.
Sie erhalten individuelle `VodAssetPlayable` Ereignisse für jede Verpackungskonfiguration in Ihrer Verpackungsgruppe. Wenn Ihre Verpackungsgruppe beispielsweise eine DASH- und eine HLS-Paketkonfiguration enthält, erhalten Sie zwei `VodAssetPlayable` Ereignisse — eines für Ihre DASH-Paketkonfiguration und eines für Ihre HLS-Paketkonfiguration.
**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"
]
}
}
```
## Wichtige Ereignisse im Zusammenhang mit Benachrichtigungen von Anbietern
Sie erhalten Benachrichtigungen über Schlüsselanbieter, wenn Sie Inhaltsverschlüsselung auf einem Endpunkt verwenden und den Schlüsselanbieter nicht erreichen MediaPackage können. Informationen zu DRM und Verschlüsselung finden Sie unter [https://docs.aws.amazon.com/speke/latest/documentation/](https://docs.aws.amazon.com/speke/latest/documentation/).
**Example Live-Benachrichtigungsereignis für den Schlüsselanbieter**
```
{
"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 Benachrichtigungsereignis für den VOD-Schlüsselanbieter**
```
{
"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"
}
}
```
## Ereignisse mit Jobbenachrichtigungen auswerten
Wenn Sie einen Clip aus einem Live-Stream exportieren, um ein live-to-VOD Asset zu erstellen, erhalten Sie Ereignisse zum Harveste-Job-Status. MediaPackage erstellt Benachrichtigungen, wenn der Harvest-Job erfolgreich ist oder fehlschlägt. Informationen zu Ernteaufträgen und live-to-VOD Ressourcen finden Sie unter[live-to-VODAnlagen erstellen mit AWS Elemental MediaPackage](ltov.md).
**Example Erfolgreiches Erntejob-Event**
```
{
"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 Event zum Erntejob gescheitert**
```
{
"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"
}
}
```
# Ereignisbenachrichtigungen werden erstellt
Sie können Amazon CloudWatch Events und Amazon Simple Notification Service (Amazon SNS) verwenden, um Sie über neue Ereignisse zu informieren. Unter CloudWatch Ereignisse beschreibt die Regel, über welche Ereignisse Sie benachrichtigt werden. In Amazon SNS beschreibt das Thema, welche Art von Benachrichtigung Sie erhalten. Dieser Abschnitt enthält allgemeine Schritte zum Erstellen eines Themas und einer Regel für Ereignisse von AWS Elemental MediaPackage. Ausführliche Informationen zu Themen und Regeln finden Sie in den folgenden Ressourcen:
+ [Erstellen Sie ein Thema](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html#CreateTopic) und [abonnieren Sie ein Thema](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html#SubscribeTopic) im *Amazon Simple Notification Service Developer Guide*
+ [Erste Schritte mit Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html) im *Amazon CloudWatch Events-Benutzerhandbuch*
**Um Benachrichtigungen über CloudWatch Ereignisse zu erstellen**
1. Greifen Sie auf [Amazon SNS](https://console.aws.amazon.com/sns/v2/home) zu und erstellen Sie ein Thema. Geben Sie dem Thema einen aussagekräftigen Namen, den Sie zu einem späteren Zeitpunkt wiedererkennen.
1. Abonnieren Sie das Thema, das Sie soeben erstellt haben. Wählen Sie aus, welche Art von Benachrichtigung Sie empfangen möchten und wohin die Benachrichtigungen gesendet werden. Bei E-Mail-Benachrichtigungen wählen Sie beispielsweise das **E-Mail**-Protokoll aus. Geben Sie dann die E-Mail-Adresse für den Empfang von Benachrichtigungen für den Endpunkt ein.
1. Greifen Sie auf [CloudWatch Ereignisse](https://console.aws.amazon.com/cloudwatch) zu und erstellen Sie eine Regel, die ein **benutzerdefiniertes Ereignismuster** verwendet. Geben Sie im Mustervorschau-Bereich die folgenden Informationen ein:
```
{
"source": [
"aws.mediapackage"
],
"detail-type": [
"detail-type from event"
]
}
```
Geben Sie für `detail-type` den Wert für das Feld `detail-type` in das Ereignis ein. Sie können die folgenden Werte für den Detailtyp verwenden:
+ **MediaPackage Input Notification**
+ **MediaPackage Key Provider Notification**
Weitere Informationen zu den Ereignistypen finden Sie unter [AWS Elemental MediaPackage Ereignisse](cloudwatch-events-example.md).
**Example**
Die folgende Beispielregel erstellt Benachrichtigungen für alle Ereignisse für alle Detailtypen.
```
{
"source": [
"aws.mediapackage"
],
"detail-type": [
"MediaPackage Input Notification",
"MediaPackage Key Provider Notification",
"MediaPackage HarvestJob Notification"
]
}
```
1. Fügen Sie ein Ziel zur gerade erstellten Regel hinzu. Wählen Sie **SNS topic (SNS-Thema)** und anschließend das Thema aus, das Sie in Schritt 1 erstellt haben.
1. Konfigurieren Sie die Details der Regel und geben Sie ihr einen beschreibenden Namen. Um mit der Verwendung der Regel beginnen zu können, überprüfen Sie, ob sie aktiviert ist, und speichern die Regel.