Commandes make de la stack de supervision

Toutes les commandes de cette page se lancent depuis la racine du dépôt de la stack de supervision, directement sur le serveur de supervision. Le Makefile regroupe une trentaine de commandes organisées par domaine : installation, cycle de vie, validation, dashboards, notifications, sauvegarde et nettoyage.

Les deux à retenir en priorité

make bilan

L’état de ce qui TOURNE : conteneurs, cibles de scrape, règles d’alerte, alertes actives.

make valider

L’état des FICHIERS : règles, configurations, dashboards, manifestes Kubernetes.

Tout ce qui a mal tourné dans cette stack était invisible à l’un des deux. Passez les deux commandes avant de conclure quoi que ce soit.

Démarrage et installation

Commande	Ce qu’elle fait
`make help`	Liste les commandes disponibles avec une brève description.
`make install`	TOUT préparer et démarrer. C’est la seule commande à connaître au début.
`make bootstrap`	(Re)génère `.env` et les manifestes sans rien démarrer.
`make htpasswd`	Génère un couple utilisateur/mot de passe pour `ADMIN_BASICAUTH_USERS`.
`make outils`	Installe `promtool` et `amtool` dans `bin/`, pour que `make valider` vérifie tout.

Cycle de vie de la stack

Commande	Ce qu’elle fait
`make up`	Démarre toute la stack (VictoriaMetrics, VictoriaLogs, vmalert, Alertmanager, Grafana).
`make down`	Arrête la stack. Les données sont conservées sur le volume local.
`make restart`	Redémarre l’ensemble de la stack proprement.
`make ps`	Affiche l’état des conteneurs en cours d’exécution.
`make logs-follow`	Suit les logs des conteneurs de la stack en temps réel.
`make config`	Régénère `alertmanager.yml`, `vmauth.yml` et les manifestes Kubernetes.
`make apply`	Applique les manifestes générés dans le cluster.
`make reload`	Recharge les règles d’alerte et la configuration de scrape sans redémarrer les services.
`make restart-alertmanager`	Recharge Alertmanager après un changement de canal de notification.
`make restart-grafana`	Recharge Grafana après un changement de dashboard ou de datasource.

Validation et diagnostic

Commande	Ce qu’elle fait
`make bilan`	État de santé de ce qui tourne : conteneurs, cibles, règles, alertes.
`make diagnostic`	Indique quels panneaux Grafana n’ont pas de données, et pourquoi.
`make valider`	Vérifie les règles, configs, dashboards et manifestes sans rien démarrer.
`make check`	Valide la syntaxe des règles Prometheus et des configurations.
`make appariement A='<métrique>' B='<métrique>' SUR=<label>`	Explique pourquoi une opération entre deux métriques ne renvoie rien (appariement de vecteurs).
`make regles-erreurs`	Liste les règles vmalert qui échouent silencieusement.
`make cardinality`	Identifie les métriques et labels qui consomment le plus de ressources.
`make test-alert`	Envoie une alerte de test dans toute la chaîne (règle, Alertmanager, notification).
`make test-smtp`	Vérifie les identifiants SMTP en tentant une vraie connexion au serveur de messagerie.

La commande make appariement est particulièrement utile pour déboguer les recording rules et les dashboards Grafana. Si deux séries temporelles ne se combinent pas, vérifiez que le label de jointure existe bien des deux côtés et qu’il porte la même valeur.

Dashboards

Commande	Ce qu’elle fait
`make dashboards`	Régénère les dashboards depuis `scripts/build-dashboards.py`.
`make apercu`	Dessine la mise en page des dashboards dans une page HTML, sans déployer.
`make grafana-etat`	Vérifie ce que Grafana a réellement chargé (dossiers, dashboards, datasources).
`make grafana-purger`	Supprime les dossiers Grafana vides laissés par un ancien provisioning.
`make doc`	Génère `docs/GUIDE-ACCUEIL.md` à partir des dashboards et du Makefile.

Notifications

Commande	Ce qu’elle fait
`make waha-sessions`	Vérifie la connexion à WAHA et affiche le nom de la session WhatsApp active.
`make waha-groups`	Liste vos groupes WhatsApp et leur identifiant (`@g.us`).

Sauvegarde et données

Commande	Ce qu’elle fait
`make backup`	Sauvegarde la configuration et les dashboards Grafana.
`make snapshot`	Crée un instantané cohérent des données VictoriaMetrics.

Journaux

Commande	Ce qu’elle fait
`make logs Q='{app="api"} i(error)'`	Interroge les logs en ligne de commande via VictoriaLogs.

Nettoyage et déploiement

Commande	Ce qu’elle fait
`make ranger`	Déplace dans `_to_delete/` les fichiers signalés comme obsolètes.
`make pg-exporter A=detecter`	Déploie le sidecar `postgres_exporter` pour surveiller une base PostgreSQL.

Pour toute question ou problème lié à la stack de supervision, contactez l’équipe DevOps : devops@kaeyros-analytics.com.

Outillage

Observabilité

Surveillance quotidienne

Catalogue applicatif

Stack de supervision

Les deux à retenir en priorité

make bilan

make valider

Démarrage et installation

Cycle de vie de la stack

Validation et diagnostic

Dashboards

Notifications

Sauvegarde et données

Journaux

Nettoyage et déploiement

​Les deux à retenir en priorité

make bilan

make valider

​Démarrage et installation

​Cycle de vie de la stack

​Validation et diagnostic

​Dashboards

​Notifications

​Sauvegarde et données

​Journaux

​Nettoyage et déploiement

Les deux à retenir en priorité

Démarrage et installation

Cycle de vie de la stack

Validation et diagnostic

Dashboards

Notifications

Sauvegarde et données

Journaux

Nettoyage et déploiement