Log

Panoramica

La sezione APM > Logs visualizza i record di log raccolti dalle applicazioni e dai servizi.

Un record di log è un record testuale di un evento (ad esempio, un pagamento non riuscito o un timeout del database). Ogni record di log ha una gravità e un messaggio (corpo). Se un record di log è stato prodotto durante un'operazione che fa parte di una traccia, contiene anche gli ID di tale traccia e dello span.

Ogni record di log viene prodotto da un servizio (ad esempio, zabbix-frontend; denominato dall'attributo della risorsa OpenTelemetry service.name) e da un ambito di strumentazione, ovvero la parte di codice che lo ha creato (ad esempio, una libreria di logging).

Per fornire il contesto relativo a ogni evento, i record di log hanno anche attributi chiave-valore: gli attributi di log descrivono l'evento stesso (ad esempio, log.file.path: /var/log/zabbix/zabbix_frontend.log), mentre gli attributi della risorsa descrivono il servizio e l'ambiente in cui viene eseguito (ad esempio, host.name: eabf8c2a5ddc).

Per ulteriori informazioni sui log, consultare la documentazione di OpenTelemetry.

La sezione APM > Logs contiene i seguenti elementi:

Elenco dei log

Ogni riga nell'elenco dei log rappresenta un record di log.

I record di log vengono visualizzati in una tabella personalizzabile. Il pulsante Personalizza tabella nell'intestazione della tabella consente di mostrare, nascondere o riordinare le colonne e di ripristinare il layout predefinito. È inoltre possibile ridimensionare ogni colonna trascinandone il bordo destro; fare doppio clic sul bordo per ripristinare le dimensioni. Tutte le personalizzazioni vengono applicate immediatamente e memorizzate per l'utente corrente.

L'elenco dei log può contenere le seguenti colonne:

Ogni colonna corrisponde a una colonna nella tabella otel_logs della sorgente dati di telemetria; per l'elenco delle colonne, vedere Colonne di dati di telemetria supportate. La maggior parte delle colonne ha lo stesso nome utilizzato nella sorgente dati (ad esempio, Testo della gravità corrisponde alla colonna SeverityText). Quando i nomi differiscono, la colonna della sorgente dati è specificata nella tabella seguente.

Colonna Descrizione
Timestamp Data e ora in cui si è verificato l'evento.
Corpo Messaggio del record di log.
Testo della gravità Livello di gravità fornito dall'applicazione (ad esempio, INFO, WARN o ERROR).
Il colore dell'etichetta dipende dalla gravità.
Numero della gravità Livello di gravità espresso come numero:
0 - NON SPECIFICATO.
1-4 - TRACE.
5-8 - DEBUG.
9-12 - INFO.
13-16 - WARN.
17-20 - ERROR.
21-24 - FATAL.
ID trace ID, se presente, della trace durante la quale è stato prodotto il record di log.
ID span ID, se presente, dello span durante il quale è stato prodotto il record di log.
Flag Flag della trace del record di log:
0 - la trace non è campionata.
1 - la trace è campionata (registrata).

Colonna della sorgente dati: TraceFlags.
Nome del servizio Servizio che ha prodotto il record di log.
Nome dell'ambito Ambito di strumentazione che ha prodotto il record di log.
Versione dell'ambito Versione dell'ambito di strumentazione.
Nome dell'evento Nome, se presente, del tipo di evento rappresentato dal record di log.
Attributi del log Attributi del log del record di log.
Fare clic sul pulsante con tre puntini per visualizzare tutti gli attributi.
Attributi della risorsa Attributi della risorsa del record di log.
Fare clic sul pulsante con tre puntini per visualizzare tutti gli attributi.
Attributi dell'ambito Attributi dell'ambito di strumentazione.
Fare clic sul pulsante con tre puntini per visualizzare tutti gli attributi.

Dettagli del log

Fare clic su un record di log nell'elenco dei log per aprire il pannello Dettagli del log, che mostra tutte le informazioni relative al record di log.

Il pannello Dettagli del log può contenere le seguenti sezioni:

Sezione Descrizione
Informazioni di base ID della traccia, ID dello span e flag della traccia del record di log.
Attributi del log Attributi del log del record di log.
Attributi della risorsa URL dello schema e attributi della risorsa.
Attributi dell'ambito URL dello schema, nome, versione e attributi dell'ambito di strumentazione.

Utilizzo del filtro

È possibile utilizzare il filtro per visualizzare solo i record di log di interesse.

Per filtrare in base agli attributi, immettere la chiave dell'attributo, selezionare l'operatore e immettere il valore dell'attributo.

Sono supportati i seguenti operatori:

  • Contiene - (predefinito) il valore dell'attributo contiene la stringa immessa.
  • Uguale - il valore dell'attributo è uguale alla stringa immessa.
  • Non contiene - il valore dell'attributo non contiene la stringa immessa.
  • Diverso da - il valore dell'attributo è diverso dalla stringa immessa.
  • Esiste - esiste l'attributo con la chiave immessa.
  • Non esiste - non esiste l'attributo con la chiave immessa.

Se si aggiungono più condizioni, selezionare come valutarle:

  • And/Or - (predefinito) devono essere soddisfatte tutte le condizioni; le condizioni con la stessa chiave dell'attributo vengono combinate con Or.
  • Or - deve essere soddisfatta almeno una condizione.