Включение Profiler для веб-приложений на виртуальной машине Azure

Статья
06/03/2024

Примечание.

Мы рекомендуем использовать модуль Azure Az PowerShell для взаимодействия с Azure. Сведения о начале работы см. в статье "Установка Azure PowerShell". Дополнительные сведения см. в статье Перенос Azure PowerShell с AzureRM на Az.

Из этой статьи вы узнаете, как запустить приложение Аналитика Profiler на виртуальной машине Azure или масштабируемом наборе виртуальных машин Azure с помощью трех различных методов:

Visual Studio и Azure Resource Manager
PowerShell
Обозреватель ресурсов Azure

С помощью любого из этих методов вы:

Настроить расширение Диагностики Azure для запуска Profiler.
Установите пакет SDK для приложения Аналитика на виртуальной машине.
Разверните приложение.
Просмотр трассировок профилировщика через экземпляр Приложения Аналитика в портал Azure.

Необходимые компоненты

Работающее приложение ASP.NET Core.
Получение ресурса Application Insights.
Чтобы просмотреть шаблоны Azure Resource Manager (шаблоны ARM) для расширения Диагностика Azure:
- Виртуальная машина
- Масштабируемый набор виртуальных машин

Добавление пакета SDK Аналитика приложения в приложение

В Visual Studio откройте проект ASP.NET Core.
Выберите Проект>Добавить телеметрию Application Insights.
Выберите приложение Azure Аналитика> Next.
Выберите подписку, в которой находится ресурс приложения Аналитика, и нажмите кнопку "Далее".
Выберите место для сохранения строка подключения и нажмите кнопку "Далее".
Нажмите Готово.

Примечание.

Полные инструкции, включая включение Аналитика приложений в приложении ASP.NET Core без Visual Studio, см. в Аналитика приложениях ASP.NET Core.

Подтвердите последний стабильный выпуск пакета SDK для Application Insights

Перейдите в раздел Проект>Управление пакетами NuGet.
Выберите Microsoft.ApplicationInsights.AspNetCore.
На боковой панели выберите последнюю версию пакета SDK в раскрывающемся списке.
Выберите Обновить.

Включение Profiler

Профилировщик можно включить любым из трех способов:

В приложении ASP.NET Core с помощью шаблона Azure Resource Manager и Visual Studio. Рекомендуется.
С помощью команды PowerShell с помощью Azure CLI.
С помощью Обозреватель ресурсов Azure.

Установка расширения "Диагностика Azure"

Выберите используемый шаблон ARM:
- Виртуальная машина
- Масштабируемый набор виртуальных машин
В шаблоне найдите ресурс типа extension.
В Visual Studio перейдите к файлу arm.json в приложении ASP.NET Core, добавленном при установке пакета SDK для приложений Аналитика.
Добавьте тип ресурса extension из шаблона в файл arm.json, чтобы настроить виртуальную машину или масштабируемый набор виртуальных машин с Диагностикой Azure.

В теге WadCfg добавьте ключ MyApplicationInsightsProfilerSinkинструментирования приложения Аналитика.

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

Разверните приложение.

Для существующих виртуальных машин используются следующие команды PowerShell, которые касаются только расширения "Диагностика Azure".

Примечание.

Если вы развернете виртуальную машину повторно, приемник будет утерян. Необходимо обновить конфигурацию, используемую при развертывании виртуальной машины, чтобы сохранить этот параметр.

Установка приложения Аналитика с помощью конфигурации Диагностика Azure

Экспортируйте развернутую конфигурацию Диагностики Azure в файл:
```
$ConfigFilePath = [IO.Path]::GetTempFileName()
```

Добавьте приемник Application Insights Profiler в возвращенную конфигурацию следующей командой:

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

Application Insights Profiler WadCfg:

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

Выполните следующую команду, чтобы передать обновленную конфигурацию команде Set-AzVMDiagnosticsExtension.
```
Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
```
Примечание.

Set-AzVMDiagnosticsExtension может потребоваться аргумент -StorageAccountName. Если исходная конфигурация диагностики имела свойство storageAccountName в разделе protectedSettings (который не может быть загружен), обязательно передайте то же исходное значение, которое было в этом вызове командлета.

Функция трассировки HTTP в IIS

Если нужное приложение выполняется с помощью IIS, необходимо включить компонент Windows IIS Http Tracing:

Установите удаленный доступ к среде.
Используйте окно Добавить функции Windows или выполните следующую команду в PowerShell (с правами администратора):
```
Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All
```
Если не удается установить удаленный доступ, можно использовать Azure CLI, чтобы выполнить следующую команду:
```
az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"
```
Разверните приложение.

Настройка приемника Профилировщика с помощью Azure Resource Обозреватель

Так как портал Azure не предоставляет способ задания приемника Application Аналитика Profiler, можно использовать Обозреватель ресурсов Azure для задания приемника.

Примечание.

Убедитесь, что расширение Microsoft Диагностика Azure установлено, просмотрев расширения, установленные для виртуальной машины.
Найдите расширение диагностики виртуальной машины:
1. Перейдите к Обозреватель ресурсов Azure.
2. Разверните подписки и найдите подписку, содержащую группу ресурсов с виртуальной машиной.
3. Выполните детализацию до расширений виртуальной машины, выбрав группу ресурсов. Затем выберите расширения Microsoft.Compute>virtualMachines>[ваша виртуальная машина].>
Добавьте приемник Профилировщика приложения Аналитика в SinksConfig узел.WadCfg Если у вас еще нет SinksConfig раздела, может потребоваться добавить его. Чтобы добавить приемник:
- Укажите в настройках правильный iKey Application Insights.
- Переключите режим Обозреватель на чтение и запись в правом верхнем углу.
- Выберите Изменить.
```
"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}        
```
После завершения редактирования конфигурации нажмите кнопку PUT.
В случае успешного put выполнения зеленый проверка появляется в середине экрана.