首页/云/可观测性速查/埋点方式:自动插桩、手动埋点与无侵入
监控体系与方法40 条

埋点方式:自动插桩、手动埋点与无侵入

三类埋点方式各有边界:自动插桩零代码改动覆盖通用框架,手动埋点补充业务语义,eBPF 等无侵入方式适合难以改造的存量系统。

可观测性速查云更新于 2026-10-12

方式对比

方式代码改动覆盖范围适用场景
自动插桩无(挂 agent/依赖库)框架级:HTTP、DB、消息快速接入标准技术栈
手动埋点需要改代码精确到业务方法业务指标、关键路径增强
无侵入采集无内核与网络层观测难以改造的存量系统

Java 应用挂载 OpenTelemetry agent(零代码改动接入)

Java 应用挂载 OpenTelemetry agent(零代码改动接入)
java -javaagent:/opt/otel/opentelemetry-javaagent.jar \
  -Dotel.service.name=order-api \
  -Dotel.exporter.otlp.endpoint=http://otel-collector:4317 \
  -jar order-api.jar
自动插桩拿到的是框架语义(如 HTTP 状态码),业务语义(订单类型、渠道)仍需手动补充。

易错点

  • 只做自动插桩时,指标粒度止步于框架层,无法回答具体业务问题
  • 手动埋点分散在业务代码里,缺少统一命名会让同名指标含义不一致

数据来源与参考

  • OpenTelemetry 文档 · Instrumentation
  • OpenTelemetry Java Agent 使用说明
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