Application Insights för virtuella Azure-datorer (VM) och virtuella datorers skalningsuppsättningar

2025-10-30

Aktivera Övervakning av Azure Monitor Application Insights via automatisk instrumentering för IIS-värdbaserade ASP.NET- och ASP.NET Core-program på Azure Virtual Machines och Azure Virtual Machine Scale Sets. Distribuera Application Insights-agenten med ett tillägg för virtuella datorer. Agenten samlar automatiskt in samma beroendesignaler som SDK:t. Använd PowerShell för att automatisera storskaliga distributioner.

Anteckning

För Java-program använder du Application Insights Java 3.0-agenten, som automatiskt samlar in de mest populära biblioteken, ramverken, loggarna och beroendena, tillsammans med många andra konfigurationer.
Node.js- och Python-program som körs på virtuella Azure-datorer och skalningsuppsättningar för virtuella Azure-datorer stöder inte autoinstrumentering. Använd Azure Monitor OpenTelemetry Distro i stället.
Information om hur du övervakar vm-gäster utöver de program som finns på dem finns i VM-gästdata.

En fullständig lista över scenarier med automatisk instrumentering som stöds finns i Miljöer, språk och resursprovidrar som stöds.

Förutsättningar

Innan du installerar Application Insights Agent-tillägget behöver du en anslutningssträng. Skapa en ny Application Insights-resurs eller kopiera anslutningssträngen från en befintlig.

Aktivera övervakning för virtuella datorer

Du kan använda Azure Portal eller PowerShell för att aktivera övervakning för virtuella datorer.

Azure Portal
PowerShell

I Azure Portal går du till din Application Insights-resurs. Kopiera din anslutningssträng till Urklipp.
Gå till den virtuella datorn. Under avsnittet Inställningar på menyn till vänster väljer du Tillägg + program>Lägg till.
Välj Application Insights Agent>Nästa.
Klistra in en anslutningssträng du kopierade i steg 1 och välj Granska + skapa.

Anteckning

Är du ny på PowerShell? Kolla in kom igång-guiden.

Installera eller uppdatera Application Insights-agenten som ett tillägg för virtuella Azure-datorer:

# 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

Anteckning

Om du vill ha mer komplicerade distributioner i stor skala kan du använda en PowerShell-loop för att installera eller uppdatera Application Insights Agent-tillägget på flera virtuella datorer.

Fråga Application Insights Agent-tilläggets status för virtuella Azure-datorer:

Get-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name ApplicationMonitoringWindows -Status

Hämta en lista över installerade tillägg för virtuella Azure-datorer:

Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myVmResourceGroup>/providers/Microsoft.Compute/virtualMachines/<myVmName>/extensions"

Avinstallera Application Insights Agent-tillägget från virtuella Azure-datorer:

Remove-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name "ApplicationMonitoring"

Anteckning

Verifiera installationen genom att välja Live Metrics Stream i Application Insights-resursen som är associerad med anslutningssträng du använde för att distribuera Application Insights Agent-tillägget. Om du skickar data från flera virtuella datorer väljer du de virtuella Azure-måldatorerna under Servernamn. Det kan ta upp till en minut innan data börjar flöda.

instrumentationKeyMap (tilläggsinställningar)

Viktigt!

InstrumentationKeyMap är en avancerad routningsfunktion som mappar IIS-appar (Internet Information Services) på samma dator till Application Insights-resurser. Funktionen gäller för IIS-värdbaserade ASP.NET och ASP.NET Core-appar som Application Insights Agent automatiskt instrumenteras.

Så här fungerar matchning

Kartan definierar en ordnad lista med regler med namnet filters. Den första matchande regeln börjar gälla. Placera specifika regler först och avsluta med en catch-all-regel.
Varje regel kan tilldela en annan Application Insights-resurs till matchande appar. Föredrar anslutningssträngar i scenarier som stöds eftersom instrumentationsnycklar är äldre.

