XiHan.Framework.Observability.OpenTelemetry 5.0.0-preview.1

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of XiHan.Framework.Observability.OpenTelemetry.
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package XiHan.Framework.Observability.OpenTelemetry --version 5.0.0-preview.1
                    


                    

                
NuGet\Install-Package XiHan.Framework.Observability.OpenTelemetry -Version 5.0.0-preview.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="XiHan.Framework.Observability.OpenTelemetry" Version="5.0.0-preview.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="XiHan.Framework.Observability.OpenTelemetry" Version="5.0.0-preview.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="XiHan.Framework.Observability.OpenTelemetry" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add XiHan.Framework.Observability.OpenTelemetry --version 5.0.0-preview.1
                    


                    

                
#r "nuget: XiHan.Framework.Observability.OpenTelemetry, 5.0.0-preview.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package XiHan.Framework.Observability.OpenTelemetry@5.0.0-preview.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=XiHan.Framework.Observability.OpenTelemetry&version=5.0.0-preview.1&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=XiHan.Framework.Observability.OpenTelemetry&version=5.0.0-preview.1&prerelease
                    


                            Install as a Cake Tool

XiHan.Framework.Observability.OpenTelemetry

可观测性导出（Ring 3，role: default）。提供 observability.export@1。内核只依赖 System.Diagnostics（FrameworkDiagnostics.ActivitySource / Meter：xihan.invoke Span、xihan.invocations 与 xihan.invocation.duration）与 Microsoft.Extensions.Logging；本包把它们和 .NET、ASP.NET Core 内置的源与仪表接到 OpenTelemetry，并按配置装配导出器。

builder.AddXiHan(xihan => xihan.UseStandardProfile().UseFeature<OpenTelemetryObservabilityFeature>());

{
  "XiHan": { "Observability": { "OpenTelemetry": {
    "ServiceName": "orders", "SamplingRatio": 0.2,
    "Otlp": { "Endpoint": "http://otel-collector:4317", "Protocol": "Grpc" },
    "Console": false, "Sources": "MyCompany.Orders", "Meters": "MyCompany.Orders"
  } } }
}

规则

  • 追踪、指标、日志三类信号各有开关（默认全开）；默认订阅 XiHan.Framework、Microsoft.AspNetCore、System.Net.Http 源与 XiHan.Framework、Microsoft.AspNetCore.Hosting、Microsoft.AspNetCore.Server.Kestrel、System.Net.Http、System.Runtime 仪表，Sources / Meters 追加。
  • OTLP 导出器在配置了 Otlp:Endpoint 或环境变量 OTEL_EXPORTER_OTLP_ENDPOINT 时自动启用，Otlp:Enabled 可强制开关；没有端点时按标准环境变量与默认端口（gRPC 4317 / HTTP 4318）决定；Otlp:Protocol 只能与 Otlp:Endpoint 一起写，只写协议时装配失败（RFC-0023）。没有配置就不导出，不会向本机空端口重试。
  • SamplingRatio 只作用于根 Span，有上游 trace 的沿用上游决定；内核的 xihan.invoke 同样遵守：有上游（traceparent、当前 Activity）时随它，没有上游时是根 Span 并按比例采样（RFC-0003 规则 7）；资源属性 service.name / service.version 默认取入口程序集，service.instance.id 取机器名。
  • 没有 ASP.NET Core 或 HttpClient 检测包：.NET 8 起它们原生发出 Activity 与 Meter，按名字订阅即可。

依赖方向

依赖 XiHan.Framework.Kernel、XiHan.Framework.Observability.Abstractions（能力 ID）、OpenTelemetry.Extensions.Hosting、OpenTelemetry.Exporter.OpenTelemetryProtocol 与 OpenTelemetry.Exporter.Console。

状态

P3：可用。

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on XiHan.Framework.Observability.OpenTelemetry:

Package Downloads
XiHan.Framework.Profiles.Full

曦寒框架 Full 组合包

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
5.0.0-preview.2 47 11/6/2026
5.0.0-preview.1 50 11/4/2026