Base de conocimiento/Best practices

Convenciones de nombres

Métricas

<namespace>_<subsystem>_<name>_<unit> — por ejemplo system_cpu_usage_percent, http_requests_total, db_query_duration_seconds.

Labels

snake_case, latin + digits + underscore.

Evita

  • Labels largos (>50 caracteres) — overhead en cada sample
  • Alta cardinalidad (user_id, session_id, timestamps) — ver cardinality-management
  • Reservados: __name__, organization_id, agent_id — los gestiona el servidor