Устранение неполадок, связанных с включением отладчика моментальных снимков Application Insights или просмотром моментальных снимков

Статья
11/05/2024

Если после включения Application Insights Snapshot Debugger для приложения вы все равно не видите моментальные снимки для исключений, воспользуйтесь этими инструкциями по устранению неполадок.

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

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

Сценарии, в которых сборщик моментальных снимков не поддерживается:

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

Убедитесь, что вы используете соответствующую конечную точку отладчика моментальных снимков

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

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

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

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

Для приложения-функции необходимо обновить host.json поддерживаемые переопределения:

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

Пример обновленной конечной host.json точки агента облака для государственных организаций США:

{
    "version": "2.0",
    "logging": {
        "applicationInsights": {
            "samplingExcludedTypes": "Request",
            "samplingSettings": {
                "isEnabled": true
            },
            "snapshotConfiguration": {
                "isEnabled": true,
                "agentEndpoint": "https://snapshot.monitor.azure.us"
            }
        }
    }
}

Использование проверки работоспособности моментальных снимков

Из-за некоторых распространенных проблем окно "Открыть моментальный снимок отладки" может не отображаться. Например, из-за использования устаревшего сборщика моментальных снимков, достижения ежедневного лимита отправки или длительного времени передачи моментального снимка. Для устранения распространенных неполадок можно использовать проверку работоспособности моментальных снимков.

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

Снимок экрана: вход в режим проверки работоспособности моментального снимка.

Интерактивный интерфейс, подобный чату, ищет распространенные проблемы и приводит инструкции по их устранению.

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

Если это не устранит проблему, воспользуйтесь следующими шагами по устранению неполадок вручную.

Проверка ключа инструментирования

Убедитесь, что в опубликованном приложении используется правильный ключ инструментирования. Как правило, ключ инструментирования считывается из файла ApplicationInsights.config. Убедитесь, что его значение такое же, что и у ключа инструментирования для ресурса Application Insights, который отображается на портале.

Примечание.

Поддержка приема ключей инструментирования будет завершена 31 марта 31, 2025 г. Прием ключей инструментирования будет и дальше осуществляться, но мы больше не будем предоставлять обновления или поддержку для этой функции. Перейдите на строки подключения, чтобы использовать новые возможности.

Проверка параметров клиента TLS/SSL (ASP.NET)

Если у вас есть приложение ASP.NET, размещенное в службе приложение Azure или службах IIS на виртуальной машине, приложение может не подключиться к службе отладчика моментальных снимков из-за отсутствия протокола безопасности SSL.

Для конечной точки snapshot Debugger требуется TLS версии 1.2. Набор протоколов безопасности SSL включается как параметр совместимости с помощью значения httpRuntime targetFramework в разделе system.web файла web.config. Если httpRuntime targetFramework имеет значение 4.5.2 или ниже, по умолчанию протокол TLS 1.2 не применяется.

Примечание.

Значение httpRuntime targetFramework не зависит от целевой платформы, используемой при сборке приложения.

Чтобы проверить этот параметр, откройте файл web.config и найдите раздел system.web. Убедитесь, что targetFramework для параметра httpRuntime задано значение 4.6 или более поздней версии.

<system.web>
    ...
    <httpRuntime targetFramework="4.7.2" />
    ...
</system.web>

Примечание.

Изменение значения httpRuntime targetFramework изменяет характеристики среды выполнения для приложения и может привести к другим незначительным изменениям в его работе. После внесения этого изменения обязательно тщательно протестируйте свое приложение. Полный список изменений совместимости см. здесь.

Примечание.

Если значение targetFramework равно 4.7 или выше, Windows определяет доступные протоколы. В Службе приложений Azure доступен протокол TLS 1.2. Однако при использовании собственной виртуальной машины может потребоваться дополнительно включить TLS 1.2 в ОС.

Сценарии накладных расходов отладчика моментальных снимков

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

Однако вы можете столкнуться с небольшими затратами на ЦП, память и ввод-вывод, связанные с отладчиком моментальных снимков, как в следующих сценариях.

