> ## 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.

# Arborescence de la stack de supervision

> Plan de l'arborescence du dépôt de la stack de supervision Kaeyros. Découvrez quels fichiers s'éditent à la main et lesquels sont générés automatiquement.

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

```text Dépôt de la stack theme={null}
scripts/build-dashboards.py   LA source des dashboards. Rien d'autre.
scripts/valider.sh              la suite de tests, lancée par make valider
scripts/bilan.py                l'état de ce qui tourne
vmalert/rules/                  les 261 règles métriques, par domaine
vmalert/rules-logs/             les 26 règles sur les journaux
k8s-agent/                      ce qui se déploie DANS le cluster
grafana/dashboards/             généré, ne pas éditer à la main
docs/GUIDE-ACCUEIL.md           ce document, généré par make doc
.env                            les secrets, en 0600, hors de git
```

## 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

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

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

> [!NOTE]
>
> 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](mailto:devops@kaeyros-analytics.com).


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