Usar a fonte de dados Athena - Amazon Managed Grafana
Políticas do IAMDados de consulta do Athena Modelos e variáveisAnotaçõesCompatibilidade de dados de consulta assíncronaReutilização dos resultados da consulta

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usar a fonte de dados Athena

Políticas do IAM

O Grafana precisa de permissões concedidas por meio do IAM para poder ler as métricas do Athena. Você pode anexar essas permissões aos perfis do IAM e usar o suporte integrado do Grafana para assumir perfis. Observe que você precisará configurar a política necessária para o perfil antes de adicionar a fonte de dados ao Grafana. Você precisará de um perfil de administrador ou editor para adicionar uma fonte de dados. A política de acesso integrada do Amazon Grafana Athena é definida na seção AWS política gerenciada: AmazonGrafanaAthenaAccess .

Dados de consulta do Athena

A fonte de dados Athena fornece um editor de consultas SQL padrão. O Amazon Managed Grafana inclui alguns macros para ajudar a escrever consultas de séries temporais mais complexas.

Macros

Macro Descrição Exemplo Exemplo de saída
$__dateFilter(column) $__dateFilter cria um filtro condicional que seleciona os dados (usando column) com base no intervalo de datas do painel. $__date(my_date) my_date BETWEEN date '2017-07-18' AND date '2017-07-18'
$__parseTime(column,format) $__parseTime lança um varchar como um carimbo de data e hora com o formato fornecido. $__parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') parse_datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z')
$__timeFilter(column,format) $__timeFilter cria uma condicional que filtra os dados (usando column) com base no intervalo de tempo do painel. O segundo argumento é usado para analisar opcionalmente a coluna de um varchar para um carimbo de data e hora com um formato específico. $__timeFilter(time, 'yyyy-MM-dd HH:mm:ss') TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z'
$__timeFrom() $__timeFrom exibe a hora de início atual do intervalo do painel com aspas. $__timeFrom() TIMESTAMP '2017-07-18 11:15:52'
$__timeTo() $__timeTo exibe a hora de término atual do intervalo do painel com aspas. $__timeTo() TIMESTAMP '2017-07-18 11:15:52'
$__timeGroup(column, '1m', format) $__timeGroup agrupa carimbos de data e hora para que haja apenas um ponto para cada período no grafo. O terceiro argumento é usado para analisar opcionalmente a coluna de um varchar para um carimbo de data e hora com um formato específico. $__timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') FROM_UNIXTIME(FLOOR(TO_UNIXTIME(parse_datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)*300)
$__table $__table retorna a tabela selecionada no seletor Tabela. $__table my_table
$__column $__column retorna a coluna selecionada no seletor Coluna (requer uma tabela). $__column col1

Visualização

A maioria das consultas no Athena será melhor representada por uma visualização de tabela. A consulta exibe dados do retorno em uma tabela. Se puder ser consultado, ele poderá ser exibido como uma tabela.

Este exemplo retorna os resultados de uma visualização de tabela: 

SELECT {column_1}, {column_2} FROM {table};

Visualizações de séries temporais e grafos

Para visualizações de séries temporais e grafos, você deve:

  • selecionar uma coluna com uma date ou um tipo de datetime. A coluna date deve estar em ordem crescente (usando ORDER BY column ASC).

  • também selecionar uma coluna numérica.

Inspecionar a consulta

O Amazon Managed Grafana é compatível com macros com os quais o Athena não é, o que significa que uma consulta pode não funcionar quando copiada e colada diretamente no Athena. Para ver a consulta interpolada completa, que funciona diretamente no Athena, clique no botão Inspetor de consultas. A consulta completa é exibida na guia Consulta.

Modelos e variáveis

Para obter mais informações sobre como adicionar uma variável de consulta do Athena, consulte Adicionar uma variável de consulta.. Use a fonte de dados Athena como a fonte de dados para as consultas disponíveis a seguir.

Qualquer valor consultado em uma tabela do Athena pode ser usado como uma variável. Evite selecionar muitos valores, pois isso pode causar problemas de performance.

Depois de criar uma variável, você poderá usá-la nas consultas do Athena usando Sintaxe da variável. Para obter mais informações sobre variáveis, consulte Modelos e variáveis.

Anotações

As Anotações permitem que você sobreponha informações importantes de eventos nos grafos. Você pode adicionar anotações selecionando o painel ou adicionando consultas de anotação usando a visualização Anotações do menu Dashboard.

Um exemplo de consulta para adicionar anotações automaticamente:

SELECT
  time as time,
  environment as tags,
  humidity as text
FROM
  tableName
WHERE
  $__dateFilter(time) and humidity > 95

A tabela a seguir representa as descrições das colunas que podem ser usadas para renderizar anotações:

Nome Descrição
Time O nome do tipo de date/time field. Could be a column with a native SQL date/time dados ou valor da época.
Timeend Nome opcional do tipo de date/time field. Could be a column with a native SQL date/time dados final ou valor da época. (Grafana v6.6+)
Text Campo de descrição do evento.
Tags Nome de campo opcional a ser usado para tags de eventos como uma string separada por vírgula.

Compatibilidade de dados de consulta assíncrona

As consultas do Athena no Amazon Managed Grafana são tratadas de forma assíncrona para evitar tempos limite. As consultas assíncronas usam solicitações separadas para iniciar a consulta, verificar seu progresso e, finalmente, obter os resultados. Isso evita os tempos limite para consultas executadas por um longo tempo.

Reutilização dos resultados da consulta

Para melhorar a performance da consulta, você pode reutilizar os resultados das consultas anteriores. Para habilitar a reutilização de consultas, habilite-as na seção Reutilização de resultados da consulta do editor de consultas. Esse processo deverá ser seguido para cada consulta que desejar reutilizar.

nota

Esse recurso exige que a instância do Athena esteja na versão 3 do mecanismo. Para obter mais informações, consulte Alterar versões do mecanismo do Athena no Guia do usuário do Amazon Athena.