部署適用于內部部署伺服器的 Azure 監視器 Application Insights 代理程式

Application Insights 代理程式(先前稱為狀態監視器 V2)是發佈至PowerShell 資源庫 PowerShell 模組。 它會取代狀態監視器。 遙測會傳送至Azure 入口網站,您可以在 其中監視 您的應用程式。

如需支援自動結構案例的完整清單,請參閱 支援的環境、語言和資源提供者

注意

模組目前支援無程式碼檢測裝載于 IIS 的 ASP.NET 和 ASP.NET Core Web 應用程式。 使用 SDK 來檢測 JAVA 和 Node.js 應用程式。

Application Insights 代理程式位於 PowerShell 資源庫

PowerShell Gallery icon.

指示

  • 若要開始使用簡潔的程式碼範例,請參閱 開始使用索引 標籤。
  • 如需如何開始使用的深入探討,請參閱 詳細指示索引標籤
  • 如需 PowerShell API 參考,請參閱 API 參考 索引 標籤。
  • 如需版本資訊更新,請參閱 版本資訊 索引標籤。

此索引標籤包含預期適用于大部分環境的快速入門命令。 指示取決於PowerShell 資源庫來散發更新。 這些命令支援 PowerShell -Proxy 參數。

如需這些命令的說明、自訂指示,以及疑難排解的相關資訊,請參閱 詳細指示

如尚未擁有 Azure 訂用帳戶,請在開始之前先建立免費帳戶

使用PowerShell 資源庫進行下載和安裝。

安裝先決條件

若要啟用監視,您必須有連接字串。 連接字串會顯示在 Application Insights 資源的 [概觀] 窗格中。 如需詳細資訊,請參閱 連線ion 字串

注意

自 2020 年 4 月起,PowerShell 資源庫已取代 TLS 1.1 和 1.0。

如需您可能需要的更多必要條件,請參閱 PowerShell 資源庫 TLS 支援

以系統管理員身分執行 PowerShell。

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

關閉 PowerShell。

安裝 Application Insights 代理程式

以系統管理員身分執行 PowerShell。

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

注意

Cmdlet AllowPrerelease 中的 Install-Module 參數允許安裝 Beta 版本。

如需詳細資訊,請參閱 Install-Module

啟用監視

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

手動下載並安裝 (離線選項)

您也可以手動下載並安裝。

下載模組

從 PowerShell 資源庫 手動下載最新版本的模組

解壓縮並安裝 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

啟用監視

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

常見問題集

本節提供常見問題的解答。

Application Insights 代理程式是否支援 Proxy 安裝?

是。 有多種方式可以下載 Application Insights 代理程式:

  • 如果您的電腦具有網際網路存取權,您可以使用參數上架至PowerShell 資源庫 -Proxy
  • 您也可以手動下載模組,並在電腦上安裝模組,或直接使用它。

每個選項都會在詳細指示 說明。

Application Insights 代理程式是否支援 ASP.NET Core 應用程式?

是。 在 Application Insights Agent 2.0.0 和更新版本中,支援裝載在 IIS 中的 ASP.NET Core 應用程式。

如何?確認啟用成功嗎?

如何?達到 Proxy 傳遞嗎?

若要達到 Proxy 傳遞,請設定電腦層級 Proxy 或應用層級 Proxy。 請參閱 DefaultProxy

範例 Web.config:

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

疑難排解

請參閱專用 的疑難排解文章

測試應用程式主機與擷取服務之間的連線能力

Application Insights SDK 和代理程式會傳送遙測,以擷取作為對擷取端點的 REST 呼叫。 您可以使用來自 PowerShell 或 curl 命令的原始 REST 用戶端,測試從 Web 服務器或應用程式主機電腦到擷取服務端點的連線。 請參閱 針對 Azure 監視器 Application Insights 中遺漏的應用程式遙測進行疑難排解。

下一步

檢視您的遙測:

新增更多遙測:

使用 Application Insights 代理程式執行更多動作: