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 que oferecem suporte ao Grafana versão 9.x.
Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana
Para ajudar na depuração de consultas, o Explore permite que você investigue solicitações e respostas de consultas, bem como estatísticas de consultas, por meio do Inspetor de consultas. Essa funcionalidade é semelhante às tarefas do inspetor de painel Inspecionar o desempenho da consulta e Inspecionar os dados de solicitação e resposta da consulta.
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 da 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 seu histórico, selecione o botão Histórico de consultas em Explorar.
nota
As consultas marcadas com estrela (favoritas) não estão sujeitas ao período de retenção de duas semanas e não são excluídas.
Exibir 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.
-
Crie e/ou edite um comentário.
-
Copie uma consulta para a área de transferência.
-
Copie um link abreviado com a consulta para a área de transferência.
-
Marque uma consulta com uma estrela (favorita).
Gerenciar consultas favoritas
Todas as consultas que foram marcadas com estrela na guia Histórico de consultas são exibidas na lista de favoritos. Isso permite que você acesse suas consultas favoritas com mais rapidez e reutilize essas consultas sem digitá-las do zero.
Classificando 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 da fonte de dados em ordem crescente ou decrescente.
Para classificar seu histórico de consultas
-
Selecione o campo Classificar consultas por.
-
Selecione uma das opções a seguir:
-
O mais novo primeiro
-
O mais antigo primeiro
-
Filtrando o histórico de consultas
Você pode filtrar seu histórico de consultas em Histórico de consultas e na guia Favoritos para uma fonte de dados específica.
Filtrando o histórico para uma fonte de dados
-
Selecione o campo Filtrar consultas para fontes de dados específicas.
-
Selecione a fonte de dados para a qual você gostaria de filtrar seu histórico. Você 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.
Pesquisando no histórico de consultas
Você pode pesquisar em seu histórico entre consultas e comentários. É possível pesquisar consultas na guia Histórico de consultas e na guia Favoritos.
Para pesquisar no histórico de consultas
-
Selecione o campo Consultas de pesquisa.
-
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 | Aba Histórico de consultas |
nota
As configurações do histórico de consultas são globais e aplicadas aos dois painéis no modo dividido.
Características específicas 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 para o gráfico e uma consulta instantânea para a tabela. Uma consulta instantânea retorna o último valor de cada série temporal, o que mostra um bom resumo dos dados mostrados no gráfico.
Explorador de métricas
No lado esquerdo do campo de consulta, escolha Métricas para abrir o Metric Explorer. Isso mostra um menu hierárquico com métricas agrupadas por seu prefixo. Por exemplo, todas as métricas do Alertmanager são agrupadas sob o prefixo. alertmanager Esse é um bom ponto de partida se você quiser apenas explorar quais métricas estão disponíveis.
Campo de consulta
O campo Consulta oferece suporte ao preenchimento automático para 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 nova 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 no campo de consulta - selecione-as para atualizar sua consulta com a alteração sugerida.
-
Para contadores (métricas que aumentam monotonicamente), uma função de taxa será sugerida.
-
Para compartimentos, 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.
