Conventions de journalisation

etcd utilise la bibliothèque zap pour la journalisation de la sortie de l’application, catégorisée en niveaux. Le niveau d’un message de journalisation est déterminé selon les conventions suivantes :

• Les journaux DebugLevel sont généralement volumineux et sont habituellement désactivés en production.

  • Exemples :
    • Envoyer un message normal à un pair distant
    • Écrire une entrée de journal sur le disque

• InfoLevel est la priorité de journalisation par défaut.

  • Exemples :
    • Configuration au démarrage
    • Effectuer un instantané
    • Ajouter un nouveau nœud au cluster
    • Ajouter un nouvel utilisateur au sous-système d’authentification

• Les journaux de niveau Warn sont plus importants que ceux de niveau Info, mais ne nécessitent pas de revue humaine individuelle.

  • Exemples :
    • Échec de l’envoi d’un message Raft à un pair distant
    • Échec de réception d’un message de battement de cœur dans le délai d’élection configuré

• Les journaux ErrorLevel sont de haute priorité. Si une application fonctionne correctement, elle ne doit générer aucun journal de niveau erreur.

  • Exemples :
    • Échec de l’allocation d’espace disque pour le WAL

• PanicLevel enregistre un message, puis provoque un arrêt anormal.

  • Exemples :
    • Échec du codage des messages Raft

• FatalLevel enregistre un message, puis appelle os.Exit(1).

  • Exemples :
    • Échec de la sauvegarde de l’instantané Raft