.NET?6中的dotnet?monitor講解
一.什么是 dotnet monitor
在不同的環(huán)境中運行 .NET 應用程序可能會使收集診斷信息（例如日志、跟蹤、dump）變得困難。dotnet monitor 是一種工具，它提供了一種統(tǒng)一的方法來收集這些診斷信息，而不管您是在桌面計算機（desktop machine 可理解為我們?nèi)粘Ｊ褂玫碾娔X）還是在 kubernetes 集群中運行。
收集這些診斷信息有兩種不同的機制：
- 按需收集診斷信息的
HTTP API。當您的應用程序遇到問題并且想收集更多信息時，可以調(diào)用這些 HTTP API。 - 基于規(guī)則配置的
觸發(fā)器。您可以配置規(guī)則，以便在滿足所需條件時收集診斷信息，例如在 CPU 持續(xù)一段時間保持較高的指標時收集進程轉(zhuǎn)儲（process dump）。
二.入門
dotnet monitor 可以通過兩種不同的分發(fā)機制獲得：
- .NET CLI 工具
- 通過 Microsoft Container Registry (MCR) 獲得的容器鏡像
.NET CLI 工具
dotnet monitor CLI 工具首先需要安裝 .NET 6 SDK，如果你沒有足夠新的 SDK，可以通過 .NET 下載網(wǎng)頁獲取安裝包進行安裝。
你可以使用一下命令獲取最新版的 dotnet monitor：
dotnet tool install -g dotnet-monitor --version 6.0.0
如果你已經(jīng)安裝但是想更新到最新，可以運行以下命令：
dotnet tool update -g dotnet-monitor --version 6.0.0
容器鏡像
dotnet monitor 容器鏡像在 MCR 上可用，你可以通過以下命令獲取最新的鏡像：
docker pull mcr.microsoft.com/dotnet/monitor:6.0.0
三.HTTP API
dotnet monitor 公開了一個 HTTP API 來查詢可用進程、收集診斷信息并檢查請求信息的狀態(tài)。
暴露了以下 HTTP API：
/processes- 獲取可被發(fā)現(xiàn)的進程的詳細信息/dump- 在不使用調(diào)試器的情況下捕獲進程的 dump/gcdump- 捕獲進程的 GC dump/trace- 不使用 profiler 來追蹤進程/metrics- 以 Prometheus exposition 格式捕獲默認進程的指標快照/livemetrics- 捕獲進程的實時指標流/logs- 捕獲進程的日志/info- 獲取有關 dotnet monitor 的信息/operations- 獲取操作狀態(tài)和取消操作
下面的示例演示如何使用 dotnet monitor 從目標進程開始，在60秒的時間內(nèi)從Microsoft.AspNetCore.Server.Kestrel.Connections 日志級別為 Debug 的日志流數(shù)據(jù)。
PS> curl.exe -X POST "https://localhost:52323/logs?name=myWebApp&durationSeconds=60" `
-H "Accept: application/x-ndjson" `
-H "Content-Type: application/json" `
--negotiate -u $(whoami)`
-d '{"filterSpecs": {"Microsoft.AspNetCore.Server.Kestrel.Connections": "Debug"}}'
{"Timestamp":"2021-11-05 08:12:54Z","LogLevel":"Debug","EventId":39,"EventName":"ConnectionAccepted","Category":"Microsoft.AspNetCore.Server.Kestrel.Connections","Message":"Connection id u00220HMD06BUKL2CUu0022 accepted.","State":{"Message":"Connection id u00220HMD06BUKL2CUu0022 accepted.","ConnectionId":"0HMD06BUKL2CU","{OriginalFormat}":"Connection id u0022{ConnectionId}u0022 accepted."}}
{"Timestamp":"2021-11-05 08:12:54Z","LogLevel":"Debug","EventId":1,"EventName":"ConnectionStart","Category":"Microsoft.AspNetCore.Server.Kestrel.Connections","Message":"Connection id u00220HMD06BUKL2CUu0022 started.","State":{"Message":"Connection id u00220HMD06BUKL2CUu0022 started.","ConnectionId":"0HMD06BUKL2CU","{OriginalFormat}":"Connection id u0022{ConnectionId}u0022 started."}}
{"Timestamp":"2021-11-05 08:12:54Z","LogLevel":"Debug","EventId":9,"EventName":"ConnectionKeepAlive","Category":"Microsoft.AspNetCore.Server.Kestrel.Connections","Message":"Connection id u00220HMD06BUKL2CUu0022 completed keep alive response.","State":{"Message":"Connection id u00220HMD06BUKL2CUu0022 completed keep alive response.","ConnectionId":"0HMD06BUKL2CU","{OriginalFormat}":"Connection id u0022{ConnectionId}u0022 completed keep alive response."},"Scopes":[{"ConnectionId":"0HMD06BUKL2CU"},{"RequestId":"0HMD06BUKL2CU:00000002","RequestPath":"/"}]}
如上面的示例所示，您可以使用 dotnet monitor 按需從目標進程中捕獲診斷信息。除了日志，您還可以從目標進程收集跟蹤、內(nèi)存轉(zhuǎn)儲、GC轉(zhuǎn)儲和 metrics。
四.觸發(fā)器
dotnet monitor 可以配置為根據(jù)發(fā)現(xiàn)的進程中的條件自動收集診斷信息。 發(fā)現(xiàn)新進程時，如果該進程數(shù)據(jù)與規(guī)則匹配，則 dotnet monitor 將嘗試應用配置的規(guī)則。 應用的規(guī)則將開始監(jiān)視觸發(fā)器描述的條件的過程。 如果滿足該條件，則假定尚未達到指定的限制來執(zhí)行操作列表。
示例：如果 dotnet monitor 檢測到持續(xù)超過一分鐘的CPU使用率在80%以上，則它將收集進程 dump，限制每小時不超過1個。
{
"CollectionRules": {
"HighCpuRule": {
"Filters": [
{
"Key": "ProcessName",
"Value": "MyApp",
"MatchType": "Exact"
}
],
"Trigger": {
"Type": "EventCounter",
"Settings": {
"ProviderName": "System.Runtime",
"CounterName": "cpu-usage",
"GreaterThan": 80,
"SlidingWindowDuration": "00:01:00"
}
},
"Limits": {
"ActionCount": 1,
"ActionCountSlidingWindowDuration": "1:00:00"
},
"Actions": [
{
"Type": "CollectDump",
"Settings": {
"Type": "Triage",
"Egress": "myBlobStorageAccount"
}
}
]
}
}
}
規(guī)則文檔：https://github.com/dotnet/dotnet-monitor/blob/main/documentation/collectionrules.md
五.反饋
github issue: https://github.com/dotnet/dotnet-monitor/issues/new/choose
以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
相關文章
asp.net 簡易生成注冊碼（數(shù)字+大小寫字母）
注釋寫的很詳細，不做過多的描述了，希望能給初學者帶來一些幫助，同時也是自己知識的一個積累過程。2008-11-11
解決iis7.5服務器上.net 獲取不到https頁面的信息
讓我糾結(jié)了一天多的問題，給大家看下，有相同情況的可以不用浪費時間了，本人當時找了好半天都沒找到什么有用的信息，項目在本地沒有問題，但部署在服務器后，獲取不到https頁面的信息，加入下面的代碼就可以了，因為iis7.5的安全協(xié)議比較高的原因。2014-06-06
本文通過實例代碼給大家介紹了asp.net中通過button打開另一個frm的方法，非常不錯，需要的朋友參考下吧2016-12-12
本文詳細講解了.Net反向代理組件Yarp的用法，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-09-09
asp.net使用Repeater控件中的全選進行批量操作實例
這篇文章主要介紹了asp.net使用Repeater控件中的全選進行批量操作方法,實例分析了Repeater控件的使用技巧,需要的朋友可以參考下2015-01-01
c#將Excel數(shù)據(jù)導入到數(shù)據(jù)庫的實現(xiàn)代碼
這篇文章主要介紹了c#將Excel數(shù)據(jù)導入到數(shù)據(jù)庫的實現(xiàn)代碼，有需要的朋友可以參考一下2013-12-12
模板頁右邊包含了一個登陸div,想讓沒登陸的時候這個div顯示，登陸后該div隱藏，具體的實現(xiàn)如下，需要的朋友可以參考下2013-08-08
asp.net下cookies的丟失和中文亂碼...2007-04-04
本文主要介紹了ASP.NET實現(xiàn)從服務器下載文件問題處理，具有很好的參考價值，下面跟著小編一起來看下吧2017-02-02
這篇文章主要介紹了asp.net中調(diào)用存儲過程的方法,結(jié)合實例形式分析了存儲過程的建立與asp.net調(diào)用存儲過程的相關技巧,需要的朋友可以參考下2016-05-05