Włączanie programu .NET Profiler dla aplikacji internetowych na maszynie wirtualnej platformy Azure

Uwaga

Do interakcji z platformą Azure zalecamy używanie modułu Azure Az w programie PowerShell. Zobacz Instalowanie programu Azure PowerShell, aby rozpocząć. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Z tego artykułu dowiesz się, jak uruchomić narzędzie Application Insights Profiler dla platformy .NET na maszynie wirtualnej platformy Azure lub w zestawie skalowania maszyn wirtualnych platformy Azure za pomocą trzech różnych metod:

• Program Visual Studio i usługa Azure Resource Manager
• PowerShell
• Eksplorator zasobów Azure

Wybierz kartę preferowanej metody, aby:

Niniejszy przewodnik zawiera informacje na temat wykonywania następujących czynności:

• Skonfiguruj rozszerzenie Diagnostyka Azure, aby uruchomić program .NET Profiler.
• Zainstaluj zestaw SDK usługi Application Insights na maszynie wirtualnej.
• Wdróż aplikację.
• Wyświetlanie śladów profilera za pośrednictwem wystąpienia usługi Application Insights w witrynie Azure Portal.

Wymagania wstępne

• Działająca aplikacja ASP.NET Core.
• Zasób usługi Application Insights.
• Aby przejrzeć szablony usługi Azure Resource Manager (szablony usługi ARM) dla rozszerzenia Diagnostyka Azure:
  • VM
  • Zestaw skalowania maszyn wirtualnych

Dodawanie zestawu SDK usługi Application Insights do aplikacji

1. Otwórz projekt ASP.NET core w programie Visual Studio.

2. Wybierz pozycję Project Add Application Insights Telemetry (Dodaj>telemetrię usługi Application Insights).

3. Wybierz pozycję aplikacja systemu Azure Insights>Next (Dalej).

4. Wybierz subskrypcję, w której znajduje się zasób usługi Application Insights, a następnie wybierz pozycję Dalej.

5. Wybierz miejsce zapisania parametry połączenia i wybierz przycisk Dalej.

6. Wybierz Zakończ.

Uwaga

Aby uzyskać pełne instrukcje, w tym sposób włączania usługi Application Insights w aplikacji ASP.NET Core bez programu Visual Studio, zobacz application insights for ASP.NET Core applications (Usługa Application Insights dla aplikacji platformy ASP.NET Core).

Potwierdzanie najnowszej stabilnej wersji zestawu SDK usługi Application Insights

1. Przejdź do pozycji Project Manage NuGet Packages (Zarządzanie pakietami NuGet w projekcie).>

2. Wybierz pozycję Microsoft.ApplicationInsights.AspNetCore.

3. W okienku bocznym wybierz najnowszą wersję zestawu SDK z listy rozwijanej.

4. Wybierz Aktualizuj.

   

Włączanie profilera platformy .NET

Profiler można włączyć na dowolny z trzech sposobów:

• W aplikacji ASP.NET Core przy użyciu szablonu usługi Azure Resource Manager i programu Visual Studio. Zalecane.
• Za pomocą polecenia programu PowerShell za pośrednictwem interfejsu wiersza polecenia platformy Azure.
• Za pomocą eksploratora zasobów platformy Azure.

Szablon programu Visual Studio i usługi ARM

Instalowanie rozszerzenia Diagnostyka Azure

1. Wybierz szablon usługi ARM do użycia:

   • VM
   • Zestaw skalowania maszyn wirtualnych

2. W szablonie znajdź zasób typu extension.

3. W programie Visual Studio przejdź do arm.json pliku w aplikacji ASP.NET Core, która została dodana podczas instalowania zestawu SDK usługi Application Insights.

4. Dodaj typ extension zasobu z szablonu do arm.json pliku, aby skonfigurować maszynę wirtualną lub zestaw skalowania maszyn wirtualnych przy użyciu Diagnostyka Azure.

5. W tagu WadCfg dodaj klucz instrumentacji usługi Application Insights do MyApplicationInsightsProfilerSinkelementu .

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

6. Wdróż aplikację.

Program PowerShell

Następujące polecenia programu PowerShell są podejściem do istniejących maszyn wirtualnych, które dotykają tylko rozszerzenia Diagnostyka Azure.

Uwaga

