Utilitário de monitorização e recolha de diagnósticos (dotnet-monitor)

Este artigo aplica-se a: ✔️ dotnet-monitor versão 6.0.0 e versões posteriores

Instalar

Existem duas formas de transferir dotnet-monitor:

• ferramenta global dotnet:

  Para instalar a versão de versão mais recente do dotnet-monitorpacote NuGet, utilize o comando de instalação da ferramenta dotnet :

  dotnet tool install --global dotnet-monitor
  

• Imagem do Docker:

  Transfira uma imagem do Docker para utilização em ambientes com vários contentores:

  docker pull mcr.microsoft.com/dotnet/monitor
  

Sinopse

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

Description

A dotnet-monitor ferramenta global é uma forma de monitorizar aplicações .NET em ambientes de produção e recolher artefactos de diagnóstico (por exemplo, capturas, rastreios, registos e métricas) a pedido ou utilizar regras automatizadas para recolha em condições especificadas.

Opções

• --version

  Apresenta a versão do utilitário dotnet-monitor.

• -h|--help

  Mostra a ajuda da linha de comandos.

Comandos

Comando
dotnet monitor collect
dotnet monitor config show
dotnet monitor generatekey

dotnet-monitor collect

Monitorize as aplicações .NET, permita a recolha de artefactos de diagnóstico e envie os resultados para um destino escolhido.

Sinopse

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

Opções

• -h|--help

  Mostra a ajuda da linha de comandos.

• -u|--urls <urls>

  Enlaces para a api HTTP. A predefinição é https://localhost:52323.

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

  Ative a publicação de métricas para encaminhar /metrics . A predefinição é true

• --metricUrls <urls>

  Enlaces para a api HTTP de métricas. A predefinição é http://localhost:52325.

• --diagnostic-port <path>

  O caminho completamente qualificado e o nome do ficheiro da porta de diagnóstico à qual as instâncias de runtime se podem ligar. Especificar esta opção coloca-se dotnet-monitor no modo de "escuta". Quando não for especificado, dotnet-monitor está no modo "ligar".

  No Windows, tem de ser um nome de pipe válido. No Linux e macOS, este tem de ser um caminho de Socket de Domínio Unix válido.

• --no-auth

  Desativa a autenticação da chave de API. A predefinição é false.

  Recomenda-se vivamente que esta opção não seja utilizada em ambientes de produção.

• --temp-apikey

  Gera uma chave de API temporária para a dotnet-monitor instância.

• --no-http-egress

  Desativa a saída de artefactos de diagnóstico através da resposta HTTP. Quando especificado, os artefactos têm de ser efetuados com um fornecedor de saída.

dotnet-monitor config show

Mostra a configuração, como se dotnet-monitor collect tivesse sido executada com estes parâmetros.

Sinopse

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

Opções

• -h|--help

  Mostra a ajuda da linha de comandos.

• -u|--urls <urls>

  Enlaces para a api HTTP. A predefinição é https://localhost:52323.

  Este valor é mapeado para a configuração como a urls chave.

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

  Ative a publicação de métricas para encaminhar /metrics . A predefinição é true.

  Este valor é mapeado para a configuração como a Metrics:Enabled chave.

• --metricUrls <urls>

  Enlaces para a api HTTP de métricas. A predefinição é http://localhost:52325.

  Este valor é mapeado para a configuração como a Metrics:Endpoints chave.

• --diagnostic-port <path>

  O caminho completamente qualificado e o nome do ficheiro da porta de diagnóstico à qual as instâncias de runtime se podem ligar. Especificar esta opção coloca-se dotnet-monitor no modo de "escuta". Quando não for especificado, dotnet-monitor está no modo "ligar".

  No Windows, tem de ser um nome de pipe válido. No Linux e macOS, este tem de ser um caminho de Socket de Domínio Unix válido.

  Este valor é mapeado para a configuração como a DiagnosticPort:EndpointName chave.

• --no-auth

  Desativa a autenticação da chave de API. A predefinição é false.

  Recomenda-se vivamente que esta opção não seja utilizada em ambientes de produção.

  Este valor não está mapeado para a configuração.

• --temp-apikey

  Gera uma chave de API temporária para a dotnet-monitor instância.

  Este valor é mapeado para a configuração como a Authentication:MonitorApiKey chave.

• --no-http-egress

  Desativa a saída de artefactos de diagnóstico através da resposta HTTP. Quando especificado, os artefactos têm de ser efetuados com um fornecedor de saída.

  Este valor não está mapeado para a configuração.

• --level

  Nível de configuração. Full A configuração pode mostrar informações confidenciais. Existem dois níveis:

  • Full - A configuração completa sem qualquer redação de quaisquer valores.
  • Redacted - A configuração completa, mas informações confidenciais, como segredos conhecidos, é redigida.

• --show-sources

  Identifica a partir da origem de configuração que cada valor de configuração eficaz é fornecido.

dotnet-monitor generatekey

Gerar uma chave de API e um hash para autenticação HTTP.

Sinopse

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

Opções

• -h|--help

  Mostra a ajuda da linha de comandos.

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

  O formato de saída no qual as informações da chave de API são escritas na saída padrão.

  Os valores permitidos são:

  • Cmd - Saídas num formato utilizável na Linha de Comandos do Windows ou em ficheiros em lote.
  • Json - Saídas num formato de um objeto JSON.
  • MachineJson - Saídas num formato de um objeto JSON sem comentários e explicação. Útil para cenários de automatização.
  • PowerShell - Saídas num formato utilizável em scripts e pedidos do PowerShell.
  • Shell - Saídas num formato utilizável em shells do Linux, como o Bash.
  • Text - Saídas num formato que é texto simples.

Consulte também

• dotnet/dotnet-monitor