AWS Elemental MediaPackage 이벤트 - AWS Elemental MediaPackage

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS Elemental MediaPackage 이벤트

AWS Elemental MediaPackage는 Amazon CloudWatch Events와 통합하여 채널 및 엔드포인트에 영향을 주는 특정 이벤트 발생 시 알립니다. 각 이벤트는 JSON(JavaScript Object Notation)으로 표시되며, 이벤트 이름, 이벤트가 발생한 날짜와 시간, 영향 받는 채널 또는 엔드포인트 등을 포함합니다. CloudWatch 이벤트 이용을 통해 이러한 이벤트를 수집하고 Amazon Kinesis Data Streams의 AWS Lambda 함수, Amazon SNS 주제, Amazon SQS 대기열, 스트림 등 하나 이상의 대상 또는 기본 제공 대상으로 라우팅하는 규칙을 설정할 수 있습니다.

다른 종류의 이벤트와 함께 CloudWatch 이벤트를 사용하는 방법에 대한 자세한 내용은 Amazon CloudWatch Events 사용 설명서를 참조하십시오.

다음 주제에서는 AWS Elemental 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" } }
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_id" ], "detail":{ "event": "IngestComplete", "message": "message text" } }
VOD 재생 이벤트

VOD 콘텐츠의 경우 MediaPackage의 자산을 재생할 수 있습니다. 자산 수집이 완료된 시점과 자산을 재생할 수 있는 시점 사이에는 시간 차이가 있습니다. VodAssetPlayable 이벤트는 MediaPackage에서 이제 자산에 대한 재생 요청을 처리할 수 있음을 의미합니다.

{ "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://accd64649dc.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/b9cc115bf7f1a/b848dfb116920772aa69ba/a3c74b1cae6a451c/index.m3u8" ] } }

키 공급자 알림 이벤트

엔드포인트에서 콘텐츠 암호화를 사용하고 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/70b44e2e666c4bdc9e5f4488e1f1aa99" ], "detail":{ "event": "KeyProviderError", "message": "message-text" } }

수집 작업 알림 이벤트

Live-to-VOD 자산을 생성하기 위해 라이브 스트림에서 클립을 내보내면 수집 작업 상태 이벤트를 얻습니다. MediaPackage는 수집 작업이 성공하거나 실패할 때 알림을 생성합니다. 수집 작업 및 Live-to-VOD 자산에 대한 자세한 내용은 을(를) 사용하여 라이브-VOD 자산 생성 AWS Elemental MediaPackage 단원을 참조하십시오.

예 성공적인 수집 작업 이벤트

{ "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": "COMPLETED", "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" } }