# Monitorar métricas de consultas do Athena com o CloudWatch
<a name="query-metrics-viewing"></a>

O Athena publica as métricas relacionadas à consulta no Amazon CloudWatch, quando a opção [Publish query metrics to CloudWatch](athena-cloudwatch-metrics-enable.md) (Publicar métricas de consulta no CloudWatch) está selecionada. Você pode criar painéis personalizados, definir alarmes e acionadores com base nas métricas no CloudWatch ou usar painéis pré-preenchidos diretamente no console do Athena. 

Quando você habilitar as métricas de consulta nos grupos de trabalho, elas serão exibidas na guia **Metrics** (Métricas) do painel **Workgroups** (Grupos de trabalho) para cada grupo de trabalho do console do Athena.

O Athena publica as seguintes métricas no console do CloudWatch:
+ `DPUAllocated`: o número total de DPUs (unidades de processamento de dados) provisionadas em uma reserva de capacidade para executar consultas.
+ `DPUConsumed`: o número de DPUs consumidas ativamente por consultas em um estado de `RUNNING` em um dado momento em uma reserva. Métrica emitida somente quando o grupo de trabalho está associado a uma reserva de capacidade e inclui todos os grupos de trabalho associados a uma reserva. 
+ `DPUCount`: o número máximo de DPUs consumidas pela consulta, publicado exatamente uma vez quando a consulta é concluída.
+ `EngineExecutionTime`: o número de milissegundos que a consulta levou para ser executada.
+ `ProcessedBytes`: o número de bytes verificados pelo Athena por consulta DML.
+ `QueryPlanningTime`: o número de milissegundos que o Athena levou para planejar o fluxo de processamento da consulta.
+ `QueryQueueTime`: o número de milissegundos que a consulta ficou na fila de consultas aguardando recursos.
+ `ServicePreProcessingTime`: o número de milissegundos que o Athena levou para pré-processar a consulta antes de enviá-la para o mecanismo de consulta.
+ `ServiceProcessingTime`: o número de milissegundos que o Athena levou para processar os resultados da consulta depois que o mecanismo de consulta concluiu sua execução.
+ `TotalExecutionTime`: o número de milissegundos que o Athena levou para executar uma consulta DDL ou DML. 

