用途:该技能针对业务运营 KPI 埋点,区别于技术指标(延迟、错误、资源占用),用于度量 charges、invoices、suppliers、payments 等业务成果。适用于需要在领域服务层(而非基础设施层)埋点、监控业务流程结果、为业务指标定义 SLI/SLO、将业务结果与系统性能关联、构建面向管理层的仪表盘,以及跟踪领域实体生命周期状态流转的场景。资料明确列出不适用情形:纯技术指标应使用 python-micrometer-core;高基数用户/请求跟踪应使用分布式追踪;未配置指标后端时应先使用 python-micrometer-metrics-setup。
主要能力:通过 MeterRegistry 注册 Counter(计数,如 charge.received、charge.approved、charge.rejected)、DistributionSummary(值分布,如 charge.value、invoice.amount,可设置 baseUnit 与 serviceLevelObjectives)、Timer(耗时,如 charge.approval.duration、payment.processing.duration,可 publishPercentiles)、Gauge(如 supplier.active.count、invoice.outstanding)等。提供公共方法记录事件,如 recordChargeReceived、recordChargeApproved、recordChargeRejected、recordSupplierOnboarded、recordInvoiceGenerated、recordInvoiceSent、recordPaymentInitiated、recordPaymentCompleted、recordPaymentFailed。示例中通过 normalizeRejectionReason 将拒绝原因归一化为有限基数(validation、duplicate、supplier_issue、amount_issue、date_issue、other)。还可通过 MeterRegistryCustomizer 为 charge.approval.duration、invoice.generation.duration 配置 SLO 直方图与目标阈值。
使用方式:先创建领域专用 Metrics 组件(@Component),在构造器中注册各 Meter;再将其注入服务层(如 ChargeProcessingService),在关键决策点调用记录方法;可通过 Tracer 的 span 设置属性(如 charge.id、supplier.id、charge.status、rejection.reason)实现与追踪关联。Quick Start 与示例代码均以 Java/Spring 为主。命令与安装方式暂未提供。
限制:该技能基于 Java/Micrometer 生态,资料未提供安装命令或依赖坐标;标签需注意基数控制;SLO 配置需依据实际业务阈值设定;原文部分内容未完整展开。