Base de connaissances/Best practices

Conventions de nommage

Métriques

<namespace>_<subsystem>_<name>_<unit> — par exemple system_cpu_usage_percent, http_requests_total, db_query_duration_seconds.

Labels

snake_case, latin + digits + underscore.

À éviter

  • Labels longs (>50 caractères) — overhead sur chaque sample
  • Haute cardinalité (user_id, session_id, timestamps) — voir cardinality-management
  • Réservés : __name__, organization_id, agent_id — gérés par le serveur