O Athena publica as métricas relacionadas à consulta no Amazon CloudWatch, quando a opção Publish query metrics to CloudWatch (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 deRUNNINGem 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 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, ouCANCELED -
QueryType–DML,DDL, ouUTILITY -
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 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.
Você pode visualizar as métricas de consultas no console do Athena ou no console do CloudWatch.
Para visualizar as métricas de consultas para um grupo de trabalho no console do Athena
Abra o console do Athena em https://console.aws.amazon.com/athena/
. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.
-
No painel de navegação, escolha Global networks (Redes globais).
-
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.
-
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.
-
Para atualizar as métricas exibidas, escolha o ícone de atualização.
-
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.
Para visualizar as métricas de consultas para um grupo de trabalho no console do Athena
Abra o console do Athena em https://console.aws.amazon.com/athena/
. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.
-
No painel de navegação, escolha Global networks (Redes globais).
-
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.
-
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.
-
Para atualizar as métricas exibidas, escolha o ícone de atualização.
-
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.
Para visualizar as métricas no console do Amazon CloudWatch
Abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/
. -
No painel de navegação, escolha Metrics (Métricas), All metrics (Todas as métricas).
-
Selecione o namespace AWS/Athena.
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"
-
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. |
| 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: |
| WorkGroup |
O nome do grupo de trabalho. |
