otel-dotnet

.NET 中的 OpenTelemetry

.NET 服务中 OpenTelemetry 机制的入口。根据任务查看下方相应参考文档；每份文档均可独立使用。

参考文档

文件	适用场景
references/setup.md	通过 DI/生成器路径（AddOpenTelemetry().WithTracing/WithMetrics/WithLogging、UseOtlpExporter、OpenTelemetrySdk.Create、OpenTelemetry.Extensions.Hosting）设置 SDK、配置导出器、使用环境变量 / IConfiguration 输入，以及了解 .NET 尚无已发布的声明式 YAML 配置的原因。
references/api.md	使用原生 BCL API（ActivitySource/Activity、System.Diagnostics.Metrics.Meter、ILogger）进行埋点、了解 SDK 如何订阅（AddSource/AddMeter）、属性、传播机制，以及可选的 OTel API 适配层。
references/instrumentation-libraries.md	零代码（opentelemetry-dotnet-instrumentation CLR 分析器 Agent）、contrib 埋点包目录，以及遵循 semconv 的手动埋点。
references/performance.md	调整采样（内置采样器，包括 AlwaysRecordSampler）、批量导出处理器、周期性指标读取器、视图、导出器选择、异步上下文及优雅关闭。
references/breaking-changes.md	审查现有代码中近期核心 / contrib 版本发布带来的弃用或重命名 API，以及 semconv 变更。

可信信息来源

有关 YAML 架构详情（与语言无关），请参阅 otel-declarative-config 技能；但请注意，.NET 尚无已发布的声明式配置实现（参见 references/setup.md）。 有关 .NET 的具体信息：

信息	获取方式
最新 OpenTelemetry 核心版本 / core-* 标签	gh api repos/open-telemetry/opentelemetry-dotnet/releases/latest -q '.tag_name'
最新 NuGet 包（OpenTelemetry、OpenTelemetry.Extensions.Hosting、导出器、OpenTelemetry.Instrumentation.<pkg>）	WebFetch https://www.nuget.org/packages/<PackageId>（Version）
最新自动埋点 Agent	gh api repos/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest -q '.tag_name'
核心 CHANGELOG（按包查看，使用正在审查的版本）	WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet/<core-tag>/src/<Package>/CHANGELOG.md
Contrib CHANGELOG（按包查看，使用该包的发布标签）	WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet-contrib/<package-tag>/src/<Package>/CHANGELOG.md
.NET 入门 / 埋点文档	WebFetch https://opentelemetry.io/docs/languages/dotnet/instrumentation/
零代码 Agent 文档	WebFetch https://opentelemetry.io/docs/zero-code/dotnet/

交叉参考

• 架构级信息：otel-declarative-config 技能（与语言无关的 YAML 架构来源；.NET 尚未实现）。
• 跨语言 SDK 版本选择：otel-sdk-versions 技能。
• 语义约定查询：otel-semantic-conventions 技能。