Jeśli ponownie wdrożysz maszynę wirtualną, ujście zostanie utracone. Aby zachować to ustawienie, należy zaktualizować konfigurację używaną podczas wdrażania maszyny wirtualnej.

Instalowanie usługi Application Insights za pośrednictwem konfiguracji Diagnostyka Azure

1. Wyeksportuj aktualnie wdrożony Diagnostyka Azure konfiguracji do pliku:

   $ConfigFilePath = [IO.Path]::GetTempFileName()
   

2. Dodaj ujście profilera usługi Application Insights do konfiguracji zwróconej przez następujące polecenie:

   (Get-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM").PublicSettings | Out-File -Verbose $ConfigFilePath
   

   Profiler WadCfgusługi Application Insights:

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

3. Uruchom następujące polecenie, aby przekazać zaktualizowaną konfigurację Set-AzVMDiagnosticsExtension do polecenia .

   Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
   

   Uwaga

   Set-AzVMDiagnosticsExtension może wymagać argumentu -StorageAccountName . Jeśli oryginalna konfiguracja diagnostyki miała storageAccountName właściwość w protectedSettings sekcji (która nie jest pobierana), pamiętaj, aby przekazać tę samą oryginalną wartość wywołania polecenia cmdlet.

Funkcja śledzenia http usług IIS

Jeśli aplikacja przeznaczona działa za pośrednictwem usług IIS, włącz funkcję systemu IIS Http Tracing Windows:

1. Ustanów zdalny dostęp do środowiska.

2. Użyj okna Dodawanie funkcji systemu Windows lub uruchom następujące polecenie w programie PowerShell (jako administrator):

   Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All
   

   Jeśli nawiązywanie dostępu zdalnego jest problemem, możesz użyć interfejsu wiersza polecenia platformy Azure, aby uruchomić następujące polecenie:

   az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"
   

3. Wdróż aplikację.

Eksplorator zasobów Azure

Ustawianie ujścia profilera przy użyciu eksploratora zasobów platformy Azure

Ponieważ witryna Azure Portal nie umożliwia ustawienia profilera usługi Application Insights dla ujścia platformy .NET, możesz ustawić ujście za pomocą Eksploratora zasobów platformy Azure.

Uwaga

Jeśli ponownie wdrożysz maszynę wirtualną, ujście zostanie utracone. Aby zachować to ustawienie, należy zaktualizować konfigurację używaną podczas wdrażania maszyny wirtualnej.

1. Sprawdź, czy rozszerzenie microsoft Diagnostyka Azure jest zainstalowane, wyświetlając rozszerzenia zainstalowane dla maszyny wirtualnej.

   

2. Znajdź rozszerzenie diagnostyki maszyny wirtualnej dla maszyny wirtualnej:

   1. Przejdź do eksploratora zasobów platformy Azure.

   2. Rozwiń subskrypcje i znajdź subskrypcję, która zawiera grupę zasobów z maszyną wirtualną.

   3. Przejdź do szczegółów rozszerzeń maszyn wirtualnych, wybierając grupę zasobów. Następnie wybierz pozycję Microsoft.Compute>virtualMachines>[twoja maszyna wirtualna]>rozszerzenia.

      

3. Dodaj profiler usługi Application Insights dla ujścia platformy .NET do węzła SinksConfig w obszarze WadCfg. Jeśli nie masz SinksConfig jeszcze sekcji, może być konieczne jej dodanie. Aby dodać ujście:

   • Określ odpowiedni klucz iKey usługi Application Insights w ustawieniach.

   • Przełącz tryb Eksploratora na odczyt/zapis w prawym górnym rogu.

   • Zaznacz Edytuj.

     

     "WadCfg": {
       "SinksConfig": {
         "Sink": [
           {
             "name": "MyApplicationInsightsProfilerSink",
             "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
           }
         ]
       }
     }        
     

4. Po zakończeniu edytowania konfiguracji wybierz pozycję PUT.

5. Jeśli pole put zakończy się pomyślnie, na środku ekranu pojawi się zielony znacznik wyboru.

   

Czy profiler platformy .NET może działać na serwerach lokalnych?

Obecnie profiler usługi Application Insights dla platformy .NET nie jest obsługiwany dla serwerów lokalnych.

Następne kroki

Generowanie obciążenia i wyświetlanie śladów profilera platformy .NET