AWS Elemental MediaPackage eventos - 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.

AWS Elemental MediaPackage eventos

AWS Elemental MediaPackage se integra con Amazon CloudWatch Events para notificarle determinados eventos que afectan a sus canales y puntos de conexión. Cada evento se representa en JSONnotación de JavaScript objeto y contiene el nombre del evento, la fecha y la hora en que se produjo, el canal o punto final afectado, etc. 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 objetivos, como AWS Lambda funciones, SNS temas de Amazon, SQS colas de Amazon, 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ás notificaciones de entrada para contenido en directo y de vídeo bajo demanda (VOD). Estos eventos te 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

  • VODcambio de estado de ingesta

  • VODpreparación para la reproducción

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, la entrada de un canal MediaPackage supera la cuota para el número de transmisiones de entrada. 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 AWS Elemental MediaPackage procesamiento de redundancia de entradas en vivo.

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",
      }
   }
}
VODEvento de estado de ingesta

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"
   }
}
VODEvento de reproducción

En cuanto al VOD contenido, MediaPackage hay un activo 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 DASH y una configuración de HLS empaquetado, recibirá dos VodAssetPlayable eventos: uno para su configuración de DASH empaquetado y otro para su configuración de HLS empaquetado.

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 punto final y no MediaPackage puedes comunicarte con el proveedor de claves. Para obtener información sobre el cifrado DRM y el cifrado, consultehttps://docs.aws.amazon.com/speke/latest/documentation/.

ejemplo Evento de notificación del proveedor de claves en directo
{
   "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 VODevento de notificación del proveedor de claves
{
   "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

Los eventos de estado de los trabajos de recolección se obtienen cuando se exporta un clip de una transmisión en directo para crear un live-to-VOD activo. MediaPackage crea notificaciones cuando el trabajo de recolección se realiza correctamente o no. Para obtener información sobre los live-to-VOD activos y los trabajos de recolección, consulteCreación de live-to-VOD activos 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"
   }
}