MySQL :: MySQL Connector/NET 开发人员指南 :: 5.12.1 启用 OpenTelemetry 跟踪

MySQL Connector/NET 开发人员指南 / ... / 启用 OpenTelemetry 跟踪

5.12.1 启用 OpenTelemetry 跟踪

OpenTelementry (OTel) 标准化了仪器、生成、收集和导出遥测数据，以便由可观察性后端使用。有关 OpenTelemetry 的更多详细信息，请访问其官方网站。

从 Connector/NET 8.1.0 开始，对 OTel 的支持封装在 MySQL.Data.OpenTelemetry NuGet 包中。此包实现了使用 OpenTelementry.Api 将连接器添加到跟踪提供程序生成器的功能。Connector/NET 既不创建也不提供创建 OTel 导出器的方法。相反，它依赖于您的应用程序提供的默认导出器。

注意

OTel 上下文转发仅适用于 MySQL 企业版（一种商业产品）。要了解有关商业产品的更多信息，请参阅 https://www.mysqlserver.cn/products/。

启用跟踪的要求

.NET 5 及更高版本。
Connector/NET 8.1.0 MySQL.Data.OpenTelemetry 和 MySQL.Data NuGet 包。

注意

Connector/NET MSI 文件不包含对 OTel 实现的支持。
您选择的 OpenTelemetry SDK 和相应的导出器包。
启用了查询属性的 MySQL 企业版服务器。如果服务器不支持查询属性或已禁用，Connector/NET 将跳过整个上下文传播流程。
使用 OTel 仪器的代码。如果您的代码未使用仪器，Connector/NET 不会为每个执行的语句转发当前 OTel 上下文。

启用 OpenTelemetry

要使用 Connector/NET 实现启用 OTel 跟踪，请将连接器添加到跟踪提供程序生成器，如下所示

var tracerProvider = sdk.TraceProviderBuilder().AddConnectorNet().Build();

当您构建与 Connector/NET 链接并使用 OTel 仪器的代码时，连接器生成的额外跨度将显示在您的代码生成的跟踪中。连接器生成的跨度将发送到与用户代码生成的跨度发送到同一目的地（跟踪导出器），如用户代码配置的那样。不可能将连接器生成的跨度发送到任何其他目的地。