Login 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

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. Aprofunde e examine as métricas.

3. Pesquise novamente e pesquise registros relacionados à métrica e ao intervalo de tempo (e, no futuro, 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 faixa completa, o gráfico com distribuição de log para todas as consultas de log inseridas será exibido automaticamente. Atualmente, esse recurso é suportado pelas fontes OpenSearch de dados do Loki.

nota

No Loki, esse histograma de volume de log de alcance completo é renderizado por consulta métrica, que pode ser cara dependendo do intervalo de tempo consultado. Essa consulta pode ser particularmente desafiadora para o processamento de instalações menores do Loki. Para mitigar 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 de histograma de volume de log podem ser identificadas procurando consultas com o cabeçalho HTTP X-Query-Tags com valorSource=logvolhist; esses cabeçalhos são adicionados pela Grafana a todas as consultas de histograma de volume de log.

Se a fonte de dados não suportar o carregamento de um histograma de volume de log de faixa completa, o modelo de registros calcula uma série temporal com base nas contagens de linhas de log agrupadas por um intervalo de tempo calculado automaticamente, e o timestamp da primeira linha de log então ancora o início do histograma a partir do resultado. O final da série temporal está ancorado na faixa 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 o 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 ela level está na sua linha de log, 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 log em barras separadas.

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

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	debug	azul
debug	debug	azul
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 o registro de data e hora das linhas de registro de entrada. Você pode ver os resultados anteriores clicando na página para visualizar. O Explore armazena em cache as últimas cinco solicitações executadas na navegação de registros, para que ele 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/hora associado à linha de registro, conforme relatado pela fonte de dados.

Rótulos exclusivos

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 False, isso resultará em rolagem horizontal.

Embeleze o JSON

Defina isso true 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 — Corresponde à 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, números e correspondências 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, adicionamos a capacidade de 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 em relação a todos os registros exibidos.

Escapando 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 “Escape new lines”.

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 de novas linhas 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.

Recursos específicos 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 log que podem ser feitos para corresponder aos rótulos do Prometheus. Para obter mais informações sobre a Grafana Loki, você pode ver o Github da Grafana Loki.

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

Mude de métricas para registros

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 registros. Por exemplo, se você tiver a seguinte consulta do Prometheus:

grafana_alerting_active_alerts{job="grafana"}

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

{job="grafana"}

Isso retornará um pedaço de registros no intervalo de tempo selecionado que pode ser pesquisado.

Amostra de registros

Se a fonte de dados selecionada implementar amostras de registros e oferecer suporte a consultas de registros e métricas, então, 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.

Rastreamento ao vivo

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

Selecione o botão Ao vivo na barra de ferramentas Explorar para alternar para a visualização final ao vivo.

Enquanto estiver na visualização traseira ao vivo, os novos registros virã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 a transmissão ao vivo e explorar os registros anteriores sem interrupção. Selecione o botão Continuar para retomar o envio ao vivo ou selecione o botão Parar para sair do envio ao vivo e voltar para a visualização padrão do Explore.