При возникновении исключения в приложении:

Создание подписи для типа проблемы и выбор необходимости создания моментального снимка добавляет небольшую нагрузку на ЦП и память.
Если включена деоптимизация, есть издержки для повторного выполнения JITting метода, вызвавшего исключение. Это происходит при следующем выполнении метода. В зависимости от размера метода может быть от 1 мс до 100 мс времени ЦП.

Если обработчик исключений решит создать моментальный снимок:

Создание моментального снимка процесса занимает около половины секунды (P50 = 0,3 s, P90 = 1,2 s, P95 = 1,9 с), в течение которого поток, который бросил исключение, приостановлен. Другие потоки не блокируются.
Преобразование моментального снимка процесса в мини-dump и отправка его в Application Insights занимает несколько минут.
- Преобразование: P50 = 63 s, P90 = 187 s, P95 = 275 с.
- Отправка: P50 = 31 s, P90 = 75 с, P95 = 98 с.
Это делается в средство отправки моментальных снимков, которое выполняется в отдельном процессе. Процесс отправки моментальных снимков выполняется ниже обычного приоритета ЦП и использует низкоприоритетный ввод-вывод.

Мини-dump сначала записывается на диск, и объем дискового пространства примерно совпадает с рабочим набором исходного процесса. Написание мини-dump может вызвать сбои страниц, так как память считывается.

Мини-dump сжимается во время отправки, который потребляет как ЦП, так и память в процессе отправки моментальных снимков. Затраты на ЦП, память и диск пропорциональны размеру моментального снимка процесса. Средство отправки моментальных снимков последовательно обрабатывает моментальные снимки.

При TrackException вызове:

Отладчик моментальных снимков проверяет, является ли исключение новым или был ли для него создан моментальный снимок. Это добавляет небольшую нагрузку на ЦП.

Предварительные версии .NET Core

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

Проверка страницы состояния расширения сайта Служб диагностики

Если вы включили Snapshot Debugger с помощью панели Application Insights на портале, он был включен расширением веб-сайта Служб диагностики.

Примечание.

Установка отладчика моментальных снимков Application Insights без кода выполняется в соответствии с политикой поддержки .NET Core. Дополнительные сведения о поддерживаемых средах выполнения см. в политике поддержки .NET Core.

Страницу состояния этого расширения можно проверить по следующему URL-адресу: https://{site-name}.scm.azurewebsites.net/DiagnosticServices

Примечание.

Домен ссылки на страницу состояния будет зависеть от облака.

Этот домен совпадает с сайтом управления Kudu для Служба приложений. На странице состояния отображается состояние установки агентов профилировщика и сборщика моментальных снимков .NET. Если произошла непредвиденная ошибка, показано, как исправить ее.

Чтобы получить базовый URL-адрес этой страницы состояния, воспользуйтесь сайтом управления KUDU для Службы приложений.

Откройте службу приложений на портале Azure.
Щелкните Дополнительные инструменты или выполните поиск по запросу Kudu.
Выберите Выполнить.
На сайте управления KUDU в URL-адресе добавьте /DiagnosticServices и нажмите клавишу ВВОД. Заканчивается следующим образом: https://<kudu-url>/DiagnosticServices

Обновление пакета NuGet до последней версии

В зависимости от того, как была включена служба Snapshot Debugger, см. следующие варианты:

Если служба Snapshot Debugger была включена с помощью панели Application Insights на портале, то в приложении, вероятно, уже установлен последний пакет NuGet.
Если служба Snapshot Debugger была включена путем включения пакета NuGet Microsoft.ApplicationInsights.SnapshotCollector, с помощью диспетчера пакетов NuGet для Visual Studio убедитесь, что вы используете последнюю версию Microsoft.ApplicationInsights.SnapshotCollector.

Сведения о последних обновлениях и исправлениях ошибок см. в заметках о выпуске.

Проверьте журналы отправителя

