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: Registre el estado de un grupo de Auto Scaling usando EventBridge
<a name="eb-log-as-group-state"></a>

Puede ejecutar una función de [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) que registre un [evento](eb-events.md) siempre que un grupo de escalado automático lance o termine una instancia de Amazon EC2 que indique si el evento se realizó correctamente.

Para obtener información sobre más escenarios que utilizan eventos de Auto Scaling de Amazon EC2, [consulte EventBridge Use to handle Auto Scaling](https://docs.aws.amazon.com/autoscaling/latest/userguide/automating-ec2-auto-scaling-with-eventbridge.html) events en *la Guía del usuario de Amazon EC2 Auto* Scaling.

En este tutorial, creará una función Lambda y creará una [regla](eb-rules.md) en la EventBridge consola que llame a esa función cuando un grupo de Amazon EC2 Auto Scaling lance o finalice una instancia.

**Topics**
+ [Requisitos previos](#eb-as-prereqs)
+ [Paso 1: Crear una función de Lambda](#eb-as-create-lambda-function)
+ [Paso 2: Crear una regla](#eb-as-create-rule)
+ [Paso 3: Probar la regla](#eb-as-test-rule)
+ [Paso 4: Confirmar el éxito](#success)
+ [Paso 5: Eliminar los recursos](#cleanup)

## Requisitos previos
<a name="eb-as-prereqs"></a>

Para completar este tutorial necesitará los siguientes recursos:
+ Un grupo de escalado automático. Para obtener más información, consulte [Creación de un grupo de escalado automático mediante una configuración de lanzamiento](https://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg.html) en la Guía del usuario de Amazon EC2 Auto Scaling.

## Paso 1: Crear una función de Lambda
<a name="eb-as-create-lambda-function"></a>

Cree una función de Lambda para registrar los eventos de escalado ascendente y descendente para su grupo de escalado automático. 

**Cómo crear una función de Lambda**

1. Abra la consola en AWS Lambda . [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/)

1. Elija **Crear función**.

1. Elija **Crear desde cero**.

1. Escriba el nombre de la función de Lambda. Por ejemplo, asigne un nombre a la función `LogAutoScalingEvent`.

1. Deje el resto de las opciones como predeterminadas y elija **Crear función**.

1. En la pestaña **Código** de la página de funciones, haga doble clic en **index.js**.

1. Sustituya el código existente por el código siguiente.

   ```
   'use strict';
   
   exports.handler = (event, context, callback) => {
       console.log('LogAutoScalingEvent');
       console.log('Received event:', JSON.stringify(event, null, 2));
       callback(null, 'Finished');
   };
   ```

1. Elija **Deploy (Implementar)**.

## Paso 2: Crear una regla
<a name="eb-as-create-rule"></a>

Cree una regla para ejecutar la función de Lambda que creó en el paso 1. La regla se ejecuta cuando el grupo de escalado automático inicia o detiene una instancia.

**Para crear una regla**

1. Abre la EventBridge consola de Amazon 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. Por ejemplo, llame a la regla `TestRule`

1. En **Bus de eventos**, elija el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, seleccione **predeterminado**. Cuando un servicio de AWS en la cuenta emite un evento, siempre va al bus de eventos predeterminado de la cuenta.

1. En **Tipo de regla**, seleccione **Regla con un patrón de eventos**.

1. Seleccione **Siguiente**.

1. En **Origen de evento**, seleccione **Servicios de AWS **.

1. En **Event pattern** (Patrón de evento), realice una de las siguientes acciones:

   1. En **Origen del evento**, seleccione **Escalado automático** en la lista desplegable.

   1. En **Tipo de evento**, seleccione **Lanzamiento y finalización de la instancia** en la lista desplegable.

   1. Elija **Cualquier evento de instancia** y **Cualquier nombre de grupo**.

1. Elija **Siguiente**.

1. En **Tipos de destino**, seleccione **Servicio de AWS **.

1. En **Seleccionar un destino**, elija **Función de Lambda** en la lista desplegable.

1. En **Función**, seleccione la función de Lambda que creó en la sección **Paso 1: Crear una función de Lambda**. En este ejemplo, seleccione `LogAutoScalingEvent`.

1. Elija **Siguiente**.

1. Elija **Siguiente**.

1. Revise los detalles de la regla y seleccione **Creación de regla**.

## Paso 3: Probar la regla
<a name="eb-as-test-rule"></a>

Puede probar la regla manualmente escalando un grupo de escalado automático para que lance una instancia. Espere unos minutos a que se produzca el evento de escalado ascendente y, a continuación, verifique que la función de Lambda se ha invocado.

**Para probar la regla con un grupo de escalado automático**

1. Para aumentar el tamaño de su grupo de escalado automático, haga lo siguiente:

   1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

   1. En el panel de navegación, seleccione **Escalado automático**, **Grupo de escalado automático**.

   1. Seleccione la casilla del grupo de escalado automático correspondiente.

   1. En la pestaña **Details**, seleccione **Edit**. En **Desired**, aumente la capacidad deseada en 1. Por ejemplo, si el valor actual es **2**, introduzca **3**. La capacidad deseada debe ser menor o igual que el tamaño máximo del grupo. Si el nuevo valor de **Desired** es mayor que **Max**, debe actualizar **Max**. Cuando haya terminado, elija **Save**.

1. Para ver la salida de la función de Lambda, haga lo siguiente:

   1. Abre la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

   1. En el panel de navegación, elija **Logs (Registros)**.

   1. Seleccione el nombre del grupo de registros para la función de Lambda (`/aws/lambda/function-name`).

   1. Seleccione el nombre del flujo de registro para ver los datos proporcionados por la función para la instancia que ha lanzado.

1. (Opcional) Cuando haya terminado, puede reducir la capacidad deseada en uno para que el grupo de escalado automático vuelva a su tamaño anterior.

## Paso 4: Confirmar el éxito
<a name="success"></a>

Si ve el evento Lambda en los CloudWatch registros, significa que ha completado correctamente este tutorial. Si el evento no está en sus CloudWatch registros, comience a solucionar problemas verificando que la regla se haya creado correctamente y, si la regla parece correcta, compruebe que el código de la función Lambda sea correcto.

## Paso 5: Eliminar los recursos
<a name="cleanup"></a>

A menos que desee conservar los recursos que creó para este tutorial, puede eliminarlos ahora. Al eliminar AWS los recursos que ya no utilizas, evitas que se hagan cargos innecesarios a tu AWS cuenta.

**Para eliminar la (s) EventBridge regla (s)**

1. Abre la [página de reglas](https://console.aws.amazon.com/events/home#/rules) de la EventBridge consola.

1. Seleccione las reglas que creó.

1. Elija **Eliminar**.

1. Elija **Eliminar**.

**Para eliminar las funciones de Lambda**

1. Abra la página de [Funciones](https://console.aws.amazon.com/lambda/home#/functions) en la consola de Lambda.

1. Seleccione las funciones que creó.

1. Elija **Actions** (Acciones), **Delete** (Eliminar).

1. Elija **Eliminar**.