运营指标：实现与数据质量

指定运营指标的收集、身份识别、存储、验证、隐私、监控和调试。该参考规范确定了采用边界、失败行为和可观察证据，同时允许配置环境特定的限制。

包状态： 参考上下文已准备好供人工审查。合同和测试场景已完成，但不保证采用的实现已通过它们。

决策

对于运营指标，采用由产品决策拥有的版本化事件和指标字典。通过一个权威的写入路径、类型化接口、显式状态和幂等副作用处理来实现行为。该包是一个参考合同：采用团队必须根据自身环境中的证据选择数值限制、提供商、管辖区和运营负责人。

范围

• 本实现模块描述的运营指标参与者、输入、输出、状态、策略或模式版本及外部可见结果。
• 主要和备用接口、后台工作、缓存、集成、支持路径及可行使相同边界的证据。
• 安全应用参考所需的采用特定配置、发布、恢复和验证职责。

不包含内容

• 为每个采用者选择通用供应商、框架、管辖区、数值阈值、保留期或服务级别目标。
• 声称已针对下游实现运行打包场景，或该参考授予法律、安全或无障碍认证。

合同

• 为每个事件指定语义所有者、模式版本、触发器、必需属性及不得发出的事件示例。
• 保持账户、设备、匿名和会话身份的区分；仅通过可审计的确定性规则合并。
• 从定义的人群和时间窗口计算决策指标，包括迟到事件、排除项和缺失数据行为。
• 在发出前应用同意和收集控制，避免敏感值出现在自由格式属性和维度中。
• 在边界处对输入进行一次验证，并保留下游逻辑使用的规范化表示。
• 在业务转换之前或与外发记录原子持久化；消费者通过持久操作身份去重。
• 从用户可见的可用性、延迟、正确性、新鲜度、饱和度和工作负载边界推导服务指标，并将每个指标附加给所有者和目标。
• 限制单位和标签，区分客户端、服务、依赖、队列和作业结果，将异常信号关联到部署、追踪、日志、运行手册、告警和恢复证据。

实现指导

• 先发布增量存储和接口变更，进行可观察的补充，然后在兼容性证据确认后废弃旧路径。
• 在选择框架或供应商细节前，建模运营指标的输入、输出、参与者、状态、不变量、副作用和证据。
• 将适用的运营指标合同或策略版本与重要状态一起存储，以便迁移、重放和支持决策可追溯。
• 在受控发布后引入路径，比较预期和观察结果，并保持经过测试的恢复路径，直到采用证据完整。

失败处理与保障措施

• 模式违规进入可见的隔离或拒绝路径；不会静默更改指标分母。
• 无效或矛盾的运营指标状态被拒绝或隔离；实现绝不猜测会扩大权限或重复效果的值。
• 重试有界且使用持久身份；耗尽后，工作进入可检查的终态并有责任所有者。

验证与运营

• 在持久化前后注入依赖失败，证明重试最终收敛到一个外部可见结果。
• 按合同版本监控运营指标的成功、拒绝、验证失败、依赖失败、重试耗尽和恢复，且不包含敏感负载维度。
• 在策略、模式、依赖、迁移或边界变更后，重新运行正负配对的测试夹具并保留结果证据。

采用假设

• 示例中的名称和值是具体夹具，不是通用默认；采用者通过文档化证据和所有权替换它们。
• 采用系统能够提供认证身份、持久操作或记录版本、有界遥测和受控变更路径。

本包中看似可执行的示例是夹具和验收合同。运行收集验证器检查结构和元数据，然后在目标仓库中翻译并执行场景，最后记录实现证据。