opentelemetry-java readme翻译

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

可参考项目 milestones 获取即将到来的（upcoming）版本细节. 在issues和milestones中描述的dates和features是基于目前情况的估计，可能会有所变化。

Summary

我们计划将项目合二为一，为未来建立一个统一社区铺平道路（pave the path），这个社区服务 tracing vendors，users和library authors，帮助他们更好的管理应用. 我们欢迎所有人提供反馈和建议!

Contributing

参见 CONTRIBUTING.md

Approvers (@open-telemetry/java-approvers):

• Armin Ruech, Dynatrace
• Pavol Loffay, Traceable.ai
• Tyler Benson, DataDog
• Giovanni Liva, Dynatrace
• Christian Neumüller, Dynatrace
• Carlos Alberto, LightStep

更多有关approver角色的信息可见 community repository.

Maintainers (@open-telemetry/java-maintainers):

• Bogdan Drutu, Splunk
• John Watson, Splunk
• Anuraag Agrawal, AWS

更多有关maintainer角色的信息可见 community repository.

感谢所有参与贡献（have contributed）的人