Eventos de AWS Elemental MediaPackage - AWS Elemental MediaPackage
Eventos de notificación de entradaEventos de notificación del proveedor de clavesEventos de notificación de trabajos de recopilación

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Eventos de AWS Elemental MediaPackage

AWS Elemental MediaPackagese integra con Amazon CloudWatch Events para notificarle determinados eventos que afectan a sus canales y puntos de conexión. Cada evento se representa en JSON (notación de JavaScript objetos) y contiene el nombre del evento, la fecha y la hora en que ocurrió el evento, el canal o punto final afectado, y más. MediaPackage emite los eventos en función del mejor esfuerzo posible. Puede usar CloudWatch Events para recopilar estos eventos y configurar reglas que los dirijan a uno o más destinos, como AWS Lambda funciones, temas de Amazon SNS, colas de Amazon SQS, transmisiones en Amazon Kinesis Data Streams o destinos integrados.

Para obtener más información sobre el uso de CloudWatch Events con otros tipos de eventos, consulta la Guía del usuario de Amazon CloudWatch Events.

En los temas siguientes se describen los CloudWatch eventos que se MediaPackage crean.

Eventos de notificación de entrada

Recibirá eventos de notificación de entrada para contenido de vídeo bajo demanda (VOD) y en directo. Estos eventos le notifican cuando ocurre algo con MediaPackage la ingesta. Estos son los eventos de notificación de entrada que puede recibir:

  • Superación del número máximo de transmisiones de entrada

  • Cambio de entrada

  • Cambio de estado de incorporación de VOD

  • Preparación para la reproducción de VOD

Las siguientes secciones describen cada uno de estos eventos.

Evento de superación del número máximo de transmisiones de entrada

En el caso del contenido en directo, el número de entradas de un canal MediaPackage supera la cuota de entradas. Para obtener información sobre cuotas, consulte Cuotas en AWS Elemental MediaPackage.

ejemplo 
{
   "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)"
   }
}
Evento de cambio de entrada

En el caso del contenido en directo, MediaPackage cambia las entradas de uno de tus puntos finales.

En un periodo de cinco minutos solo se envía un evento. Si la entrada cambia varias veces en cinco minutos (por ejemplo, si MediaPackage cambia a una entrada y luego vuelve a la otra), solo recibirás un evento.

Para obtener más información acerca de la redundancia de entrada y qué es que lo hace que las entradas cambien, consulte Flujo de procesamiento de AWS Elemental MediaPackage con redundancia de entrada en directo.

ejemplo 
{
   "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",
      }
   }
}
Evento de estado de incorporación de VOD

En el caso del contenido de vídeo bajo demanda (VOD), un activo MediaPackage cambia su estado de ingesta. Recibirá notificaciones sobre los siguientes eventos:

  • IngestStart

  • IngestError

  • IngestComplete

ejemplo 
{
   "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"
   }
}
Evento de reproducción de VOD

En el caso del contenido VOD, hay un activo MediaPackage disponible para su reproducción. Hay un período de tiempo entre el momento en el que se completa la incorporación del activo y el momento en que este puede reproducirse. El evento VodAssetPlayable significa que ahora MediaPackage puede cumplir con las solicitudes de reproducción del recurso.

Obtiene eventos VodAssetPlayable individuales para cada configuración de empaquetado de su grupo de empaquetado. Por ejemplo, si su grupo de empaquetado contiene una configuración de empaquetado de DASH y otra de HLS, recibirá dos eventos VodAssetPlayable: uno para su configuración de empaquetado de DASH y otro para su configuración de empaquetado de HLS.

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

Eventos de notificación del proveedor de claves

Recibes eventos de notificación del proveedor de claves cuando utilizas el cifrado de contenido en un terminal y no MediaPackage puedes comunicarte con el proveedor de claves. Para obtener más información acerca de DRM y el cifrado, consulte https://docs.aws.amazon.com/speke/latest/documentation/.

ejemplo Evento de notificación al proveedor de claves en tiempo real
{
   "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"
   }
}
ejemplo Evento de notificación de proveedores de claves 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"
   }
}

Eventos de notificación de trabajos de recopilación

Al exportar un clip de una transmisión en directo para crear un activo de vídeo a VOD, se obtienen los eventos relacionados con el estado de las tareas de recolección. MediaPackage crea notificaciones cuando el trabajo de recolección se realiza correctamente o no. Para obtener información sobre los trabajos de recopilación y los activos de directo a VOD, consulte Creación de recursos de directo a VOD con AWS Elemental MediaPackage.

ejemplo Evento de trabajo de recopilación realizado con éxito
{
   "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"
      }
   }
}
ejemplo Evento de trabajo de recopilación fallido
{
   "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"
   }
}