Explorar

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

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

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

Em um espaço de trabalho do Grafana, a interface do usuário do painel fornece ferramentas para criar painéis para visualização. O Explore remove todas as opções de painel e painel para que você possa se concentrar na consulta. Repita até que você tenha uma consulta funcional e, em seguida, planeje e crie um painel.

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 em suas métricas e registros e encontrar a causa.

O Explore facilita a visualização de seus dados sem criar um painel. Se sua fonte de dados oferecer suporte a dados gráficos e tabelas, o Explore mostrará os resultados como um gráfico e uma tabela. Isso ajuda você a ver tendências nos dados e mais detalhes ao mesmo tempo.

Comece a explorar

nota

Por padrão, os usuários com a função de Visualizador não podem editar e não têm acesso ao Explore.

O ícone Explorar no menu do lado esquerdo abre uma guia Explorar vazia.

Para começar com uma consulta existente em um painel, escolha a opção Explorar no menu Painel. Isso abre uma guia Explorar que contém a consulta do painel. Em seguida, você pode ajustar ou iterar a consulta fora do seu painel.

Escolha sua 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 seu editor de consultas padrão.

No campo de consulta, você pode escrever sua consulta e explorar seus 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.

Dividindo e comparando

O recurso de visualização dividida é uma forma de comparar gráficos e tabelas side-by-side ou de analisar dados relacionados juntos em uma página. Escolha Dividir para duplicar a consulta atual e dividir a página em duas side-by-side consultas. 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 hora dos dois painéis podem ser vinculados (se você alterar um, o outro também será alterado) escolhendo um dos botões de sincronização de tempo anexados aos seletores de tempo. Vincular os seletores de hora ajuda a manter sincronizados os horários 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.

Compartilhando 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 7 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 seu histórico, escolha Histórico de consultas no Explore.

Visualizando o histórico de consultas

No histórico de consultas, você pode fazer o seguinte:

• Execute uma consulta.

• Crie 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 como estrela.

Gerenciando consultas favoritas

Todas as consultas que foram marcadas com estrela na guia Histórico de consultas são exibidas na guia Favoritas. Você pode acessar suas consultas favoritas com mais rapidez e reutilizá-las sem precisar digitá-las novamente.

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

No lado direito do histórico de consultas, na lista suspensa, escolha uma das seguintes opções: campo.

• O mais novo primeiro

• O mais antigo primeiro

• Fonte de dados de A a Z

• Fonte de dados Z-A

nota

Se você estiver na visualização dividida, o modo de classificação se aplica somente ao painel ativo.

Filtrar histórico de consultas

Nas guias Histórico de consultas e Favoritos, você pode filtrar o histórico de consultas pelo nome da fonte de dados.

1. Escolha Filtrar consultas para fontes de dados específicas.

2. Selecione a fonte de dados que você deseja usar para filtrar seu histórico. Você 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.

Pesquisando no histórico de consultas

Você pode pesquisar em seu histórico entre consultas e comentários. É possível pesquisar consultas nas guias Histórico de consultas e Favoritos.

1. Escolha o campo Consultas de pesquisa.

2. No campo de pesquisa, insira seu 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 a Grafana salvará seu histórico de consultas.	1 semana
Altere a guia ativa padrão.	Aba Histórico de consultas
Mostre consultas somente para a fonte de dados atualmente ativa no Explore.	Verdadeiro
Limpe 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 são aplicadas aos dois painéis no modo dividido.

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 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 para explorar quais métricas estão disponíveis.

Campo de consulta

O campo Consulta oferece suporte ao preenchimento automático para nomes de métricas, 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 Autocomplete pode ser acessado pressionando Ctrl+Space. 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 sua consulta com a alteração sugerida.

• Para contadores (métricas que aumentam monotonicamente), uma função de taxa é sugerida.

• Para compartimentos, uma função de histograma é 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 de registros

Você também pode usar o Explore para investigar seus registros com as seguintes fontes de dados:

• InfluxDB

• Elasticsearch

Visualização de registros

Os resultados das consultas de registro são mostrados como histogramas no gráfico, 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 registros calculará uma série temporal com base nas contagens de linhas de registro agrupadas por um intervalo de tempo calculado automaticamente. O início do histograma é então ancorado pelo timestamp da primeira linha de registro a partir do resultado. O final da série temporal está ancorado na faixa To do seletor de tempo.

Nível de log

