你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

控制和禁止 Kusto SDK 客户端跟踪

项目
02/03/2025

适用于：✅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，并在完成后自动重命名。

每个跟踪文件记录包含以下字段：

跟踪记录标识符： 唯一标识每个跟踪记录。
时间戳： 跟踪记录的时间戳。
跟踪源名称： 跟踪源的名称。
跟踪级别： 跟踪的详细级别。
文本内容： 跟踪记录内容。

通过