Diagnosztikai monitorozási és gyűjtési segédprogram (dotnet-monitor)
Ez a cikk a ✔️ dotnet-monitor
6.0.0-s és újabb verziókra vonatkozik
Telepítés
Kétféleképpen tölthető le dotnet-monitor
:
dotnet globális eszköz:
A NuGet-csomag legújabb kiadási verziójának
dotnet-monitor
telepítéséhez használja a dotnet eszköz telepítési parancsát:dotnet tool install --global dotnet-monitor
Docker-kép:
Docker-rendszerkép letöltése többtárolós környezetekben való használatra:
docker pull mcr.microsoft.com/dotnet/monitor
Szinopszis
dotnet-monitor [-h|--help] [--version] <command>
Leírás
A dotnet-monitor
globális eszköz a .NET-alkalmazások éles környezetben való monitorozásának és diagnosztikai összetevők (például memóriaképek, nyomkövetések, naplók és metrikák) igény szerinti gyűjtésének vagy automatizált szabályok használatával történő gyűjtésének módja.
Beállítások
--version
Megjeleníti a dotnet-monitor segédprogram verzióját.
-h|--help
Parancssori súgót jelenít meg.
Parancsok
Parancs |
---|
dotnet monitor collect |
dotnet monitor config show |
dotnet monitor generatekey |
dotnet-monitor collect
Figyelje a .NET-alkalmazásokat, engedélyezze a diagnosztikai összetevők gyűjtését, és küldje el az eredményeket egy kiválasztott célhelyre.
Szinopszis
dotnet-monitor collect [-h|--help] [-u|--urls] [-m|--metrics] [--metricUrls] [--diagnostic-port] [--no-auth] [--temp-apikey] [--no-http-egress]
Beállítások
-h|--help
Parancssori súgót jelenít meg.
-u|--urls <urls>
Kötések a HTTP API-hoz. Az alapértelmezett szint a
https://localhost:52323
.-m|--metrics [true|false]
A metrikák átirányításhoz való közzétételének
/metrics
engedélyezése. Az alapértelmezett értéktrue
--metricUrls <urls>
A metrikák HTTP API-kötései. Az alapértelmezett szint a
http://localhost:52325
.--diagnostic-port <path>
Annak a diagnosztikai portnak a teljes elérési útja és fájlneve, amelyhez a futtatókörnyezeti példányok csatlakozhatnak. Ennek a beállításnak a megadása "figyelési" módban jelenik
dotnet-monitor
meg. Ha nincs megadva,dotnet-monitor
"kapcsolódás" módban van.Windows rendszeren ennek érvényes elnevezett csőnévnek kell lennie. Linux és macOS rendszeren ennek érvényes Unix Domain Socket-elérési útnak kell lennie.
--no-auth
Letiltja az API-kulcsok hitelesítését. Az alapértelmezett szint a
false
.Erősen ajánlott, hogy ez a beállítás éles környezetben ne legyen használva.
--temp-apikey
Létrehoz egy ideiglenes API-kulcsot a
dotnet-monitor
példányhoz.--no-http-egress
Letiltja a diagnosztikai összetevők kimenő forgalmát a HTTP-válaszon keresztül. Ha meg van adva, az összetevőket kimenő szolgáltatóval kell kibocsátani.
dotnet-monitor konfigurációs show
Úgy jeleníti meg a konfigurációt, mintha dotnet-monitor collect
ezekkel a paraméterekkel lett volna végrehajtva.
Szinopszis
dotnet-monitor config show [-h|--help] [-u|--urls] [-m|--metrics] [--metricUrls] [--diagnostic-port] [--no-auth] [--temp-apikey] [--no-http-egress] [--level] [--show-sources]
Beállítások
-h|--help
Parancssori súgót jelenít meg.
-u|--urls <urls>
Kötések a HTTP API-hoz. Az alapértelmezett szint a
https://localhost:52323
.Ez az érték kulcsként
urls
konfigurációra van leképezve.-m|--metrics [true|false]
A metrikák átirányításhoz való közzétételének
/metrics
engedélyezése. Az alapértelmezett szint atrue
.Ez az érték kulcsként
Metrics:Enabled
konfigurációra van leképezve.--metricUrls <urls>
A metrikák HTTP API-kötései. Az alapértelmezett szint a
http://localhost:52325
.Ez az érték kulcsként
Metrics:Endpoints
konfigurációra van leképezve.--diagnostic-port <path>
Annak a diagnosztikai portnak a teljes elérési útja és fájlneve, amelyhez a futtatókörnyezeti példányok csatlakozhatnak. Ennek a beállításnak a megadása "figyelési" módban jelenik
dotnet-monitor
meg. Ha nincs megadva,dotnet-monitor
"kapcsolódás" módban van.Windows rendszeren ennek érvényes elnevezett csőnévnek kell lennie. Linux és macOS rendszeren ennek érvényes Unix Domain Socket-elérési útnak kell lennie.
Ez az érték kulcsként
DiagnosticPort:EndpointName
konfigurációra van leképezve.--no-auth
Letiltja az API-kulcsok hitelesítését. Az alapértelmezett szint a
false
.Erősen ajánlott, hogy ez a beállítás éles környezetben ne legyen használva.
Ez az érték nincs konfigurációba leképezve.
--temp-apikey
Létrehoz egy ideiglenes API-kulcsot a
dotnet-monitor
példányhoz.Ez az érték kulcsként
Authentication:MonitorApiKey
konfigurációra van leképezve.--no-http-egress
Letiltja a diagnosztikai összetevők kimenő forgalmát a HTTP-válaszon keresztül. Ha meg van adva, az összetevőket kimenő szolgáltatóval kell kibocsátani.
Ez az érték nincs konfigurációba leképezve.
--level
Konfigurációs szint.
Full
konfiguráció bizalmas információkat jeleníthet meg. Két szint létezik:Full
- A teljes konfiguráció az értékek újrafelfedése nélkül.Redacted
- A teljes konfiguráció, de a bizalmas információk, például az ismert titkos kódok újra lesznek kitéve.
--show-sources
Meghatározza, hogy melyik konfigurációs forrásból adja meg az egyes tényleges konfigurációs értékeket.
dotnet-monitor generatekey
HOZZon létre egy API-kulcsot és kivonatot a HTTP-hitelesítéshez.
Szinopszis
dotnet-monitor generatekey [-h|--help] [-o|--output]
Beállítások
-h|--help
Parancssori súgót jelenít meg.
-o|--output <Cmd|Json|MachineJson|PowerShell|Shell|Text>
Az a kimeneti formátum, amelyben az API-kulcs információi szabványos kimenetre íródnak.
Az engedélyezett értékek a következők:
Cmd
– Windows parancssori vagy kötegelt fájlokban használható formátumú kimenetek.Json
- JSON-objektum formátumú kimenetek.MachineJson
- JSON-objektum formátumú kimenetek megjegyzések és magyarázat nélkül. Automatizálási forgatókönyvek esetén hasznos.PowerShell
– PowerShell-parancssorokban és szkriptekben használható formátumú kimenetek.Shell
- Linux-rendszerhéjakban, például Bashben használható formátumú kimenetek.Text
– Egyszerű szöveg formátumú kimenetek.