SuperAPI AI 工具集

ddd4j-metrics

部署与运维

查看项目

更新于 10-15 21:48

技能介绍

用途:为 ddd4j 的 Projection、Runtime、Web、MQ、缓存与领域操作设计、审查和测试指标,核心实现为 ProjectionMetrics 端口与 OpenTelemetryProjectionMetrics 适配器,其他能力按真实适配器扩展。

主要能力:设计投影指标(成功/失败、处理量、耗时、位置滞后);为 Web、MQ、缓存、Runtime 设计指标集(请求数、ack/nack、命中/未命中、启动/就绪);审查标签基数与隐私,拒绝 tenant、user id、message id 等高基数或含 PII 的标签;编写指标测试,验证名称、标签集、增量与异常路径;区分指标与日志、追踪、就绪、业务验收各自能证明的内容。

使用方式:先确认要插桩的模块、可观测后端、命名规范与 SLO/告警目标;定位核心中的 ProjectionMetrics/NoopProjectionMetrics 与适配器中的 OpenTelemetryProjectionMetrics,确认运行时确实绑定真实实现;设计指标集,保持成功/失败、耗时、处理量分离,选用稳定低基数标签;实现并测试行为,重点覆盖异常路径与无后端降级路径;由 SLO 推导告警,并端到端验证导出器/收集器确实收到数据。

适用场景:投影指标插桩与审查、跨能力指标设计、标签基数与隐私评审、指标测试与证据分级。

限制:不负责 OpenTelemetry 扩展模块的依赖、类路径守卫或装配(用 ddd4j-extensions);不负责就绪/存活或健康聚合(用 ddd4j-web 或 ddd4j-runtime);不负责日志与追踪设计;不得虚构端口或适配器未提供的指标;不涉及无 ddd4j 插桩的仪表盘/后端运维。Noop 实现是降级而非可观测性成功;指标不能替代日志、追踪、就绪或业务验收。标签不得含令牌、用户 ID、电话、完整 URL、SQL 或消息体。安装命令:npx skills add full-stack-skills/ddd4j-skills --skill ddd4j-extensions;npx skills add full-stack-skills/ddd4j-skills --skill ddd4j-web。