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

Функции диагностики

  • Статья

Важно!

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

Узнайте больше о сроках поддержки и альтернативных вариантах.

В этом разделе вы узнаете о наборе функций, доступных для службы диагностики Центра приложений.

Аналитика сбоев и ошибок

В разделе Диагностика Центра приложений можно просматривать аналитические данные, автоматически создаваемые Центром приложений, чтобы понять, когда в приложении происходит сбой или ошибка.

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

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

Примечание

Центр приложений фильтрует потенциально конфиденциальную информацию. Примерами конфиденциальной информации, которые будут фильтроваться, являются URL-адреса, строки JSON и идентификаторы запросов.

Центр приложений показывает аналитику сбоев и ошибок

Группирование

Диагностика Центра приложений группирует сбои и ошибки по сходствам, например причину проблемы и место возникновения проблемы в приложении. Для каждой группы сбоев и ошибок Центр приложений отображает строку кода, которая завершилась сбоем, имя класса или метода, имя файла, номер строки, тип ошибки или сбой, а также сообщение, чтобы лучше понять эти группы. Выберите группу, чтобы просмотреть дополнительные сведения и получить доступ к списку подробных отчетов о проблемах и журналов. Это позволяет еще глубже и использовать набор функций, чтобы лучше понять поведение приложения во время сбоя или ошибки.

Если сбой вызван неудачным вызовом URL-адреса (например, "Ошибка при вызове azure.com или google.com"), Центр приложений может группировать сбои по данному URL-адресу (например, все не удалось вызвать azure.com будут сгруппированы и не удалось вызвать google.com будут сгруппированы). Тем не менее, так как мы удаляем URL-адреса, добавленные к HTTP или HTTPS, из журнала сбоев такое группирование будет работать только в том случае, если избежать такого синтаксиса, например: "Ошибка вызова http://azure.com" Не будет сгруппирован с другими вызовами Azure, но "Ошибка вызова azure.com" будет сгруппирована с аналогичными отчетами об ошибках.

Сбои и ошибки в Центре приложений на основе сходства

Идентификация пользователя

Диагностика Центра приложений позволяет прикрепить идентификатор пользователя к сбоям и ошибкам. Для этого используйте пакет SDK центра приложений на целевой платформе Android, Apache Cordova, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms и MAUI/Xamarin. Вы найдете идентификатор пользователя, связанный с сбоем или ошибкой, при щелчке по проблеме в группе.

После присоединения идентификатора пользователя можно использовать функцию поиска в Центре приложений для поиска сбоев с указанным идентификатором. Узнайте, как это сделать, следуя документации по поиску в Центре приложений.

Вложения

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

Чтобы узнать, как добавлять вложения в отчеты о сбоях, ознакомьтесь с документацией по пакетам SDK Crashes для приложений Android, iOS, macOS, React Native, UWP, WPF/WinForms и MAUI/Xamarin.

Вложения для обрабатываемых ошибок поддерживаются только для платформ Android, Unity, UWP, WPF, WinForms и Xamarin. Узнайте, как добавлять вложения в отчеты об ошибках в документации по пакету SDK для приложений Android, Unity, UWP, WPF/WinForms и MAUI/Xamarin .

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

Центр приложений позволяет добавлять вложения в отчеты о сбоях и ошибках

События перед сбоем

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

Чтобы определить пользовательское событие, проверка нашу документацию по пакету SDK для Android, iOS, macOS, React Native, Windows и MAUI/Xamarin.

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

Центр приложений позволяет отслеживать события, приводящие к сбою

Пары "ключ-значение"

Вы можете настроить отчеты об ошибках, отправляемые в Центр приложений, чтобы включить дополнительный контекст для ошибки, передав словарь строковых значений (в виде пар "ключ-значение") в TrackError метод . Эти свойства являются необязательными. Чтобы задать пары "ключ-значение", ознакомьтесь с документацией по Android, MAUI/Xamarin, Unity, UWP и WPF/WinForms .

Примечание

Эта функция поддерживается только для Ошибок Android, iOS, Xamarin, React Native, Unity, UWP, WinForms и WPF.

Экспорт диагностических данных

Центр приложений может экспортировать необработанные данные диагностика (сбои и ошибки) в Azure. Экспорт данных диагностика в хранилище BLOB-объектов для настройки данных.

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

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

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

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

Потоки

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

Центр приложений отображает текущие потоки во время сбоя

Примечание

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

Настройка предупреждений

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

  1. Войдите в Центр приложений и выберите свое приложение.
  2. В меню слева перейдите к разделу Параметры.
  3. Щелкните Email уведомления.
  4. Выберите Немедленно, Ежедневно или Никогда. По умолчанию задано значение Никогда.

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

Дополнительные сведения об уведомлениях см. в документации по панели мониторинга Центра приложений.

Создание средства отслеживания ошибок

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

Отправка отчетов в Центр приложений

Документация по отправке сбоев через API перемещена.