为本地服务器部署 Azure Monitor Application Insights 代理

Application Insights 代理是发布到 PowerShell 库的 PowerShell 模块。 它将替换状态监视器。 遥测数据将发送到 Azure 门户,你可以在其中监视应用。

有关支持的 自动结构 方案的完整列表,请参阅 支持的环境、语言和资源提供程序

注意

该模块当前支持使用 Internet Information Server (IIS)托管的 ASP.NET 和 ASP.NET Core Web 应用的无代码检测。 使用 SDK 检测 Java 和 Node.js 应用程序。

注意

默认情况下,ASP.NET Core 应用启用客户端监视。 如果要禁用客户端监视,请使用以下信息在服务器中定义环境变量:

  • 名称APPINSIGHTS_JAVASCRIPT_ENABLED
  • 价值:false

Application Insights 代理位于 PowerShell 库中。

PowerShell 库图标。

说明

  • 若要开始使用简洁的代码示例,请参阅“入门”选项卡。
  • 若要深入了解如何开始使用,请参阅“详细说明”选项卡。
  • 有关 PowerShell API 参考,请参阅“API 参考”选项卡。
  • 有关发行说明更新,请参阅“发行说明”选项卡。

此选项卡包含应适用于大多数环境的快速入门命令。 这些说明依赖于 PowerShell 库来分发更新。 这些命令支持 PowerShell -Proxy 参数。

有关这些命令的说明、自定义说明以及有关故障排除的信息,请参阅详细说明

如果没有 Azure 订阅,可在开始前创建一个试用帐户

使用 PowerShell 库来下载并安装。

安装先决条件

若要启用监视,你必须有一个连接字符串。 连接字符串将显示在 Application Insights 资源的“概述”窗格上。 有关详细信息,请参阅连接字符串

注意

有关可能需要的更多先决条件,请参阅 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

注意

AllowPrerelease cmdlet 中的 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.cn/'

手动下载并安装(脱机选项)

还可以手动下载并安装。

下载模块

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.cn/'