AWS Elemental MediaPackage 이벤트

AWS Elemental MediaPackageAmazon CloudWatch Events와 통합하여 채널 및 엔드포인트에 영향을 미치는 특정 이벤트를 알려줍니다. 각 이벤트는 JSON (JavaScript 객체 표기법) 으로 표시되며 이벤트 이름, 이벤트가 발생한 날짜 및 시간, 영향을 받은 채널 또는 엔드포인트 등을 포함합니다. MediaPackage 최선을 다해 이벤트를 내보냅니다. CloudWatch 이벤트를 사용하여 이러한 이벤트를 수집하고 AWS Lambda 함수, Amazon SNS 주제, Amazon SQS 대기열, Amazon Kinesis Data Streams의 스트림 또는 내장된 대상과 같은 하나 이상의 대상으로 라우팅하는 규칙을 설정할 수 있습니다.

이벤트를 다른 종류의 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 전환합니다.

한 이벤트는 5분 내에 전송됩니다. 입력이 5분 동안 여러 번 전환되는 경우 (예: 한 입력으로 MediaPackage 전환되었다가 다시 다른 입력으로 전환되는 경우) 이벤트는 하나만 수신됩니다.

입력 중복 및 입력이 전환되는 이유에 대한 자세한 내용은 라이브 입력 중복 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 사용할 수 있습니다. 자산 수집이 완료된 시점과 자산을 재생할 수 있는 시점 사이에는 시간 차이가 있습니다. 이벤트는 이제 해당 자산에 대한 재생 요청을 처리할 MediaPackage 수 VodAssetPlayable 있음을 의미합니다.

패키징 그룹의 각 패키징 구성에 대한 개별 VodAssetPlayable 이벤트를 얻습니다. 예를 들어, 패키징 그룹에 DASH 패키징 구성 하나와 HLS 패키징 구성 하나가 포함된 경우 VodAssetPlayable 이벤트 두 개를 수신하게 됩니다. 하나는 DASH 패키징 구성에 대한 것이고, 다른 하나는 HLS 패키징 구성에 대한 것입니다.

예


{
   "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 이벤트를 통한 모니터링

이벤트 알림 생성