opentelemetry-java readme翻译

最新推荐文章于 2025-10-12 13:32:08 发布

原创最新推荐文章于 2025-10-12 13:32:08 发布 · 514 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#opentelemetry

Java文档阅读和翻译专栏收录该内容

4 篇文章

订阅专栏

OpenTelemetry是一个由OpenCensus和OpenTracing合并而成的项目，旨在提供统一的应用追踪和度量标准。该项目包括稳定的追踪API、上下文API、度量API及各种扩展组件。它支持Java 8及以上版本。

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