AWS Elemental MediaPackage イベント

AWS Elemental MediaPackage は Amazon CloudWatch Events と統合して、チャネルやエンドポイントに影響する特定のイベントを通知します。各イベントは JSON (JavaScript Object Notation) で表され、イベント名、イベントが発生した日時、影響を受けるチャネルまたはエンドポイント、およびベストエフォートベースでイベント MediaPackage を発行します。 CloudWatch Events を使用してこれらのイベントを収集し、 AWS Lambda 関数、Amazon SNS トピック、Amazon SQS キュー、Amazon Kinesis Data Streams のストリーム、組み込みターゲットなどの 1 つ以上のターゲットにルーティングするルールを設定できます。

他の種類の CloudWatch イベントでイベントを使用する方法の詳細については、「Amazon CloudWatch Events ユーザーガイド」を参照してください。

以下のトピックでは、が MediaPackage 作成する CloudWatch イベントについて説明します。

入力通知イベント

ライブおよびビデオオンデマンド (VOD) コンテンツの入力通知イベントを取得します。これらのイベントは、 MediaPackage 取り込みで何かが発生したときに通知します。以下は、受け取る可能性のある入力通知イベントです。

最大入力ストリームの超過
入力スイッチ
VOD 取り込みステータスの変更
VOD 再生の準備完了

以下のセクションでは、これらの各イベントについて説明します。

最大入力ストリーム超過イベント

ライブコンテンツの場合、のチャンネルは入力ストリーム数のクォータ MediaPackage を超えています。クォータの詳細については、「AWS Elemental MediaPackage のクォータ」を参照してください。

例


{
   "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)"
   }
}

入力切り替えイベント

ライブコンテンツの場合、はいずれかのエンドポイントの入力を MediaPackage 切り替えます。

1 つのイベントは 5 分間隔で送信されます。入力が 5 分間に複数回切り替わった場合 (例えば、が 1 つの入力に MediaPackage 切り替わり、次に別の入力に戻る場合）、受信するイベントは 1 つだけです。

入力冗長およびどのような場合に入力が切り替えられるかについては、「ライブ入力冗長の AWS Elemental MediaPackage 処理の流れ」を参照してください。

例


{
   "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 取り込みステータスイベント

ビデオオンデマンド (VOD) コンテンツの場合、のアセットは取り込みステータス MediaPackage を変更します。以下のイベントの通知を受け取ります。

IngestStart
IngestError
IngestComplete

例


{
   "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 再生イベント

VOD コンテンツの場合、のアセット MediaPackage を再生できます。アセットの取り込みが完了してから、アセットが再生可能になるまでに時間がかかります。イベントVodAssetPlayableは、がアセットの再生リクエストを処理 MediaPackage できることを意味します。

パッケージンググループ内の各パッケージング設定について、個別の VodAssetPlayable イベントを取得することができます。例えば、パッケージンググループに DASH と HLS のパッケージング設定が各 1 つずつ含まれている場合は、ユーザーは (DASH パッケージング設定用と HLS パッケージング設定用として) 2 つの VodAssetPlayable イベントを受け取ります。

例


{
   "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"
      ]
    }
}

キープロバイダーの通知イベント

エンドポイントでコンテンツ暗号化を使用していて、キープロバイダーに到達 MediaPackage できない場合、キープロバイダー通知イベントが発生します。DRM と暗号化の詳細については、https://docs.aws.amazon.com/speke/latest/documentation/ を参照してください。

例ライブキープロバイダー通知イベント


{
   "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"
   }
}

例 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"
   }
}

収集ジョブの通知イベント

ライブストリームからクリップをエクスポートして Live-to-VOD アセットを作成すると、収集ジョブのステータスイベントが発生します。は、収集ジョブが成功または失敗したときに通知 MediaPackage を作成します。収集ジョブと live-to-VOD アセットについては、「AWS Elemental MediaPackage を使用した live-to-VOD アセットの作成」を参照してください。

例成功した収集ジョブのイベント


{
   "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"
      }
   }
}

例失敗した収集ジョブのイベント


{
   "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"
   }
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

CloudWatch イベントによるモニタリング

イベント通知の作成