Partilhar via


Implantar o Azure Monitor Application Insights Agent para servidores locais

O Application Insights Agent (anteriormente chamado Status Monitor V2) é 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 IIS. Use um SDK para instrumentar aplicativos Java e Node.js.

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

Em abril de 2020, a Galeria do PowerShell desativou o TLS 1.1 e 1.0.

Para obter mais pré-requisitos que você pode precisar, consulte Suporte a TLS 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/'

Perguntas mais frequentes

Esta secção fornece respostas a perguntas comuns.

O Application Insights Agent suporta instalações de proxy?

Sim. Há várias maneiras de baixar o Application Insights Agent:

  • Se o seu computador tiver acesso à Internet, você poderá integrar a Galeria do PowerShell usando -Proxy parâmetros.
  • Você também pode baixar manualmente o módulo e instalá-lo em seu computador ou usá-lo diretamente.

Cada uma dessas opções é descrita nas instruções detalhadas.

O Application Insights Agent suporta aplicativos ASP.NET Core?

Sim. No Application Insights Agent 2.0.0 e posterior, há suporte para aplicativos ASP.NET Core hospedados no IIS.

Como verifico se a habilitação foi bem-sucedida?

  • Você pode usar o cmdlet Get-ApplicationInsightsMonitoringStatus para verificar se a habilitação foi bem-sucedida.
    • Use o Live Metrics para determinar rapidamente se seu aplicativo está enviando telemetria.

    • Você também pode usar o Log Analytics para listar todas as funções na nuvem que estão enviando telemetria no momento:

      union * | summarize count() by cloud_RoleName, cloud_RoleInstance
      

Como faço para obter passagem de proxy?

Para obter passagem de proxy, configure um proxy no nível da máquina ou um proxy no nível do aplicativo. Consulte DefaultProxy.

Exemplo Web.config:

<system.net>
    <defaultProxy>
    <proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
    </defaultProxy>
</system.net>

Resolução de Problemas

Consulte o artigo dedicado à resolução de problemas.

Testar a conectividade entre o host do aplicativo e o serviço de ingestão

SDKs e agentes do Application Insights enviam telemetria para serem ingeridos como chamadas REST para nossos pontos de extremidade de ingestão. Você pode testar a conectividade do seu servidor Web ou máquina host de aplicativo para os pontos de extremidade do serviço de ingestão usando clientes REST brutos do PowerShell ou comandos curl. Consulte Solucionar problemas de telemetria de aplicativo ausente no Azure Monitor Application Insights.

Próximos passos

Ver a telemetria:

Adicionar mais telemetria:

Faça mais com o Application Insights Agent: