Java

以 Java 语言实现特定的 OpenTelemetry。

这是 OpenTelemetry Java 的文档。 OpenTelemetry 是一个可观测性框架，这个框架提供了 API、SDK 以及一系列工具，用于辅助生成以及收集应用程序的遥测数据，比如指标（metrics）、日志（logs） 和链路追踪（trace），通过本文档，你会了解如何开始使用 OpenTelemetry Java。

状态以及版本发布

OpenTelemetry Java 的当前主要功能组件状态如下：

我们可以在 Releases 中找到所有已发布的版本，包括 latest release。

仓库

OpenTelemetry Java 由以下仓库组成：

• opentelemetry-java： 用于手动插桩的组件，包括 API 和 SDK，也包括扩展和 OpenTracing shim。
• opentelemetry-java-docs：手动插桩样例。
• opentelemetry-java-instrumentation： 建立在 opentelemetry-java 之上，并提供一个 Java agent JAR，可以附加到任何 Java 8+ 应用程序，并动态注入字节码，从许多流行的库和框架中捕获遥测数据。
• opentelemetry-java-contrib： 提供有用的库和独立的基于 OpenTelemetry 的实用程序，这些实用程序不属于 OpenTelemetry Java 或 Java Instrumentation 项目的明确范围。 例如，JMX 指标收集。
• semantic-conventions-java： OpenTelemetry 语义约定的 Java 实现。例如 ResourceAttributes.SERVICE_NAME。
• opentelemetry-proto-java： OpenTelemetry 协议 (OTLP) 的 Java 绑定。

组件

查看组件以获取已发布组件的完整列表。

发行版

已经发布的发行版可以在 maven 中央仓库上找到。 我们强烈推荐使用我们的 BOM 来保持各种组件的版本同步。

Maven

<project>
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>io.opentelemetry</groupId>
        <artifactId>opentelemetry-bom</artifactId>
        <version>1.42.1</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.opentelemetry</groupId>
      <artifactId>opentelemetry-api</artifactId>
    </dependency>
  </dependencies>
</project>

Gradle

dependencies {
  implementation(platform("io.opentelemetry：opentelemetry-bom：1.42.1"))
  implementation("io.opentelemetry：opentelemetry-api")
}