Skip to main content
Cette page est un plan de l’arborescence du dépôt de la stack de supervision. La règle générale est simple : si un fichier est produit par un script, il porte un en-tête qui le dit. Ne le modifiez pas, modifiez le script.

​
Arborescence

Dépôt de la stack

​
Ce qu’on édite à la main

scripts/build-dashboards.py

Source de vérité des dashboards Grafana. Modifiez ici, régénérez avec make dashboards.

vmalert/rules/

Les 261 règles métriques, organisées par domaine. Modifiez le YAML, puis make valider && make reload.

vmalert/rules-logs/

Les 26 règles sur les journaux. Même procédure.

k8s-agent/

Les manifestes déployés DANS le cluster (agents de collecte).

​
Ce qu’on ne modifie JAMAIS à la main

grafana/dashboards/ est généré. Toute modification y est écrasée à la prochaine exécution de make dashboards. Passez par scripts/build-dashboards.py.

​
Le .env

Le fichier .env contient les secrets, en 0600, HORS de Git. Ne le committez sous aucun prétexte. Utilisez make htpasswd pour générer les identifiants basic auth, et les apostrophes simples pour toute valeur contenant $ (voir ‘Pièges connus’ #4).

​
Le fichier docs/GUIDE-ACCUEIL.md

Ce guide interne est généré par make doc à partir des 13 dashboards et du Makefile. Il ne périme pas : sa régénération à chaque évolution de la stack le maintient à jour automatiquement.
Des questions sur l’arborescence ? Écrivez à devops@kaeyros-analytics.com.