metrics-setuplisted

# Conception des métriques ## Ce que ce skill n'enseigne pas Installer Prometheus, écrire un `scrape_config`, brancher Grafana, rédiger une règle Alertmanager : c'est le skill `prometheus-grafana-setup`. Ici on décide **quoi mesurer et sous quel nom**, avant de toucher à l'outillage. Le corollaire vaut aussi : une métrique mal nommée ou trop cardinale ne se corrige pas, elle se remplace, et l'historique est perdu. ## Nommage : convention imposée **La même convention sur tous les projets**, comme le format console de `logging-setup`. Un nom de métrique se lit sans documentation. ``` <namespace>_<sujet>_<unité>[_total] ``` ``` http_requests_total compteur de requêtes http_request_duration_seconds histogramme de latence queue_messages_pending jauge de profondeur de file process_resident_memory_bytes jauge de mémoire ``` Règles de forme : | Règle | Détail | |---|---| | **Unités de base uniquement** | `seconds`, `bytes`, `ratio`. Jamais `ms`, `mb`, `percent` | | **L'unité est dans le nom** | Un nom sans unité oblige à ouvrir le code pour savoir ce qu'on lit | | **Suffixe `_total`** sur tout compteur | Rend le type lisible à l'œil et dans les requêtes | | **Pas de suffixe de type** ailleurs | Pas de `_gauge`, pas de `_histogram` | | **Namespace = le service ou le composant** | `checkout_`, `ingest_`, pas l'équipe ni l'environnement | | **Snake case, en anglais, au pluriel pour ce qui se compte** | `requests`, `errors