otel-dotnet

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Entry point for OpenTelemetry mechanics in .NET services. Load a reference below based on the task; each reference is self-contained.

.NET 服务中 OpenTelemetry 机制的入口。根据任务加载下方对应的参考资料；每份参考资料都是独立完整的。

File	Use when
`references/setup.md`	Setting up the SDK via the DI/builder path ( `AddOpenTelemetry().WithTracing/WithMetrics/WithLogging` , `UseOtlpExporter` , `OpenTelemetrySdk.Create` , `OpenTelemetry.Extensions.Hosting` ), exporter wiring, env-var / `IConfiguration` inputs, and why there is no declarative YAML config in .NET.
`references/api.md`	Instrumenting with native BCL APIs ( `ActivitySource` / `Activity` , `System.Diagnostics.Metrics.Meter` , `ILogger` ), how the SDK subscribes ( `AddSource` / `AddMeter` ), attributes, propagation, and the optional OTel API shim.
`references/instrumentation-libraries.md`	Zero-code (the `opentelemetry-dotnet-instrumentation` CLR-profiler agent), the contrib instrumentation-package catalog, and manual instrumentation following semconv.
`references/performance.md`	Tuning sampling, batch export processor, periodic metric reader, views, exporter choice, async context, graceful shutdown.
`references/breaking-changes.md`	Auditing existing code for deprecated/renamed APIs and semconv changes across recent core/contrib releases.

文件	使用场景
`references/setup.md`	通过 DI/builder 路径配置 SDK（ `AddOpenTelemetry().WithTracing/WithMetrics/WithLogging` 、 `UseOtlpExporter` 、 `OpenTelemetrySdk.Create` 、 `OpenTelemetry.Extensions.Hosting` ）、导出器连接、环境变量 / `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 探查器代理）、贡献者检测包目录，以及遵循语义规范的手动检测。
`references/performance.md`	调优采样、批量导出处理器、定期指标读取器、视图、导出器选择、异步上下文、优雅关闭。
`references/breaking-changes.md`	审核现有代码，检查近期核心/贡献者版本中已弃用/重命名的 API 以及语义规范变更。

For YAML schema details (language-agnostic), see the

otel-declarative-config

skill — but note .NET does not yet implement declarative config (see

references/setup.md

). For .NET-specific facts:

Fact	Fetch
Latest `OpenTelemetry` core / `core-*` tag	`gh api repos/open-telemetry/opentelemetry-dotnet/releases/latest -q '.tag_name'`
Latest NuGet package ( `OpenTelemetry` , `OpenTelemetry.Extensions.Hosting` , exporters, `OpenTelemetry.Instrumentation.<pkg>` )	`WebFetch https://www.nuget.org/packages/<PackageId>` (Version)
Latest auto-instrumentation agent	`gh api repos/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest -q '.tag_name'`
Core CHANGELOG (per package)	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet/main/src/<Package>/CHANGELOG.md`
Contrib CHANGELOG (per package)	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet-contrib/main/src/<Package>/CHANGELOG.md`
.NET getting-started / instrumentation docs	`WebFetch https://opentelemetry.io/docs/languages/dotnet/instrumentation/`
Zero-code agent docs	`WebFetch https://opentelemetry.io/docs/zero-code/dotnet/`

如需了解 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>` （版本信息）
最新自动检测代理	`gh api repos/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest -q '.tag_name'`
核心变更日志（按包划分）	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet/main/src/<Package>/CHANGELOG.md`
贡献者变更日志（按包划分）	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet-contrib/main/src/<Package>/CHANGELOG.md`
.NET 入门 / 检测文档	`WebFetch https://opentelemetry.io/docs/languages/dotnet/instrumentation/`
零代码代理文档	`WebFetch https://opentelemetry.io/docs/zero-code/dotnet/`

Schema-level facts:
```
otel-declarative-config
```
skill (language-agnostic YAML schema sources; .NET not yet implemented).
SDK version selection across languages:
```
otel-sdk-versions
```
skill.
Semantic conventions lookup:
```
otel-semantic-conventions
```
skill.