Включение отладчика моментальных снимков для приложений .NET в Службе приложений Azure

Отладчик моментальных снимков в настоящее время поддерживает приложения ASP.NET и ASP.NET Core, работающие на службе приложений Azure в рамках тарифных планов Windows.

Примечание.

Если вы используете предварительную версию .NET Core или приложение ссылается на пакет SDK Application Insights напрямую или косвенно с помощью зависимой сборки, следуйте инструкциям для включения отладчика моментальных снимков для других сред , чтобы включить Microsoft.ApplicationInsights.SnapshotCollector пакет NuGet с приложением.

При использовании отладчика моментальных снимков рекомендуется запустить приложение на уровнях служб "Базовый" или выше. Для большинства приложений:

Уровни бесплатных и общих служб не имеют достаточного объема памяти или дискового пространства для сохранения моментальных снимков.
Уровень потребления в настоящее время недоступен для отладчика моментальных снимков.

Хотя отладчик моментальных снимков предварительно установлен в рамках Среды выполнения Службы приложений, его необходимо включить, чтобы получить моментальные снимки для приложения службы приложений. Без необходимости написания кода установка отладчика для моментальных снимков осуществляется в соответствии с политикой поддержки .NET Core.

Портал Azure
Azure Resource Manager

Вы можете включить отладчик моментальных снимков в портал Azure после развертывания веб-приложения .NET Служба приложений s.

Перейдите к веб-приложению служб приложений на портале Azure.
В меню слева выберите "Мониторинг>Application Insights".
Выберите "Включить Application Insights".

Если у вас есть существующий ресурс Application Insights, который вы хотите использовать, выберите этот параметр в разделе "Изменить ресурс".
В разделе "Инструментирование приложения" выберите .NET.
Переключите оба отладчика моментальных снимков в положение «Вкл».
Отладчик моментальных снимков теперь включен.

Отключить Snapshot Debugger

Чтобы отключить отладчик моментальных снимков для ресурса Службы приложений:

Перейдите к App Service в портале Azure.
В меню слева выберите "Мониторинг>Application Insights".
Переключите переключатель отладчика моментальных снимков в положение "Отключить".

Вы также можете включить отладчик моментальных снимков и профилировщик .NET с помощью параметров приложения в шаблоне Azure Resource Manager. Например:

{
  "apiVersion": "2023-12-01",
  "name": "[parameters('webSiteName')]",
  "type": "Microsoft.Web/sites",
  "location": "[resourceGroup().location]",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  "tags": { 
    "[concat('hidden-related:', resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName')))]": "empty",
    "displayName": "Website"
  },
  "properties": {
    "name": "[parameters('webSiteName')]",
    "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName'))]"
  },
  "resources": [
    {
      "apiVersion": "2015-08-01",
      "name": "appsettings",
      "type": "config",
      "dependsOn": [
        "[parameters('webSiteName')]",
        "[concat('AppInsights', parameters('webSiteName'))]"
      ],
      "properties": {
        "APPINSIGHTS_INSTRUMENTATIONKEY": "[reference(resourceId('Microsoft.Insights/components', concat('AppInsights', parameters('webSiteName'))), '2014-04-01').InstrumentationKey]",
        // "Turn on" a Snapshot Debugger version
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

Создайте трафик для вашего приложения, который может вызвать исключение. После этого подождите 10–15 минут, пока снимки не будут отправлены в экземпляр Application Insights.

Включение отладчика моментальных снимков для других облачных регионов

В настоящее время единственными регионами, которым требуются изменения конечных точек, являются Azure для государственных организаций и Microsoft Azure, управляемые 21Vianet через строку подключения Application Insights.

Свойство строки подключения	Облако для государственных организаций США	облако для Китая.
СнэпшотЭндпоинт	`https://snapshot.monitor.azure.us`	`https://snapshot.monitor.azure.cn`

Дополнительные сведения о других переопределениях подключения см. в Документации по Application Insights.

Настройка Snapshot Debugger

Включите аутентификацию Microsoft Entra для импорта моментальных снимков

Отладчик моментальных снимков поддерживает аутентификацию Microsoft Entra для включения моментальных снимков. Для приема всех моментальных снимков приложения необходимо пройти проверку подлинности и указать необходимые параметры приложения агенту отладчика моментальных снимков.

Примечание.

В настоящее время отладчик моментальных снимков поддерживает аутентификацию Microsoft Entra только при ссылке и настройке Microsoft Entra ID с помощью SDK Application Insights в вашем приложении.

Добавьте управляемое удостоверение, которое проходит проверку подлинности в ресурсе Application Insights в Службе приложений. Вы можете создать любой из следующих вариантов:
- Системно назначаемое управляемое удостоверение личности.
- Управляемое удостоверение, назначаемое пользователем.
На портале Azure настройте и включите идентификатор Microsoft Entra в ресурсе Application Insights.

Добавьте следующий параметр приложения. Этот параметр сообщает агенту Snapshot Debugger, какое управляемое удостоверение использовать.

Для автоматически назначаемой системой идентичности:

Настройки приложения	Значение
Строка аутентификации ApplicationInsights	Authorization=AD

Для назначаемого пользователем удостоверения:

Параметр приложения	Значение
Строка аутентификации ApplicationInsights	Authorization=AD; ClientID={Идентификатор клиента назначаемого пользователем удостоверения}

Неподдерживаемые сценарии

В следующем сценарии показано, где сборщик моментальных снимков не поддерживается.

Сценарий	Побочные эффекты	Рекомендация
Вы используете SDK для сборщика моментальных снимков в приложении напрямую (.csproj) и включили расширенный параметр Interop.	Локальный пакет SDK Application Insights, включая телеметрию коллектора моментальных снимков, утерян, поэтому моментальные снимки недоступны. Приложение может аварийно завершить работу при запуске с ошибкой `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.` Для получения дополнительной информации о функции Application Insights, подробности см. в разделе "Устранение неполадок интеграции Application Insights".	Если вы используете расширенную опцию Interop, используйте интеграцию без кода сборщика снимков, включаемую через портал Azure.

Просмотр моментальные снимки в портале Azure.
Устранение неполадок с отладчиком снапшотов.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-19