Événements de notification d'entrée Principaux événements de notification destinés aux fournisseurs Événements de notification des tâches de récolte

AWS Elemental MediaPackage événements

AWS Elemental MediaPackage s'intègre à Amazon CloudWatch Events pour vous informer de certains événements qui affectent vos canaux et vos points de terminaison. Chaque événement est représenté au format JSON (JavaScript Object Notation) et contient le nom de l'événement, la date et l'heure auxquelles l'événement s'est produit, le canal ou le point de terminaison concerné, etc. MediaPackage émet des événements dans la mesure du possible. Vous pouvez utiliser les CloudWatch événements pour collecter ces événements et définir des règles qui les acheminent vers une ou plusieurs cibles, telles que les AWS Lambda fonctions, les rubriques Amazon SNS, les files d'attente Amazon SQS, les flux dans Amazon Kinesis Data Streams ou les cibles intégrées.

Pour plus d'informations sur l'utilisation d' CloudWatch Events avec d'autres types d'événements, consultez le guide de l'utilisateur Amazon CloudWatch Events.

Les rubriques suivantes décrivent les CloudWatch événements MediaPackage créés.

Types d’événements

Événements de notification d'entrée
Principaux événements de notification destinés aux fournisseurs
Événements de notification des tâches de récolte

Événements de notification d'entrée

Vous obtenez des événements de notification en entrée pour le contenu en direct et vidéo à la demande (VOD). Ces événements vous avertissent lorsque quelque chose se produit lors de MediaPackage l'ingestion. Voici les événements de notification en entrée que vous pourriez recevoir :

Flux d'entrée maximum dépassés
Changement d'entrée
Modification du statut d’ingestion VOD
Préparation à la lecture de VOD

Les sections suivantes décrivent chacun de ces événements.

Événement de flux d'entrée maximum dépassés

Pour le contenu en direct, une chaîne MediaPackage dépasse le quota du nombre de flux d'entrée. Pour obtenir des informations sur les quotas, veuillez consulter Quotas dans AWS Elemental MediaPackage.

Exemple


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

Événement de changement d'entrée

Pour le contenu en direct, MediaPackage change d'entrée pour l'un de vos points de terminaison.

Un événement est envoyé au cours d'une période de cinq minutes. Si l'entrée change plusieurs fois en cinq minutes (par exemple, si elle MediaPackage passe à une entrée, puis à nouveau à l'autre), vous ne recevez qu'un seul événement.

Pour plus d'informations sur la redondance des entrées et ce qui entraîne le changement d'entrée, consultez Flux de traitement de redondance AWS Elemental MediaPackage des entrées en direct.

Exemple


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

Événement de statut d’ingestion de VOD

Pour le contenu de vidéo à la demande (VOD), un actif MediaPackage change de statut d'ingestion. Vous recevez des notifications pour les événements suivants :

IngestStart
IngestError
IngestComplete

Exemple


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

Événement de lecture VOD

Pour le contenu VOD, un actif MediaPackage est disponible pour la lecture. Il y a un délai entre le moment où l'ingestion de la ressource est terminée et le moment où la ressource peut être lue. L'événement VodAssetPlayable signifie qu'il MediaPackage peut désormais répondre aux demandes de lecture de la ressource.

Vous bénéficiez d'VodAssetPlayableévénements individuels pour chaque configuration d'emballage de votre groupe d'emballage. Par exemple, si votre groupe d'emballage contient une configuration d'emballage DASH et une configuration d'emballage HLS, vous recevez deux VodAssetPlayable événements : un pour votre configuration d'emballage DASH et un pour votre configuration d'emballage HLS.

Exemple


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

Principaux événements de notification destinés aux fournisseurs

Vous recevez des notifications du fournisseur de clés lorsque vous utilisez le chiffrement de contenu sur un terminal et que vous ne MediaPackage parvenez pas à joindre le fournisseur de clés. Pour plus d'informations sur la gestion des droits numériques et le chiffrement, consultez https://docs.aws.amazon.com/speke/latest/documentation/.

Exemple Événement de notification en direct du fournisseur de clés


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

Exemple Événement de notification du fournisseur de clés 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"
   }
}

Événements de notification des tâches de récolte

Vous obtenez des informations sur le statut des tâches de récolte lorsque vous exportez un clip depuis une diffusion en direct pour créer une ressource en direct en VOD. MediaPackage crée des notifications lorsque la tâche de récolte réussit ou échoue. Pour plus d'informations sur les tâches de collecte et les ressources en direct transformées en VOD, consultez Création de ressources Live-to-VOD avec AWS Elemental MediaPackage.

Exemple Événement de promotion de la récolte réussi


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

Exemple Échec de la tâche de récolte


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

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Surveillance à l'aide d' CloudWatch événements

Création de notifications d'événements