opentelemetry .net
.NET OPENTELEMETRY实现。
支持的.NET版本
从该存储库中运送的软件包通常支持.NET和.NET Framework（较旧的基于Windows的.NET实现）的所有正式支持版本，但.NET Framework 3.5除外。任何例外都在单个readme.md文件中注明。
项目状态
在所有3个信号（日志，指标和痕迹）中稳定。
警告
某些被标记为预发行的组件仍在进行中，并且在稳定释放之前可能会发生破坏变化。检查每个组件以了解其当前状态的单个readme.md文件。
要了解OpentElemetry规范的哪些部分已在OpenTelemetry .NET中实现，请参见：Spec Compliance矩阵。
入门
如果您是新来的，请阅读入门文档：
开始记录
如果您是新手的记录，建议您首先在5分钟内首先跟随入门 – ASP.NET核心应用指南或在5分钟内入门 – 控制台应用程序指南以启动和运行。
有关一般信息和最佳实践，请参见：OpenTelemetry .NET日志。有关SDK日志记录功能的更详细说明，请参见以下内容：为日志自定义OpenTelemetry .NET SDK。
指标开始
如果您不熟悉指标，建议首先在5分钟内首先跟随入门 – ASP.NET核心应用指南或在5分钟内入门 – 控制台应用程序指南以启动和运行。
有关一般信息和最佳实践，请参见：OpenTelemetry .NET指标。有关SDK指标功能的更详细说明，请参见：定制opentelemetry .NET SDK用于指标。
开始追踪
如果您是迹线的新手，建议首先在5分钟内首先跟随入门 – ASP.NET核心应用指南或在5分钟内入门 – 控制台应用指南以启动和运行。
有关一般信息和最佳实践，请参见：opentelemetry .NET跟踪。有关SDK跟踪功能的更详细说明，请参见：自定义opentelemetry .NET SDK进行跟踪。
存储库结构
该存储库仅包含OpenTelemetry规范中定义的内容，并通过Nuget作为单独的软件包发货。每个组件都有一个单独的readme.md和changelog.md文件，该文件涵盖了有关如何安装和启动的说明，以及分别（分别进行）（分别进行）的单个更改的详细信息。要查找所有可用组件，请查看SRC文件夹。
这是最常用的组件：
- OpentElemetry API
- OpenTelemetry SDK
- OpentElemetry托管扩展
这是出口商库：
- 安慰
- 内存
- OTLP（opentelemetry协议）
- Prometheus aspnetcore
- Prometheus httplistener
- Zipkin
可以在OpenTElemetry-Dotnet-Contrib存储库和/或OpenTelemetry注册表中找到其他软件包，包括仪器库，出口商，资源探测器和扩展程序。
故障排除
有关一般说明，请参见：故障排除。此外，用于单个组件的readme.md文件可能包含更详细的故障排除信息。
可扩展性
OpentElemetry .NET设计为可扩展。这是最常见的扩展场景：
- 构建定制仪器库。
- 为日志，指标和痕迹构建自定义出口商。
- 为日志和轨迹构建自定义处理器。
- 为轨迹构建自定义采样器。
发行
有关即将发布的计划发行的详细信息，请参见：里程碑。问题和里程碑中描述的日期和特征是估计值，并且可能会发生变化。
有关稳定发行版的亮点和宣告，请参见：发行说明。
要访问软件包，源代码和/或查看版本中所有组件的更改列表，请参见：发行。
每晚从此存储库中发布到Myget，可以使用https://www.my*ge**t.org/f/opentelemetry/api/api/v3/index.json source安装。
数字签名
从1.10.0释放开始，使用Sigstore将推入Nuget的软件包中包含的DLL进行数字签名。在每个Nuget软件包中，数字签名及其相应的证书文件与 /lib文件夹中的已发货DLL一起放置。当一个项目以多个框架为目标时，每个目标都会输出专用的DLL并根据TFM签名到子文件夹中。
数字签名和证书文件共享与DLL相同的名称前缀，以确保易于识别和关联。
为了验证Nuget软件包内部的DLL的完整性，请使用Sigstore的Cosign工具：
cosign verify-blob \\
--signature OpenTelemetry.dll-keyless.sig \\
--certificate OpenTelemetry.dll-keyless.pem.cer \\
--certificate-identity \" https://github*.c**om/open-telemetry/opentelemetry-dotnet/.github/workflows/publish-packages-1.0.yml@refs/tags/core-1.10.0-rc.1 \" \\
--certificate-oidc-issuer \" https://token.act*io*ns.githubusercont*ent.com \" \\
OpenTelemetry.dll
笔记
成功的验证输出验证确定。
有关更多验证选项，请参阅Cosign文档。
贡献
有关为项目贡献的信息，请参见：贡献。
我们每周在星期二开会，会议时间在下午9点至下午4点之间。会议可能会根据贡献者的可用性而变化。检查OpenTelemetry社区日历中的特定日期和缩放会议链接。
会议笔记可作为公共Google文档获得。如果您在访问文档时遇到困难，请与Slack联系。
会议开放供所有人加入。无论您的经验水平如何，我们都会邀请所有人参加我们的会议。无论您是经验丰富的OpenTelemetry开发人员，刚开始旅程，还是只是对我们所做的工作感到好奇，都欢迎您参加！
维护者
- 艾伦·韦斯特（Alan West），新遗物
- Microsoft Rajkumar Rangaraj
有关维护人员角色的更多信息，请参见社区存储库。
批准者
- Cijo Thomas，Microsoft
- 马丁·科斯特洛（Grafana Labs）
- Mikel Blanchard，微软
- PiotrKiełkowicz，Splunk
有关批准者角色的更多信息，请参阅社区存储库。
三名
- 马丁·特威特斯（Martin Thwaites），蜂窝
- 蒂莫西“莫斯拉”李
有关Triager角色的更多信息，请参见社区存储库。
名誉维护者
- 迈克·戈德史密斯
- Sergey Kanzhelev
- Utkarsh Umesan Pillai
有关名誉角色的更多信息，请参见社区存储库。
名誉批准者
- 布鲁诺·加西亚（Bruno Garcia）
- 埃迪·纳卡村（Eddy Nakamura）
- Liudmila Molkova
- Paulo Janotti
- 蕾利杨
- 罗伯特·帕杰克
- Vishwesh Bankwar
有关名誉角色的更多信息，请参见社区存储库。
名誉三名
- 维克多·鲁
有关名誉角色的更多信息，请参见社区存储库。
感谢所有贡献的人
参考
- Opentelemetry项目
- OpentElemetry规范
