open-telemetry/opentelemetry-proto-go
GitHub: open-telemetry/opentelemetry-proto-go
OpenTelemetry OTLP 数据模型的 Go 语言 protobuf 自动生成代码库，为 Go 项目提供标准化的遥测数据类型定义。
Stars: 42 | Forks: 43
# opentelemetry-proto-go
[](https://pkg.go.dev/go.opentelemetry.io/proto/otlp)
为 OpenTelemetry protobuf 数据模型生成的 Go 代码。
## 版本控制策略
自动生成的 Go 代码遵循以下定义的稳定性保证：
[成熟度
级别](https://github.com/open-telemetry/opentelemetry-proto?tab=readme-ov-file#maturity-level)。
本项目中的模块版本控制将符合使用 [Go modules](https://github.com/golang/go/wiki/Modules) 的 Go 项目的惯用做法。
它们将使用[语义化导入版本控制](https://github.com/golang/go/wiki/Modules#semantic-import-versioning)。
这意味着模块将遵循 [semver 2.0](https://semver.org/spec/v2.0.0.html) 规范，但以下情况除外：
- 带有 `development` 后缀的包不遵循 [semver 2.0](https://semver.org/spec/v2.0.0.html) 规范。
- 这些包可能会在次要版本之间引入向后不兼容的更改。
- 这些包是临时性的。
当 protobuf 定义稳定或被移除时，它们将被弃用并删除。
如果 protobuf 定义稳定，该包将被替换为稳定的“非开发（non-development）”包。
如果 protobuf 定义被移除，该包将被直接删除，恕不替代。
## 快速入门
在你的项目中安装最新版本。
```
go get go.opentelemetry.io/proto/otlp@latest
```
在你的项目中直接导入生成的代码。
```
import (
collogspb "go.opentelemetry.io/proto/otlp/collector/logs/v1"
colmetricspb "go.opentelemetry.io/proto/otlp/collector/metrics/v1"
coltracepb "go.opentelemetry.io/proto/otlp/collector/trace/v1"
commonpb "go.opentelemetry.io/proto/otlp/common/v1"
logspb "go.opentelemetry.io/proto/otlp/logs/v1"
metricspb "go.opentelemetry.io/proto/otlp/metrics/v1"
resourcepb "go.opentelemetry.io/proto/otlp/resource/v1"
tracepb "go.opentelemetry.io/proto/otlp/trace/v1"
)
```
### 兼容性
OpenTelemetry Proto Go 确保与当前受支持的
[Go 语言](https://golang.org/doc/devel/release#policy) 版本兼容：
对于上游不再支持的 Go 版本，opentelemetry-proto-go 将按以下方式停止确保与其的兼容性：
- opentelemetry-proto-go 将发布一个次要版本，以添加对新
受支持 Go 版本的支持。
- 随后发布的 opentelemetry-proto-go 次要版本将移除对最旧（现已在上游归档）的 Go 版本的兼容性
测试。此版本及
未来的 opentelemetry-proto-go 版本可能仅包含由
当前受支持的 Go 版本所支持的功能。
本项目在以下系统上进行过测试。
| 操作系统 | Go 版本 |
| -------- | ---------- |
| Ubuntu | 1.26 |
| Ubuntu | 1.25 |
虽然本项目应该可以在其他系统上运行，但目前不对这些系统提供兼容性保证。
## 维护者
- [OpenTelemetry Go 维护者](https://github.com/open-telemetry/opentelemetry-go/blob/main/CONTRIBUTING.md#maintainers)
- [Mike Goldsmith](https://github.com/MikeGoldsmith)，Honeycomb
有关维护者角色的更多信息，请参阅[社区仓库](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#maintainer)。
## 批准者
- [OpenTelemetry Go 批准者](https://github.com/open-telemetry/opentelemetry-go/blob/main/CONTRIBUTING.md#approvers)
有关批准者角色的更多信息，请参阅[社区仓库](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#approver)。
标签：API集成, GET参数, Go语言, OpenTelemetry, Protobuf, SOC Prime, 可观测性, 开发工具, 数据模型, 日志审计, 用户代理, 程序破解