使用 API 扩展插桩功能

结合 OpenTelemetry API 与 Spring Boot 启动器，通过自定义 Span 和指标扩展自动生成的遥测数据。

The content of this page may be outdated and some links may be invalid. A newer version of this page exists in English.

More information ...

To see the changes to the English page since this page was last updated: visit GitHub compare c392c714..4b5381a2 and search for content/en/docs/zero-code/java/spring-boot-starter/api.md.

Introduction

除开箱即用的插桩功能外，你还可借助 OpenTelemetry API，通过自定义手动插桩的方式对 Spring 启动器进行扩展。 这使你能够为自己的代码创建 Span 和指标， 无需进行过多代码修改。

所需的依赖项已包含在 Spring Boot 启动器中。

OpenTelemetry

Spring Boot 启动器是一个特殊的案例，其中 OpenTelemetry 可作为 Spring Bean 使用。 只需将 OpenTelemetry 注入到你的 Spring 组件中即可。

Span

import io.opentelemetry.api.OpenTelemetry;
import io.opentelemetry.api.trace.Tracer;

@Controller
public class MyController {
  private final Tracer tracer;

  public MyController(OpenTelemetry openTelemetry) {
    this.tracer = openTelemetry.getTracer("application");
  }
}

使用 Tracer 创建一个 Span，如 Span 部分所述。

完整示例可在示例代码库中找到。

Meter

import io.opentelemetry.api.OpenTelemetry;
import io.opentelemetry.api.metrics.Meter;

@Controller
public class MyController {
  private final Meter meter;

  public MyController(OpenTelemetry openTelemetry) {
    this.meter = openTelemetry.getMeter("application");
  }
}

使用 Meter 创建一个指标，如 Meter 部分所述。

完整示例可在示例代码库中找到。


最后修改 April 14, 2026: chore(zh): update drift status (14222b73)