Consultar e transformar de dados - Amazon Managed Grafana

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á.

Consultar e transformar de dados

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x.

Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.

Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.

O Amazon Managed Grafana é compatível com os 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 do 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 é compatível com até 26 consultas por painel.

Você pode encontrar mais informações sobre cada linguagem de consulta da fonte de dados na seção Fontes de dados.

Editores de consultas

Cada editor de consultas da 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 consultas da fonte de dados tem um formato 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, incluindo informações sobre consultas e sintaxe, consulte a documentação da fonte de dados:

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, Mista e Dashboard. Para obter mais informações, consulte Conectar-se à fonte 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 os 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, no qual você pode visualizar e otimizar a 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 Gravar consultas de expressão.

Adicionar uma consulta

Uma consulta retorna dados que o Grafana visualiza nos painéis do dashboard. Quando você cria um painel, o Grafana seleciona automaticamente a fonte de dados padrão.

Para adicionar uma consulta
  1. Edite o painel ao qual você está adicionando uma consulta.

  2. Escolha a guia Queries (Consultas).

  3. Escolha o menu suspenso Fonte de dados e selecione uma fonte de dados.

  4. Escolha Opções de consulta para configurar o número máximo de pontos de dados necessários. Para obter mais informações sobre essas opções, consulte Opções de consulta.

  5. Escreva a consulta usando o editor de consultas.

  6. Escolha Aplicar.

O Grafana consulta a fonte de dados e visualiza os dados.

Gerenciar consultas

O 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 as consultas, você pode copiar, ocultar, remover e reordená-las 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.

O Grafana define padrões que são mostrados em texto cinza escuro. As alterações são exibidas em texto na cor branca. Para retornar um campo à configuração padrão, exclua o texto na cor branca 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 for compatível, isso definirá 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 máxima de pontos de dados, a fonte de dados reduzirá o número de pontos retornados ao agregá-los por média, máximo ou outra função.

    Você pode limitar o número de pontos para melhorar a performance da consulta ou suavizar a linha visualizada. O valor padrão é a largura (ou o número de pixels) do grafo, porque você só pode visualizar a quantidade de pontos de dados que o painel de grafo tem 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 blocos.

  • Intervalo mínimo: define um limite mínimo para o intervalo calculado automaticamente, que normalmente é o intervalo mínimo de extração. 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 para um mínimo maior do que o intervalo de extração para recuperar consultas mais simplificadas e funcionais.

  • 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 grafo. Conforme o usuário diminui o zoom em uma visualização, o intervalo aumenta, resultando em uma agregação mais simplificada. Da mesma forma, se o usuário aumentar o zoom, o intervalo diminuirá, resultando em uma agregação mais refinada.

    Para obter 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 dashboard no canto superior direito do dashboard. Você pode usar isso para mostrar métricas de diferentes períodos ou dias no mesmo dashboard.

    nota

    As substituições de tempo do painel não têm efeito quando o intervalo de tempo do dashboard é absoluto.

    Exemplo Campo de tempo relativo

    Últimos 5 minutos

    now-5m

    O dia até o momento

    now/d

    Últimos 5 dias

    now-5d/d

    Esta semana até o momento

    now/w

    Últimos 2 anos

    now-2y/y

  • Mudança de tempo: substitui o intervalo de tempo de painéis individuais ao mudar o início e o 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 tempo do dashboard.

    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 tempo

    Semana passada

    1w/w

    Há duas semanas

    2w/w

    Mês passado

    1M/M

    Este ano

    1d/y

    Ano passado

    1y/y

  • Tempo limite de cache: (visível somente se disponível na fonte de dados) substituirá o tempo limite de cache padrão se seu armazenamento de séries temporais tiver um cache de consulta. Especifique este valor como um valor numérico em segundos.