插桩与埋点

这一课你将能做到

1. 区分 自动插桩 与 手动埋点 的职责边界，说清判题链路上哪些观测点必须靠框架、哪些必须自己写
2. 为 POST /api/judge/submissions 设计最少必要的手动埋点（Counter / Timer / Span），并给出标签白名单
3. 评估插桩对 性能 与 标签基数 的影响，能讲清「指标爆炸」是怎么把自己放倒的

为什么要学

可观测性不会从空气里长出来：要么框架和 agent 替你注入，要么你在业务代码里显式声明。插桩（Instrumentation） 就是把 Metrics / Logs / Traces 信号「种」进系统的过程。种少了，故障时两眼一抹黑；种多了、标签乱了，时序库和账单先把你放倒——典型翻车：有人给每个 REST 路径的每个查询参数组合建指标，一周后 Prometheus 内存爆了，监控先死于自己的观测。

判题链路横跨 浏览器 → Nginx → Spring Boot → Kafka → 判题 worker → MySQL/Redis，任何一个环节没有信号，排障就断在哪一环。面试里「自动插桩和手动埋点怎么分工」「你们怎么控制指标基数」都是高频题，本课给答案。

先建立图像

方式	来源	覆盖什么	注意
自动插桩	OTel Java Agent、Micrometer 的 MVC/JDBC 插桩	HTTP 入口、JDBC、HTTP client、JVM	零侵入打底，标签仍要治理
手动埋点	业务代码里的 registry.counter()、@Timed、自定义 Span	业务结果：提交量、判题通过/拒绝、队列投递	只埋业务决策点，控制基数

一次判题提交的信号来源：

浏览器 → Nginx → Spring Boot → Kafka → worker → MySQL/Redis
           │         │          │       │         │
           │         │          │       │         └─ 自动：JDBC Span + 慢 SQL 日志
           │         │          │       └─ 手动：judge_results_total{result="accepted"}
           │         │          └─ 自动：Kafka producer Span + 手动：队列投递 Counter
           │         └─ 自动：http_server_requests Timer + MVC Span
           └─ 手动：access log（含 traceId）

原则：自动打底（框架已知边界），手动补「业务结果与决策」（框架不知道的部分）

跟着做

步骤 1：给判题链路列一张「谁负责」清单

在记事本填表，每个观测点标注 自动/手动：

1. 接口 QPS、4xx/5xx、延迟      → 自动（Micrometer MVC 插桩）
2. JDBC 调用、连接池占用         → 自动（DataSource 插桩）
3. Kafka 投递成功/失败           → 自动（producer 插桩）+ 手动业务标签
4. 判题结果分布（AC/WA/TLE/RE）  → 手动：框架不知道什么叫「判题通过」
5. 提交语言分布                  → 手动 Counter，标签 language（枚举可控）
6. traceId 全链传播              → 自动（agent），异步线程池需验证

应得到的核心结论：超过八成观测点应该自动完成，手动只补框架不知道的业务语义。

步骤 2：写一个低基数的判题结果 Counter

worker 判完题后记录结果：

@Service
public class JudgeResultRecorder {

    private final MeterRegistry registry;

    public JudgeResultRecorder(MeterRegistry registry) {
        this.registry = registry;
    }

    public void record(String language, String result) {
        // 标签只用有界枚举：language 3~5 种，result 是 AC/WA/TLE/RE/MLE 之一
        registry.counter("judge_results_total",
                "language", language,
                "result", result)
            .increment();
    }
}