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.
# Tutorial: envío de alertas de Amazon Simple Notification Service para eventos de trabajos fallidos
En este tutorial, usted configura una regla de evento Amazon EventBridge que sólo captura eventos de trabajo donde el trabajo se ha movido a un estado `FAILED`. Al final de este tutorial, si lo desea, también puede enviar un trabajo a esta cola de trabajos. Esto sirve para comprobar que ha configurado correctamente las alertas de Amazon SNS.
## Requisitos previos
En este tutorial se supone que tiene un entorno de computación y una cola de trabajos que están listos para aceptar trabajos. Si no dispone de un entorno de computación y una cola de trabajos para capturar eventos, siga los pasos de [Cómo empezar con AWS Batch los tutoriales](Batch_GetStarted.md) para crearlos.
**Topics**
+ [Requisitos previos](#batch_sns_prereq)
+ [Tutorial: creación de un tema de Amazon SNS y suscribirse a él](batch_sns_create_topic.md)
+ [Tutorial: registro de una regla de eventos](batch_sns_reg_rule.md)
+ [Tutorial: prueba de la regla](batch_sns_test_rule.md)
+ [Regla alternativa: cola de trabajos por lotes bloqueada](#test_blocked_job_queue)
# Tutorial: creación de un tema de Amazon SNS y suscribirse a él
Para este tutorial, se configura un tema de Amazon SNS para utilizarse como destino de eventos para la nueva regla de eventos.
**Para crear un tema de Amazon SNS**
1. Abra la consola de Amazon SNS en [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).
1. Seleccione **Topics (Temas)**, **Create topic (Creación de tema)**.
1. En **Tipo**, seleccione **Estándar**.
1. Para **Nombre**, escriba **JobFailedAlert** y, a continuación, elija **Creación de tema**.
1. En la pantalla **JobFailedAlert**, elija **Creación de suscripción**.
1. En **Protocolo**, seleccione **Correo electrónico**.
1. En **Endpoint (Punto de conexión)**, ingrese una dirección de email a la que actualmente tenga acceso y elija **Create subscription (Creación de suscripción)**.
1. Consulte su cuenta de correo electrónico y espere para recibir un mensaje de correo electrónico de confirmación de la suscripción. Cuando lo reciba, seleccione **Confirmar suscripción**.
# Tutorial: registro de una regla de eventos
A continuación, registre una regla de eventos que solo capture los eventos de trabajos con error.
**Para registrar su regla de EventBridge**
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Reglas**.
1. Elija **Creación de regla**.
1. Escriba un nombre y una descripción para la regla.
Una regla no puede tener el mismo nombre que otra regla de la misma región y del mismo bus de eventos.
1. En **Bus de eventos**, seleccione el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, seleccione **Bus de eventos predeterminado de AWS**. Cuando un servicio de AWS en su cuenta emite un evento, siempre va al bus de eventos predeterminado de su cuenta.
1. En **Tipo de regla**, elija **Regla con un patrón de evento**.
1. Seleccione **Siguiente**.
1. En **Origen del evento**, seleccione **Otro**.
1. En **Patrón de eventos**, seleccione **Patrones personalizados (editor de JSON)**.
1. Pegue el siguiente patrón de eventos en el área de texto.
```
{
"detail-type": [
"Batch Job State Change"
],
"source": [
"aws.batch"
],
"detail": {
"status": [
"FAILED"
]
}
}
```
Este código define una regla de eventos de EventBridge que coincide con cualquier evento en el que el estado del trabajo sea `FAILED`. Para obtener más información sobre los patrones de eventos, consulte [Eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. En **Tipos de destino**, seleccione **Servicio de AWS**.
1. En **Seleccione un destino**, elija un **tema de SNS** y, en **Tema**, elija **JobFailedAlert**.
1. (Opcional) En **Configuración adicional**, haga lo siguiente:
1. En **Antigüedad máxima del evento**, indique un valor entre un minuto (00:01) y 24 horas (24:00).
1. En **Cantidad de reintentos**, indique un número entre 0 y 185.
1. En **Cola de mensajes falidos**, seleccione si desea utilizar una cola de Amazon SQS estándar como cola de mensajes fallidos. EventBridge envía eventos que coincidan con esta regla a la cola de mensajes fallidos si no se entregan correctamente al destino. Realice una de las siguientes acciones:
+ Seleccione **Ninguna** para no usar una cola de mensajes fallidos.
+ Elija **Seleccionar una cola de Amazon SQS en la cuenta de AWS actual para usarla como cola de mensajes fallidos** y luego seleccione de la lista desplegable la cola que quiera usar.
+ Elija **Seleccionar una cola de Amazon SQS en otra cuenta de AWS como cola de mensajes fallidos** y luego ingrese el ARN de la cola que quiera usar. Debe asociar una política basada en recursos a la cola que conceda permiso a EventBridge para enviarle mensajes. Para obtener más información, consulte [Concesión de permisos a la cola de mensajes fallidos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. (Opcional) Introduzca una o varias etiquetas para la regla. Para obtener más información, consulte [Etiquetas de Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. Revise los detalles de la regla y seleccione **Creación de regla**.
# Tutorial: prueba de la regla
Para probar la regla, envíe un trabajo que se cierre poco después de que comience y tenga un código de salida distinto de cero. Si su regla de eventos está configurada correctamente, debería recibir un mensaje de correo electrónico en unos minutos con el texto del evento.
**Para probar una regla**
1. Abra la consola AWS Batch en [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Envíe un nuevo trabajo de AWS Batch. Para obtener más información, consulte [Tutorial: envío de un trabajo](submit_job.md). Para el comando del trabajo, sustituya este comando para salir del contenedor con un código de salida de 1.
```
/bin/sh, -c, 'exit 1'
```
1. Compruebe su correo electrónico para confirmar que ha recibido una alerta de correo electrónico para la notificación de trabajo fallido.
## Regla alternativa: cola de trabajos por lotes bloqueada
Para crear una regla de eventos que supervise si *la cola de trabajos por lotes está bloqueada*, repita estos tutoriales con las siguientes modificaciones:
1. **En [Tutorial: creación de un tema de Amazon SNS y suscribirse a él](batch_sns_create_topic.md)**, utilice *BlockedJobQueue* como nombre del tema.
1. **En [Tutorial: registro de una regla de eventos](batch_sns_reg_rule.md)**, utilice el siguiente patrón en el editor JSON:
```
{
"detail-type": [
"Batch Job Queue Blocked"
],
"source": [
"aws.batch"
]
}
```