Share via


Hulpprogramma voor diagnostische bewaking en verzameling (dotnet-monitor)

Dit artikel is van toepassing op: ✔️ dotnet-monitor versie 6.0.0 en latere versies

Installeren

Er zijn twee manieren om te downloaden dotnet-monitor:

Samenvatting

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

Beschrijving

Het dotnet-monitor globale hulpprogramma is een manier om .NET-toepassingen in productieomgevingen te bewaken en diagnostische artefacten (bijvoorbeeld dumps, traceringen, logboeken en metrische gegevens) op aanvraag te verzamelen of geautomatiseerde regels te gebruiken voor het verzamelen onder opgegeven omstandigheden.

Opties

  • --version

    Geeft de versie van het hulpprogramma dotnet-monitor weer.

  • -h|--help

    Toont opdrachtregelhulp.

Opdracht

Opdracht
dotnet-monitor verzamelen
dotnet monitor config show
dotnet monitor generatekey

dotnet-monitor verzamelen

Bewaak .NET-toepassingen, sta het verzamelen van diagnostische artefacten toe en verzend de resultaten naar een gekozen bestemming.

Samenvatting

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

Opties

  • -h|--help

    Toont opdrachtregelhulp.

  • -u|--urls <urls>

    Bindingen voor de HTTP-API. Standaard is https://localhost:52323.

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

    Publicatie van metrische gegevens inschakelen om te /metrics routeren. Standaard is true

  • --metricUrls <urls>

    Bindingen voor de HTTP-API voor metrische gegevens. Standaard is http://localhost:52325.

  • --diagnostic-port <path>

    Het volledig gekwalificeerde pad en de bestandsnaam van de diagnostische poort waarmee runtime-exemplaren verbinding kunnen maken. Als u deze optie opgeeft, wordt in de luistermodus geplaatst dotnet-monitor . Wanneer dit niet is opgegeven, bevindt zich in de dotnet-monitor modus Verbinding maken.

    In Windows moet dit een geldige pijpnaam zijn. In Linux en macOS moet dit een geldig Unix Domain Socket-pad zijn.

  • --no-auth

    Hiermee wordt verificatie van API-sleutels uitgeschakeld. Standaard is false.

    Het wordt sterk aangeraden deze optie niet te gebruiken in productieomgevingen.

  • --temp-apikey

    Hiermee wordt een tijdelijke API-sleutel voor het dotnet-monitor exemplaar gegenereerd.

  • --no-http-egress

    Schakelt uitgaand verkeer van diagnostische artefacten uit via het HTTP-antwoord. Wanneer dit is opgegeven, moeten artefacten worden verzonden met behulp van een uitgaande provider.

configuratie van dotnet-monitor weergeven

Toont de configuratie, alsof dotnet-monitor collect deze parameters zijn uitgevoerd.

Samenvatting

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

Opties

  • -h|--help

    Toont opdrachtregelhulp.

  • -u|--urls <urls>

    Bindingen voor de HTTP-API. Standaard is https://localhost:52323.

    Deze waarde wordt als sleutel toegewezen aan de urls configuratie.

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

    Publicatie van metrische gegevens inschakelen om te /metrics routeren. Standaard is true.

    Deze waarde wordt als sleutel toegewezen aan de Metrics:Enabled configuratie.

  • --metricUrls <urls>

    Bindingen voor de HTTP-API voor metrische gegevens. Standaard is http://localhost:52325.

    Deze waarde wordt als sleutel toegewezen aan de Metrics:Endpoints configuratie.

  • --diagnostic-port <path>

    Het volledig gekwalificeerde pad en de bestandsnaam van de diagnostische poort waarmee runtime-exemplaren verbinding kunnen maken. Als u deze optie opgeeft, wordt in de luistermodus geplaatst dotnet-monitor . Wanneer dit niet is opgegeven, bevindt zich in de dotnet-monitor modus Verbinding maken.

    In Windows moet dit een geldige pijpnaam zijn. In Linux en macOS moet dit een geldig Unix Domain Socket-pad zijn.

    Deze waarde wordt als sleutel toegewezen aan de DiagnosticPort:EndpointName configuratie.

  • --no-auth

    Hiermee wordt verificatie van API-sleutels uitgeschakeld. Standaard is false.

    Het wordt sterk aangeraden deze optie niet te gebruiken in productieomgevingen.

    Deze waarde wordt niet toegewezen aan de configuratie.

  • --temp-apikey

    Hiermee wordt een tijdelijke API-sleutel voor het dotnet-monitor exemplaar gegenereerd.

    Deze waarde wordt als sleutel toegewezen aan de Authentication:MonitorApiKey configuratie.

  • --no-http-egress

    Schakelt uitgaand verkeer van diagnostische artefacten uit via het HTTP-antwoord. Wanneer dit is opgegeven, moeten artefacten worden verzonden met behulp van een uitgaande provider.

    Deze waarde wordt niet toegewezen aan de configuratie.

  • --level

    Configuratieniveau. Full configuratie kan gevoelige informatie weergeven. Er zijn twee niveaus:

    • Full - De volledige configuratie zonder enige redaction van waarden.
    • Redacted - De volledige configuratie, maar gevoelige informatie, zoals bekende geheimen, wordt redacted.
  • --show-sources

    Identificeert uit welke configuratiebron elke effectieve configuratiewaarde wordt opgegeven.

dotnet-monitor generatekey

Genereer een API-sleutel en hash voor HTTP-verificatie.

Samenvatting

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

Opties

  • -h|--help

    Toont opdrachtregelhulp.

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

    De uitvoerindeling waarin de API-sleutelgegevens naar de standaarduitvoer worden geschreven.

    De toegestane waarden zijn:

    • Cmd - Uitvoer in een indeling die bruikbaar is in windows-opdrachtprompt of batchbestanden.
    • Json - Uitvoer in een indeling van een JSON-object.
    • MachineJson - Uitvoer in een indeling van een JSON-object zonder opmerkingen en uitleg. Handig voor automatiseringsscenario's.
    • PowerShell - Uitvoer in een indeling die kan worden gebruikt in PowerShell-prompts en -scripts.
    • Shell - Uitvoer in een indeling die kan worden gebruikt in Linux-shells zoals Bash.
    • Text - Uitvoer in een indeling die tekst zonder opmaak is.

Zie ook