Włączanie profilera 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 na maszynie wirtualnej platformy Azure lub zestawie skalowania maszyn wirtualnych platformy Azure przy użyciu trzech różnych metod:

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

W przypadku dowolnej z tych metod:

• Skonfiguruj rozszerzenie Diagnostyka Azure do uruchamiania profilera.
• Zainstaluj zestaw SDK usługi Application Insights na maszynie wirtualnej.
• Wdróż aplikację.
• Wyświetl ślady profilera za pośrednictwem wystąpienia usługi Application Insights w 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 (ARM) dla rozszerzenia Diagnostyka Azure:
  • VM
  • Zestaw skalowania maszyn wirtualnych

Dodawanie zestawu SDK usługi Application Insights do aplikacji

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

2. Wybierz pozycję ProjectAdd 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 parametrów 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 obszaru ProjectManage NuGet Packages (Zarządzanie pakietami NuGetw projekcie>).

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

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ą usługi Azure Resource Explorer.

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 elementu MyApplicationInsightsProfilerSink.

   "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 za pomocą następującego polecenia:

   (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 element może wymagać argumentu -StorageAccountName . Jeśli oryginalna konfiguracja diagnostyki zawierała storageAccountName właściwość w protectedSettings sekcji (która nie jest dostępna do pobrania), pamiętaj o przekazaniu tej samej oryginalnej wartości, która była w tym wywołaniu 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 ustanowienie 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ż Azure Portal nie zapewnia sposobu ustawiania ujścia profilera usługi Application Insights, 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 usługi Azure Resource Explorer.

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

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

      

3. Dodaj ujście profilera usługi Application Insights 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.

   • Wybierz pozycję Edytuj.

     

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

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

5. W przypadku powodzenia put zielony znacznik wyboru pojawi się na środku ekranu.

   

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

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

Następne kroki

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