指标列表

本页区分 OpenBao 遥测接口的原始指标 与 vmalert 计算生成的记录指标。当前源码的 files/victoria/rules/vault.yml 定义了 14 条记录规则；记录指标由规则求值得到，不应在 /v1/sys/metrics 接口中查找。

原始指标会随 OpenBao 版本、成员角色与运行状态变化。下文列出的是 Vault Overview 面板与记录规则用到的原始指标，并不代表遥测接口的完整输出，完整列表请参考 OpenBao 遥测指标文档。

标签模型

所有 VAULT 指标都携带统一的标签：

记录规则以 vault:ins:*（实例级）与 vault:cls:*（集群级）命名。

原始指标的特点

OpenBao 沿用了上游 Vault 的 vault_ 指标前缀，并通过 go-metrics 输出 Prometheus 格式的指标，有几点需要注意：

• 计数器没有 _total 后缀，例如 vault_raft_apply、vault_token_creation；
• Summary 的单位是毫秒，例如 vault_core_handle_request 的分位数与 _sum 都以毫秒计，记录规则在计算平均延迟时会除以 1000 换算为秒；
• 部分计数器只有在首次发生后才会出现，例如审计失败计数器 vault_audit_log_request_failure，因此记录规则使用 increase_pure 从 0 开始计算增量；
• Autopilot 与 follower 指标只由 leader 上报，并且在成员卸任 leader 后仍会被保留 24 小时（prometheus_retention_time）。因此记录规则只采信当前 active 成员上报的值，并把其中的 node_id / peer_id 标签映射回 ins；
• 用量类指标（令牌数、KV 机密数、身份实体数）由 OpenBao 每 10 分钟计算一次（usage_gauge_period）。

当前记录规则

表达式保留源码语义，ins 与 cls 分别表示实例与集群聚合层级，实际保留的标签以 by 与向量匹配子句为准。

在一个时间窗口内没有任何请求时，平均延迟的计算结果为 0/0 = NaN，会被丢弃，表现为没有数据。

此外，vault_up 来自 INFRA 的 共享存活记录规则（up{job="vault"}），不包含在上面的模块规则数量中。它反映的是抓取是否成功，不代表成员已解封或能够正常提供服务。

常用原始指标

状态与请求

Raft 与 Autopilot

机密、令牌与审计

运行时

快照备份（来自 node_exporter 的 textfile 采集器，job 为 node 的抓取任务）

这两个指标由 vault-backup 脚本在快照成功后写入 /var/lib/node_exporter/textfile/vault.prom，只在成功时更新。移除成员时，该文件会一并删除。