Implantar Application Insights Agent do Azure Monitor em servidores locais

  • Artigo

O Application Insights Agent (anteriormente denominado Status Monitor v2) é um módulo do PowerShell publicado na Galeria do PowerShell. Ele substitui o Status Monitor. A telemetria é enviada para a portal do Azure, no qual você pode monitorar seu aplicativo.

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

Observação

No momento, o módulo oferece suporte à instrumentação sem código de aplicativos ASP.NET e ASP.NET Core hospedados no IIS. Use um SDK para instrumentar aplicativos Java e Node.js.

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

PowerShell Gallery icon.

Instruções

  • Para começar a usar exemplos de código concisos, veja a guia Introdução.
  • Para obter um aprofundamento sobre como começar, veja as Instruções detalhadas.
  • Para ver a referência da API do PowerShell, veja a guia Referência de API.
  • Para ver atualizações de notas sobre a versão, veja a guia Notas sobre a 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 são suportados pelo parâmetro -Proxy do PowerShell.

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

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

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

Pré-requisitos da instalação

Para habilitar o monitoramento, você precisa ter uma cadeia de conexão. Uma cadeia de conexão é exibida no painel Visão geral do recurso do Application Insights. Para saber mais, confira Cadeias de conexão.

Observação

A partir de abril de 2020, a Galeria do PowerShell preteriu o TLS 1.1 e 1.0.

Para mais pré-requisitos de que você pode precisar, veja Suporte ao 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

Observação

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

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

Habilitar o monitoramento

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.

Baixar o modulo

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

Descompactar 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

Habilitar o monitoramento

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

Perguntas frequentes

Esta seção fornece respostas para perguntas comuns.

O Application Insights Agent dá suporte a instalações de proxy?

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

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

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

O Agente do Application Insights dá suporte a 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 verificar se a habilitação foi bem-sucedida?

  • O cmdlet Get-ApplicationInsightsMonitoringStatus pode ser usado para verificar se a habilitação foi bem-sucedida.

  • Recomendamos que você use Métricas Dinâmicas para determinar rapidamente se o seu aplicativo está enviando telemetria.

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

    union * | summarize count() by cloud_RoleName, cloud_RoleInstance

Como fazer obtenho a passagem do proxy?

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

Exemplo de Web.config:

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

Solução de problemas

Confira o artigo de solução de problemas dedicado.

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

Os 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 servidor Web ou do computador host do aplicativo para os pontos de extremidade do serviço de ingestão usando clientes REST brutos do PowerShell ou comandos curl. Confira Solucionar problemas de telemetria de aplicativo ausente no Application Insights do Azure Monitor.

Próximas etapas

Exiba sua telemetria:

Adicione mais telemetria:

Faça mais com o Application Insights Agent: