Aller au contenu principal

7. Identifiants de Données Structurées

Cette section définit les SD-ID standardisés qui peuvent être utilisés dans les implémentations. Ces SD-ID sont enregistrés auprès de l'IANA.

7.1. timeQuality​

Le SD-ID timeQuality fournit des informations sur la qualité de l'horodatage dans l'EN-TÊTE. Il contient des paramètres qui décrivent:

  • Connaissance du fuseau horaire
  • État de synchronisation du temps
  • Précision de la synchronisation

Nom du SD-ID: timeQuality

7.1.1. tzKnown​

Indique si le TIMESTAMP inclut des informations de fuseau horaire.

Valeurs:

  • 0: Les informations de fuseau horaire ne sont pas connues (par défaut)
  • 1: Les informations de fuseau horaire sont connues

Si le paramètre est absent, la valeur 0 est supposée.

7.1.2. isSynced​

Indique si le temps de l'émetteur est synchronisé avec une source de temps fiable (par exemple, serveur NTP).

Valeurs:

  • 0: Le temps n'est pas synchronisé
  • 1: Le temps est synchronisé

Si le paramètre est absent, la valeur ne peut pas être déterminée.

7.1.3. syncAccuracy​

Indique la précision de l'horodatage en microsecondes. Cette valeur n'est significative que lorsque isSynced="1".

Valeur: Un entier représentant la précision en microsecondes.

Exemple: syncAccuracy="60000" signifie que le temps est précis à 60 millisecondes près.

7.1.4. Exemples​

Fuseau horaire connu, synchronisé, précision de 100ms:

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

Fuseau horaire inconnu, non synchronisé:

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

Seulement synchronisé:

[timeQuality isSynced="1"]

7.2. origin​

Le SD-ID origin fournit des informations sur l'émetteur du message syslog. Ceci est particulièrement utile lorsque les messages passent par des relais.

Nom du SD-ID: origin

7.2.1. ip​

Contient l'adresse IP de l'émetteur.

Valeur: Adresse IPv4 ou IPv6

Les adresses IPv6 DEVRAIENT être entourées de crochets.

Exemple: ip="192.0.2.1" ou ip="[2001:db8::1]"

7.2.2. enterpriseId​

Contient le numéro d'entreprise privée (PEN) attribué par l'IANA du fournisseur ou de l'organisation.

Valeur: Entier représentant le numéro d'entreprise

Exemple: enterpriseId="32473"

Les numéros d'entreprise peuvent être obtenus auprès de l'IANA. Voir http://www.iana.org/assignments/enterprise-numbers

7.2.3. software​

Identifie le logiciel qui a généré le message.

Valeur: Chaîne de forme libre identifiant le logiciel

Exemple: software="rsyslogd" ou software="myapp"

7.2.4. swVersion​

Spécifie la version du logiciel identifié dans le paramètre software.

Valeur: Chaîne de version

Exemple: swVersion="1.2.3" ou swVersion="8.24.0"

7.2.5. Exemple​

Informations complètes sur l'origine:

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

Informations minimales sur l'origine:

[origin ip="192.0.2.1"]

7.3. meta​

Le SD-ID meta fournit des métadonnées sur le message lui-même.

Nom du SD-ID: meta

7.3.1. sequenceId​

Un identifiant unique pour le message, souvent un numéro de séquence. Ceci peut être utilisé pour détecter la perte de messages.

Valeur: Entier ou chaîne représentant la séquence

Exemple: sequenceId="1234"

7.3.2. sysUpTime​

Le temps en centièmes de seconde depuis le dernier redémarrage de l'émetteur. Similaire à SNMP sysUpTime.

Valeur: Entier représentant le temps en centisecondes (1/100 de seconde)

Exemple: sysUpTime="1234567" (environ 3,4 heures)

7.3.3. language​

Spécifie la langue naturelle utilisée dans la partie MSG du message.

Valeur: Balise de langue telle que définie dans RFC 5646

Exemples:

  • language="en" (Anglais)
  • language="fr-CA" (Français canadien)
  • language="ja" (Japonais)
  • language="de" (Allemand)

Exemple d'utilisation:

[meta sequenceId="1234" sysUpTime="1234567" language="en"]
Dernière mise à jour le