MySQL :: MySQL Connector/NET 開發人員指南 :: 5.12.1 啟用 OpenTelemetry 追蹤

MySQL Connector/NET 開發人員指南 / ... / 啟用 OpenTelemetry 追蹤

5.12.1 啟用 OpenTelemetry 追蹤

OpenTelemetry (OTel) 標準化儀器、產生、收集和匯出遙測資料，以便由可觀察性後端使用。有關 OpenTelemetry 的更多詳細資訊，請造訪其官方網站。

從 Connector/NET 8.1.0 開始，對 OTel 的支援封裝在 MySQL.Data.OpenTelemetry NuGet 套件中。此套件實作使用 OpenTelementry.Api 將連接器新增至追蹤器提供者的功能。Connector/NET 既不建立也不提供建立 OTel 匯出器的工具。相反地，它依賴您的應用程式提供的預設匯出器。

注意

OTel 環境轉發僅適用於商業產品 MySQL 企業版。若要瞭解有關商業產品的更多資訊，請參閱https://mysql.dev.org.tw/products/。

啟用追蹤的必要條件

.NET 5 及更新版本。
Connector/NET 8.1.0 MySQL.Data.OpenTelemetry 和 MySQL.Data NuGet 套件。

注意

Connector/NET MSI 檔案不包含對此 OTel 實作的支援。
您選擇的 OpenTelemetry SDK 和適當的匯出器套件。
已啟用查詢屬性的 MySQL 企業版伺服器。如果伺服器不支援查詢屬性或已停用這些屬性，則 Connector/NET 會跳過整個環境傳播流程。
使用 OTel 檢測的程式碼。如果您的程式碼未使用檢測，則連接器不會轉發每個已執行陳述式的目前 OTel 環境。

啟用 OpenTelemetry

若要使用 Connector/NET 實作啟用 OTel 追蹤，請將連接器新增至追蹤提供者產生器，如下所示

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

當您建置連結至 Connector/NET 並使用 OTel 檢測的程式碼時，由連接器產生的額外跨度會出現在您的程式碼產生的追蹤中。由連接器產生的跨度會傳送到與使用者程式碼設定的傳送其他跨度相同的目的地（追蹤匯出器）。無法將連接器產生的跨度傳送到任何其他目的地。