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

Статья
09/22/2023

Примечание

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

Из этой статьи вы узнаете, как запустить Application Insights Profiler на виртуальной машине Azure или масштабируемом наборе виртуальных машин Azure тремя разными способами:

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

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

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

Предварительные требования

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

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

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

Примечание

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

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

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

Включение Profiler

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

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

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

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

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

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

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

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

Примечание

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

Установка Application Insights с помощью конфигурации Диагностика 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"
```
Разверните приложение.

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

Так как портал Azure не предоставляет способ настройки приемника Application Insights Profiler, вы можете использовать azure Resource Обозреватель для задания приемника.

Примечание

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