共用方式為

控制及隱藏 Kusto SDK 用戶端追蹤

適用於：✅Microsoft Fabric✅Azure 數據總管

Kusto 用戶端連結庫會經過檢測，以將追蹤寫入本機檔案。 根據預設，追蹤機制會停用，但可以程序設計方式啟用。

啟用追蹤

若要啟用追蹤，請確定您已安裝 Microsoft.Azure.Kusto.Cloud.PlatformNuGet 套件。 然後執行下列程式代碼：

using Kusto.Cloud.Platform.Utils; // Requires the NuGet package, Microsoft.Azure.Kusto.Cloud.Platform.

var manifest = new RollingCsvTraceListener2Manifest
{
  TracesLocalRootPath=@"c:\temp" // The folder where trace files will be written.
};
RollingCsvTraceListener2.CreateAndInitialize(manifest);
TraceSourceManager.StartupDone();

控制追蹤層級

連結庫中的每個追蹤來源都可以有自己的預設詳細資訊層級。 追蹤來源只會寫入其詳細資訊等於或高於其本身詳細資訊層級的檔案追蹤。 您可以控制追蹤來源的詳細資訊。 下列範例會將所有追蹤來源的詳細資訊層級設定為 Verbose，確保所有追蹤都會寫入檔案：

using Kusto.Cloud.Platform.Utils; // Requires the NuGet package, Microsoft.Azure.Kusto.Cloud.Platform.

TraceSourceManager.SetOverrideTraceVerbosityLevel(TraceVerbosity.Verbose);

使用 TraceVerbosity.Fatal 自變數只追蹤最嚴重的事件。

清除所有擱置中的追蹤

當載入追蹤系統的應用程式關閉以確保儲存未寫入的追蹤時，建議清除擱置中的追蹤。 即使追蹤系統未初始化，也可以安全地完成。 下列程式代碼會強制所有暫止追蹤排清至檔案並回收所有檔案：

TraceSourceManager.SuperFlush(SuperFlushMode.Emergency);

啟用 MSAL （Microsoft驗證連結庫） 追蹤

啟用客戶端連結庫的追蹤會自動啟用 MSAL 的追蹤Microsoft驗證連結庫。

讀取追蹤檔案

一旦初始化追蹤系統，追蹤檔案就會寫入指定的資料夾或其子資料夾。 其格式為具有 .csv 擴展名的 CSV 檔案。 目前正在寫入的檔案會使用延伸模組 .csv.in-progress，並在完成之後自動重新命名。

每個追蹤檔案記錄都包含下列欄位：

  • 追蹤記錄標識碼： 唯一識別每個追蹤記錄。
  • 時間戳： 追蹤記錄的時間戳。
  • 追蹤來源名稱： 追蹤來源的名稱。
  • 追蹤層級： 追蹤的詳細資訊層級。
  • 文字內容： 追蹤記錄內容。