dotnet-monitor 是 .NET Core 命令列介面 (CLI) 工具, 可以很方便的在dotnet環境中分析我們的應用程式，需要注意的是，目前它還只是一個實驗性的工具 在這之前，我們使用的有 dotnet-counters，dotnet-dump 和 dotnet-trace，那 dotnet-monitor 有什麼意義呢？在執行dotnet應用程式時，不同的本地環境和生產環境中的差異可能使收集診斷工件（例如日誌，跟蹤，過程轉儲）變得困難, 所以需要通過公開一致的REST API來簡化診斷的流程，而不受程式環境的影響，可以更方便的分析程式的問題。 ### 安裝 dotnet-monitor ##### 本地使用 你可以使用以下命令，進行全域性安裝，因為本身是一個實驗性的工具，所以需要在後面加上 --add-source ```csharp 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` 拉取完成後, 執行 ```csharp 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，它們都一樣 ```json [{ "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](https://github.com/dotnet/diagnostics "https://github.com/dotnet/diagnostics") dotnet-monitor 診斷工具，提供了一套 REST API 來訪問診斷資料，目前還只推出了預覽版，大家可以在 github上 反饋和關注專案的進度 ### 擴充套件專案 [dotnet-monitor-ui](https://github.com/SachiraChin/dotnet-monitor-ui"https://github.com/SachiraChin/dotnet-monitor-ui") 是一個針對與 dotnet-monitor的ui專案，這得益於 dotnet-monitor 提供了一套便捷的 REST API, 你可以在 github 關注這個專案，瞭解它後臺是如何工作的  ### 最後 歡迎關注我們的公眾號，專注國外優秀部落格的翻譯和開源專案分享，也可以新增QQ群 897216102