Java

以 Java 语言实现特定的 OpenTelemetry。

This is the OpenTelemetry Java documentation. OpenTelemetry is an observability framework – an API, SDK, and tools that are designed to aid in the generation and collection of application telemetry data such as metrics, logs, and traces. This documentation is designed to help you understand how to get started using OpenTelemetry Java.

Status and Releases

The current status of the major functional components for OpenTelemetry Java is as follows:

For releases, including the latest release, see Releases.

仓库

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")
}