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á.
Login no Explore
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x 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
Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana
O Explore permite que você investigue seus registros em diferentes fontes de dados, incluindo:
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 registros com outros sinais de telemetria, como métricas, rastreamentos ou perfis, visualizando-os. side-by-side
Os resultados das consultas de registro são exibidos como linhas de registro individuais e como um gráfico mostrando o volume de registros para o período selecionado.
Volume de registros
Ao trabalhar com fontes de dados que suportam um volume completo de registros, o Explore exibe automaticamente um gráfico mostrando a distribuição de registros para todas as consultas de registro inseridas. Atualmente, esse recurso é suportado pelas fontes OpenSearch de dados do Loki.
nota
No Loki, esse volume de log de intervalo completo é renderizado por uma consulta métrica que pode ser cara, dependendo do intervalo de tempo consultado. Essa consulta pode ser particularmente difícil de processar em instalações menores do Loki. Para mitigar isso, você pode usar um proxy como o nginxX-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 todo o volume de registros, o modelo de registros calcula uma série temporal contando as linhas do registro e organizando-as em compartimentos com base em um intervalo de tempo calculado automaticamente. O timestamp da primeira linha de registros é usado para ancorar o início do volume de registros nos resultados. O final da série temporal está ancorado na faixa To do seletor de tempo. Dessa forma, você ainda pode analisar e visualizar dados de log com eficiência, mesmo quando a fonte de dados não oferece suporte completo.
Logs
Nas seções a seguir, você encontrará explicações detalhadas sobre como visualizar e interagir com registros individuais no Explore.
Navegação de registros
A navegação de registros, no lado direito das linhas de registro, pode ser usada para solicitar facilmente registros adicionais. Você pode fazer isso clicando no botão Registros mais antigos na parte inferior da navegação. Isso é especialmente útil quando você atinge o limite da linha e deseja ver mais registros. Cada solicitação executada a partir da navegação é então exibida na navegação como uma página separada. Cada página mostra os carimbos de to data from e hora das linhas de registro de entrada. Você pode ver os resultados anteriores clicando em cada página. O Explore armazena em cache as últimas cinco solicitações executadas na navegação de registros, para que você não execute novamente as mesmas consultas ao clicar nas páginas, economizando tempo e recursos.
Opções de visualização
Você pode personalizar a forma como os registros são exibidos e selecionar quais colunas são mostradas.
| Opção | Descrição |
|---|---|
| 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 essa true opção se quiser que a tela use quebra de linha. Se definido comofalse, 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. As correspondências exatas são feitas em toda a linha, exceto nos campos de data. As correspondências de números são feitas na linha após a remoção de números como durações, endereços IP e assim por diante. A assinatura é a desduplicação mais agressiva, pois retira todas as letras, números e correspondências nos espaços em branco e na pontuação restantes. |
| Exibir 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). |
Baixar linhas de registro
Para baixar os resultados do registro em um txt ou json outro formato, use o botão Download. Esse recurso permite salvar os dados de registro para análise posterior ou compartilhá-los com outras pessoas em um formato conveniente e acessível.
Meta-informações do resultado do log
Acima das linhas de registro recebidas, você pode encontrar meta-informações essenciais, incluindo:
-
Número de registros recebidos — Indica a contagem total de registros recebidos para a consulta atual ou o intervalo de tempo.
-
Erro — Exibe possíveis erros nos resultados do seu registro.
-
Rótulos comuns — Mostra rótulos comuns.
-
Total de bytes processados — Representa o tamanho cumulativo dos dados de log processados em bytes.
nota
A disponibilidade de determinadas metainformações pode depender da fonte de dados e, como resultado, você pode ver apenas alguns desses detalhes de fontes de dados específicas.
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 de novas linhas.
Para corrigir automaticamente sequências de escape incorretas que o Explore detectou
-
Escolha Escape de novas linhas para substituir as sequências.
-
Analise manualmente as substituições para confirmar se estão corretas.
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.
Nível de log
Para os registros em que um level rótulo é especificado, usamos o valor desse rótulo para determinar o nível do registro e atualizar a cor de cada linha de registro adequadamente. Se o registro não tiver um rótulo de nível especificado, tentaremos descobrir se seu conteúdo corresponde a alguma das expressões suportadas (consulte a tabela a seguir para obter mais informações). O nível do registro é sempre determinado pela primeira partida. No caso em que o Grafana não consiga inferir um campo de nível de log, ele será visualizado com um nível de log desconhecido.
nota
Se você usa uma fonte de dados Loki e ela level faz parte da sua linha de log, você pode usar analisadores (JSON, logfmt, regex,..) para extrair as informações do nível em um rótulo de nível usado para determinar o valor do nível. Isso permitirá que o histograma mostre os vários níveis de log como barras separadas.
Níveis de registro suportados e mapeamento de abreviações e expressões de nível de registro:
| Nível de log | Cor | Expressões suportadas |
|---|---|---|
| crítica | roxo | emergente, fatal, alerta, crítico, crítico |
| erro | vermelho | erro, erro, erro |
| aviso | amarelo | avisar, avisar |
| info | verde | informação, informação, informação, aviso |
| depurar | azul | depurar, depurar |
| traço | azul claro | traço |
| desconhecido | cinza | * |
Destacar palavras pesquisadas
Quando sua consulta inclui palavras ou expressões específicas para pesquisar, o Explore as destacará nas linhas de registro para melhor visibilidade. Esse recurso de destaque facilita a identificação e o foco no conteúdo relevante em seus registros.
nota
A capacidade de destacar palavras de pesquisa pode variar dependendo da fonte de dados. Para algumas fontes de dados, o destaque das palavras de pesquisa pode não estar disponível.
Visualização dos detalhes do registro
No Explore, cada linha de registro tem uma seção expansível chamada Detalhes do registro, que pode ser aberta escolhendo a linha de registro. A visualização de detalhes do registro fornece informações adicionais e opções de exploração na forma de campos e links anexados às linhas de registro, permitindo uma interação e análise mais robustas.
Campos
Na visualização de detalhes do registro, você pode filtrar os campos exibidos de duas maneiras: um filtro positivo (para focar em um campo específico) e um filtro negativo (para excluir determinados campos). Esses filtros atualizarão a consulta correspondente que produziu a linha de registro, adicionando expressões de igualdade e desigualdade adequadamente. Se a fonte de dados tiver suporte, como é o caso de Loki e OpenSearch, os detalhes do registro verificarão se o campo já está presente na consulta atual, mostrando um estado ativo (somente para filtros positivos), permitindo que você desative a consulta ou altere a expressão do filtro de positiva para negativa.
Você pode selecionar um subconjunto de campos para visualizar na lista de registros em vez da linha completa do registro clicando no ícone do olho. Cada campo tem um ícone de estatísticas para exibir estatísticas em relação a todos os registros exibidos.
Links
O Grafana oferece a funcionalidade de links ou correlações de dados, permitindo que você converta qualquer parte de uma mensagem de log em um link interno ou externo. Esses links podem ser usados para navegar até dados relacionados ou recursos externos, fornecendo uma maneira simples e conveniente de explorar mais informações.
Contexto do log
O contexto de registro exibe linhas adicionais de contexto em torno de uma entrada de registro que corresponde a uma consulta de pesquisa específica. Isso pode ser útil para entender o contexto da entrada de registro e é semelhante ao -C parâmetro no grep comando.
Você pode encontrar longas linhas de texto que dificultam a leitura e a análise do contexto em torno de cada entrada de registro. É aqui que o botão Wrap lines pode ser útil. Ao ativar essa opção, o Grafana envolverá automaticamente longas linhas de texto para que elas caibam na largura visível do visualizador. Isso pode facilitar a leitura e a compreensão das entradas do registro.
O botão Abrir na visualização dividida permite que você execute a consulta de contexto para uma entrada de registro em uma tela dividida na visualização Explorar. A escolha desse botão abrirá um novo painel Explorar com a consulta de contexto exibida ao lado da entrada do registro, facilitando a análise e a compreensão do contexto circundante.
A consulta de contexto do log também pode ser aberta em uma nova guia do navegador pressionando a tecla Ctrl (ouCmd) ao escolher o botão para abrir o modal de contexto. Quando abertos em uma nova guia, os filtros selecionados anteriormente também são aplicados.
Copiar linha de registro
Você pode copiar facilmente o conteúdo de uma linha de registro selecionada para sua área de transferência escolhendo o botão Copiar linha de registro.
Copiar link para a linha de registro
A vinculação de linhas de registro no Grafana permite que você navegue rapidamente até entradas de registro específicas para uma análise precisa. Ao escolher o botão Copiar link curto para uma linha de registro, você pode gerar e copiar uma URL curta que fornece acesso direto à entrada exata do registro em um intervalo de tempo absoluto. Quando você abre o link, o Grafana rola automaticamente até a linha de registro correspondente e a destaca com um fundo azul, facilitando a identificação e o foco nas informações relevantes.
nota
Isso só é suportado no Loki e em outras fontes de dados que fornecem um id campo.
Rastreamento ao vivo
Para visualizar registros em tempo real de fontes de dados compatíveis, você pode aproveitar o recurso Live Tailing no Explore.
Para visualizar registros em tempo real com rastreamento ao vivo
-
Escolha 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, novos registros aparecerão na parte inferior da tela e terão um fundo desbotado e contrastante, permitindo que você acompanhe facilmente o que há de novo.
-
Se você quiser pausar a transmissão ao vivo e explorar os registros anteriores sem interrupções, você pode fazer isso escolhendo o botão Pausar ou simplesmente percorrendo a visualização dos registros.
-
Para limpar a exibição e remover todos os registros da tela, escolha o botão Limpar registros. Essa ação redefinirá a visualização do registro e fornecerá uma página limpa para continuar sua análise do registro.
-
Para retomar a transmissão ao vivo e continuar visualizando os registros em tempo real, escolha o botão Continuar.
-
Se você quiser sair do Live Tailing e retornar à visualização padrão do Explore, escolha o botão Parar.
Usando o recurso Live Tailing, você pode acompanhar de perto os registros mais recentes à medida que eles chegam, facilitando o monitoramento de eventos em tempo real e a detecção rápida de problemas.
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.
Mude de métricas para registros
Se você estiver vindo de uma fonte de dados de métricas que implementa DataSourceWithQueryExportSupport (como Prometheus) para uma fonte de dados de registro DataSourceWithQueryImportSupport compatível (como Loki), ela manterá os rótulos da sua consulta que existem nos registros e os usará para consultar os fluxos de registros.
Por exemplo, a seguinte grafana_alerting_active_alerts{job='grafana'} consulta do Prometheus, depois de mudar para a fonte de dados Loki, mudará para. {job='grafana'} Isso retornará um pedaço de registros no intervalo de tempo selecionado que pode ser coletado ou pesquisado por texto.
