DotTrace系列：9. 大结局之 跨平台 和 自定义行为 诊断

一：背景

1. 讲故事

本篇是系列的最后一篇，我们从跨平台部署和自定义诊断的角度跟大家聊一聊 dottrace，希望对大家有所启发。

二：跨平台和自定义诊断

1. 如何跨平台诊断分析

如果 dottrace 只能在 windows 平台上跑，那确实不值得写一个系列，目前它可以横跨三大平台（Windows，Linux，Mac），这里就用 ubuntu 来给大家演示下，参考代码如下：

     public class TimeConsumingMethodExample     {         public static void Main()         {             Console.WriteLine("开始执行耗时方法...");              // 调用耗时方法             PerformTimeConsumingTask(3000);               Console.WriteLine("耗时方法执行完成！");         }          /// <summary>         /// 模拟一个耗时方法         /// </summary>         /// <param name="milliseconds">要模拟的耗时（毫秒）</param>         public static void PerformTimeConsumingTask(int milliseconds)         {             Stopwatch stopwatch = Stopwatch.StartNew();              // 模拟耗时操作 - 这里使用Thread.Sleep             Thread.Sleep(milliseconds);              stopwatch.Stop();             Console.WriteLine($"方法执行耗时: {stopwatch.ElapsedMilliseconds} 毫秒");         }     }  

接下来使用 dotnet pulish 将其发布到 ubuntu 平台。

 root@ubuntu2404:/data2/code# ls -lh total 100K -rw-r--r-- 1 root root  71K Jun 30 09:01 ConsoleApp7 -rw-r--r-- 1 root root  482 Jun 30 09:01 ConsoleApp7.deps.json -rw-r--r-- 1 root root 4.5K Jun 30 09:01 ConsoleApp7.dll -rw-r--r-- 1 root root  12K Jun 30 09:01 ConsoleApp7.pdb -rw-r--r-- 1 root root  268 Jun 30 09:01 ConsoleApp7.runtimeconfig.json  

为了能够在 ubuntu 上开启 dottrace 跟踪，有两种部署方式。

• 源码包方式

可以通过官方链接： https://www.jetbrains.com/profiler/download/?section=commandline 下载 linux 的 tar 包，然后本地解压，开启 timeline 跟踪模式，参考如下：

 root@ubuntu2404:/data2/dottrace# tar -xzxf JetBrains.dotTrace.CommandLineTools.linux-x64.2025.1.3.tar.gz  root@ubuntu2404:/data2/dottrace# ./dottrace start --profiling-type=Timeline  --framework=NetCore /usr/bin/dotnet  /data2/code/ConsoleApp7.dll --save-to=/data2/output/snnapshot.dtp dotTrace command-line profiler 2025.1.3 build 777.0.20250604.2353. Copyright (C) 2025 JetBrains s.r.o. Preparing to profile... Profiling in progress... 开始执行耗时方法... 方法执行耗时: 3000 毫秒 耗时方法执行完成！ Profiling is finished in 5.523 seconds Collected snapshot: /data2/output/snnapshot.dtp 

从卦中可以看到 snnapshot.dtp 跟踪文件已生成，接下来就是打包到windows平台用分析啦，是不是有点像 dump 的事后分析，参考如下：

 root@ubuntu2404:/data2/output# tar -czvf dottrace_snapshot.tar.gz snnapshot.dtp* snnapshot.dtp snnapshot.dtp.0000 snnapshot.dtp.0001 snnapshot.dtp.0002 snnapshot.dtp.0003 snnapshot.dtp.0004 snnapshot.dtp.0005 snnapshot.dtp.0006 snnapshot.dtp.0007 ...  root@ubuntu2404:/data2/output# sz dottrace_snapshot.tar.gz  

• dotnet cli 工具包

如果使用源码方式有这样或者那样的问题，可以使用此种方式，它会将 command-line 工具集成到了 dotnet cli 中，参考如下：

 root@ubuntu2404:/data2/dottrace# dotnet tool install --global JetBrains.dotTrace.GlobalTools Skipping NuGet package signature verification. You can invoke the tool using the following command: dottrace Tool 'jetbrains.dottrace.globaltools' (version '2025.1.3') was successfully installed. root@ubuntu2404:/data2/dottrace# cd .. root@ubuntu2404:/data2# dottrace start --profiling-type=Timeline  --framework=NetCore --save-to=/data2/output/snnapshot.dtp   /usr/bin/dotnet  /data2/code/ConsoleApp7.dll dotTrace command-line profiler 2025.1.3 build 777.0.20250604.2353. Copyright (C) 2025 JetBrains s.r.o. Preparing to profile... Profiling in progress... 开始执行耗时方法... 方法执行耗时: 3000 毫秒 耗时方法执行完成！ Profiling is finished in 5.65 seconds Collected snapshot: /data2/output/snnapshot.dtp  

是不是挺有意思的。

2. 如何自定义诊断分析

很多朋友应该知道dottrace默认的诊断方式为全局跟踪，即启动后跟踪，截图如下：

但这种跟踪方式会掺杂很多噪音，除了让跟踪文件变大，也不利于我们过滤分析，所以就有了一个需求，如何指定 作用域 分析？比如我只想分析某一个方法，厉害的是 dottrace 还真可以做到，在 nuget 上引用 JetBrains.Profiler.Api 包，然后用 MeasureProfiler.StartCollectingData() 和 MeasureProfiler.SaveData(); 将分析的范围圈一下即可，参考代码如下：

 class Program {     static void Main()     {         // 创建并启动Stopwatch         Stopwatch stopwatch = new Stopwatch();         stopwatch.Start();          string filePath = @"D:1GB_LogFile.log";         DoRequest(filePath);          // 停止并显示总耗时         stopwatch.Stop();         Console.WriteLine($"总耗时: {stopwatch.Elapsed.TotalSeconds:F2}秒");     }      static void DoRequest(string filePath)     {         CheckParameter();          const int chunkSize = 512 * 1024 * 1024; // 每次读取512MB          try         {             Console.WriteLine("开始分块读取文件...");             int chunkCount = 0;             long totalBytesRead = 0;              MeasureProfiler.StartCollectingData();              using (var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read))             {                 byte[] buffer = new byte[chunkSize];                 int bytesRead;                  while ((bytesRead = fileStream.Read(buffer, 0, buffer.Length)) > 0)                 {                     totalBytesRead += bytesRead;                     chunkCount++;                      // 处理当前块的数据                     string chunkContent = Encoding.UTF8.GetString(buffer, 0, bytesRead);                     Console.WriteLine($"读取块 {chunkCount}, 大小: {bytesRead / 1024}KB, 总计: {totalBytesRead / 1024 / 1024}MB");                 }             }              MeasureProfiler.SaveData();              Console.WriteLine($"文件读取完成，共 {chunkCount} 块");         }         catch (Exception ex)         {             Console.WriteLine($"出错: {ex.Message}");         }     }      static void CheckParameter()     {         Console.WriteLine("检查参数开始...");         Thread.Sleep(5000);         Console.WriteLine("检查参数结束...");     } }  

从卦中代码不难看出，MeasureProfiler.StartCollectingData 应该就是 Start 的API实现，既然是api实现那肯定需要同 dottrace 本体进行通信，所以在启动 dottrace 的时候一定要记的勾选 Using Api 模式，截图如下：

跟踪完成之后打开跟踪文件，发现 CheckParameter() 方法不在其中，同时也详细的记录了 DoRequest 下的 fileStream 耗时详情，是不是挺有意思，截图如下：

三：总结

本系列总共9篇，本想着写10篇凑个十全十美，但天残地缺，天聋地哑，才是一个人最好的状态，终归小满胜万全呀！

作为JetBrains社区内容合作者，如有购买jetbrains的产品，可以用我的折扣码 HUANGXINCHENG，有25%的内部优惠哦。