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
