# 指标命名规范

## 命名格式

```
rmdc_{module}_{resource}_{action}_{unit}
```

## 命名规则

1. 全小写，下划线分隔
2. 以 `rmdc_` 前缀开头
3. 包含模块名
4. 描述清晰的资源和动作
5. 带单位后缀（如适用）

## 常用后缀

| 后缀 | 说明 | 示例 |
|:---|:---|:---|
| _total | 计数器 | rmdc_user_auth_login_total |
| _seconds | 时间（秒） | rmdc_api_request_duration_seconds |
| _bytes | 大小（字节） | rmdc_file_size_bytes |
| _ratio | 比率 | rmdc_cache_hit_ratio |

## 示例

```go
// 计数器
rmdc_user_auth_login_total{status="success"}
rmdc_user_auth_login_total{status="failed"}

// 直方图
rmdc_user_auth_request_duration_seconds{endpoint="/api/auth/login"}

// Gauge
rmdc_user_auth_active_sessions
```

## 标签规范

- 标签名小写下划线
- 标签值使用小写
- 避免高基数标签（如 user_id）

```go
// ✅ 正确
loginCounter.WithLabelValues("success").Inc()

// ❌ 错误 - 高基数
loginCounter.WithLabelValues(userID).Inc()
```
