Partilhar via

Implantar o Azure Monitor Application Insights Agent para servidores locais

O Application Insights Agent é um módulo do PowerShell publicado na Galeria do PowerShell. Ele substitui o Status Monitor. A telemetria é enviada para o portal do Azure, onde você pode monitorar seu aplicativo.

Para obter uma lista completa dos cenários de autoinstrumentação suportados, consulte Ambientes suportados, idiomas e provedores de recursos.

Nota

Atualmente, o módulo suporta instrumentação sem código de aplicativos Web ASP.NET e ASP.NET Core hospedados com o Internet Information Server (IIS). Use um SDK para instrumentar aplicativos Java e Node.js.

Nota

O monitoramento do lado do cliente é habilitado por padrão para aplicativos ASP.NET Core. Se você quiser desabilitar o monitoramento do lado do cliente, defina uma variável de ambiente no servidor com as seguintes informações:

  • Designação:APPINSIGHTS_JAVASCRIPT_ENABLED
  • Valor:false

O Agente do Application Insights está localizado na Galeria do PowerShell.

Ícone da Galeria do PowerShell.

Instruções

  • Para começar a usar exemplos de código conciso, consulte a guia Introdução .
  • Para um aprofundamento sobre como começar, consulte a guia Instruções detalhadas.
  • Para referência da API do PowerShell, consulte a guia Referência da API.
  • Para atualizações da nota de versão, consulte a guia Notas de versão.

Esta guia contém os comandos de início rápido que devem funcionar para a maioria dos ambientes. As instruções dependem da Galeria do PowerShell para distribuir atualizações. Esses comandos dão suporte ao parâmetro PowerShell -Proxy .

Para obter uma explicação desses comandos, instruções de personalização e informações sobre solução de problemas, consulte as instruções detalhadas.

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Use a Galeria do PowerShell para download e instalação.

Pré-requisitos de instalação

Para habilitar o monitoramento, você deve ter uma cadeia de conexão. Uma cadeia de conexão é exibida no painel Visão geral do recurso do Application Insights. Para obter mais informações, consulte Cadeias de conexão.

Nota

Para obter mais pré-requisitos que você pode precisar, consulte Suporte a TLS (Transport Layer Security) da Galeria do PowerShell.

Execute o PowerShell como administrador.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force

Feche o PowerShell.

Instalar o Application Insights Agent

Execute o PowerShell como administrador.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

Nota

A AllowPrerelease opção no cmdlet permite a Install-Module instalação da versão beta.

Para obter mais informações, consulte Install-Module.

Ativar monitorização

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Baixar e instalar manualmente (opção offline)

Você também pode baixar e instalar manualmente.

Faça o download do módulo

Baixe manualmente a versão mais recente do módulo da Galeria do PowerShell.

Descompacte e instale o Application Insights Agent

$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

Ativar monitorização

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'
  • Last updated on