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. Aby rozpocząć, zobacz Instalowanie programu Azure PowerShell. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az programu PowerShell, zobacz Migrowanie 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 instancji Application Insights w portalu Azure.

Uwaga

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

Wymagania wstępne

• Działająca aplikacja ASP.NET Core.
• Zasób usługi Application Insights.
• Aby przejrzeć szablony Azure Resource Manager (szablony 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 Project>Dodaj telemetrię usługi Application Insights.

3. Wybierz pozycję Azure Application Insights>Dalej.

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

5. Wybierz, gdzie zapisać parametry połączenia, a następnie wybierz przycisk Dalej.

6. Wybierz pozycję 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 ASP.NET Core).

Potwierdzanie najnowszej stabilnej wersji zestawu SDK usługi Application Insights

1. Przejdź do Project>Zarządzanie pakietami NuGet.

2. Wybierz pozycję Microsoft.ApplicationInsights.AspNetCore.

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

4. Wybierz pozycję 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.

Visual Studio i szablon ARM

Instalowanie rozszerzenia Diagnostyka Azure

1. Wybierz szablon ARM do użycia.

   • VM
   • Zestaw skalowania maszyn wirtualnych

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

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

4. Dodaj z szablonu typ zasobu extension do pliku arm.json, aby skonfigurować maszynę wirtualną lub zestaw skalowania maszyn wirtualnych za pomocą Azure Diagnostics.

5. W tagu WadCfg dodaj parametry połączenia usługi Application Insights do MyApplicationInsightsProfilerSink.

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

6. Wdróż aplikację.

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ą, odsysacz zostanie utracony. Aby zachować to ustawienie, należy zaktualizować konfigurację używaną podczas wdrażania maszyny wirtualnej.

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

1. Wyeksportuj obecnie wdrożoną konfigurację diagnostyki Azure 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
   

   Application Insights ProfilerWadCfg:

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

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

   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 właściwość storageAccountName w sekcji protectedSettings, której nie można pobrać, upewnij się, że przekażesz tę samą oryginalną wartość podczas wywołania tego polecenia cmdlet.

Funkcja Http Tracing systemu IIS

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

1. Skonfiguruj 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 platformy 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ą, odsysacz zostanie utracony. Aby zachować to ustawienie, należy zaktualizować konfigurację używaną podczas wdrażania maszyny wirtualnej.

1. Sprawdź, czy rozszerzenie Microsoft Diagnostyki Azure jest zainstalowane, przeglądając zainstalowane rozszerzenia na maszynie wirtualnej.

   

2. Znajdź rozszerzenie diagnostyczne dla swojej maszyny wirtualnej.

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

   2. Rozwiń subskrypcje i znajdź subskrypcję, która zawiera grupę zasobów, która zawiera twoją 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ć zlew:

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

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

   • Wybierz pozycję 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 haczyk.

   

Następne kroki

Generowanie obciążenia i wyświetlanie śledzeń profilera .NET