opentelemetry-java readme翻译

关注

原创最新推荐文章于 2026-08-27 15:48:24 发布 647 阅读 AI 写同款· GEO 优化 ›

实战OpenTelemetry Trace：使用Java实现分布式跟踪 OpenTelemetry Trace是一种分布式跟踪技术，可以帮助开发者在复杂的应用程序中识别和解决问题。它允许开发者在跨越多个应用程序和服务的请求路径上跟踪请求，并提供有关这些请求的有用信息。OpenTelemetry Trace通过在请求路径上创建一系列跨度（Spans）来实现跟踪。每个跨度代表了请求路径上的一部分，可以包含一些有用的信息，例如跨度的起始时间和结束时间、跨度的标签等等。这些信息可以帮助开发者识别潜在的性能问题和故障。阅读详情

OpenTelemetry

原文链接：原文

我们定期举行会议，细节可见社区页面.

我们使用 GitHub Discussions 来获取支持或者讨论问题. 请不要有任何负担，欢迎参与讨论.

Overview

OpenTelemetry是由OpenCensus和OpenTracing合二为一的项目.

项目包含了以下几个顶层模块（top level components）:

OpenTelemetry API:
- stable apis including Tracer, Span, SpanContext, and Baggage
- semantic conventions Generated code for the OpenTelemetry semantic conventions.
- context api The OpenTelmetry Context implementation.
- metrics api alpha code for the metrics API.
extensions define additional API extensions, which are not part of the core API.
sdk defines the reference implementation complying to the OpenTelemetry API.
sdk-extensions define additional SDK extensions, which are not part of the core SDK.
OpenTracing shim defines a bridge layer from OpenTracing to the OpenTelemetry API.
examples on how to use the APIs, SDK, and standard exporters.

我们非常乐于看到社区壮大，并从中听取反馈：请积极地提供反馈和建议.

Requirements

除非特殊说明之外，所有发布的artifacts支持Java 8及以上. 查看CONTRIBUTING.md 获取关于开发过程中构建本项目的指导。

Note about extensions

API和SDK extensions构成了多样的额外组件，这些组件被排除在core artifacts之外，以防止后者增长过大. 但我们仍然致力于提供和核心组件相同的质量保证，所以如果你发现他们有用，请放心使用他们。

Project setup and contribute

请参考contribution guide来了解如何setup和contribute!

Quick Start

请参考quick start guide 来了解如何使用OpenTelemetry API.

Published Releases

已发布的Releases版本可在maven中央仓库（maven central）获取.

Maven

  <dependencies>
    <dependency>
      <groupId>io.opentelemetry</groupId>
      <artifactId>opentelemetry-api</artifactId>
      <version>0.13.1</version>
    </dependency>
  </dependencies>

Gradle

dependencies {
	implementation('io.opentelemetry:opentelemetry-api:0.13.1')
}

Snapshots

基于master 分支的Snapshots版本也可以在下面地址中获取，此版本提供了opentelemetry-api, opentelemetry-sdk 和剩下的artifacts:

Maven

  <repositories>
    <repository>
      <id>oss.sonatype.org-snapshot</id>
      <url>https://oss.jfrog.org/artifactory/oss-snapshot-local</url>
    </repository>
  </repositories>

  <dependencies>
    <dependency>
      <groupId>io.opentelemetry</groupId>
      <artifactId>opentelemetry-api</artifactId>
      <version>0.14.0-SNAPSHOT</version>
    </dependency>
  </dependencies>

Gradle

repositories {
	maven { url 'https://oss.jfrog.org/artifactory/oss-snapshot-local' }
}

dependencies {
	implementation('io.opentelemetry:opentelemetry-api:0.14.0-SNAPSHOT')
}

Libraries一般只需要opentelemetry-api, 但是应用（applications）可能需要使用opentelemetry-sdk.

Releases

OpenTelemetry Java仍然在开发中. 发布的版本（Releases）并不保证基于特定的规范（specfications）实现. 未来的releases版本将不会保持对之前版本的向后兼容性。

核对信息（check information）请参考 latest release.

这是当前 feature 状态列表:

Component	Version
Tracing API	v0.13.1
Tracing SDK	v0.13.1
Metrics API	v0.13.1
Metrics SDK	v0.13.1
OTLP Exporter	v0.13.1
Jaeger Trace Exporter	v0.13.1
Zipkin Trace Exporter	v0.13.1
Prometheus Metrics Exporter	v0.13.1
Context Propagation	v0.13.1
OpenTracing Bridge	v0.13.1
OpenCensus Bridge	N/A