MySQL :: MySQL Connector/ODBC 開發人員指南 :: 5.8 OpenTelemetry 追蹤支援

MySQL Connector/ODBC 開發人員指南 / 設定 Connector/ODBC / OpenTelemetry 追蹤支援

5.8 OpenTelemetry 追蹤支援

對於使用 OpenTelemetry (OTel) 檢測的 Linux 系統上的應用程式，連接器會將查詢和連線範圍新增至應用程式碼產生的追蹤，並將目前的 OpenTelemetry 環境傳遞到伺服器。OpenTelemetry 追蹤是在 Connector/ODBC 8.1.0 版本中引入的。

注意

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

啟用和停用追蹤

預設情況下，連接器僅在檢測過的應用程式安裝了所需的 OpenTelemetry SDK 程式庫並設定追蹤匯出器以將追蹤資料傳送到某些目的地時，才會轉發環境。如果應用程式碼未使用檢測，則舊版連接器也不會使用。

Connector/ODBC 支援連線屬性選項 OPENTELEMETRY，其具有以下值：

PREFERRED：預設值。如果可以使用所需的 OpenTelemetry 檢測，則在連線中使用檢測。否則，允許連線在沒有任何 OpenTelemetry 檢測的情況下運作。
DISABLED：連接器不會建立 OpenTelemetry 範圍或將 OpenTelemetry 環境轉發到伺服器。

設定為布林值 false 的行為與 DISABLED 相同。

當您建置連結到 Connector/ODBC 並使用 OTel 檢測的程式碼時，連接器產生的其他範圍會顯示在您的程式碼產生的追蹤中。連接器產生的範圍會傳送到使用者程式碼設定的其他範圍傳送的相同目的地（追蹤匯出器）。無法將連接器產生的範圍傳送到任何其他目的地。

此實作與透過 MySQL 用戶端程式庫（或相關的 telemetry_client 用戶端外掛程式）提供的實作不同。

限制

僅當應用程式使用 -rdynamic 編譯器選項建置，以便在使用者程式碼中定義的符號在外部可見時，ODBC 驅動程式中的 OTel 檢測才會起作用。如果沒有此選項，則 OTel 環境不會轉發到伺服器（因為驅動程式無法取得目前的 OTel 環境），並且 ODBC 驅動程式產生的範圍將不會傳送到應用程式中指定的目的地（它們將被丟棄）。