Login no Explore

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

Para espaços de trabalho do Grafana compatíveis com a versão 8.x do Grafana, consulteTrabalhando na versão 8 do Grafana.

Além das métricas, o Explore permite que você investigue seus registros nas seguintes fontes de dados:

• OpenSearch

• InfluxDB

• Loki

Durante o monitoramento da infraestrutura e a resposta a incidentes, você pode se aprofundar nas métricas e nos registros para encontrar a causa. O Explore também permite que você correlacione métricas e registros visualizando-os side-by-side. Isso cria um novo fluxo de trabalho de depuração.

1. Receba um alerta.

2. Opções de detalhamento e análise.

3. Examine novamente e pesquise registros relacionados à métrica e ao intervalo de tempo (e, no future, rastreamentos distribuídos).

Visualização de registros

Os resultados das consultas de registro são mostrados como histogramas no gráfico e os registros individuais são explicados nas seções a seguir.

Se a fonte de dados suportar um histograma de volume de log de intervalo completo, o gráfico com distribuição de log para todas as consultas de registro inseridas será exibido automaticamente. Atualmente, esse recurso é suportado por fontes de dados OpenSearch e Loki.

nota

No Loki, esse histograma de volume de log de intervalo completo é renderizado por consulta métrica, o que pode ser caro dependendo do intervalo de tempo consultado. Essa consulta pode ser particularmente difícil para instalações menores do Loki processarem. Para atenuar isso, recomendamos usar um proxy como o nginx na frente do Loki para definir um tempo limite personalizado (por exemplo, 10 segundos) para essas consultas. As consultas do histograma de volume de log podem ser identificadas procurando consultas com o cabeçalho HTTPX-Query-Tags com valorSource=logvolhist; esses cabeçalhos são adicionados pelo Grafana a todas as consultas do histograma de volume de log.

Se a fonte de dados não suportar o carregamento de histograma de volume de log de faixa completa, o modelo de registros calcula uma série temporal com base nas contagens de linhas de registro agrupadas por um intervalo de tempo calculado automaticamente, e o carimbo de data/hora da primeira linha de registro ancora o início do histograma a partir do resultado. O final da série temporal está ancorado no intervalo To do seletor de tempo.

Nível de registro

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, ele tentará descobrir se seu conteúdo corresponde a alguma das expressões suportadas (veja abaixo para obter mais informações). O nível do registro é sempre determinado pela primeira partida. Caso o Grafana não consiga determinar um nível de log, ele será visualizado com um nível de log desconhecido.

dica

Se você usa a fonte de dados Loki e olevel is em sua linha de registro, use analisadores (JSON, logfmt, regex,..) para extrair as informações do nível em um rótulo de nível usado para determinar o nível do log. Isso permitirá que o histograma mostre os vários níveis de registro em barras separadas.

Níveis de registro suportados e mapeamento de abreviações e expressões em nível de log:

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

Navegação de registros

A interface de navegação de registros, ao lado das linhas de registro, pode ser usada para solicitar mais registros. Você pode fazer isso selecionando o botão Registros mais antigos na parte inferior da navegação. Quando você atinge o limite de linha e quer ver mais registros, você pode usar isso para buscar mais registros. Cada solicitação é exibida na navegação como uma página separada. Cada página mostra a data e hora de e para as linhas de registro recebidas. Você pode ver os resultados anteriores clicando na página para ver. O Explore armazena em cache as últimas cinco solicitações executadas a partir da navegação de registros, para que não execute novamente a mesma consulta ao clicar nessas páginas.

Opções de visualização

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

Time (Tempo)

Mostra ou oculta a coluna de tempo. Esse é o carimbo de data e hora associado à linha de registro, conforme relatado pela fonte de dados.

Etiquetas exclusivas

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

Defina isso como Verdadeiro se quiser que a exibição use quebra de linha. Se definido como Falso, isso resultará em rolagem horizontal.

Embelezar JSON

Defina issotrue para imprimir de forma bonita todos os registros JSON. Essa configuração não afeta os registros em nenhum formato que não seja JSON.