Para registros em que um rótulo de nível é especificado, o Grafana usa o valor do rótulo para determinar o nível do registro e atualizar a cor de acordo. Se o registro não tiver um rótulo de nível especificado, o Grafana analisará o registro para descobrir se seu conteúdo corresponde a alguma das expressões suportadas. O nível do registro é sempre determinado pela primeira partida. 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 log e o mapeamento de abreviações e expressões de nível de log.

Expressões suportadas	Nível de log	Cor
emergir	crítica	roxo
fatal	crítica	roxo
alerta	crítica	roxo
crítico	crítica	roxo
crítica	crítica	roxo
errar	erro	vermelho
erro	erro	vermelho
erro	erro	vermelho
advertir	aviso	amarelo
aviso	aviso	amarelo
info	info	verde
informações	info	verde
notificação	info	verde
depurar	depurar	azul
depurar	depurar	azul
traço	traço	azul claro
*	desconhecido	cinza

Opções de visualização

Você pode personalizar a forma como os registros são exibidos e selecionar quais colunas são mostradas.

Tempo

Essa opção mostra ou oculta a coluna de tempo. Esse é o carimbo de data/hora associado à linha de registro, conforme relatado pela fonte de dados.

Rótulos exclusivos

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

Linhas de embrulho

Para usar a quebra de linha na exibição, defina isso como Verdadeiro. Definir essa opção como False resulta em rolagem horizontal.

Desduplicação

Os dados de registro podem ser muito repetitivos. O Explore pode ajudar ocultando linhas de registro duplicadas. Você pode escolher entre diferentes algoritmos de desduplicação:

• Exato — As correspondências exatas são feitas 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 agressiva, que retira 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 registros recebidos da ordem decrescente padrão (os mais novos primeiro) para a ordem crescente (os mais antigos primeiro).

Rótulos e campos detectados

Cada linha de registro 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 (filtro positivo) e filtrar (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 registros exibidos.

Alternar campos detectados

Se seus registros estiverem estruturados em JSON ou logfmt, você poderá mostrar ou ocultar os campos detectados. Expanda uma linha de registro 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="Alternando campos detectados no Explore” >}}

Integração de rastreamento

Você pode visualizar traços de fontes de dados de rastreamento no Explore. Fontes de dados atualmente suportadas:

• Conecte-se a uma fonte de dados Jaeger

• Conecte-se a uma fonte de dados Tempo

• Conecte-se a uma fonte AWS X-Ray de dados

• Conecte-se a uma fonte de dados Zipkin

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 os trechos que contêm o texto pesquisado

• Metadados sobre o rastreamento

Minimapa

O minimapa mostra uma visão condensada da linha do tempo do traçado. Arraste o mouse sobre o minimapa para ampliar em um intervalo de tempo menor. O zoom também atualizará a linha do tempo principal, então é fácil ver períodos mais curtos. 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 traçado. Cada linha de extensão consiste nos seguintes componentes:

• Botão Expandir filhos: expande ou contrai todos os intervalos infantis do período selecionado

• Nome do serviço: nome do serviço que registrou o intervalo

• Nome da operação: nome da operação que esse intervalo representa

• Barra de duração do intervalo: representação visual da duração da operação dentro do traçado

Escolher qualquer lugar na linha do intervalo mostra os detalhes do intervalo.

Detalhes do Span

Os detalhes do período incluem os seguintes itens:

• Nome de operação

• Metadados do Span

• Tags (quaisquer tags associadas a esse período)

• Metadados do processo (metadados sobre o processo que registrou esse período)

• Registros: lista de registros registrados por esse intervalo e valores de chave associados. No caso de registros do Zipkin, a seção mostra as anotações do Zipkin.

Navegando entre o Explore e um painel

Para ajudar a acelerar os fluxos de trabalho que envolvem a mudança regular do Explore para um painel e vice-versa, adicionamos a capacidade de retornar ao painel de origem depois de navegar até o Explore na lista suspensa do painel.

Depois de navegar até o Explore, você deve observar o botão “Voltar” na barra de ferramentas do Explore.

Basta escolher o botão para retornar ao painel de origem ou, se quiser trazer as alterações feitas no Explore de volta ao painel, 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 estatísticas de consultas, por meio do Inspetor de consultas. Essa funcionalidade é semelhante à guia Estatísticas do inspetor de painéis e à guia Consulta. Para ter mais informações, consulte Inspecione o desempenho da consulta e Visualize a solicitação bruta e a resposta à fonte de dados.