4. PVC观测标签体系设计原则：标签键命名规范、值语义约束、可扩展性要求

在存储版本漂移校准场景中，PVC观测标签体系是连接原始存储元数据与可观测性分析引擎的桥梁。标签设计质量直接决定校准规则的匹配精度、告警聚合的准确性以及未来新存储类型的接入成本。本节从键命名规范、值语义约束和可扩展性要求三个维度，建立PVC观测标签的设计契约。

4.1 标签键命名规范

标签键（Label Key）采用分层前缀 + 语义域 + 属性名的三段式结构，确保全局唯一性与可读性。前缀用于区分标签来源域，避免不同采集组件之间的键名冲突。

完整键名示例：

pvc.obs.storage.version.driver
pvc.obs.storage.version.provisioner
pvc.obs.storage.version.api
pvc.obs.storage.version.fsType
pvc.obs.csi.driver.name
pvc.obs.csi.driver.version
pvc.obs.volume.migration.status

4.2 值语义约束

标签值（Label Value）必须遵循类型化 + 枚举化 + 可排序的语义约束，确保下游分析引擎能够对标签值进行精确匹配、范围查询和版本比较。

4.3 可扩展性要求

标签体系必须支持存储类型扩展、CSI驱动版本迭代和新校准规则注入三种扩展场景，且扩展时无需修改已有标签的键名和值语义。

标签模板示例（CSI RBD 驱动）：

apiVersion: obs.k8s.io/v1
kind: PVCLabelTemplate
metadata:
  name: csi-rbd-template
spec:
  storageClass: "csi-rbd-sc"
  labels:
    - key: "pvc.obs.storage.version.driver"
      valueFrom: "spec.csi.driver"
    - key: "pvc.obs.storage.version.provisioner"
      valueFrom: "metadata.annotations.provisioner"
    - key: "pvc.obs.csi.rbd.imageFeatures"
      valueFrom: "parameters.imageFeatures"
      defaultValue: "layering"
    - key: "pvc.obs.storage.version.api"
      value: "v1"

4.4 标签体系与校准场景的映射关系

在存储版本漂移校准场景中，标签体系需要直接支撑版本差异检测、漂移范围界定和校准策略选择三个核心动作。下表展示了标签与场景的映射关系：

4.5 标签生命周期管理

标签体系不是静态的，需要随存储生态演进持续维护。建议建立以下管理机制：

• 标签注册中心：所有PVC观测标签必须在集群级ConfigMap中注册，包含键名、值类型、枚举值列表、引入版本和废弃版本。
• 废弃标签策略：标签废弃后保留至少两个大版本周期，期间采集器同时生成新旧两个标签，下游告警规则逐步迁移。
• 标签审计：定期扫描集群中所有PVC的标签覆盖率，发现缺失标签或非法值时触发告警。

4.6 设计原则总结

PVC观测标签体系的设计核心在于标准化与可演化的平衡。键命名规范确保不同团队、不同存储厂商的标签不会冲突；值语义约束保证下游分析工具能够正确解析和比较；可扩展性要求则让标签体系能够跟随K8s存储生态的演进持续生长，而不需要推倒重来。