

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.

# Configuración del escalado basada en Amazon SQS

El siguiente procedimiento describe la forma de configurar el escalado automático basado en Amazon SQS. Aprenderás cómo crear un CloudWatch métrica personalizada, cómo configurar una política de seguimiento de objetivos mediante el AWS CLI y cómo probar la configuración. 

Antes de empezar, asegúrese de que dispone de AWS CLI [instalada](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) y [configurado](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). Además, debe tener una cola de Amazon SQS que pueda usar. En las siguientes tareas se presupone que ya tiene una cola (estándar o FIFO), un grupo de escalado automático e instancias EC2 ejecutándose en la aplicación que utiliza la cola. 

Para obtener más información sobre Amazon SQS, consulte la [Guía del desarrollador de Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/).

**Topics**
+ [Paso 1: Crea un CloudWatch métrica personalizada](#create-sqs-cw-alarms-cli)
+ [Paso 2: Crear una política de escalado de seguimiento de destino](#create-sqs-policies-cli)
+ [Paso 3: Prueba de la política de escalado](#validate-sqs-scaling-cli)

## Paso 1: Crea un CloudWatch métrica personalizada
<a name="create-sqs-cw-alarms-cli"></a>

Una métrica personalizada se define mediante un nombre de métrica y un espacio de nombres de su elección. Los espacios de nombres para métricas personalizadas no pueden comenzar por `AWS/`. Para obtener más información acerca de la publicación de métricas personalizadas, consulte [Publica métricas personalizadas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html) tema en el *Amazon CloudWatch Guía del usuario*.

Siga este procedimiento para crear la métrica personalizada leyendo primero la información de su AWS cuenta. A continuación, calcule las tareas pendientes para cada métrica de instancia, tal como se recomienda en una sección anterior. Por último, publica este número en CloudWatch con una granularidad de 1 minuto. Siempre que sea posible, le recomendamos que cuando realizado el escalado basado en métricas, utilice una granularidad de un minuto para garantizar una respuesta más rápida a los cambios en la carga del sistema. 

**Para crear un CloudWatch métrica personalizada (AWS CLI)**

1. Utilice el comando [get-queue-attributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/get-queue-attributes.html) de SQS para obtener el número de mensajes en espera en la cola (`ApproximateNumberOfMessages`). 

   ```
   aws sqs get-queue-attributes --queue-url {{https://sqs.region.amazonaws.com/123456789/MyQueue}} \
     --attribute-names ApproximateNumberOfMessages
   ```

1. Utilice el comando [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html) para obtener la capacidad de ejecución del grupo, que es el número de instancias que tienen el estado de ciclo de vida `InService`. Este comando devuelve las instancias de un grupo de escalado automático junto con su estado de ciclo de vida. 

   ```
   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-names {{my-asg}}
   ```

1. Calcule las tareas pendientes por instancia dividiendo el número aproximado de mensajes disponibles para su recuperación de la cola por la capacidad de puesta en marcha del grupo. 

1. Cree un script que se ejecute cada minuto para recuperar el valor del trabajo atrasado por instancia y publicarlo en un CloudWatch métrica personalizada. Cuando publica una métrica personalizada, especifica el nombre de la métrica, el espacio de nombres, la unidad, el valor y cero o más dimensiones. Una dimensión consta de un nombre de dimensión y un valor de dimensión.

   Para publicar tu métrica personalizada, reemplaza los valores de los marcadores de posición en {{italics}} con el nombre de la métrica que prefieras, el valor de la métrica y un espacio de nombres (siempre y cuando no empiece por»`AWS`«) y dimensiones (opcional) y, a continuación, ejecuta lo siguiente [put-metric-data](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-data.html) comando. 

   ```
   aws cloudwatch put-metric-data --metric-name {{MyBacklogPerInstance}} --namespace {{MyNamespace}} \
     --unit None --value {{20}} --dimensions {{MyOptionalMetricDimensionName=MyOptionalMetricDimensionValue}}
   ```

Después de que la aplicación emita la métrica deseada, los datos se envían a CloudWatch. La métrica está visible en el CloudWatch consola. Puede acceder a ella iniciando sesión en Consola de administración de AWS y navegando hasta el CloudWatch página. A continuación, puede ver la métrica desplazándose a la página de métricas o buscándola usando el campo de búsqueda. Para obtener información sobre la visualización de las métricas, consulte [Ver las métricas disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) en el *Amazon CloudWatch Guía del usuario*.

## Paso 2: Crear una política de escalado de seguimiento de destino
<a name="create-sqs-policies-cli"></a>

La métrica que creó ahora se puede añadir a una política de escalado de seguimiento de destino.

**Para crear una política de escalado y seguimiento de objetivos (AWS CLI)**

1. Utilice el siguiente comando `cat` para almacenar un valor de destino para su política de escalado y una especificación de métricas personalizada en un archivo JASON llamado `config.json` en su directorio principal. Reemplace cada {{user input placeholder}} por su propia información. Para el `TargetValue`, calcule las tareas pendientes aceptables por cada métrica de instancia e introdúzcala aquí. Para calcular este número, decida un valor de latencia normal y divídalo por el tiempo medio que tarda en procesar un mensaje, como se describe en una sección anterior. 

   Si no especificó ninguna dimensión para la métrica que creó en el paso 1, no incluya ninguna dimensión en la especificación métrica personalizada.

   ```
   $ cat ~/config.json
   {
      "TargetValue":{{100}},
      "CustomizedMetricSpecification":{
         "MetricName":"{{MyBacklogPerInstance}}",
         "Namespace":"{{MyNamespace}}",
         "Dimensions":[
            {
               "Name":"{{MyOptionalMetricDimensionName}}",
               "Value":"{{MyOptionalMetricDimensionValue}}"
            }
         ],
         "Statistic":"Average",
         "Unit":"None"
      }
   }
   ```

1. Utilice el comando [put-scaling-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-scaling-policy.html), junto con el archivo `config.json` creado en el paso anterior, para crear su política de escalado.

   ```
   aws autoscaling put-scaling-policy --policy-name {{sqs100-target-tracking-scaling-policy}} \
     --auto-scaling-group-name {{my-asg}} --policy-type TargetTrackingScaling \
     --target-tracking-configuration {{file://~/config.json}}
   ```

   Esto crea dos alarmas: una para el escalado horizontal y otra para la reducción horizontal. También devuelve el nombre de recurso de Amazon (ARN) de la política en la que está registrada CloudWatch, cual CloudWatch se utiliza para invocar el escalado cuando se infringe el umbral métrico. 

## Paso 3: Prueba de la política de escalado
<a name="validate-sqs-scaling-cli"></a>

Una vez que finalice la configuración, verifique que la política de escalado funcione. Puede probarla aumentando el número de mensajes en la cola de SQS y verificando después que el grupo de escalado automático ha lanzado una instancia EC2 adicional. También puede probarla reduciendo el número de mensajes en la cola de SQS y verificando después que el grupo de escalado automático ha terminado una instancia EC2.

**Pruebas de la función de escalado horizontal**

1. Siga los pasos de [Creación de una cola estándar de Amazon SQS y envío de un mensaje](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/creating-sqs-standard-queues.html) o [Creación de una cola FIFO de Amazon SQS y envío de un mensaje](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/creating-sqs-fifo-queues.html) para añadir mensajes a la cola. Asegúrese de que ha aumentado el número de mensajes en la cola de forma que las tareas pendientes por cada métrica de instancia supere el valor de destino.

   Este proceso puede tardar unos minutos hasta que los cambios invoquen la alarma.

1. Utilice el comando [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html) para verificar que el grupo ha lanzado una instancia.

   ```
   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name {{my-asg}}
   ```

**Cómo probar la función de reducción horizontal**

1. Siga los pasos de [Recibir y eliminar un mensaje (consola)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/step-receive-delete-message.html) para eliminar los mensajes de la cola. Asegúrese de que ha disminuido el número de mensajes en la cola de forma que las tareas pendientes por cada métrica de instancia esté por debajo del valor de destino.

   Este proceso puede tardar unos minutos hasta que los cambios invoquen la alarma.

1. Utilice el comando [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html) para verificar que el grupo ha terminado una instancia.

   ```
   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name {{my-asg}}
   ```