# Supervisión de las métricas de consultas de Athena con CloudWatch
Athena publica métricas relacionadas con las consultas en Amazon CloudWatch cuando se selecciona la opción [Publicar métricas de consultas en CloudWatch](athena-cloudwatch-metrics-enable.md). Puede crear tableros personalizados, configurar alarmas y desencadenadores en métricas en CloudWatch, o utilizar los paneles completados de forma automática directamente desde la consola de Athena.
Al habilitar las métricas de consultas en grupos de trabajo, las métricas se mostrarán en la pestaña **Métricas** en el panel **Grupos de trabajo**, para cada grupo de trabajo en la consola de Athena.
Athena publica las siguientes métricas en la consola de CloudWatch:
+ `DPUAllocated`: el número total de DPU (unidades de procesamiento de datos) aprovisionadas en una reserva de capacidad para ejecutar consultas.
+ `DPUConsumed`: el número de DPU consumidas activamente por las consultas en un estado `RUNNING` determinado de una reserva. La métrica se emite solo cuando el grupo de trabajo está asociado a una reserva de capacidad e incluye todos los grupos de trabajo asociados a una reserva.
+ `DPUCount`: el número máximo de DPU consumidas por la consulta, que se publica exactamente una vez cuando se completa la consulta.
+ `EngineExecutionTime`: El número de milisegundos que la consulta tardó en ejecutarse.
+ `ProcessedBytes`: Número de bytes que Athena ha analizado por consulta de DML.
+ `QueryPlanningTime`: Número de milisegundos que Athena tardó en planificar el flujo de procesamiento de consultas.
+ `QueryQueueTime`: Número de milisegundos que la consulta estaba en la cola de consultas en espera de recursos.
+ `ServicePreProcessingTime`: número de milisegundos que Athena tardó en preprocesar la consulta antes de enviarla al motor de consulta.
+ `ServiceProcessingTime`: Número de milisegundos que Athena tardó en procesar los resultados de la consulta después de que el motor de consulta terminara de ejecutarla.
+ `TotalExecutionTime`: Número de milisegundos que Athena tardó en ejecutar una consulta de DDL o DML.
Para obtener descripciones más completas, consulte [Lista de métricas y dimensiones de CloudWatch para Athena](#athena-cloudwatch-metrics-table) más adelante en este documento.
Estas métricas tienen las dimensiones siguientes:
+ `CapacityReservation`: el nombre de la reserva de capacidad utilizada para ejecutar la consulta, si corresponde.
+ `QueryState`: `SUCCEEDED`, `FAILED`, o `CANCELED`
+ `QueryType`: `DML`, `DDL`, o `UTILITY`
+ `WorkGroup`: nombre del grupo de trabajo
Athena publica las siguientes métricas en la consola de CloudWatch bajo el espacio de nombres `AmazonAthenaForApacheSpark`:
+ `DPUCount`: número de DPU consumidas durante la sesión para ejecutar los cálculos.
Esta métrica tiene las siguientes dimensiones:
+ `SessionId`: ID de la sesión en la que se envían los cálculos.
+ `WorkGroup`: nombre del grupo de trabajo.
Para obtener más información, consulte [Lista de métricas y dimensiones de CloudWatch para Athena](#athena-cloudwatch-metrics-table) más adelante en este tema. Para obtener información sobre las métricas del uso de Athena, consulte [Supervisión de las métricas de uso de Athena con CloudWatch](monitoring-athena-usage-metrics.md).
Puede ver las métricas de las consultas en la consola de Athena o en la consola de CloudWatch.
## Visualización de las métricas de las consultas en la consola de Athena
**Visualización de las métricas de consultas de un grupo de trabajo en la consola de Athena**
1. Abra la consola de Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Si el panel de navegación de la consola no está visible, elija el menú de expansión de la izquierda.
![\[Elija el menú de expansión.\]](http://docs.aws.amazon.com/es_es/athena/latest/ug/images/nav-pane-expansion.png)
1. En el panel de navegación, elija **Grupos de trabajo**.
1. Elija el grupo de trabajo que quiera de la lista y, a continuación, elija la pestaña **Métricas**.
Aparecerá el panel de métricas.
**nota**
Si ha habilitado recientemente las métricas para el grupo de trabajo y/o no se ha producido ninguna actividad de consulta reciente, los gráficos del panel pueden estar vacíos. La actividad de consulta se recupera de CloudWatch en función del intervalo que especifique en el siguiente paso.
1. En la sección **Métricas**, elija el intervalo de métricas que Athena debe utilizar para obtener las métricas de consulta de CloudWatch, o bien especifique un intervalo personalizado.
![\[Especificación del intervalo de recuperación de métricas para un grupo de trabajo en la consola de Athena.\]](http://docs.aws.amazon.com/es_es/athena/latest/ug/images/wg-custom-interval.png)
1. Para actualizar las métricas mostradas, elija el icono de actualización.
![\[Elija el icono de actualización.\]](http://docs.aws.amazon.com/es_es/athena/latest/ug/images/wg-refresh-metrics.png)
1. Haga clic en la flecha situada junto al icono de actualización para elegir con qué frecuencia quiere que se actualice la visualización de las métricas.
![\[Elección de un intervalo de actualización para ver métricas de grupo de trabajo en la consola de Athena.\]](http://docs.aws.amazon.com/es_es/athena/latest/ug/images/wg-choose-refresh-interval.png)
## Visualización de las métricas de consultas en la consola de CloudWatch
**Para consultar las métricas en la consola de Amazon CloudWatch**
1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, seleccione **Métricas** y, a continuación, **Todas las métricas**.
1. Seleccione el espacio de nombres de **AWS/Athena**.
## Visualización de las métricas de consultas con la AWS CLI
**Cómo visualizar las métricas mediante la AWS CLI**
+ Realice una de las siguientes acciones:
+ Para enumerar las métricas de Athena, abra un símbolo del sistema y utilice el siguiente comando:
```
aws cloudwatch list-metrics --namespace "AWS/Athena"
```
+ Para mostrar todas las métricas disponibles, utilice el siguiente comando:
```
aws cloudwatch list-metrics"
```
## Lista de métricas y dimensiones de CloudWatch para Athena
Si habilitó métricas de CloudWatch en Athena, envía las siguientes métricas a CloudWatch por grupo de trabajo. Las siguientes métricas utilizan el espacio de nombres `AWS/Athena`.
| Nombre de métrica | Descripción |
| --- | --- |
| DPUAllocated | El número total de DPUs (unidades de procesamiento de datos) aprovisionadas en una reserva de capacidad para ejecutar consultas. |
| DPUConsumed | El número de DPU consumidas activamente por las consultas en un estado RUNNING determinado de una reserva. Esta métrica se emite solo cuando el grupo de trabajo está asociado a una reserva de capacidad e incluye todos los grupos de trabajo asociados a una reserva. Si mueve un grupo de trabajo de una reserva a otra, la métrica incluye datos del momento en que el grupo de trabajo pertenecía a la primera reserva. Para obtener información sobre cómo compartir reservas de capacidad, consulte [Administración de la capacidad de procesamiento de consultas](capacity-management.md). |
| DPUCount | El número máximo de DPU consumidas por la consulta, que se publica exactamente una vez cuando se completa la consulta. Esta métrica se emite solo para los grupos de trabajo asociados a una reserva de capacidad. |
| EngineExecutionTime | El número de milisegundos que la consulta tardó en ejecutarse. |
| ProcessedBytes | Número de bytes que Athena ha analizado por consulta de DML. En el caso de las consultas canceladas (ya sea por los usuarios, automáticamente o por alcanzar el límite), se incluye la cantidad de datos escaneados antes de la cancelación. Esta métrica no se informa para las consultas de DDL. |
| QueryPlanningTime | Número de milisegundos que Athena tardó en planificar el flujo de procesamiento de consultas. Esto incluye el tiempo dedicado a recuperar las particiones de tabla del origen de datos. Tenga en cuenta que debido a que el motor de consultas realiza la planificación de consultas, el tiempo de planificación de consultas es un subconjunto de EngineExecutionTime. |
| QueryQueueTime | Número de milisegundos que la consulta estaba en la cola de consultas en espera de recursos. Tenga en cuenta que si se producen errores transitorios, la consulta se puede agregar automáticamente de nuevo a la cola. |
| ServicePreProcessingTime | Número de milisegundos que Athena tardó en preprocesar la consulta antes de enviarla al motor de consulta. |
| ServiceProcessingTime | Número de milisegundos que Athena tardó en procesar los resultados de la consulta después de que el motor de consulta terminara de ejecutarla. |
| TotalExecutionTime | Número de milisegundos que Athena tardó en ejecutar una consulta de DDL o DML. TotalExecutionTime incluye QueryQueueTime, QueryPlanningTime, EngineExecutionTime y ServiceProcessingTime. |
Las métricas de CloudWatch para Athena tienen las siguientes dimensiones.
| Dimensión | Descripción |
| --- | --- |
| CapacityReservation | El nombre de la reserva de capacidad utilizada para ejecutar la consulta, si corresponde. Cuando no se utiliza una reserva de capacidad, esta dimensión no devuelve ningún dato. |
| QueryState | El estado de la consulta. Estadísticas válidas: SUCCEEDED, FAILED o CANCELED. |
| QueryType | El tipo de consulta. Estadísticas válidas: `DDL`, `DML` o `UTILITY`. El tipo de instrucción de consulta que se ejecutó. `DDL` indica las instrucciones de consulta DDL (lenguaje de definición de datos). `DML` indica instrucciones de consulta DML (lenguaje de manipulación de datos), como `CREATE TABLE AS SELECT`. `UTILITY` indica instrucciones de consulta distintas de DDL y DML, como `SHOW CREATE TABLE` o `DESCRIBE TABLE`. |
| WorkGroup | El nombre del grupo de trabajo. |