Usługa Application Insights dla maszyn wirtualnych platformy Azure i zestawów skalowania maszyn wirtualnych

W tym artykule wyjaśniono, jak włączyć monitorowanie Azure MonitorApplication Insights za pomocą automatycznej instrumentacji dla aplikacji ASP.NET i ASP.NET Core hostowanych przez usługi IIS na Azure Virtual Machines i Azure Virtual Machine Scale Sets. Opisano w nim sposób wdrażania agenta usługi Application Insights przy użyciu rozszerzenia maszyny wirtualnej, które automatycznie tworzy te same sygnały zależności co zestaw SDK, oraz zawiera wskazówki dotyczące automatyzowania wdrożeń na dużą skalę za pomocą programu PowerShell.

Uwaga

• W przypadku aplikacji Java użyj agenta Java 3.0 usługi Application Insights, który automatycznie generuje najpopularniejsze biblioteki, struktury, dzienniki i zależności, wraz z wieloma innymi konfiguracjami.
• Node.js i aplikacje języka Python działające na maszynach wirtualnych platformy Azure i w zestawach skalowania maszyn wirtualnych platformy Azure nie obsługują automatycznegoinstrumentacji. Zamiast tego użyj Azure Monitor OpenTelemetry Distro.
• Aby monitorować gości maszyn wirtualnych oprócz aplikacji hostowanych na nich, zobacz Dane gościa maszyny wirtualnej.

Aby uzyskać pełną listę obsługiwanych scenariuszy automatycznego instrumentacji, zobacz Obsługiwane środowiska, języki i dostawcy zasobów.

Wymagania wstępne

Przed zainstalowaniem rozszerzenia agenta usługi Application Insights potrzebne są parametry połączenia. Utwórz nowy zasób usługi Application Insights lub skopiuj parametry połączenia z istniejącego zasobu.

Włączanie monitorowania maszyn wirtualnych

Aby włączyć monitorowanie maszyn wirtualnych, możesz użyć witryny Azure Portal lub programu PowerShell.

Portal Azure

1. W witrynie Azure Portal przejdź do zasobu usługi Application Insights. Skopiuj parametry połączenia do schowka.

   

2. Przejdź do swojej maszyny wirtualnej. W sekcji Ustawienia w menu po lewej stronie wybierz pozycję Rozszerzenia i aplikacje>Dodaj.

   

3. Wybierz opcję Agent usługi Application Insights>Dalej.

   

4. Wklej parametry połączenia skopiowane w kroku 1 i wybierz pozycję Przejrzyj i utwórz.

   

PowerShell

Uwaga

Dopiero zaczynasz korzystać z programu PowerShell? Zapoznaj się z przewodnikiem Wprowadzenie.

Zainstaluj lub zaktualizuj agenta usługi Application Insights jako rozszerzenie dla maszyn wirtualnych platformy Azure:

# 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

Uwaga

W przypadku bardziej skomplikowanych wdrożeń na dużą skalę można użyć pętli programu PowerShell do zainstalowania lub zaktualizowania rozszerzenia agenta usługi Application Insights na wielu maszynach wirtualnych.

Wykonaj zapytanie dotyczące stanu rozszerzenia agenta usługi Application Insights dla maszyn wirtualnych platformy Azure:

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

Pobierz listę zainstalowanych rozszerzeń dla maszyn wirtualnych platformy Azure:

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

Odinstaluj rozszerzenie agenta usługi Application Insights z maszyn wirtualnych platformy Azure:

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

Uwaga

Zweryfikuj instalację, wybierając Strumień Metryk na Żywo w zasobie usługi Application Insights skojarzonym z ciągiem połączenia użytym do wdrożenia rozszerzenia agenta Application Insights. Jeśli wysyłasz dane z wielu maszyn wirtualnych, wybierz docelową maszynę wirtualną platformy Azure w obszarze Nazwa serwera. Rozpoczęcie przepływu danych może potrwać do minuty.

Włącz monitorowanie dla skalowalnych zestawów maszyn wirtualnych

Aby włączyć monitorowanie zestawów skalowania maszyn wirtualnych, można użyć witryny Azure Portal lub programu PowerShell.

Portal Azure

Wykonaj poprzednie kroki dla maszyn wirtualnych, ale przejdź do zestawów skalowania maszyn wirtualnych zamiast maszyny wirtualnej.

PowerShell

Zainstaluj lub zaktualizuj agenta usługi Application Insights jako rozszerzenie dla zestawów skalowania maszyn wirtualnych:

# 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

Pobierz listę zainstalowanych rozszerzeń dla zestawów skalowania maszyn wirtualnych:

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

Odinstaluj rozszerzenie monitorowania aplikacji z zestawów skalowania maszyn wirtualnych:

# 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

Najczęściej zadawane pytania

Jak wyłączyć monitorowanie po stronie klienta dla aplikacji ASP.NET Core?

Monitorowanie po stronie klienta jest domyślnie włączone dla aplikacji ASP.NET Core. Jeśli chcesz go wyłączyć, zdefiniuj zmienną środowiskową na serwerze przy użyciu następujących informacji:

• Nazwa:APPINSIGHTS_JAVASCRIPT_ENABLED
• Wartość:false

Rozwiązywanie problemów

Znajdź porady dotyczące rozwiązywania problemów z rozszerzeniem agenta monitorowania usługi Application Insights dla aplikacji platformy .NET uruchomionych na maszynach wirtualnych platformy Azure i zestawach skalowania maszyn wirtualnych.

Jeśli masz problemy z wdrożeniem rozszerzenia, przejrzyj dane wyjściowe wykonywania zarejestrowane w plikach znajdujących się w następujących katalogach:

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

Jeśli rozszerzenie zostało wdrożone pomyślnie, ale nie widzisz telemetrii, może to być jeden z następujących problemów opisanych w temacie Rozwiązywanie problemów z agentem:

• Konfliktowe biblioteki DLL w folderze bin aplikacji
• Konflikt z wspólną konfiguracją IIS

Testowanie łączności między hostem aplikacji a usługą pozyskiwania

Zestawy SDK i agenci usługi Application Insights wysyłają dane telemetryczne, które są przetwarzane jako wywołania REST do naszych punktów końcowych pozyskiwania. Możesz przetestować łączność z serwera internetowego lub maszyny hosta aplikacji do punktów końcowych usługi pozyskiwania przy użyciu pierwotnych klientów REST z poziomu programu PowerShell lub poleceń curl. Zobacz Rozwiązywanie problemów z brakującą telemetrią aplikacji w usłudze Azure Monitor Application Insights.

Informacje o wersji

2.8.44

• Zaktualizowano zestaw SDK .NET/.NET Core do wersji 2.20.1 w ramach usługi Application Insights – pole oznaczone na czerwono.
• Włączono zbieranie zapytań SQL.
• Włączono obsługę uwierzytelniania Microsoft Entra.

2.8.42

Zaktualizowano SDK usługi Application Insights dla .NET/.NET Core do wersji 2.18.1 - czerwone pole.

2.8.41

Dodano funkcję automatycznej instrumentacji ASP.NET Core.

Następne kroki

• Wdróż aplikację w usłudze Virtual Machine Scale Sets.
• Testy dostępności usługi Application Insights
• Monitorowanie danych gościa maszyny wirtualnej