Logs

Visão geral

A seção APM > Logs exibe registros de log coletados de seus aplicativos e serviços.

Um registro de log é um registro de texto de um evento (por exemplo, um pagamento com falha ou um tempo limite do banco de dados). Cada registro de log tem uma gravidade e uma mensagem (corpo). Se um registro de log foi produzido durante uma operação que faz parte de um trace, ele também contém os IDs desse trace e span.

Cada registro de log é produzido por um serviço (por exemplo, zabbix-frontend; nomeado pelo atributo de recurso service.name do OpenTelemetry) e por um escopo de instrumentação, a parte do código que o criou (por exemplo, uma biblioteca de logging).

Para fornecer contexto sobre cada evento, os registros de log também têm atributos de chave-valor: os atributos de log descrevem o próprio evento (por exemplo, log.file.path: /var/log/zabbix/zabbix_frontend.log), enquanto os atributos de recurso descrevem o serviço e o ambiente no qual ele é executado (por exemplo, host.name: eabf8c2a5ddc).

Para obter mais detalhes sobre logs, consulte a documentação do OpenTelemetry.

A seção APM > Logs contém os seguintes elementos:

  • Botão Modo quiosque - exibe apenas o conteúdo da página, sem o menu e o cabeçalho.
  • Seletor de período - seleciona o período para o qual os registros de log serão exibidos.
  • Filtro - exibe apenas os registros de log de seu interesse.
  • Lista de logs - exibe os registros de log.
  • Detalhes do log - exibe os detalhes do registro de log selecionado.

Lista de logs

Cada linha na lista de logs representa um registro de log.

Os registros de log são exibidos em uma tabela personalizável. O botão Personalizar tabela, no cabeçalho da tabela, permite mostrar, ocultar ou reordenar colunas e redefinir o layout para o padrão. Você também pode redimensionar cada coluna arrastando sua borda direita; clique duas vezes na borda para redefini-la. Todas as personalizações são aplicadas imediatamente e lembradas para o usuário atual.

A lista de logs pode conter as seguintes colunas:

Cada coluna corresponde a uma coluna na tabela otel_logs da fonte de dados de telemetria; para obter a lista de colunas, consulte Colunas de dados de telemetria compatíveis. A maioria das colunas tem o mesmo nome que na fonte de dados (por exemplo, Texto da severidade corresponde à coluna SeverityText). Quando os nomes são diferentes, a coluna da fonte de dados é especificada na tabela abaixo.

Coluna Descrição
Timestamp Data e hora em que o evento ocorreu.
Corpo Mensagem do registro de log.
Texto da severidade Nível de severidade fornecido pelo aplicativo (por exemplo, INFO, WARN ou ERROR).
A cor do rótulo depende da severidade.
Número da severidade Nível de severidade como um número:
0 - NÃO ESPECIFICADO.
1-4 - TRACE.
5-8 - DEBUG.
9-12 - INFO.
13-16 - WARN.
17-20 - ERROR.
21-24 - FATAL.
ID do trace ID, se houver, do trace durante o qual o registro de log foi produzido.
ID do span ID, se houver, do span durante o qual o registro de log foi produzido.
Flags Flags de trace do registro de log:
0 - o trace não é amostrado.
1 - o trace é amostrado (registrado).

Coluna da fonte de dados: TraceFlags.
Nome do serviço Serviço que produziu o registro de log.
Nome do escopo Escopo de instrumentação que produziu o registro de log.
Versão do escopo Versão do escopo de instrumentação.
Nome do evento Nome, se houver, do tipo de evento que o registro de log representa.
Atributos do log Atributos de log do registro de log.
Clique no botão de três pontos para exibir todos os atributos.
Atributos do recurso Atributos de recurso do registro de log.
Clique no botão de três pontos para exibir todos os atributos.
Atributos do escopo Atributos do escopo de instrumentação.
Clique no botão de três pontos para exibir todos os atributos.

Detalhes do log

Clique em um registro de log na lista de logs para abrir o painel Detalhes do log, que exibe todas as informações sobre o registro de log.

O painel Detalhes do log pode conter as seguintes seções:

Seção Descrição
Informações básicas ID do trace, ID do span e flags de trace do registro de log.
Atributos do log Atributos de log do registro de log.
Atributos do recurso URL do esquema e atributos do recurso.
Atributos do escopo URL do esquema, nome, versão e atributos do escopo de instrumentação.

Usando o filtro

Você pode usar o filtro para exibir apenas os registros de log nos quais está interessado.

Para filtrar por atributos, insira a chave do atributo, selecione o operador e insira o valor do atributo.

Os seguintes operadores são compatíveis:

  • Contém - (padrão) o valor do atributo contém a string inserida.
  • É igual a - o valor do atributo é igual à string inserida.
  • Não contém - o valor do atributo não contém a string inserida.
  • Não é igual a - o valor do atributo não é igual à string inserida.
  • Existe - o atributo com a chave inserida existe.
  • Não existe - o atributo com a chave inserida não existe.

Se você adicionar várias condições, selecione como avaliá-las:

  • E/Ou - (padrão) todas as condições devem ser atendidas; as condições com a mesma chave de atributo são combinadas com Ou.
  • Ou - pelo menos uma condição deve ser atendida.