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á.
Gerenciamento de consultas no Explore
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte Trabalhar no Grafana versão 10.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
Para ajudar na depuração de consultas, o Explore permite que você investigue solicitações e respostas de consultas, bem como as estatísticas de consultas, por meio do Inspetor de consultas. Essa funcionalidade é semelhante às tarefas Inspecionar performance da consulta e Inspecionar os dados de solicitação e resposta da consulta do inspetor do painel.
Histórico de consultas
O histórico de consultas é uma lista de consultas que você usou no Explore. O histórico é armazenado no banco de dados do Grafana e não é compartilhado com outros usuários. O período de retenção das consultas no histórico é de duas semanas. As consultas com mais de duas semanas são excluídas automaticamente. Para abrir e interagir com o histórico, selecione o botão Histórico de consultas no Explore.
nota
As consultas com estrela (favoritas) não estão sujeitas ao período de retenção de duas semanas e não são excluídas.
Visualizar o histórico de consultas
O histórico de consultas permite que você visualize o histórico de suas consultas. Para cada consulta individual, você pode:
-
Execute uma consulta.
-
Criar e editar um comentário.
-
Copiar uma consulta para a área de transferência.
-
Copiar um link encurtado com a consulta para a área de transferência.
-
Marcar uma consulta com uma estrela (favorita).
Gerenciar consultas favoritas
Todas as consultas com estrela na guia Histórico de consultas são exibidas na lista Com estrela. Isso permite que você acesse suas consultas favoritas com mais rapidez e reutilize essas consultas sem digitá-las do zero.
Classificar o histórico de consultas
Por padrão, o histórico de consultas mostra as consultas mais recentes. Você pode classificar seu histórico por data ou nome de fonte de dados em ordem crescente ou decrescente.
Para classificar o histórico de consultas
-
Selecione o campo Classificar consultas por.
-
Selecione uma das opções a seguir:
-
Mais recente primeiro
-
Mais antigo primeiro
-
Filtrar o histórico de consultas
Você pode filtrar seu histórico de consultas em Histórico de consultas e na guia Com estrela para uma fonte de dados específica.
Filtrar o histórico para uma fonte de dados
-
Selecione o campo Filtrar consultas para fontes de dados específicas.
-
Selecione a fonte de dados que você quer usar para filtrar o histórico. Você também pode selecionar várias fontes de dados.
Na guia Histórico de consultas, também é possível filtrar as consultas por data usando o controle deslizante:
-
Use o controle deslizante vertical para filtrar as consultas por data.
-
Ajuste a data de início arrastando a alça superior.
-
Ajuste a data de término arrastando a alça superior.
Pesquisar no histórico de consultas
Você pode pesquisar nas consultas e comentários do histórico. É possível pesquisar consultas nas guias Histórico de consultas e Com estrela.
Para pesquisar no histórico de consultas
-
Selecione o campo Pesquisar consultas.
-
Insira o termo que você está procurando no campo de pesquisa.
Configurações do histórico de consultas
Você pode personalizar o histórico de consultas na guia Configurações. As opções estão descritas na tabela abaixo.
Configuração | Valor padrão |
---|---|
Alterar a guia ativa padrão | Guia Histórico de consultas |
nota
As configurações do histórico de consultas são globais e aplicadas aos dois painéis no modo de divisão.
Recursos específicos do Prometheus
O Explore oferece uma experiência de consulta personalizada para o Prometheus. Quando uma consulta é executada, na verdade, ela executa duas consultas: uma consulta normal do Prometheus do grafo e uma Consulta instantânea da tabela. Uma consulta instantânea retorna o último valor de cada série temporal, o que mostra um bom resumo dos dados apresentados no grafo.
Explorador de métricas
No lado esquerdo do campo de consulta, escolha Métricas para abrir o Explorador de métricas. Ele mostra um menu hierárquico com métricas agrupadas pelo prefixo. Por exemplo, todas as métricas do Alertmanager são agrupadas no prefixo alertmanager
. Este é um bom ponto de partida se você quiser apenas explorar quais métricas estão disponíveis.
Campo Consulta
O campo Consulta é compatível com o preenchimento automático de nomes e funções de métricas, comparável ao editor de consultas padrão do Prometheus. Você pode pressionar a tecla Enter para criar uma linha e Shift+Enter para executar uma consulta.
O menu de preenchimento automático pode ser acionado pressionando Ctrl+Espaço. O menu Preenchimento automático contém uma nova seção Histórico com uma lista das consultas executadas recentemente.
As sugestões podem aparecer embaixo do campo de consulta. Selecione-as para atualizar a consulta com a alteração sugerida.
-
Para contadores (métricas que aumentam monotonicamente), uma função de taxa será sugerida.
-
Para buckets, uma função de histograma será sugerida.
-
Para regras de gravação, é possível expandir as regras.
Filtros de tabela
Selecione o botão de filtro na coluna de rótulo de um painel Tabela para adicionar filtros à expressão de consulta. Você também pode adicionar filtros para várias consultas. O filtro é adicionado para todas as consultas.