

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.

# Supervisa las solicitudes EC2 de API de Amazon con Amazon CloudWatch
<a name="monitor"></a>

Puedes monitorizar las solicitudes de EC2 API de Amazon con Amazon CloudWatch, que recopila datos sin procesar y los procesa para convertirlos en métricas legibles prácticamente en tiempo real. Estas métricas proporcionan una forma sencilla de realizar un seguimiento del uso y los resultados de las operaciones de la EC2 API de Amazon a lo largo del tiempo. Esta información le brinda una mejor perspectiva del rendimiento de las aplicaciones web, y le permite identificar y diagnosticar diversos problemas. También puede establecer alarmas que vigilen determinados umbrales y enviar notificaciones o realizar acciones específicas cuando se llegue a dichos umbrales.

Para obtener más información al respecto CloudWatch, consulta la [Guía del CloudWatch usuario de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

**importante**  
Las métricas EC2 de la API de Amazon son una función opcional. Debe solicitar el acceso a esta característica. Para obtener más información, consulte [Habilitar las métricas de EC2 la API de Amazon](#enable-ec2-api-metrics).

**Topics**
+ [Habilitar las métricas de EC2 la API de Amazon](#enable-ec2-api-metrics)
+ [Métricas y dimensiones de la EC2 API de Amazon](#monitor-metrics_dimensions)
+ [Retención de datos de métricas](#monitor-retention)
+ [Monitorización de solicitudes realizadas en su nombre](#throttling-metrics)
+ [Facturación](#monitor-billing)
+ [Trabajando con Amazon CloudWatch](#monitor-using)

## Habilitar las métricas de EC2 la API de Amazon
<a name="enable-ec2-api-metrics"></a>

Utilice el siguiente procedimiento para solicitar acceso a esta característica para su Cuenta de AWS.

**Cómo solicitar acceso a esta característica**

1. Abra [Centro de AWS Support](https://console.aws.amazon.com/support/home#/).

1. Elija **Crear caso**.

1. Elija **Cuenta y facturación**.

1. En **Servicio**, seleccione **Información general y cómo empezar**.

1. En **Categoría**, selecciona **Uso AWS y servicios**.

1. Elija **Siguiente paso: información adicional**.

1. En **Subject (Asunto)**, escriba **Request access to Amazon EC2 API metrics**.

1. En **Descripción**, escriba **Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html**. Incluya también la región a la que necesita acceder.

1. Elija **Siguiente paso: Resuelva ahora o póngase en contacto con nosotros**.

1. Elija la pestaña **Contacte con nosotros** y seleccione el idioma y el método de contacto preferidos.

1. Seleccione **Enviar**.

## Métricas y dimensiones de la EC2 API de Amazon
<a name="monitor-metrics_dimensions"></a>

### Métricas
<a name="monitor-metrics"></a>

Las métricas de la EC2 API de Amazon están incluidas en el espacio de `AWS/EC2/API` nombres. En las siguientes tablas se muestran las métricas disponibles para las solicitudes de la EC2 API de Amazon.


| Métrica | Description (Descripción) | 
| --- | --- | 
|  `ClientErrors` |  Número de solicitudes de API fallidas causadas por errores del cliente. Estos errores se suelen producir por alguna acción del cliente, como especificar un parámetro incorrecto o no válido en la solicitud o usar una acción o un recurso en nombre de un usuario que no tiene permisos para utilizar la acción o el recurso. Unidad: recuento  | 
|  `RequestLimitExceeded` |  El número de veces que se EC2 APIs ha superado la tasa máxima de solicitudes permitida por Amazon para tu cuenta. Las solicitudes de la EC2 API de Amazon se limitan para ayudar a mantener el rendimiento del servicio. Si sus solicitudes tienen una limitación, se producirá un error de `Client.RequestLimitExceeded`. Unidad: recuento  | 
|  `AwsTriggeredRequestLimitExceeded` |  El número de solicitudes de API fallidas causadas por una limitación que se AWS ha aplicado debido a un problema operativo. Cuando se produce esta limitación, recibes un mensaje de `Client.RequestLimitExceeded` error que indica que tu solicitud se ha limitado debido a un problema operativo. AWS Esta limitación es temporal y se resuelve automáticamente una vez que se soluciona el problema operativo. Implemente una lógica de retardo exponencial y reinténtelo para gestionar estas limitaciones temporales sin problemas. Unidad: recuento  | 
|  `ServerErrors` |  Número de solicitudes de API fallidas causadas por errores del servidor interno. Por lo general, estos errores se deben a un error, una excepción o una AWS falla del servidor. Unidad: recuento  | 
|  `SuccessfulCalls` |  Número de solicitudes de la API realizadas correctamente. Unidad: recuento  | 

### Dimensiones
<a name="monitor-dimensions"></a>

Los datos de las EC2 métricas de Amazon se pueden filtrar en todas las acciones EC2 de la API. Para obtener más información sobre las dimensiones, consulta [Amazon CloudWatch Concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html).

## Retención de datos de métricas
<a name="monitor-retention"></a>

Las métricas EC2 de la API de Amazon se envían a CloudWatch intervalos de 1 minuto. CloudWatch conserva los datos de las métricas de la siguiente manera:
+ Los puntos de datos con un periodo de 60 segundos (1 minuto) están disponibles durante 15 días.
+ Los puntos de datos con un periodo de 300 segundos (5 minutos) están disponibles durante 63 días.
+ Los puntos de datos con un periodo de 3 600 segundos (1 hora) están disponibles para 455 días (15 meses).

## Monitorización de solicitudes realizadas en su nombre
<a name="throttling-metrics"></a>

Las solicitudes de API realizadas por AWS los servicios en tu nombre, como las solicitudes realizadas por roles vinculados a servicios, no se tienen en cuenta para los límites de limitación de la API y no envían métricas a Amazon CloudWatch para tu cuenta. Estas solicitudes no se pueden monitorear mediante. CloudWatch

Las solicitudes de API realizadas en tu nombre por proveedores de servicios externos se tienen en cuenta para los límites de limitación de las API y, además, envían las métricas de tu cuenta a Amazon CloudWatch . Estas solicitudes se pueden monitorizar mediante. CloudWatch

## Facturación
<a name="monitor-billing"></a>

Se aplican CloudWatch precios y cargos estándar. No se aplican cargos adicionales por el uso de las métricas de la EC2 API de Amazon. Para obtener más información, consulta los [ CloudWatch precios de Amazon](https://aws.amazon.com/cloudwatch/pricing/).

## Trabajando con Amazon CloudWatch
<a name="monitor-using"></a>

**Contents**
+ [Visualización de CloudWatch métricas](#monitor-using-viewing)
+ [Creación de CloudWatch alarmas](#monitor-creating)

### Visualización de CloudWatch métricas
<a name="monitor-using-viewing"></a>

Usa el siguiente procedimiento para ver las métricas de la EC2 API de Amazon.

**Requisito previo**  
Debes habilitar el acceso a las métricas de la EC2 API de Amazon para tu cuenta. Para obtener más información, consulte [Habilitar las métricas de EC2 la API de Amazon](#enable-ec2-api-metrics).

**Para ver las métricas de la EC2 API de Amazon mediante la consola**

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

1. En el panel de navegación, seleccione **Métricas**, **Todas las métricas**.

1. En la pestaña **Explorar**, en **Métricas**, seleccione la región deseada para ver métricas.

1. Elija el espacio de nombres **EC2**métrico.

1. Para ver las métricas, seleccione la dimensión de la métrica, como **Métricas por instancia**.
**nota**  
Las métricas se ocultan tras dos semanas de inactividad. Si no reciben nuevos puntos de datos en las dos últimas semanas, dejarán de aparecer en la consola, no aparecerán cuando escriba el nombre de la métrica o de las dimensiones en el cuadro de búsqueda de la consola y el comando [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) de AWS CLI no las devolverá. Para recuperar estas métricas, utilice los comandos [get-metric-data]()o [get-metric-statistics]().

**Para ver las métricas de EC2 la API de Amazon mediante la línea de comandos**

Utilice uno de los siguientes comandos:
+ [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) (AWS CLI)

  ```
  aws cloudwatch list-metrics --namespace "AWS/EC2/API"
  ```
+ [Get- CWMetric List](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-CWMetricList.html) (AWS Tools for Windows PowerShell)

  ```
  Get-CWMetricList -Namespace "AWS/EC2/API"
  ```

### Creación de CloudWatch alarmas
<a name="monitor-creating"></a>

Puede crear una CloudWatch alarma que envíe un mensaje de Amazon SNS cuando la alarma cambie de estado. Una alarma vigila una métrica determinada durante el periodo especificado. Envía una notificación a un tema de SNS según el valor de la métrica con respecto a un umbral dado durante varios periodos de tiempo.

Por ejemplo, puede crear una alarma que supervise el número de solicitudes de DescribeInstances API que fallan debido a errores del servidor. La siguiente alarma envía una notificación por correo electrónico cuando el número de errores en las solicitudes de DescribeInstances API alcanza un umbral de 10 errores del lado del servidor durante un período de 5 minutos.

**Requisito previo**  
Debes habilitar el acceso a las métricas de la EC2 API de Amazon para tu cuenta. Para obtener más información, consulte [Habilitar las métricas de EC2 la API de Amazon](#enable-ec2-api-metrics).

**Para crear una alarma por errores en el servidor de solicitudes de la EC2 DescribeInstances API de Amazon**

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

1. En el panel de navegación, elija **Alarms** (Alarmas) y, luego, **Create Alarm** (Crear alarma).

1. Elija **Crear alarma**.

1. Elija **Seleccionar métrica** y especifique lo siguiente:

   1. Elija **EC2/API.**

   1. Elija **Métricas por acción**.

   1. Seleccione la casilla de verificación situada junto a la **DescribeInstances**que está en la misma fila que el nombre de la **ServerErrors**métrica.

   1. Elija **Seleccionar métrica**.

1. Aparece la página **Specify metric and conditions (Especificar métrica y condiciones)**, que muestra un gráfico y otra información sobre la métrica y la estadística que ha seleccionado.

   1. En **Métrica**, especifique lo siguiente:

      1. En **Statistic** (Estadística), elija **Sum** (Suma).

      1. En **Periodo**, compruebe que esté seleccionada la opción **5 minutos**.

   1. En **Conditions (Condiciones)**, especifique lo siguiente:

      1. En **Threshold type (Tipo de umbral)**, elija **Static (Estático)**.

      1. **En **Siempre que ServerErrors sea**, seleccione **Mayor/Igual** >=.**

      1. En **que...**, introduzca **10**.

   1. Elija **Siguiente**.

1. La página **Configure actions** (Configurar acciones) aparecerá.

   1. En **Notificación**, especifique lo siguiente:

     1. En **Desencadenador de estado de alarma**, elija **En alarma**.

     1. En **Seleccionar un tema de SNS**, elija **Seleccionar un tema de SNS existente** o **Crear tema nuevo** y complete los campos obligatorios de la notificación.

     1. Elija **Siguiente**.

1. Aparece la página **Agregar nombre y descripción**. 

   1. En **Nombre de la alarma**, escriba un nombre para la alarma. El nombre solo debe contener caracteres ASCII.

   1. En **Descripción de la alarma**, escriba una descripción opcional sobre la alarma.

   1. Elija **Siguiente**.

1. Aparece la página **Vista previa y creación**. Compruebe que la información sea correcta y, a continuación, elija **Crear alarma**.

Para obtener más información, consulta [Uso de CloudWatch alarmas de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) en la *Guía del CloudWatch usuario de Amazon*.