Application Insights voor virtuele Azure-machines en virtuele-machineschaalsets

In dit artikel wordt uitgelegd hoe u Azure MonitorApplication Insights-bewaking inschakelt via automatische instrumentatie voor door IIS gehoste ASP.NET- en ASP.NET Core-toepassingen in Azure Virtual Machines en Virtuele-machineschaalsets van Azure. Hierin wordt beschreven hoe u de Application Insights-agent implementeert met behulp van een virtuele-machineextensie, die dezelfde afhankelijkheidssignalen als de SDK automatisch opslaat en richtlijnen biedt voor het automatiseren van grootschalige implementaties met PowerShell.

Notitie

• Gebruik voor Java-toepassingen de Application Insights Java 3.0-agent, waarmee de populairste bibliotheken, frameworks, logboeken en afhankelijkheden automatisch worden opgehaald , samen met vele andere configuraties.
• Node.js en Python-toepassingen die worden uitgevoerd op Azure-VM's en Virtuele-machineschaalsets van Azure bieden geen ondersteuning voor automatische instrumentatie. Gebruik in plaats daarvan de Azure Monitor OpenTelemetry Distro .
• Als u VM-gasten wilt bewaken naast de toepassingen die erop worden gehost, raadpleegt u VM-gastgegevens.

Zie Ondersteunde omgevingen, talen en resourceproviders voor een volledige lijst met ondersteunde auto-instrumentatiescenario's.

Vereiste voorwaarden

Voordat u de Application Insights Agent-extensie installeert, hebt u een verbindingsreeks nodig. Maak een nieuwe Application Insights-resource of kopieer de verbindingsreeks van een bestaande.

Bewaking voor virtuele machines inschakelen

U kunt Azure Portal of PowerShell gebruiken om bewaking voor VM's in te schakelen.

Azure-portal

1. Ga in Azure Portal naar uw Application Insights-resource. Kopieer uw verbindingsreeks naar het klembord.

   

2. Ga naar uw virtuele machine. Selecteer onder de sectie Instellingen in het menu aan de linkerkant Extensies + toepassingen>Toevoegen.

   

3. Selecteer Application Insights-agent>.

   

4. Plak de verbindingsreeks die u in stap 1 hebt gekopieerd en selecteer Beoordelen en maken.

   

PowerShell

Notitie

Nieuw in PowerShell? Bekijk de Aan de slag-gids.

De Application Insights-agent installeren of bijwerken als een extensie voor virtuele Azure-machines:

# 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

Notitie

Voor complexere implementaties op schaal kunt u een PowerShell-lus gebruiken om de Application Insights Agent-extensie op meerdere VM's te installeren of bij te werken.

Voer een query uit voor de extensiestatus van de Application Insights-agent voor virtuele Azure-machines:

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

Een lijst met geïnstalleerde extensies voor virtuele Azure-machines ophalen:

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

Verwijder de Application Insights Agent-extensie van virtuele Azure-machines:

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

Notitie

Controleer de installatie door Live Metrics Stream te selecteren in de Application Insights-resource die is gekoppeld aan de verbindingsreeks die u hebt gebruikt om de Application Insights Agent-extensie te implementeren. Als u gegevens van meerdere virtuele machines verzendt, selecteert u de doel-azure-VM's onder Servernaam. Het kan tot een minuut duren voordat gegevens worden gestroomd.

Monitoring voor virtuele machineschaalsets inschakelen

U kunt Azure Portal of PowerShell gebruiken om bewaking voor virtuele-machineschaalsets in te schakelen.

Azure-portal

Volg de voorgaande stappen voor VM's, maar ga naar uw schaalsets voor virtuele machines in plaats van uw VM.

PowerShell

Application Insights-agent installeren of bijwerken als extensie voor virtuele-machineschaalsets:

# 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

Een lijst met geïnstalleerde extensies voor virtuele-machineschaalsets ophalen:

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

Verwijder de extensie voor toepassingsbewaking uit virtuele-machineschaalsets:

# 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

Probleemoplossing

Zoek tips voor probleemoplossing voor de Application Insights Monitoring Agent-extensie voor .NET-toepassingen die worden uitgevoerd op virtuele Azure-machines en virtuele-machineschaalsets.

Als u problemen ondervindt bij het implementeren van de extensie, controleert u de uitvoer van de uitvoering die is vastgelegd in bestanden in de volgende mappen:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.ApplicationMonitoringWindows\<version>\

Als uw extensie succesvol is geïmplementeerd maar u geen telemetrie ziet, kan dit een van de volgende problemen zijn die worden behandeld in problemen met agents oplossen.

• Conflicterende DLL's in de bin-map van een app
• Conflict met gedeelde IIS-configuratie

Connectiviteit testen tussen uw toepassingshost en de opnameservice

Application Insights SDK's en agenten verzenden telemetrie die als REST-aanroepen naar onze verwerkings-eindpunten wordt gestuurd. U kunt de connectiviteit vanaf uw webserver of applicatiehost testen op de service-eindpunten voor opname met behulp van rauwe REST-clients zoals PowerShell- of curl-opdrachten. Zie Problemen met ontbrekende toepassingstelemetrie oplossen in Azure Monitor Application Insights.

Opmerkingen bij de release

2.8.44

• Application Insights .NET/.NET Core SDK bijgewerkt naar 2.20.1 - rood veld.
• Sql-queryverzameling is ingeschakeld.
• Ondersteuning ingeschakeld voor Microsoft Entra-verificatie.

2.8.42

Application Insights .NET/.NET Core SDK bijgewerkt naar 2.18.1 - rood veld.

2.8.41

ASP.NET Core autoinstrumentatiefunctie toegevoegd.

Volgende stappen

• Als u veelgestelde vragen (FAQ) wilt bekijken, raadpleegt u Application Insights voor azure-VM's en veelgestelde vragen over virtuele-machineschaalsets
• Implementeer uw toepassing op Virtuele Machine Schaalsets.
• Beschikbaarheidstests voor Application Insights
• VM-gastgegevens bewaken