База знаний/Best practices

Naming conventions

Метрики

<namespace>_<subsystem>_<name>_<unit> — например system_cpu_usage_percent, http_requests_total, db_query_duration_seconds.

Лейблы

snake_case, latin + digits + underscore.

Избегайте

  • Длинных лейблов (>50 символов) — overhead на каждый sample
  • High-cardinality (user_id, session_id, timestamps) — см. cardinality-management
  • Reserved: __name__, organization_id, agent_id — управляются сервером