> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Commandes make de la stack de supervision

> Catalogue complet des commandes make de la stack de supervision. Découvrez bilan, valider, diagnostic, appariement et les outils de cycle de vie, validation et déploiement.

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.

> [!WARNING]
>
> 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. |

> [!TIP]
>
> 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. |

> [!NOTE]
>
> Pour toute question ou problème lié à la stack de supervision, contactez l'équipe DevOps : [**devops@kaeyros-analytics.com**](mailto:devops@kaeyros-analytics.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.