Alertas sobre dados numéricos

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte ao Grafana versão 9.x.

Para espaços de trabalho do Grafana que suportam a versão 10.x do Grafana, consulte. Trabalhando na versão 10 do Grafana

Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

Este tópico descreve como o Grafana lida com alertas em dados numéricos em vez de dados de séries temporais.

Entre determinadas fontes de dados, os dados numéricos que não são séries temporais podem ser diretamente alertados ou passados para as Expressões do Lado do Servidor (SSE). Isso permite mais processamento e eficiência resultante na fonte de dados, além de simplificar as regras de alerta. Ao alertar sobre dados numéricos em vez de dados de séries temporais, não há necessidade de reduzir cada série temporal rotulada em um único número. Em vez disso, os números rotulados são devolvidos à Grafana.

Dados tabulares

Esse recurso é compatível com fontes de dados de back-end que consultam dados tabulares:

• Fontes de dados SQL, como MySQL, Postgres, MSSQL e Oracle.

• Os serviços baseados no Azure Kusto: Azure Monitor (Logs), Azure Monitor (Azure Resource Graph) e Azure Data Explorer.

Uma consulta com alertas gerenciados pelo Grafana ou SSE é considerada numérica com essas fontes de dados, se:

• A opção “Formatar AS” está definida como “Tabela” na consulta da fonte de dados.

• A resposta da tabela retornada ao Grafana a partir da consulta inclui apenas uma coluna numérica (por exemplo, int, double, float) e, opcionalmente, colunas de string adicionais.

Se houver colunas de string, essas colunas se tornarão rótulos. O nome da coluna se torna o nome do rótulo e o valor de cada linha se torna o valor do rótulo correspondente. Se várias linhas forem retornadas, cada linha deverá ter seus rótulos identificados de forma exclusiva.

Exemplo

Para uma tabela MySQL chamada “”: DiskSpace

Tempo	Host	Disk	PercentFree
7 de junho de 2021	web1	/etc	3
7 de junho de 2021	web2	/var	4
7 de junho de 2021	web3	/var	8
...	...	...	...

Você pode consultar a filtragem de dados a tempo, mas sem retornar a série temporal ao Grafana. Por exemplo, um alerta que seria acionado por host, disco quando houvesse menos de 5% de espaço livre:

SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
   SELECT
      Host, 
      Disk, 
      Avg(PercentFree) 
   FROM DiskSpace
   Group By
      Host, 
      Disk 
   Where __timeFilter(Time)

Essa consulta retorna a seguinte resposta da Tabela para Grafana:

Host	Disk	PercentFree
web1	/etc	3
web2	/var	4
web3	/var	0

Quando essa consulta é usada como condição em uma regra de alerta, o que não é zero será um alerta. Como resultado, três instâncias de alerta são produzidas:

Rótulos	Status
{host = Web1, disco =/etc}	Geração de alertas
{host = Web2, disco =/var}	Geração de alertas
{host = Web3, disco =/var}	Normal