使用 dotnet-monitor 分析.NET 應用程式

SpringLeee發表於2020-12-31

dotnet-monitor 是 .NET Core 命令列介面 (CLI) 工具, 可以很方便的在dotnet環境中分析我們的應用程式，需要注意的是，目前它還只是一個實驗性的工具

在這之前，我們使用的有 dotnet-counters，dotnet-dump 和 dotnet-trace，那 dotnet-monitor 有什麼意義呢？在執行dotnet應用程式時，不同的本地環境和生產環境中的差異可能使收集診斷工件（例如日誌，跟蹤，過程轉儲）變得困難, 所以需要通過公開一致的REST API來簡化診斷的流程，而不受程式環境的影響，可以更方便的分析程式的問題。

安裝 dotnet-monitor

本地使用

你可以使用以下命令，進行全域性安裝，因為本身是一個實驗性的工具，所以需要在後面加上 --add-source

dotnet tool install -g dotnet-monitor --add-source https://dnceng.pkgs.visualstudio.com/public/_packaging/dotnet5-transport/nuget/v3/index.json --version 5.0.0-preview.*

安裝完成成，執行以下命令，啟動成功後，會開放 http://localhost:52323 和 http://localhost:52325 兩個埠，我們這裡只使用 52323

dotnet monitor collect

Dokcer 環境

docker pull mcr.microsoft.com/dotnet/nightly/monitor:5.0.0-preview.1

拉取完成後, 執行

docker volume create diagnosticserver
docker run -d --rm -p 8000:80 -v diagnosticsserver:/tmp mcr.microsoft.com/dotnet/core/samples:aspnetapp
docker run -it --rm -p 52323:52323 -v diagnosticsserver:/tmp mcr.microsoft.com/dotnet/nightly/monitor:5.0.0-preview.1 --urls http://*:52323

端點列表

你可以訪問 http://localhost:52323, 這個 REST API 開放了以下端點，pid 是 processId 程式Id，我們需要找到需要監控的程式的程式id，這裡我本地的程式id是21856

/processes
/dump/{pid?}
/gcdump/{pid?}
/trace/{pid?}
/logs/{pid?}
/metrics

Processes

程式資訊，訪問 http://localhost:52323/processes，會顯示所有的dotnet 程式的程式id的列表，不給過這個命令屬實有點雞肋，因為我並不能知道哪個是我需要的 pid，它們都一樣

[{
   "pid": 36540,
   "uid": "b65c518b-0ad3-4ebf-af85-dfb3c862d1a7"
}, {
   "pid": 11088,
   "uid": "00000000-0000-0000-0000-000000000000"
}, {
   "pid": 21856,
   "uid": "00000000-0000-0000-0000-000000000000"
}, {
   "pid": 39008,
   "uid": "00000000-0000-0000-0000-000000000000"
}]

Dump

轉儲檔案，訪問 http://localhost:52323/dump/pid 來下載檔案

GCDump

收集 GCDump，可以訪問 http://localhost:52323/gcdump/pid, 跟 Dump 檔案不同的是，GCDump 檔案是一種輕便的格式，你可以使用 VS 或者 perfview 開啟並分析

Trace

跟蹤資料，http://localhost:52323/trace/pid ，trace 可以獲取到 CPU Stack(棧), Http 請求的開始和結束事件，來自 EventSourceLogger 和 Microsoft.Extensions.Logging 的日誌，Runtime 執行時和 ASP.NET Core EventCounters 的指標資料, 下載生成的 .nettrace 檔案，你同樣可以使用 VS 或者 PerfView 開啟