После создания моментального снимка на диске создается файл минидампа (.dmp). Этот файл минидампа и любые связанные PDB-файлы создаются в отдельном процессе передачи в хранилище Snapshot Debugger Application Insights. После успешной отправки minidump удаляется с диска. Файлы журнала для процесса передачи сохраняются на диске. В среде службы приложений эти журналы можно найти в D:\Home\LogFiles. Используйте веб-сайт управления Kudu для службы приложений, чтобы найти эти файлы журнала.

Откройте службу приложений на портале Azure.
Щелкните Дополнительные инструменты или выполните поиск по запросу Kudu.
Выберите Выполнить.
В раскрывающемся списке Консоль отладки выберите CMD.
Щелкните LogFiles.

Вы увидите хотя бы один файл с именем, начинающимся с Uploader_ или SnapshotUploader_, и расширением .log. Выберите соответствующую пиктограмму, чтобы скачать все файлы журналов, или открыть их в браузере. Имя файла содержит уникальный суффикс, который идентифицирует экземпляр службы приложений. Если экземпляр службы приложений размещен на нескольких компьютерах, для каждого компьютера существуют отдельные файлы журналов. Когда отправитель обнаруживает новый файл минидампа, он записывается в файл журнала. Ниже приведен пример успешного моментального снимка и отправки:

SnapshotUploader.exe Information: 0 : Received Fork request ID 139e411a23934dc0b9ea08a626db16c5 from process 6368 (Low pri)
    DateTime=2018-03-09T01:42:41.8571711Z
SnapshotUploader.exe Information: 0 : Creating minidump from Fork request ID 139e411a23934dc0b9ea08a626db16c5 from process 6368 (Low pri)
    DateTime=2018-03-09T01:42:41.8571711Z
SnapshotUploader.exe Information: 0 : Dump placeholder file created: 139e411a23934dc0b9ea08a626db16c5.dm_
    DateTime=2018-03-09T01:42:41.8728496Z
SnapshotUploader.exe Information: 0 : Dump available 139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:45.7525022Z
SnapshotUploader.exe Information: 0 : Successfully wrote minidump to D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:45.7681360Z
SnapshotUploader.exe Information: 0 : Uploading D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp, 214.42 MB (uncompressed)
    DateTime=2018-03-09T01:42:45.7681360Z
SnapshotUploader.exe Information: 0 : Upload successful. Compressed size 86.56 MB
    DateTime=2018-03-09T01:42:59.6184651Z
SnapshotUploader.exe Information: 0 : Extracting PDB info from D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp.
    DateTime=2018-03-09T01:42:59.6184651Z
SnapshotUploader.exe Information: 0 : Matched 2 PDB(s) with local files.
    DateTime=2018-03-09T01:42:59.6809606Z
SnapshotUploader.exe Information: 0 : Stamp does not want any of our matched PDBs.
    DateTime=2018-03-09T01:42:59.8059929Z
SnapshotUploader.exe Information: 0 : Deleted D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:59.8530649Z

Примечание.

В предыдущем примере используется версия 1.2.0 Microsoft.ApplicationInsights.SnapshotCollector пакета NuGet. В более ранних версиях процесс передачи называется MinidumpUploader.exe, а журнал содержит менее подробные сведения.

В предыдущем примере, ключ инструментирования — это c12a605e73c44346a984e00000000000. Это значение должно соответствовать ключу инструментирования для вашего приложения. Минидамп связан с моментальным снимком с идентификатором 139e411a23934dc0b9ea08a626db16c5. Позже этот идентификатор можно использовать для поиска связанной записи исключений в аналитике Application Insights.

Отправитель проверяет наличие новых PDB-файлов примерно один раз каждые 15 минут. Приведем пример:

SnapshotUploader.exe Information: 0 : PDB rescan requested.
    DateTime=2018-03-09T01:47:19.4457768Z
SnapshotUploader.exe Information: 0 : Scanning D:\home\site\wwwroot for local PDBs.
    DateTime=2018-03-09T01:47:19.4457768Z
SnapshotUploader.exe Information: 0 : Local PDB scan complete. Found 2 PDB(s).
    DateTime=2018-03-09T01:47:19.4614027Z
