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á.
Consulte e transforme dados
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
O Grafana oferece suporte a vários tipos de fontes de dados. As consultas às fontes de dados retornam dados que o Grafana pode transformar e visualizar. Cada fonte de dados usa sua própria linguagem de consulta, e cada plug-in de fonte de dados implementa uma interface de usuário de criação de consultas chamada editor de consultas.
Sobre consultas
Os painéis Grafana se comunicam com as fontes de dados por meio de consultas, que recuperam dados para a visualização. Uma consulta é uma pergunta escrita na linguagem de consulta usada pela fonte de dados.
Você pode configurar a frequência de consultas e os limites de coleta de dados nas opções da fonte de dados do painel. O Grafana suporta até 26 consultas por painel.
Você pode encontrar mais informações sobre a linguagem de consulta de cada fonte de dados na seção Fontes de dados.
Editores de consultas
O editor de consultas de cada fonte de dados fornece uma interface de usuário personalizada que ajuda você a escrever consultas que aproveitam seus recursos exclusivos.
Devido às diferenças entre as linguagens de consulta, cada editor de consulta de fonte de dados parece e funciona de forma diferente. Dependendo da fonte de dados, o editor de consultas pode fornecer recursos de preenchimento automático, nomes de métricas, sugestões de variáveis ou uma interface visual de criação de consultas.
Para obter detalhes sobre os recursos exclusivos do editor de consultas de uma fonte de dados específica, consulte sua documentação:
-
Para fontes de dados incluídas no Grafana, consulte Fontes de dados integradas.
-
Para fontes de dados incluídas na edição Grafana Enterprise, consulte. Conecte-se às fontes de dados corporativas
Sintaxe de consulta
As fontes de dados usam linguagens de consulta diferentes para solicitar dados. Para obter detalhes sobre a linguagem de consulta exclusiva de uma fonte de dados específica, consulte sua documentação.
Exemplo de PostgreSQL:
SELECT hostname FROM host WHERE region IN($region)
Exemplo de PromQL:
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Fontes de dados especiais
O Grafana também inclui três fontes de dados especiais: Grafana, Mixed e Dashboard. Para obter detalhes, consulte Fontes de dados
Navegue pela guia de consulta
A guia Consulta de um painel consiste nos seguintes elementos:
-
Seletor de fonte de dados — Seleciona a fonte de dados a ser consultada.
-
Opções de consulta: — Define parâmetros máximos de recuperação de dados e intervalos de tempo de execução da consulta.
-
Botão do inspetor de consultas: — Abre o painel do inspetor de consultas, onde você pode visualizar e otimizar sua consulta.
-
Lista do editor de consultas: — Lista as consultas que você escreveu.
-
Expressões: — Usa o construtor de expressões para criar expressões de alerta. Para obter mais informações sobre expressões, consulte Escrever consultas de expressão.
Adicionar uma consulta
Uma consulta retorna dados que o Grafana visualiza nos painéis do painel. Quando você cria um painel, o Grafana seleciona automaticamente a fonte de dados padrão.
Para adicionar uma consulta
-
Edite o painel ao qual você está adicionando uma consulta.
-
Escolha a guia Queries (Consultas).
-
Escolha o menu suspenso Fonte de dados e selecione uma fonte de dados.
-
Escolha Opções de consulta para configurar o número máximo de pontos de dados necessários. Para obter mais informações sobre as opções de consulta, consulteOpções de consulta.
-
Escreva a consulta usando o editor de consultas.
-
Escolha Aplicar.
Grafana consulta a fonte de dados e visualiza os dados.
Gerenciar consultas
Grafana organiza as consultas em linhas de consulta recolhíveis. Cada linha de consulta contém um editor de consultas e é identificada com uma letra (A, B, C e assim por diante).
Para gerenciar suas consultas, você pode copiar consultas, ocultar consultas, remover uma consulta, reordenar consultas e alternar a ajuda para o editor de consultas.
Opções de consulta
Escolha Opções de consulta ao lado do seletor da fonte de dados para ver as configurações da fonte de dados selecionada. As alterações feitas aqui afetam somente as consultas feitas nesse painel.
Grafana define padrões que são mostrados em texto cinza escuro. As alterações são exibidas em texto branco. Para retornar um campo à configuração padrão, exclua o texto em branco do campo.
As opções de consulta da fonte de dados do painel incluem:
-
Máximo de pontos de dados — Se a fonte de dados suportar, isso define o número máximo de pontos de dados para cada série retornada. Se a consulta retornar mais pontos de dados do que a configuração de máximo de pontos de dados, a fonte de dados reduzirá o número de pontos retornados agregando-os por média, máximo ou outra função.
Você pode limitar o número de pontos para melhorar o desempenho da consulta ou suavizar a linha visualizada. O valor padrão é a largura (ou número de pixels) do gráfico, porque você só pode visualizar tantos pontos de dados quanto o painel gráfico tiver espaço para exibir.
Com dados de streaming, o Grafana usa o valor máximo de pontos de dados para o buffer contínuo. O streaming é um fluxo contínuo de dados, e o buffer divide o fluxo em partes. Por exemplo, o Loki transmite dados em seu modo de rastreamento ao vivo.
-
Intervalo mínimo — Define um limite mínimo para o intervalo calculado automaticamente, que normalmente é o intervalo mínimo de raspagem. Se um ponto de dados for salvo a cada 15 segundos, você não se beneficiará de ter um intervalo menor do que isso. Você também pode definir isso como um mínimo maior do que o intervalo de coleta para recuperar consultas mais granulares e que funcionem bem.
-
Intervalo — Define um intervalo de tempo que você pode usar ao agregar ou agrupar pontos de dados por tempo.
O Grafana calcula automaticamente um intervalo apropriado que você pode usar como variável em consultas modeladas. A variável é medida em segundos (
$__interval
) ou milissegundos ($__interval_ms
).Os intervalos são normalmente usados em funções de agregação, como soma ou média. Por exemplo, esta é uma consulta do Prometheus que usa a variável de intervalo:.
rate(http_requests_total[$__interval])
Esse intervalo automático é calculado com base na largura do gráfico. Conforme o usuário diminui o zoom em uma visualização, o intervalo aumenta, resultando em uma agregação mais granulada. Da mesma forma, se o usuário aumentar o zoom, o intervalo diminui, resultando em uma agregação mais refinada.
Para ter mais informações, consulte Variáveis globais.
-
Tempo relativo — substitui o intervalo de tempo relativo para painéis individuais, o que faz com que eles sejam diferentes do que está selecionado no seletor de tempo do painel no canto superior direito do painel. Você pode usar isso para mostrar métricas de diferentes períodos ou dias no mesmo painel.
nota
As substituições de tempo do painel não têm efeito quando o intervalo de tempo do painel é absoluto.
Exemplo Campo de tempo relativo Últimos 5 minutos
now-5m
O dia até agora
now/d
Últimos 5 dias
now-5d/d
Esta semana até agora
now/w
Últimos 2 anos
now-2y/y
-
Mudança de horário — substitui o intervalo de tempo de painéis individuais mudando seu início e fim em relação ao seletor de tempo. Por exemplo, você pode alterar o intervalo de tempo do painel para duas horas antes do seletor de horas do painel.
nota
As substituições de tempo do painel não têm efeito quando o intervalo de tempo do painel é absoluto.
Exemplo Campo de mudança de horário Última semana inteira
1w/w
Duas semanas inteiras atrás
2w/w
Último mês inteiro
1M/M
Esse ano inteiro
1d/y
Último ano inteiro
1y/y
-
Tempo limite de cache — (Visível somente se disponível na fonte de dados) Substitui o tempo limite de cache padrão se seu armazenamento de séries temporais tiver um cache de consulta. Especifique esse valor como um valor numérico em segundos.