Desduplicação

Os dados de registro podem ser muito repetitivos e o Explore pode ajudar ocultando linhas de registro duplicadas. Há alguns algoritmos de desduplicação diferentes que você pode usar:

• Exato — As correspondências exatas são feitas em toda a linha, exceto nos campos de data.

• Números — Correspondências 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 remove todas as letras e números e coincide com os espaços em branco e 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, adicionamos a capacidade de filtrar os rótulos selecionados (filtro positivo) e filtrar (filtro negativo). Cada campo ou rótulo também tem um ícone de estatísticas para exibir estatísticas em relação a todos os registros exibidos.

Fugindo de novas linhas

O Explore detecta automaticamente algumas sequências com escape incorreto nas linhas de registro, como novas linhas (\n,\r) ou guias (\t). Quando detecta essas sequências, o Explore fornece a opção “Escapar novas linhas”.

O Explore pode corrigir automaticamente sequências de escape incorretas que ele detectou

Para corrigir automaticamente as sequências de escape

1. Selecione Escape de novas linhas para substituir as sequências.

2. Analise manualmente as substituições para confirmar sua exatidão.

O Explore substitui essas sequências. Quando isso acontecer, a opção mudará de Escape newlines para Remover escape. Avalie as alterações, pois a análise pode não ser precisa com base na entrada recebida. Você pode reverter as substituições selecionando Remover escape.

Links de dados

Usando links de dados, você pode transformar qualquer parte de uma mensagem de log em um link interno ou externo. O link criado é visível como um botão na seção Links dentro da visualização de detalhes do registro.

Alternar a visibilidade do campo

Expanda uma linha de registro e clique no ícone do olho para mostrar ou ocultar campos.

Características específicas do Loki

O Loki é o sistema de agregação de registros de código aberto da Grafana Labs. O Loki foi projetado para ser econômico, pois não indexa o conteúdo dos registros, mas sim um conjunto de rótulos para cada fluxo de registros. Os registros do Loki são consultados de forma semelhante à consulta com seletores de rótulos no Prometheus. Ele usa rótulos para agrupar fluxos de registro que podem ser feitos para coincidir com seus rótulos do Prometheus. Para obter mais informações sobre o Grafana Loki, você pode ver o Github do Grafana Loki.

Para obter mais informações, consulte Loki sobre como consultar dados de registro.

Passar de métricas para logs

Se você mudar de uma consulta do Prometheus para uma consulta de registros (você pode fazer uma divisão primeiro para ter suas métricas e registros lado a lado), ele manterá os rótulos de sua consulta que existem nos registros e os usará para consultar os fluxos de registro. Por exemplo, se tiver a seguinte consulta do Prometheus:

grafana_alerting_active_alerts{job="grafana"}

depois de mudar para a fonte de dados Logs, ela mudará para:

{job="grafana"}

Isso retornará uma parte dos registros no intervalo de tempo selecionado que pode ser pesquisada.

Amostra de registros

Se a fonte de dados selecionada implementar amostras de registros e oferecer suporte a consultas de log e métricas, para consultas métricas, você poderá ver automaticamente amostras de linhas de registro que contribuíram para as métricas visualizadas. Atualmente, esse recurso é suportado pelas fontes de dados do Loki.

Seguimento ao vivo

Use o recurso Live Tailing para ver registros em tempo real das fontes de dados suportadas.

Selecione o botão Ao vivo na barra de ferramentas Explorar para alternar para a visualização em tempo real.

Enquanto estiver no Live Tail View, novos registros surgirão da parte inferior da tela e terão um fundo contrastante e desbotado para que você possa acompanhar o que há de novo. Selecione o botão Pausar ou role a visualização dos registros para pausar o acompanhamento ao vivo e explorar os registros anteriores sem interrupção. Selecione o botão Retomar para retomar a visualização ao vivo ou selecione o botão Parar para sair da seleção ao vivo e voltar para a visualização padrão do Explore.