Référence de l’orchestrateur
Référence de la configuration
Contrôle et journalisation
Journalisation

Journalisation

Maverics est en mesure de s’intégrer à des systèmes d’agrégation de logs pour consommer et traiter ces derniers.

Les logs sont envoyés à Syslog et incluent un identifiant Maverics. La plupart des plateformes d’agrégation de logs (ELK, Loggly, etc.) acceptent les flux de logs via Syslog.

Pour exécuter Maverics en mode debug, définissez la variable d’environnement MAVERICS_DEBUG_MODE sur true. La journalisation sera beaucoup plus claire en mode debug.

Options de configuration

Les options de journalisation peuvent être définies dans la section logger du fichier de configuration de Maverics.

Level

level détermine le degré de verbosité des logs de l’orchestrateur. Par exemple, level: error n’affichera que les logs d’erreur (lorsque le mode debug est désactivé). Les niveaux de log suivants sont pris en charge :

  • debug
  • info
  • error
ℹ️
L’activation du mode debug à partir de la ligne de commande (-v/--verbose) ou à travers la variable d’environnement (MAVERICS_DEBUG_MODE) sera prioritaire sur le champ level.

Log Session IDs

logSessionID est utilisé pour ajouter un identifiant de session dans les messages de log. Ce paramètre est utile pour filtrer les logs afin d’isoler un problème lié à une session particulière.

ℹ️
L’identifiant imprimé dans les logs correspond à une session particulière, mais il ne s’agit pas de l’identifiant de session à proprement parler et il ne peut donc pas être utilisé pour usurper l’identité d’un utilisateur.

Time format

timeFormat est utilisé pour modifier le formatage des horodatages de logs.

Par exemple, un format de type timeFormat: ANSIC créera des horodatages au format ts=:"Mon Jan 2 15:04:05 2006".

Les noms de format suivants sont pris en charge (insensible à la casse) :

NomFormat
ANSIC“Mon Jan _2 15:04:05 2006”
UnixDate“Mon Jan _2 15:04:05 MST 2006”
RubyDate“Mon Jan 02 15:04:05 -0700 2006”
RFC822“02 Jan 06 15:04 MST”
RFC822Z“02 Jan 06 15:04 -0700”
RFC850“Monday, 02-Jan-06 15:04:05 MST”
RFC1123“Mon, 02 Jan 2006 15:04:05 MST”
RFC1123Z“Mon, 02 Jan 2006 15:04:05 -0700”
RFC3339“2006-01-02T15:04:05Z07:00”
RFC3339Nano“2006-01-02T15:04:05.999999999Z07:00”
Kitchen“3:04PM”
Stamp“Jan _2 15:04:05”
StampMilli“Jan _2 15:04:05.000”
StampMicro“Jan _2 15:04:05.000000”
StampNano“Jan _2 15:04:05.000000000”

Les formats horaires personnalisés peuvent être spécifiés à l’aide d’une chaîne de caractères utilisant la date dans les exemples ci-dessus (Jan 2 15:04:05 2006) conformément au format horaire de Golang. Par exemple :

logger:
  timeFormat: "2006-01-02 15:04:05 MST"
ℹ️
Les logs de l’orchestrateur sont toujours en temps universel coordonné (UTC). Lors de la définition d’une chaîne timeFormat personnalisée comme ci-dessus, l’abréviation du fuseau horaire MST (ou un décalage de -0700) dans la chaîne de présentation ne change rien, mais définit la position de de l’echelle UTC ou de -0000 dans l’horodatage.

Exemples 

logger:
  level: debug
  logSessionID: true
  timeFormat: UnixDate
Santé