SnapshotUploader.exe Information: 0 : Deleted PDB scan marker : D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\6368.pdbscan
    DateTime=2018-03-09T01:47:19.4614027Z

Для приложений, которые не размещаются в службе приложений, журналы отправителя находятся в той же папке, что и минидампы: %TEMP%\Dumps\<ikey> (где <ikey> — ваш ключ инструментирования).

Устранение неполадок с облачными службами

В облачных службах размер временной папки по умолчанию может быть слишком мал для хранения файлов минидампов. Это приводит к потере моментальных снимков.

Необходимый размер зависит от общего рабочего набора приложения и количества параллельных моментальных снимков.

Как правило, рабочий набор веб-роли 32-разрядного приложения ASP.NET может занимать от 200 МБ до 500 МБ. Предусмотрите место хотя бы для двух параллельных моментальных снимков.

Например, если в приложении используется 1 ГБ общего рабочего набора, необходимо убедиться, что для хранения моментальных снимков требуется не менее 2 ГБ дискового пространства.

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

Добавьте новый локальный ресурс в облачную службу, изменив файл ее определения (.csdef). В следующем примере определяется ресурс с именем SnapshotStore и размером 5 ГБ.
```
<LocalResources>
    <LocalStorage name="SnapshotStore" cleanOnRoleRecycle="false" sizeInMB="5120" />
</LocalResources>
```

Измените код запуска роли, чтобы добавить переменную среды, указывающую на локальный ресурс SnapshotStore. Для рабочих ролей код необходимо добавить в метод OnStart нужной роли:

public override bool OnStart()
{
    Environment.SetEnvironmentVariable("SNAPSHOTSTORE", RoleEnvironment.GetLocalResource("SnapshotStore").RootPath);
    return base.OnStart();
}

Для веб-ролей (ASP.NET) код необходимо добавить в метод Application_Start веб-приложения:

using Microsoft.WindowsAzure.ServiceRuntime;
using System;
namespace MyWebRoleApp
{
    public class MyMvcApplication : System.Web.HttpApplication
    {
        protected void Application_Start()
        {
            Environment.SetEnvironmentVariable("SNAPSHOTSTORE", RoleEnvironment.GetLocalResource("SnapshotStore").RootPath);
            // TODO: The rest of your application startup code
        }
    }
}

Обновите файл ApplicationInsights.config для используемой роли, чтобы переопределить размещение временной папки, которое используется в SnapshotCollector.

<TelemetryProcessors>
    <Add Type="Microsoft.ApplicationInsights.SnapshotCollector.SnapshotCollectorTelemetryProcessor, Microsoft.ApplicationInsights.SnapshotCollector">
        <!-- Use the SnapshotStore local resource for snapshots -->
        <TempFolder>%SNAPSHOTSTORE%</TempFolder>
        <!-- Other SnapshotCollector configuration options -->
    </Add>
</TelemetryProcessors>

Переопределение папки теневой копии

При запуске сборщик Snapshot Collector пытается найти папку на диске, который подходит для выполнения процесса передачи моментальных снимков. Выбранная папка называется папкой теневой копии.

Snapshot Collector проверяет несколько известных расположений, гарантируя наличие прав на копирование двоичных файлов отправителя моментальных снимков. Используются следующие переменные среды:

Fabric_Folder_App_Temp
LOCALAPPDATA
APPDATA
TEMP

Если подходящая папка не найдена, Snapshot Collector сообщает об ошибке: Could not find a suitable shadow copy folder (Не удалось найти подходящую папку теневой копии).

Если копирование завершается сбоем, Snapshot Collector выдает ошибку ShadowCopyFailed.

Если не удается запустить отправитель, Snapshot Collector выдает ошибку UploaderCannotStartFromShadowCopy. Текст сообщения часто содержит исключение System.UnauthorizedAccessException. Эта ошибка обычно возникает из-за того, что приложение работает от имени учетной записи с ограниченными разрешениями. У учетной записи есть разрешение на запись в папку теневой копии, но нет разрешения на выполнение кода.

