Consultas

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

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

Os painéis do espaço de trabalho do Grafana usam consultas para se comunicar com fontes de dados e obter dados para a visualização. Uma consulta é uma pergunta escrita na linguagem de consulta usada pela fonte de dados. Se a consulta for formada corretamente, a fonte de dados responderá. Nas opções da fonte de dados do painel, você pode ajustar a frequência com que a consulta é enviada à fonte de dados e quantos pontos de dados são coletados.

Os espaços de trabalho do Grafana suportam até 26 consultas por painel.

Editores de consultas

Editores de consultas são formulários que ajudam você a escrever consultas. Dependendo da sua fonte de dados, o editor de consultas pode fornecer preenchimento automático, nomes de métricas ou sugestão de variáveis.

Devido às diferenças entre as linguagens de consulta, as fontes de dados podem ter editores de consulta com aparência diferente.

Sintaxe de consulta

As fontes de dados têm linguagens de consulta e sintaxes diferentes para solicitar os dados. Aqui estão dois exemplos de consulta.

PostgreSQL

SELECT hostname FROM host WHERE region IN($region)

PromQL

query_result(max_over_time(<metric>[${__range_s}s]) != <state>)

Para obter mais informações sobre como escrever uma consulta para sua fonte de dados, consulte a documentação dessa fonte de dados. As fontes de dados estão listadas emFontes de dados.

UI da guia Consulta

A guia Consulta consiste nos seguintes elementos:

• Seletor de fonte de dados

• Opções de consulta

• Botão do inspetor de consultas

• Lista do editor de consultas

Seletor de fonte de dados

O seletor da fonte de dados é uma lista suspensa. Escolha-a para selecionar uma fonte de dados que você adicionou. Quando você cria um painel, o Amazon Managed Grafana seleciona automaticamente sua fonte de dados padrão. Para obter mais informações sobre fontes de dados, consulteFontes de dados.

Além das fontes de dados que você configurou em seu espaço de trabalho do Grafana, três fontes de dados especiais estão disponíveis.

• TestDataDB — Uma fonte de dados integrada que gera dados de caminhada aleatórios. A fonte de dados Grafana é útil para testar visualizações e executar experimentos.

• Mista — Uma fonte de dados para consultar várias fontes de dados no mesmo painel. Quando essa fonte de dados é selecionada, você pode selecionar uma fonte de dados para cada nova consulta adicionada.

  • A primeira consulta usará a fonte de dados selecionada antes de você selecionar Misto.

  • Você não pode alterar uma consulta existente para usar a fonte de dados mista.

• Painel — Uma fonte de dados para usar um conjunto de resultados de outro painel no mesmo painel.

Opções de consulta

Para ver as configurações da fonte de dados selecionada, escolha Opções de consulta ao lado do seletor da fonte de dados. As alterações feitas aqui afetam somente as consultas feitas nesse painel.

O Amazon Managed 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.

Você pode usar as seguintes opções de consulta de fonte de dados em painel:

• Máximo de pontos de dados — Se a fonte de dados suportar, 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 os consolidará (reduz o número de pontos retornados ao agregá-los por média, máximo ou outra função).

  Há duas razões principais para limitar o número de pontos: desempenho e suavização da linha. O valor padrão é a largura (ou número de pixels) do gráfico, o que evita ter mais pontos de dados do que o painel gráfico pode exibir.

  Com dados de streaming, o valor máximo de pontos de dados é usado para o buffer contínuo. (O streaming é um fluxo contínuo de dados e o armazenamento em buffer é uma forma de dividir o fluxo em partes).

• Intervalo mínimo — Define um limite mínimo para o intervalo calculado automaticamente, normalmente o intervalo mínimo de raspagem. Se um ponto de dados for salvo a cada 15 segundos, você não precisará ter um intervalo menor do que isso. Outro caso de uso é configurá-lo para um mínimo maior do que o intervalo de coleta para obter consultas mais detalhadas e que funcionem bem.

