本文介绍如何通过自动检测为 Azure 虚拟机和 Azure 虚拟机规模集上的 IIS 托管 ASP.NET 及 ASP.NET Core 应用程序启用 Azure Monitor Application Insights 监视。 它介绍如何使用虚拟机扩展部署 Application Insights 代理,该扩展 自动收集与 SDK 相同的依赖项信号,并提供有关使用 PowerShell 自动执行大规模部署的指导。
有关支持的自动检测方案的完整列表,请参阅支持的环境、语言和资源提供程序。
先决条件
在安装 Application Insights 代理扩展之前,需要一个连接字符串。 创建新的 Application Insights 资源 或从现有资源复制连接字符串。
为虚拟机启用监视
可使用 Azure 门户或 PowerShell 来启用 VM 监视。
在 Azure 门户中,转到你的 Application Insights 资源。 将你的连接字符串复制到剪贴板。
转到虚拟机。 在左侧菜单的“设置”部分下,选择“扩展 + 应用程序”>“添加”。
选择“Application Insights 代理”>“下一步”。
粘贴你在步骤 1 中复制的连接字符串,然后选择“查看 + 创建”。
注意
不熟悉 PowerShell? 请查看入门指南。
安装或更新用作 Azure 虚拟机扩展的 Application Insights 代理:
# define variables to match your environment before running
$ResourceGroup = "<myVmResourceGroup>"
$VMName = "<myVmName>"
$Location = "<myVmLocation>"
$ConnectionString = "<myAppInsightsResourceConnectionString>"
$publicCfgJsonString = @"
{
"redfieldConfiguration": {
"instrumentationKeyMap": {
"filters": [
{
"appFilter": ".*",
"machineFilter": ".*",
"virtualPathFilter": ".*",
"instrumentationSettings" : {
"connectionString": "$ConnectionString"
}
}
]
}
}
}
"@
$privateCfgJsonString = '{}'
Set-AzVMExtension -ResourceGroupName $ResourceGroup -VMName $VMName -Location $Location -Name "ApplicationMonitoringWindows" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -Version "2.8" -SettingString $publicCfgJsonString -ProtectedSettingString $privateCfgJsonString
注意
对于更复杂的大规模部署,你可以使用 PowerShell 循环跨多个 VM 安装或更新 Application Insights 代理扩展。
查询 Azure 虚拟机的 Application Insights 代理扩展状态:
Get-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name ApplicationMonitoringWindows -Status
获取 Azure 虚拟机的已安装扩展的列表:
Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myVmResourceGroup>/providers/Microsoft.Compute/virtualMachines/<myVmName>/extensions"
从 Azure 虚拟机卸载 Application Insights 代理扩展:
Remove-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name "ApplicationMonitoring"
注意
通过选择与你在部署 Application Insights 代理扩展时使用的连接字符串相关联的 Application Insights 资源中的“实时指标流”来验证安装。 如果你从多个虚拟机发送数据,请在“服务器名称”下选择目标 Azure 虚拟机。 最长可能需要等待一分钟,数据才会开始流动。
为虚拟机规模集启用监视
可以使用 Azure 门户或 PowerShell 为虚拟机规模集启用监视。
遵循前述用于 VM 的步骤,但需转到虚拟机规模集而不是 VM。
安装或更新 Application Insights 代理程序,将其用作虚拟机规模集的扩展:
# Set resource group, vmss name, and connection string to reflect your environment
$ResourceGroup = "<myVmResourceGroup>"
$VMSSName = "<myVmName>"
$ConnectionString = "<myAppInsightsResourceConnectionString>"
$publicCfgHashtable =
@{
"redfieldConfiguration"= @{
"instrumentationKeyMap"= @{
"filters"= @(
@{
"appFilter"= ".*";
"machineFilter"= ".*";
"virtualPathFilter"= ".*";
"instrumentationSettings" = @{
"connectionString"= "$ConnectionString"
}
}
)
}
}
};
$privateCfgHashtable = @{};
$vmss = Get-AzVmss -ResourceGroupName $ResourceGroup -VMScaleSetName $VMSSName
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "ApplicationMonitoringWindows" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -TypeHandlerVersion "2.8" -Setting $publicCfgHashtable -ProtectedSetting $privateCfgHashtable
Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss
# Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance
获取虚拟机规模集的已安装扩展的列表:
Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/<myVmssName>/extensions"
从虚拟机规模集卸载应用程序监视扩展:
# set resource group and vmss name to reflect your environment
$vmss = Get-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myVmssName>"
Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "ApplicationMonitoringWindows"
Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss.Name -VirtualMachineScaleSet $vmss
# Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance
常见问题
如何进行禁用 ASP.NET Core 应用的客户端监控?
默认情况下,ASP.NET Core 应用启用客户端监视。 如果要禁用它,请使用以下信息在服务器中定义环境变量:
- 名称:
APPINSIGHTS_JAVASCRIPT_ENABLED
- 值:
false
疑难解答
查找有关在 Azure 虚拟机和虚拟机规模集上运行的 .NET 应用程序的 Application Insights 监视代理扩展的故障排除提示。
如果在部署扩展时遇到问题,请查看记录到以下目录中的文件的执行输出:
C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.ApplicationMonitoringWindows\<version>\
如果扩展已成功部署,但你看不到遥测数据,则可能发生了代理故障排除中介绍的以下问题之一:
- 应用的 bin 目录中存在冲突的 Dll
- 与 IIS 共享配置冲突
测试应用程序主机与引入服务之间的连接性
Application Insights SDK 和代理会发送遥测,以将其作为 REST 调用引入到终结点。 可以使用原始 REST 客户端通过 PowerShell 或使用 curl 命令,测试从 Web 服务器或应用程序主机计算机到引入服务终结点的连接。 请参阅排查 Azure Monitor Application Insights 中应用程序遥测数据缺失的问题。
发行说明
2.8.44
- 已将 Application Insights .NET/.NET Core SDK 更新为 2.20.1 - 红色字段。
- 启用了 SQL 查询集合。
- 已启用对 Microsoft Entra 身份验证的支持。
2.8.42
已将 Application Insights .NET/.NET Core SDK 更新到 2.18.1 - 红色字段。
2.8.41
添加了 ASP.NET Core 自动检测功能。
后续步骤