Tillgängliga filter

MachineFilter eller machineFilter: C#-reguljärt uttryck som matchar datorns eller den virtuella datorns (VM) namn. .* matchar alla namn.
AppFilter eller appFilter: C#-reguljärt uttryck som matchar IIS-webbplatsnamnet (HostingEnvironment.SiteName). Det här filtret krävs när VirtualPathFilter eller virtualPathFilter inte tillhandahålls.
VirtualPathFilter eller virtualPathFilter: C#-reguljärt uttryck som matchar den virtuella IIS-sökvägen (HostingEnvironment.ApplicationVirtualPath). Använd det här filtret för att rikta en enskild app under en webbplats.

Terminologimappning

PowerShell-cmdletar använder MachineFilter, AppFilteroch VirtualPathFilter.
Azure VM- och Virtual Machine Scale Sets-tillägget JSON använder machineFilter, appFilteroch virtualPathFilteroch anger resursen med instrumentationSettings.

Tips/Råd

Inkludera en slutlig regel som matchar alla appar, till exempel .*, och använd en standardresurs för att göra beteendet explicit.

Vart det går för tillägget VM och Vm Scale Sets

Placera kartan under redfieldConfiguration.instrumentationKeyMap.filters i tilläggets offentliga inställningar (-SettingString för virtuella datorer, -Setting för VM-skalningsuppsättningar). Egenskapsnamn är gemener. Ange målresursen per regel med instrumentationSettings.connectionString.

{
  "redfieldConfiguration": {
    "instrumentationKeyMap": {
      "filters": [
        {
          "machineFilter": ".*",
          "appFilter": ".*",
          "instrumentationSettings": {
            "connectionString": "<your-APPLICATIONINSIGHTS_CONNECTION_STRING>"
          }
        }
      ]
    }
  }
}

Aktivera övervakning för virtuella maskin skalningsuppsättningar

Du kan använda Azure-portalen eller PowerShell för att aktivera övervakning för virtuella datorers skalningsuppsättningar.

Azure Portal
PowerShell

Följ de föregående stegen för virtuella datorer, men gå till dina virtuella maskiners skalningsgrupper istället för den virtuella datorn.

Installera eller uppdatera Application Insights-agenten som ett tillägg för VM-skalningsuppsättningar:

# 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

Hämta en lista över installerade tillägg för skalmaskinuppsättningar:

Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/<myVmssName>/extensions"

Avinstallera tillägget för applikationsövervakning från virtuella maskinskalningsuppsättningar:

# 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

Felsökning

Dedikerade felsökningssteg finns i Problem med att distribuera Application Insights Monitoring Agent-tillägget för virtuella datorer och vm-skalningsuppsättningar.

Viktig information

2.8.44

Application Insights .NET/.NET Core SDK har uppdaterats till 2.20.1 – rött fält.
Aktiverad SQL-frågesamling.
Stöd för Microsoft Entra-autentisering har aktiverats.

2.8.42

Application Insights .NET/.NET Core SDK har uppdaterats till 2.18.1 – rött fält.

2.8.41

Funktionen ASP.NET Core autoinstrumentation har lagts till.

Nästa steg

För att granska vanliga frågor (FAQ) se Vanliga frågor och svar om Application Insights för virtuella Azure-datorer och skalningsuppsättningar för virtuella datorer
Distribuera ditt program på VM-skalningsuppsättningar.
Tillgänglighetstest för Application Insights
Övervaka vm-gästdata

Feedback

Var den här sidan till hjälp?

Dela via

Application Insights för virtuella Azure-datorer (VM) och virtuella datorers skalningsuppsättningar

Förutsättningar

Aktivera övervakning för virtuella datorer

instrumentationKeyMap (tilläggsinställningar)

Aktivera övervakning för virtuella maskin skalningsuppsättningar

Felsökning

Viktig information

2.8.44

2.8.42

2.8.41

Nästa steg

Feedback

Ytterligare resurser