Documentation

Logs et templates

Utilisez des logs texte, JSON ou logfmt et remodelez la sortie structurée dans la TUI.

Modes de logs

Vectron peut router la sortie des processus vers:

  • console
  • files
  • both

Le comportement par défaut est configuré globalement et peut être surchargé par processus.

Valeurs par défaut utiles ici:

  • global.log_mode : défaut console
  • process.log_mode : hérite de global.log_mode

Formats de logs

Les formats supportés incluent:

  • text
  • logfmt
  • json
  • json_pretty

Choisissez un format structuré si vous voulez que la TUI extraie des champs et rende la ligne autrement que sous sa forme brute.

Valeurs par défaut utiles ici:

  • global.log_format : défaut text
  • process.log_format : hérite de global.log_format

Les templates n’affectent que le rendu

Les templates de logs remodèlent les lignes structurées pour la console et l’historique. Les fichiers conservent toujours la sortie brute du processus.

Cette séparation est importante:

  • les logs rendus peuvent être plus courts et plus lisibles
  • les logs fichiers restent fidèles à la sortie du processus enfant

Presets

Definissez des presets sous [log_templates.<name>], puis liez-les via:

  • [global.log_template]
  • [process.log_template]

Utilisez:

  • preset
  • stdout_preset
  • stderr_preset

Valeurs par défaut utiles ici:

  • preset : défaut aucun
  • stdout_preset : défaut aucun
  • stderr_preset : défaut aucun
  • separator dans un layout : valeur effective par défaut " "
  • format sur un champ : valeur effective par défaut none
  • visible_if sur un champ : valeur effective par défaut always

Désactiver les couleurs ANSI des processus enfants

Quand vous parsez du JSON ou du logfmt issu des processus enfants, les séquences ANSI peuvent être indésirables. Utilisez:

[global]
disable_color_env = true

Vous pouvez surcharger ce comportement par processus.

Valeurs par défaut utiles ici:

  • global.disable_color_env : défaut false
  • process.disable_color_env : hérite de global.disable_color_env