Documentation

Probes de readiness

Marquez les processus comme prêts via des motifs de logs ou une connectivité TCP.

Pourquoi la readiness est importante

Un processus peut être lancé correctement sans être encore prêt à servir du trafic. Vectron modélise cela explicitement et expose la readiness dans status et dans la TUI.

Readiness basée sur les logs

Utilisez un motif de logs quand le processus imprime un message de démarrage fiable.

[process.readiness]
type = "log"

[process.readiness.ready]
pattern = "listening"
stream = "stdout"

Valeurs par défaut utiles ici:

  • ready.stream : défaut stdout
  • error : défaut aucun

Readiness TCP

Utilisez une probe TCP quand le processus est considéré comme prêt dès qu’un port accepte des connexions.

[process.readiness]
type = "tcp"
host = "127.0.0.1"
port = "auto"
interval_ms = 500

port = "auto" suit le port alloué à l’instance.

Valeurs par défaut utiles ici:

  • host : défaut 127.0.0.1
  • port : défaut auto
  • interval_ms : défaut 500

Valeurs globales et surcharges par processus

Définissez la readiness globalement quand la plupart des processus partagent le même modèle, puis surchargez-la par processus si nécessaire.

Si un bloc readiness est absent au niveau processus, il hérite de global.readiness.

Bonne pratique

  • préférez la readiness par logs quand le processus émet une ligne de démarrage stable
  • préférez la readiness TCP quand le signal réel d’utilisabilité est l’ouverture du port
  • évitez les regex fragiles qui matchent trop de lignes sans rapport