OpenTelemetry
原文链接:原文
我们定期举行会议,细节可见社区页面.
我们使用 GitHub Discussions 来获取支持或者讨论问题. 请不要有任何负担,欢迎参与讨论.
Overview
OpenTelemetry是由OpenCensus和OpenTracing合二为一的项目.
项目包含了以下几个顶层模块(top level components):
- OpenTelemetry API:
- stable apis including
Tracer
,Span
,SpanContext
, andBaggage
- semantic conventions Generated code for the OpenTelemetry semantic conventions.
- context api The OpenTelmetry Context implementation.
- metrics api alpha code for the metrics API.
- stable apis including
- 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
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)的人