Explore
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.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 9.x, consulte Trabalhar no Grafana versão 9.
Em um espaço de trabalho do Grafana, a interface de usuário do dashboard fornece ferramentas para criar dashboards para visualização. O Explore remove todas as opções do dashboard e painel para que você possa se concentrar na consulta. Itere até que você tenha uma consulta funcional e, em seguida, planeje e crie um dashboard.
Para monitoramento da infraestrutura e resposta a incidentes, você não precisa mais mudar para outras ferramentas para depurar o que deu errado. Você pode usar o Explore para se aprofundar nas métricas e logs para encontrar a causa.
O Explore facilita a visualização dos dados sem criar um dashboard. Se a fonte de dados for compatível com dados de grafos e tabelas, o Explore mostrará os resultados como um grafo e uma tabela. Isso permite que você veja tendências nos dados e mais detalhes ao mesmo tempo.
Começar a explorar
nota
Por padrão, os usuários com o perfil Visualizador não podem editar e não têm acesso ao Explore.
O ícone do Explore no menu do lado esquerdo abre uma guia do Explore vazia.
Para começar com uma consulta existente em um painel, escolha a opção Explore no menu Painel. Isso abre uma guia do Explore que contém a consulta do painel. Você pode então ajustar ou iterar a consulta fora do dashboard.
Escolha a fonte de dados na lista suspensa no canto superior esquerdo. O Prometheus tem uma implementação personalizada do Explore. As outras fontes de dados usam o editor de consultas padrão.
No campo de consulta, você pode escrever a consulta para explorar os dados. Há três botões ao lado do campo de consulta: um botão para limpar (X), um botão para adicionar consulta (+) e o botão para remover consulta (-). Como no editor de consultas do painel, você pode adicionar e remover várias consultas.
Dividir e comparar
O recurso de visualização dividida é uma forma de comparar grafos e tabelas lado a lado ou de analisar dados relacionados juntos em uma página. Escolha Dividir para duplicar a consulta atual e dividir a página em duas consultas lado a lado. Você tem a opção de selecionar uma fonte de dados diferente para a nova consulta. Isso lhe dá a oportunidade de comparar a mesma consulta para dois servidores diferentes, ou comparar o ambiente de preparação com o ambiente de produção.
Na visualização dividida, os seletores de tempo dos dois painéis podem ser vinculados (se você alterar um, o outro também será alterado) ao escolher um dos botões de sincronização de tempo anexados aos seletores de tempo. Vincular os seletores de tempo ajuda a manter sincronizados as horas de início e término das consultas de visualização dividida para que você veja o mesmo intervalo de tempo nos dois painéis divididos.
Você pode fechar a consulta recém-criada escolhendo Fechar divisão.
Compartilhar um link encurtado
Use o recurso Compartilhar link encurtado para criar URLs menores e mais simples do formato /goto/:uid, em vez de compartilhar URLs mais longos que contêm parâmetros de consulta complexos. Você pode criar um link encurtado escolhendo a opção Compartilhar na barra de ferramentas do Explore. Todos os links encurtados que nunca são usados são excluídos automaticamente após sete dias.
Histórico de consultas
O histórico de consultas é uma lista de consultas que você usou no Explore. O histórico é local no seu navegador e não é compartilhado. Para abrir e interagir com o histórico, escolha Histórico de consultas no Explore.
Visualizar o histórico de consultas
No histórico de consultas, você pode fazer o seguinte:
-
Execute uma consulta.
-
Criar ou 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.
-
Marque uma consulta com favorita.
Gerenciar consultas marcadas como favoritas
Todas as consultas que foram marcadas com estrela na guia Histórico de consultas são exibidas na guia Com estrela. Você pode acessar as consultas marcadas como favoritas com mais rapidez e reutilizá-las sem precisar digitá-las novamente.
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.
No lado direito do histórico de consultas, na lista suspensa, escolha uma das seguintes opções de campo:
-
Mais recente primeiro
-
Mais antigo primeiro
-
Fonte de dados A-Z
-
Fonte de dados Z-A
nota
Se você estiver na visualização dividida, o modo de classificação se aplicará somente ao painel ativo.
Filtrar o histórico de consultas
Nas guias Histórico de consultas e Com estrela, você pode filtrar o histórico de consultas pelo nome da fonte de dados.
-
Escolha Filtrar consultas para fontes de dados específicas.
-
Selecione a fonte de dados que você deseja usar para filtrar o histórico. Você também pode selecionar várias fontes de dados.
Na guia Histórico de consultas, você pode usar o controle deslizante vertical para filtrar as consultas por data:
-
Arraste a alça inferior para ajustar a data de início.
-
Arraste a alça superior para ajustar a data de término.
nota
Se você estiver na visualização dividida, os filtros serão aplicados somente ao painel ativo.
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.
-
Escolha o campo Pesquisar consultas.
-
No campo de pesquisa, insira o termo de pesquisa.
Configurações do histórico de consultas
Você pode personalizar o histórico de consultas na guia Configurações. A tabela a seguir lista as opções disponíveis.
| Configuração | Valor padrão |
|---|---|
| Especifique por quanto tempo o Grafana salvará o histórico de consultas. | 1 semana |
| Altere a guia ativa padrão. | Guia Histórico de consultas |
| Mostre consultas somente para a fonte de dados atualmente ativa no Explore. | Verdadeiro |
| Limpar o histórico de consultas. | (Escolha Limpar histórico de consultas para excluir permanentemente todas as consultas armazenadas.) |
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
A primeira versão do Explore apresenta uma experiência de consulta personalizada para o Prometheus. Quando você executa uma consulta, o Grafana na verdade executa duas consultas: uma consulta normal do Prometheus para o grafo 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 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 para explorar quais métricas estão disponíveis.
Campo Consulta
O campo Consulta é compatível com o preenchimento automático para nomes de métricas e funções e funciona basicamente da mesma forma que o editor de consultas padrão do Prometheus. Pressione Enter para executar uma consulta.
O menu Preenchimento automático pode ser acessado 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 Consulta. Escolha uma sugestão 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
Escolha o botão Filtrar na coluna de rótulo de um painel de 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.
Integração com logs
Você também pode usar o Explore para investigar os logs com as seguintes fontes de dados:
-
InfluxDB
-
Elasticsearch
Visualização de logs
Os resultados das consultas de logs são mostrados como histogramas no grafo, e os registros individuais são exibidos abaixo. Se a fonte de dados não enviar dados do histograma para o intervalo de tempo solicitado, o modelo de logs calculará uma série temporal com base nas contagens de linhas de logs agrupadas por um intervalo de tempo calculado automaticamente. O início do histograma é então ancorado pelo carimbo de data e hora da primeira linha de log do resultado. O final da série temporal está ancorado no intervalo Até do seletor de tempo.
Nível de log
Para logs em que um rótulo de nível é especificado, o Grafana usa o valor do rótulo para determinar o nível do log e atualizar a cor de acordo. Se o log não tiver um rótulo de nível especificado, o Grafana analisará o log para descobrir se seu conteúdo corresponde a alguma das expressões compatíveis. O nível do log é sempre determinado pela primeira correspondência. Se o Grafana não conseguir determinar um nível de log, ele será visualizado com o nível de log desconhecido. A tabela a seguir lista os níveis de logs e o mapeamento de abreviações e expressões de níveis de logs.
| Expressões compatíveis | Nível de log | Cor |
|---|---|---|
| emerg | crítico | roxo |
| fatal | crítico | roxo |
| alerta | crítico | roxo |
| crit | crítico | roxo |
| crítico | crítico | roxo |
| err | erro | vermelho |
| eror | erro | vermelho |
| erro | erro | vermelho |
| warn | aviso | amarelo |
| aviso | aviso | amarelo |
| info | info | verde |
| informações | info | verde |
| notice | info | verde |
| dbug | depurar | azul |
| depurar | depurar | azul |
| trace | rastreamento | azul claro |
| * | desconhecido | cinza |
Opções de visualização
Você pode personalizar a forma como os logs são exibidos e selecionar quais colunas são mostradas.
Tempo
Esta opção mostra ou oculta a coluna de tempo. Este é o carimbo de data e hora associado à linha de log, conforme relatado pela fonte de dados.
Rótulos exclusivos
Esta opção mostra ou oculta a coluna de rótulos exclusivos, que inclui somente rótulos não comuns. Todos os rótulos comuns são exibidos acima.
Quebrar linhas
Para usar a quebra de linha na exibição, defina esta opção como True. Defini-la como False resulta em rolagem horizontal.
Desduplicação
Os dados de logs podem ser muito repetitivos. O Explore pode ajudar ocultando linhas de logs duplicadas. É possível escolher entre diferentes algoritmos de desduplicação:
-
Exato: são feitas correspondências exatas em toda a linha, exceto nos campos de data.
-
Números: as correspondências são feitas na linha após a remoção de números, como durações, endereços IP e assim por diante.
-
Assinatura: a desduplicação mais radical, que remove todas as letras e números. As correspondências são feitas nos espaços em branco e na pontuação restantes.
Inverter a ordem dos resultados
Você pode alterar a ordem dos logs recebidos da ordem decrescente padrão (os mais recentes primeiro) para a ordem crescente (os mais antigos primeiro).
Rótulos e campos detectados
Cada linha de log tem uma área extensível com seus rótulos e campos detectados para uma interação mais robusta. Para todos os rótulos, você pode filtrar por (filtro positivo) e filtrar excluindo (filtro negativo) os rótulos selecionados. Cada campo ou rótulo também tem um ícone de estatísticas para exibir estatísticas únicas em relação a todos os logs exibidos.
Alternar campos detectados
Se os logs estiverem estruturados em JSON ou logfmt, você poderá mostrar ou ocultar os campos detectados. Expanda uma linha de log e escolha o ícone de olho para mostrar ou ocultar campos.
{{< docs-imagebox img="/img/docs/explore/parsed-fields-7-2.gif" max-width="800px" caption="Toggling detected fields in Explore" >}}
Integração de rastreamento
Você pode visualizar os rastreamentos de fontes de dados de rastreamento no Explore. Fontes de dados atualmente compatíveis:
Para obter informações sobre como usar o editor de consultas, consulte a documentação da fonte de dados específica.
Cabeçalho
O cabeçalho inclui os seguintes itens:
-
Título do cabeçalho, que mostra o nome da extensão raiz e o ID de rastreamento
-
Pesquisa, que destaca as extensões que contêm o texto pesquisado
-
Metadados sobre o rastreamento
Minimapa
O minimapa mostra uma visão condensada da linha do tempo do rastreamento. Arraste o ponteiro do mouse sobre o minimapa para ampliar para um intervalo de tempo menor. O zoom também atualizará a linha do tempo principal, para que seja fácil ver extensões mais curtas. Se você pausar no minimapa, quando ampliado, poderá ver o botão Redefinir seleção, que redefine o zoom.
Linha do tempo
A linha do tempo mostra uma lista de extensões dentro do rastreamento. Cada linha de extensão consiste nos seguintes componentes:
-
Botão Expandir secundárias: expande ou contrai todas as extensões secundárias da extensão selecionada
-
Nome do serviço: nome do serviço que registrou em log a extensão
-
Nome da operação: nome da operação que essa extensão representa
-
Barra de duração da extensão: representação visual da duração da operação no rastreamento
Escolher qualquer lugar na linha da extensão mostra os detalhes dela.
Detalhes da extensão
Os detalhes da extensão incluem os seguintes itens:
-
Nome de operação
-
Metadados da extensão
-
Tags (quaisquer tags associadas a essa extensão)
-
Metadados do processo (metadados sobre o processo que registrou em log essa extensão)
-
Logs: lista de logs registrados por essa extensão e valores de chave associados. No caso de logs do Zipkin, a seção mostra as anotações do Zipkin.
Navegar entre o Explore e um dashboard
Para ajudar a acelerar os fluxos de trabalho que envolvem a mudança regular do Explore para um dashboard e vice-versa, adicionamos a capacidade de retornar ao dashboard de origem depois de navegar até o Explore na lista suspensa do painel.
Depois de navegar até o Explore, você verá o botão “Voltar” na barra de ferramentas do Explore.
Ao escolher o botão para retornar ao dashboard de origem ou, se quiser levar as alterações feitas no Explore de volta para o dashboard, basta escolher a seta ao lado do botão para revelar o item de menu “Retornar ao painel com alterações”.
Inspetor de consultas
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 à guia Estatísticas do inspetor do painel e à guia Consulta. Para ter mais informações, consulte Inspecionar a performance da consulta e Visualizar a resposta e a solicitação brutas à fonte de dados.
