Passa al contenuto principale

7. ID Dati Strutturati

Questa sezione definisce SD-ID standardizzati che possono essere utilizzati tra le implementazioni. Questi SD-ID sono registrati presso IANA.

7.1. timeQuality​

L'SD-ID timeQuality fornisce informazioni sulla qualità del timestamp nell'HEADER. Contiene parametri che descrivono:

  • Conoscenza del fuso orario
  • Stato di sincronizzazione del tempo
  • Precisione della sincronizzazione

Nome SD-ID: timeQuality

7.1.1. tzKnown​

Indica se il TIMESTAMP include informazioni sul fuso orario.

Valori:

  • 0: Le informazioni sul fuso orario non sono note (predefinito)
  • 1: Le informazioni sul fuso orario sono note

Se il parametro è assente, si presume il valore 0.

7.1.2. isSynced​

Indica se il tempo dell'originatore è sincronizzato con una fonte di tempo affidabile (ad es. server NTP).

Valori:

  • 0: Il tempo non è sincronizzato
  • 1: Il tempo è sincronizzato

Se il parametro è assente, il valore non può essere determinato.

7.1.3. syncAccuracy​

Indica la precisione del timestamp in microsecondi. Questo valore è significativo solo quando isSynced="1".

Valore: Un intero che rappresenta la precisione in microsecondi.

Esempio: syncAccuracy="60000" significa che il tempo è preciso entro 60 millisecondi.

7.1.4. Esempi​

Fuso orario noto, sincronizzato, precisione 100ms:

[timeQuality tzKnown="1" isSynced="1" syncAccuracy="100000"]

Fuso orario sconosciuto, non sincronizzato:

[timeQuality tzKnown="0" isSynced="0"]

Solo sincronizzato:

[timeQuality isSynced="1"]

7.2. origin​

L'SD-ID origin fornisce informazioni sull'originatore del messaggio syslog. Questo è particolarmente utile quando i messaggi passano attraverso i relè.

Nome SD-ID: origin

7.2.1. ip​

Contiene l'indirizzo IP dell'originatore.

Valore: Indirizzo IPv4 o IPv6

Gli indirizzi IPv6 DOVREBBERO essere racchiusi tra parentesi quadre.

Esempio: ip="192.0.2.1" o ip="[2001:db8::1]"

7.2.2. enterpriseId​

Contiene il numero di impresa privata (PEN) assegnato da IANA del fornitore o dell'organizzazione.

Valore: Intero che rappresenta il numero di impresa

Esempio: enterpriseId="32473"

I numeri di impresa possono essere ottenuti da IANA. Vedere http://www.iana.org/assignments/enterprise-numbers

7.2.3. software​

Identifica il software che ha generato il messaggio.

Valore: Stringa in formato libero che identifica il software

Esempio: software="rsyslogd" o software="myapp"

7.2.4. swVersion​

Specifica la versione del software identificato nel parametro software.

Valore: Stringa di versione

Esempio: swVersion="1.2.3" o swVersion="8.24.0"

7.2.5. Esempio​

Informazioni complete sull'origine:

[origin ip="192.0.2.1" enterpriseId="32473" software="myapp" swVersion="1.2.3"]

Informazioni minime sull'origine:

[origin ip="192.0.2.1"]

7.3. meta​

L'SD-ID meta fornisce metadati sul messaggio stesso.

Nome SD-ID: meta

7.3.1. sequenceId​

Un identificatore univoco per il messaggio, spesso un numero di sequenza. Questo può essere utilizzato per rilevare la perdita di messaggi.

Valore: Intero o stringa che rappresenta la sequenza

Esempio: sequenceId="1234"

7.3.2. sysUpTime​

Il tempo in centesimi di secondo dall'ultimo riavvio dell'originatore. Simile a SNMP sysUpTime.

Valore: Intero che rappresenta il tempo in centisecondi (1/100 di secondo)

Esempio: sysUpTime="1234567" (circa 3,4 ore)

7.3.3. language​

Specifica la lingua naturale utilizzata nella parte MSG del messaggio.

Valore: Tag linguistico come definito in RFC 5646

Esempi:

  • language="en" (Inglese)
  • language="fr-CA" (Francese canadese)
  • language="ja" (Giapponese)
  • language="de" (Tedesco)

Esempio d'uso:

[meta sequenceId="1234" sysUpTime="1234567" language="en"]
Ultimo aggiornamento il