Para obter descrições mais completas, consulte [Lista de métricas e dimensões do CloudWatch para o Athena](#athena-cloudwatch-metrics-table) mais adiante neste documento.

Essas métricas têm as seguintes dimensões:
+ `CapacityReservation`: o nome da reserva de capacidade usada para executar a consulta, se aplicável.
+ `QueryState` – `SUCCEEDED`, `FAILED`, ou `CANCELED`
+ `QueryType` – `DML`, `DDL`, ou `UTILITY`
+ `WorkGroup`: nome do grupo de trabalho

O Athena publica a seguinte métrica no console do CloudWatch sob o namespace `AmazonAthenaForApacheSpark`:
+ `DPUCount`: a quantidade de DPUs consumidas durante a sessão para executar os cálculos.

Essa métrica tem as seguintes dimensões:
+ `SessionId`: o ID da sessão para a qual os cálculos são enviados.
+ `WorkGroup`: o nome do grupo de trabalho.

Para obter mais informações, consulte [Lista de métricas e dimensões do CloudWatch para o Athena](#athena-cloudwatch-metrics-table) posteriormente neste tópico. Para obter mais informações as métricas de uso do Athena, consulte [Monitorar métricas de uso do Athena com o CloudWatch](monitoring-athena-usage-metrics.md).

Você pode visualizar as métricas de consultas no console do Athena ou no console do CloudWatch.

## Visualizar métricas de consultas no console do Athena
<a name="query-metrics-viewing-athena-console"></a>

**Para visualizar as métricas de consultas para um grupo de trabalho no console do Athena**

1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.  
![\[Escolha o menu de expansão.\]](http://docs.aws.amazon.com/pt_br/athena/latest/ug/images/nav-pane-expansion.png)

1. No painel de navegação, escolha **Global networks** (Redes globais).

1. Escolha o grupo de trabalho que você deseja na lista e escolha a guia **Metrics** (Métricas). 

   O painel de métricas é exibido.
**nota**  
Se você ativou recentemente métricas para o grupo de trabalho e/ou não houve nenhuma atividade de consulta recente, os gráficos no painel poderão ficar vazios. A atividade de consulta é recuperada do CloudWatch dependendo do intervalo especificado na próxima etapa. 

1. Na seção **Metrics** (Métricas), escolha o intervalo de métricas que o Athena deve usar para buscar as métricas de consulta do CloudWatch ou especifique um intervalo personalizado.  
![\[Especificar o intervalo de recuperação de métricas para um grupo de trabalho no console do Athena.\]](http://docs.aws.amazon.com/pt_br/athena/latest/ug/images/wg-custom-interval.png)

1. Para atualizar as métricas exibidas, escolha o ícone de atualização.  
![\[Escolha o ícone de atualização.\]](http://docs.aws.amazon.com/pt_br/athena/latest/ug/images/wg-refresh-metrics.png)

1. Clique na seta ao lado do ícone de atualização para escolher com que frequência você deseja que a exibição de métricas seja atualizada.  
![\[Escolher um intervalo de atualização para a exibição das métricas do grupo de trabalho no console do Athena.\]](http://docs.aws.amazon.com/pt_br/athena/latest/ug/images/wg-choose-refresh-interval.png)

## Visualizar métricas de consultas no console do CloudWatch
<a name="query-metrics-viewing-cw-console"></a>

**Para visualizar as métricas no console do Amazon CloudWatch**

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Metrics** (Métricas), **All metrics** (Todas as métricas).

1. Selecione o namespace **AWS/Athena**.

## Visualizar métricas de consultas com a AWS CLI
<a name="query-metrics-viewing-cli"></a>

**Para visualizar métricas com a AWS CLI**
+ Execute um destes procedimentos:
  + Para listar as métricas do Athena, abra um prompt de comando e use o seguinte comando:

    ```
    aws cloudwatch list-metrics --namespace "AWS/Athena"
    ```
  + Para listar todas as métricas disponíveis, use o comando a seguir:

    ```
    aws cloudwatch list-metrics"
    ```

## Lista de métricas e dimensões do CloudWatch para o Athena
<a name="athena-cloudwatch-metrics-table"></a>

Se você habilitou as métricas do CloudWatch no Athena, ele enviará as métricas a seguir ao CloudWatch por grupo de trabalho. As métricas a seguir usam o namespace `AWS/Athena`.


| Nome da métrica | Descrição | 
| --- | --- | 
| DPUAllocated |  O número total de DPUs (unidades de processamento de dados) provisionadas em uma reserva de capacidade para executar consultas.   | 
| DPUConsumed | O número de DPUs consumidas ativamente por consultas em um estado de RUNNING em um dado momento em uma reserva. Essa métrica só é emitida quando o grupo de trabalho está associado a uma reserva de capacidade e inclui todos os grupos de trabalho associados a uma reserva. Se você mover um grupo de trabalho de uma reserva para outra, a métrica incluirá dados de quando o grupo de trabalho pertencia à primeira reserva. Para obter mais informações sobre reservas de capacidade, consulte [Gerenciar a capacidade de processamento de consulta](capacity-management.md). | 
| DPUCount | O número máximo de DPUs consumidas pela consulta, publicado exatamente uma vez quando a consulta é concluída. Essa métrica só é emitida para grupos de trabalho associados a uma reserva de capacidade. | 
| EngineExecutionTime |  O número de milissegundos que a consulta levou para ser executada.  | 
| ProcessedBytes |  O número de bytes verificados pelo Athena para cada consulta DML. Para consultas que foram canceladas (pelo usuários, ou automaticamente, se atingiram o limite), isso inclui a quantidade de dados verificada antes da hora do cancelamento. Essa métrica não é relatada para consultas DDL.  | 
| QueryPlanningTime | O número de milissegundos que o Athena levou para planejar o fluxo de processamento da consulta. Isso inclui o tempo gasto recuperando partições de tabela da fonte de dados. Observe que, como o mecanismo de consulta executa o planejamento da consulta, o tempo de planejamento de consulta é um subconjunto de EngineExecutionTime. | 
| QueryQueueTime | O número de milissegundos que a consulta estava na fila de consultas aguardando recursos. Observe que, se ocorrerem erros temporários, a consulta poderá ser adicionada automaticamente de volta à fila. | 
| ServicePreProcessingTime | O número de milissegundos que o Athena levou para pré-processar a consulta antes de enviá-la para o mecanismo de consulta. | 
| ServiceProcessingTime | O número de milissegundos que o Athena levou para processar os resultados da consulta depois que o mecanismo de consulta concluiu a execução da consulta. | 
| TotalExecutionTime | O número de milissegundos que o Athena levou para executar uma consulta DDL ou DML. TotalExecutionTime inclui QueryQueueTime, QueryPlanningTime, EngineExecutionTime e ServiceProcessingTime. | 

Essas métricas do Athena têm as dimensões a seguir.


| Dimensão | Descrição | 
| --- | --- | 
| CapacityReservation |  O nome da reserva de capacidade usada para executar a consulta, se aplicável. Quando uma reserva de capacidade não é usada, essa dimensão não retorna nenhum dado.  | 
| QueryState |  O estado da consulta. Estatísticas válidas: SUCCEEDED, FAILED ou CANCELED.  | 
| QueryType |  O tipo de consulta. Estatísticas válidas: `DDL`, `DML` ou `UTILITY`. O tipo de instrução de consulta que foi executada. `DDL` indica instruções de consulta DDL (Data Definition Language). `DML` indica instruções de consulta DML (Data Manipulation Language), como `CREATE TABLE AS SELECT`. `UTILITY` indica instruções de consulta diferentes de DDL e DML, como `SHOW CREATE TABLE` ou `DESCRIBE TABLE`.  | 
| WorkGroup |  O nome do grupo de trabalho.  |