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

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 打開

總結

https://github.com/dotnet/diagnostics

dotnet-monitor 診斷工具，提供了一套 REST API 來訪問診斷數據，目前還只推出了預覽版，你們能夠在 github上 反饋和關注項目的進度

擴展項目

dotnet-monitor-ui 是一個針對與 dotnet-monitor的ui項目，這得益於 dotnet-monitor 提供了一套便捷的 REST API, 你能夠在 github 關注這個項目，瞭解它後臺是如何工做的

最後

歡迎關注咱們的公衆號，專一國外優秀博客的翻譯和開源項目分享，也能夠添加QQ羣 897216102