Nástroj pro monitorování diagnostiky a shromažďování (dotnet-monitor)

  • Článek

Tento článek se vztahuje na: ✔️ dotnet-monitor verze 6.0.0 a novější verze

Instalace

Existují dva způsoby, jak stáhnout dotnet-monitor:

  • dotnet global tool:

    Pokud chcete nainstalovat nejnovější verzi dotnet-monitor balíčku NuGet, použijte příkaz dotnet tool install :

    dotnet tool install --global dotnet-monitor

  • Image Dockeru:

    Stáhněte si image Dockeru pro použití v prostředích s více kontejnery:

    docker pull mcr.microsoft.com/dotnet/monitor

Synopse

dotnet-monitor [-h|--help] [--version] <command>

Popis

Globální dotnet-monitor nástroj je způsob, jak monitorovat aplikace .NET v produkčních prostředích a shromažďovat diagnostické artefakty (například výpisy paměti, trasování, protokoly a metriky) na vyžádání nebo pomocí automatizovaných pravidel pro shromažďování za určitých podmínek.

Možnosti

  • --version

    Zobrazí verzi nástroje dotnet-monitor.

  • -h|--help

    Zobrazuje nápovědu k příkazovému řádku.

Příkazy

Příkaz
dotnet monitor collect
dotnet monitor config show
dotnet monitor generatekey

dotnet-monitor collect

Monitorujte aplikace .NET, povolte shromažďování diagnostických artefaktů a odesílejte výsledky do zvoleného cíle.

Synopse

dotnet-monitor collect [-h|--help] [-u|--urls] [-m|--metrics] [--metricUrls] [--diagnostic-port] [--no-auth] [--temp-apikey] [--no-http-egress]

Možnosti

  • -h|--help

    Zobrazuje nápovědu k příkazovému řádku.

  • -u|--urls <urls>

    Vazby pro rozhraní API PROTOKOLU HTTP Výchozí hodnota je https://localhost:52323.

  • -m|--metrics [true|false]

    Povolte publikování metrik pro /metrics směrování. Výchozí hodnota je true

  • --metricUrls <urls>

    Vazby pro rozhraní API HTTP metrik Výchozí hodnota je http://localhost:52325.

  • --diagnostic-port <path>

    Plně kvalifikovaná cesta a název souboru diagnostického portu, ke kterému se instance modulu runtime mohou připojit. Zadáním této možnosti dotnet-monitor přejdete do režimu naslouchání. Pokud není zadáno, dotnet-monitor je v režimu připojení.

    Ve Windows to musí být platný název pojmenovaného kanálu. V systémech Linux a macOS to musí být platná cesta k soketu domény unixu.

  • --no-auth

    Zakáže ověřování pomocí klíče rozhraní API. Výchozí hodnota je false.

    Důrazně doporučujeme, aby se tato možnost nepoužívala v produkčních prostředích.

  • --temp-apikey

    Vygeneruje dočasný klíč rozhraní API pro dotnet-monitor instanci.

  • --no-http-egress

    Zakáže výchozí přenos diagnostických artefaktů prostřednictvím odpovědi HTTP. Při zadání musí být artefakty výchozího přenosu dat pomocí poskytovatele výchozího přenosu dat.

dotnet-monitor config show

Zobrazuje konfiguraci, jako kdyby dotnet-monitor collect byla provedena s těmito parametry.

Synopse

dotnet-monitor config show [-h|--help] [-u|--urls] [-m|--metrics] [--metricUrls] [--diagnostic-port] [--no-auth] [--temp-apikey] [--no-http-egress] [--level] [--show-sources]

Možnosti

  • -h|--help

    Zobrazuje nápovědu k příkazovému řádku.

  • -u|--urls <urls>

    Vazby pro rozhraní API PROTOKOLU HTTP Výchozí hodnota je https://localhost:52323.

    Tato hodnota se mapuje na konfiguraci jako urls klíč.

  • -m|--metrics [true|false]

    Povolte publikování metrik pro /metrics směrování. Výchozí hodnota je true.

    Tato hodnota se mapuje na konfiguraci jako Metrics:Enabled klíč.

  • --metricUrls <urls>

    Vazby pro rozhraní API HTTP metrik Výchozí hodnota je http://localhost:52325.

    Tato hodnota se mapuje na konfiguraci jako Metrics:Endpoints klíč.

  • --diagnostic-port <path>

    Plně kvalifikovaná cesta a název souboru diagnostického portu, ke kterému se instance modulu runtime mohou připojit. Zadáním této možnosti dotnet-monitor přejdete do režimu naslouchání. Pokud není zadáno, dotnet-monitor je v režimu připojení.

    Ve Windows to musí být platný název pojmenovaného kanálu. V systémech Linux a macOS to musí být platná cesta k soketu domény unixu.

    Tato hodnota se mapuje na konfiguraci jako DiagnosticPort:EndpointName klíč.

  • --no-auth

    Zakáže ověřování pomocí klíče rozhraní API. Výchozí hodnota je false.

    Důrazně doporučujeme, aby se tato možnost nepoužívala v produkčních prostředích.

    Tato hodnota není namapována na konfiguraci.

  • --temp-apikey

    Vygeneruje dočasný klíč rozhraní API pro dotnet-monitor instanci.

    Tato hodnota se mapuje na konfiguraci jako Authentication:MonitorApiKey klíč.

  • --no-http-egress

    Zakáže výchozí přenos diagnostických artefaktů prostřednictvím odpovědi HTTP. Při zadání musí být artefakty výchozího přenosu dat pomocí poskytovatele výchozího přenosu dat.

    Tato hodnota není namapována na konfiguraci.

  • --level

    Úroveň konfigurace. Full konfigurace může zobrazovat citlivé informace. Existují dvě úrovně:

    • Full – Úplná konfigurace bez jakékoli redakce jakýchkoli hodnot.
    • Redacted – Úplná konfigurace, ale citlivé informace, jako jsou známé tajné kódy, jsou upraveny.

  • --show-sources

    Identifikuje, ze kterého zdroje konfigurace se zadaná každá platná hodnota konfigurace.

dotnet-monitor generatekey

Vygenerujte klíč rozhraní API a hodnotu hash pro ověřování HTTP.

Synopse

dotnet-monitor generatekey [-h|--help] [-o|--output]

Možnosti

  • -h|--help

    Zobrazuje nápovědu k příkazovému řádku.

  • -o|--output <Cmd|Json|MachineJson|PowerShell|Shell|Text>

    Výstupní formát, ve kterém jsou informace o klíči rozhraní API zapsány do standardního výstupu.

    Povolené hodnoty jsou:

    • Cmd – Výstupy ve formátu použitelném v příkazovém řádku Windows nebo dávkových souborech.
    • Json – Výstupy ve formátu objektu JSON.
    • MachineJson – Výstupy ve formátu objektu JSON bez komentářů a vysvětlení. Užitečné pro scénáře automatizace.
    • PowerShell – Výstupy ve formátu použitelném v powershellových výzev a skriptech.
    • Shell – Výstupy ve formátu použitelném v linuxových prostředích, jako je Bash.
    • Text – Výstupy ve formátu prostého textu.

Viz také