Sdílet prostřednictvím

Nasazení agenta Application Insights služby Azure Monitor pro místní servery

  • Článek

Agent Application Insights (dříve s názvem Monitorování stavu V2) je modul PowerShellu publikovaný do Galerie prostředí PowerShell. Nahrazuje monitorování stavu. Telemetrie se odesílá na web Azure Portal, kde můžete monitorovat aplikaci.

Úplný seznam podporovanýchscénářůch

Poznámka:

Modul v současné době podporuje instrumentaci ASP.NET a webových aplikací ASP.NET Core hostovaných ve službě IIS. K instrumentaci aplikací v Javě a Node.js použijte sadu SDK.

Agent Application Insights se nachází v Galerie prostředí PowerShell.

Galerie prostředí PowerShell ikona.

Pokyny

  • Pokud chcete začít používat stručné ukázky kódu, podívejte se na kartu Začínáme .
  • Podrobné informace o tom, jak začít, najdete na kartě Podrobné pokyny .
  • Referenční informace k rozhraní API PowerShellu najdete na kartě Reference k rozhraní API.
  • Informace o aktualizacích poznámek k verzi najdete na kartě Poznámky k verzi.

Tato karta obsahuje příkazy pro rychlý start, které by měly fungovat pro většinu prostředí. Pokyny závisí na Galerie prostředí PowerShell k distribuci aktualizací. Tyto příkazy podporují parametr PowerShellu -Proxy .

Vysvětlení těchto příkazů, pokynů k přizpůsobení a informací o řešení potíží najdete v podrobných pokynech.

Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

Ke stažení a instalaci použijte Galerie prostředí PowerShell.

Požadavky na instalaci

Pokud chcete povolit monitorování, musíte mít připojovací řetězec. V podokně Přehled prostředku Application Insights se zobrazí připojovací řetězec. Další informace naleznete v tématu Připojovací řetězce.

Poznámka:

Od dubna 2020 Galerie prostředí PowerShell už nepoužívá protokol TLS 1.1 a 1.0.

Další požadavky, které možná potřebujete, najdete v tématu Galerie prostředí PowerShell podpora protokolu TLS.

Spusťte PowerShell jako správce.

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

Zavřete PowerShell.

Instalace agenta Application Insights

Spusťte PowerShell jako správce.

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

Poznámka:

Přepínač AllowPrerelease v rutině Install-Module umožňuje instalaci beta verze.

Další informace naleznete v tématu Install-Module.

Povolení monitorování

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

Ruční stažení a instalace (možnost offline)

Můžete si také stáhnout a nainstalovat ručně.

Stažení modulu

Ručně stáhněte nejnovější verzi modulu z Galerie prostředí PowerShell.

Rozbalení a instalace agenta Application Insights

$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

Povolení monitorování

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

Nejčastější dotazy

Tato část obsahuje odpovědi na běžné otázky.

Podporuje agent Application Insights instalace proxy serveru?

Ano. Agenta Application Insights si můžete stáhnout několika způsoby:

  • Pokud má váš počítač přístup k internetu, můžete připojit k Galerie prostředí PowerShell pomocí -Proxy parametrů.
  • Modul si také můžete stáhnout ručně a buď ho nainstalovat do počítače, nebo ho použít přímo.

Každá z těchto možností je popsaná v podrobných pokynech.

Podporuje agent Application Insights ASP.NET základní aplikace?

Ano. V agentu Application Insights 2.0.0 a novějších se podporují aplikace ASP.NET Core hostované ve službě IIS.

Návody ověřit, že povolení proběhlo úspěšně?

  • K ověření úspěšného povolení můžete použít rutinu Get-ApplicationInsightsMonitoringStatus .

    • Pomocí živých metrik můžete rychle zjistit, jestli vaše aplikace odesílá telemetrii.

    • Pomocí Log Analytics můžete také zobrazit seznam všech cloudových rolí, které aktuálně odesílají telemetrii:

      union * | summarize count() by cloud_RoleName, cloud_RoleInstance

Návody dosáhnout průchodu proxy serverem?

Pokud chcete dosáhnout průchodu proxy serverem, nakonfigurujte proxy server na úrovni počítače nebo proxy server na úrovni aplikace. Viz DefaultProxy.

Příklad Web.config:

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

Řešení problému

Projděte si vyhrazený článek o řešení potíží.

Testování připojení mezi hostitelem vaší aplikace a službou příjmu dat

Sady Application Insights SDK a agenti odesílají telemetrii, aby se ingestovala jako volání REST do koncových bodů příjmu dat. Připojení z webového serveru nebo hostitelského počítače aplikace ke koncovým bodům služby pro příjem dat můžete otestovat pomocí nezpracovaných klientů REST z příkazů PowerShellu nebo curl. Viz Řešení potíží s chybějící telemetrií aplikací ve službě Azure Monitor Application Insights.

Další kroky

Zobrazení telemetrických dat:

Přidání další telemetrie:

Další možnosti s využitím agenta Application Insights: