framework
framework/observability/index.md
medium
framework-observability-index
通用应用可观测性规约 — Micrometer 指标、SkyWalking 链路追踪、结构化日志、黄金指标四个独立决策点。Use when 埋点指标 / 接入链路追踪 / 规范 JSON 日志 / 定监控告警指标时。
子项索引
| 子项 | 一句话 |
|---|---|
| observability-micrometer-metrics skill | Micrometer 指标门面 — @Timed/Counter/Gauge 三类仪表对接 Prometheus，Actuator 暴露 /actuator/prometheus 供拉取 |
| observability-skywalking-tracing skill | SkyWalking 链路追踪 — javaagent 字节码增强无侵入埋点，traceId 跨服务贯穿，跨线程/MQ 需手动透传上下文 |
| observability-structured-logging skill | 结构化 JSON 日志 — 输出机器可解析的 JSON 字段并携带 traceId(MDC)，供 ELK/EFK 采集检索，禁日志中打印敏感信息 |
| observability-golden-signals skill | 黄金指标 — 延迟/流量/错误/饱和度四类信号决定该监控告警哪些指标，延迟看分位数而非平均，告警建在这四类上 |
通用应用可观测性 · 子项索引
四个独立决策点，按你正在做的事下钻：
| 你在做什么 | 进哪个 |
|---|---|
| 给方法埋耗时/计数/瞬时值，对接 Prometheus 采集 | micrometer-metrics |
| 跨服务排查调用链、让 traceId 贯穿全链路 | skywalking-tracing |
| 规范日志格式、让日志带 traceId 进 ELK/EFK | structured-logging |
| 不知道该监控/告警哪些指标 | golden-signals |
本模块是通用应用可观测。LLM 调用链的 prompt/token/成本可观测见
../../ai/llm-engineering/observability.md，不在此重复。