• Intervalo — Um intervalo de tempo que você pode usar ao agregar ou agrupar pontos de dados por tempo.

  O Amazon Managed Grafana calcula automaticamente um intervalo apropriado que pode ser usado como uma variável em consultas modeladas. A variável está em segundos:$__interval; ou em milissegundos:$__interval_ms. Normalmente é usado em funções de agregação como sum ouaverage. Por exemplo, esta é uma consulta do Prometheus usando a variável de intervalo:. rate(http_requests_total[$__interval])

  Esse intervalo automático é calculado com base na largura do gráfico. Se o usuário diminuir muito o zoom, o intervalo se torna maior, resultando em uma agregação mais granulada. Se o usuário aumentar o zoom, o intervalo diminuirá, resultando em uma agregação mais refinada.

  Para ter mais informações, consulte Variáveis globais.

• Tempo relativo — Substituição do intervalo de tempo relativo para painéis individuais, fazendo com que sejam diferentes do que está selecionado no seletor de tempo do painel no canto superior direito do painel. Isso permite que você mostre métricas de diferentes períodos ou dias no mesmo painel.

• Mudança de horário — fornece outra maneira de substituir o intervalo de tempo para painéis individuais. Essa função funciona somente com intervalos de tempo relativos e você pode ajustar o intervalo de tempo.

  Por exemplo, você pode alterar o intervalo de tempo do painel para 2 horas antes do seletor de hora do painel. Para ter mais informações, consulte Controles de intervalo de tempo.

• Tempo limite do cache — (Esse campo só é visível se estiver disponível na sua fonte de dados.) Substitui o tempo limite de cache padrão se seu armazenamento de séries temporais tiver um cache de consulta. Ele é especificado como um valor numérico em segundos.

Botão do inspetor de consultas

Você pode escolher Inspetor de consultas para abrir a guia Consulta do inspetor de painéis. Na guia Consulta, você pode ver a solicitação de consulta enviada pelo painel e a resposta.

Escolha Atualizar para ver o texto completo da solicitação enviada por esse painel ao servidor.

nota

Você precisa adicionar pelo menos uma consulta para que o inspetor de consultas possa retornar os resultados.

Para obter mais informações sobre o inspetor do painel, consulteInspecionar um painel.

Lista do editor de consultas

Na interface do usuário, as consultas são organizadas 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).

Compartilhamento de resultados de consultas entre painéis

Com o Amazon Managed Grafana, você pode usar o resultado da consulta de um painel para qualquer outro painel no painel. O compartilhamento dos resultados da consulta entre painéis reduz o número de consultas feitas à sua fonte de dados, o que pode melhorar o desempenho do seu painel.

A fonte de dados do Painel permite que você selecione um painel em seu painel que contém as consultas para as quais você deseja compartilhar os resultados. Em vez de enviar uma consulta separada para cada painel, o Amazon Managed Grafana envia uma consulta, e outros painéis usam os resultados da consulta para criar visualizações.

Essa estratégia pode reduzir drasticamente o número de consultas feitas quando, por exemplo, você tem vários painéis visualizando os mesmos dados.

Para compartilhar consultas de fontes de dados com outro painel

1. Crie um painel. Para ter mais informações, consulte Criação de um painel.

2. Adicione um painel. Para ter mais informações, consulte Adicionando um painel.

3. Altere o título paraSource panel. Você usará esse painel como fonte para os outros painéis. Defina a consulta ou consultas que serão compartilhadas. Se você não tiver uma fonte de dados disponível no momento, poderá usar a fonte de dados Grafana, que retorna uma série temporal aleatória que você pode usar para testes.

4. Adicione um segundo painel e selecione a fonte de dados do Dashboard no editor de consultas.

5. Em Usar resultados da lista de painéis, selecione o primeiro painel que você criou.

Todas as consultas definidas no painel de origem agora estão disponíveis para o novo painel. As consultas feitas no painel de origem podem ser compartilhadas com vários painéis.

Para acessar um painel em que uma consulta é definida, escolha essa consulta.