Так как эти ошибки обычно возникают во время запуска, они часто следуют за ошибкой ExceptionDuringConnect , указывая, что отправитель не удалось запустить.

Чтобы устранить эти ошибки, вы можете указать папку теневой копии вручную с помощью параметра конфигурации ShadowCopyFolder. Например, в файле ApplicationInsights.config:

<TelemetryProcessors>
    <Add Type="Microsoft.ApplicationInsights.SnapshotCollector.SnapshotCollectorTelemetryProcessor, Microsoft.ApplicationInsights.SnapshotCollector">
        <!-- Override the default shadow copy folder. -->
        <ShadowCopyFolder>D:\SnapshotUploader</ShadowCopyFolder>
        <!-- Other SnapshotCollector configuration options -->
    </Add>
</TelemetryProcessors>

Или же в файле appsettings.json, если вы используете его с приложением .NET Core:

{
    "ApplicationInsights": {
        "InstrumentationKey": "<your instrumentation key>"
    },
    "SnapshotCollectorConfiguration": {
        "ShadowCopyFolder": "D:\\SnapshotUploader"
    }
}

Поиск исключений с моментальными снимками с помощью поиска Application Insights

При создании моментального снимка вызванное исключение обозначается идентификатором моментального снимка. При передаче сведений об исключении в Application Insights этот идентификатор моментального снимка добавляется в качестве пользовательского свойства. В колонке поиска Application Insights можно найти все записи с пользовательским свойством ai.snapshot.id.

Перейдите к ресурсу Application Insights на портале Azure.
Нажмите Поиск.
В текстовом поле поиска введите ai.snapshot.id и нажмите клавишу ВВОД.

Если этот поиск не возвращает результатов, моментальные снимки не сообщались в Application Insights в выбранном диапазоне времени.

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

Еще раз проверьте, что вы смотрите на правильный ресурс Application Insights при проверке ключа инструментирования.
С помощью метки времени из журнала отправителя, настройте фильтр диапазона времени поиска так, чтобы охватить этот диапазон времени.

Если исключение с таким идентификатором моментальных снимков по-прежнему не отображается, значит запись этого исключения не отправлялась в Application Insights. Это происходит в случае сбоя приложения после снятия снимка, но до того, как оно передало запись исключения. В этом случае проверьте журналы службы приложений в Diagnose and solve problems, чтобы проверить, были ли неожиданные перезагрузки или необработанные исключения.

Изменение правил прокси-сервера сети или брандмауэра

Если ваше приложение подключается к Интернету через прокси-сервер или брандмауэр, вам может потребоваться обновить правила для обмена данными со службой Snapshot Debugger.

IP-адреса, используемые службой Application Insights Snapshot Debugger, включены в тег службы Azure Monitor. Дополнительные сведения см. в статье Документация по Тегам служб.

Существуют ли затраты на выставление счетов при использовании моментальных снимков?

Плата за подписку на Snapshot Debugger не взимается. Собранные файлы моментальных снимков хранятся отдельно от телеметрии, собранной пакетами SDK Application Insights, и плата за получение или хранение моментальных снимков не взимается.

Поделиться через

Устранение неполадок, связанных с включением отладчика моментальных снимков Application Insights или просмотром моментальных снимков

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

Убедитесь, что вы используете соответствующую конечную точку отладчика моментальных снимков

Использование проверки работоспособности моментальных снимков

Проверка ключа инструментирования

Проверка параметров клиента TLS/SSL (ASP.NET)

Сценарии накладных расходов отладчика моментальных снимков

Предварительные версии .NET Core

Проверка страницы состояния расширения сайта Служб диагностики

Обновление пакета NuGet до последней версии

Проверьте журналы отправителя

Устранение неполадок с облачными службами

Переопределение папки теневой копии

Поиск исключений с моментальными снимками с помощью поиска Application Insights

Изменение правил прокси-сервера сети или брандмауэра

Существуют ли затраты на выставление счетов при использовании моментальных снимков?

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

Дополнительные ресурсы