Мониторинг и устранение неполадок подключаемых модулей Dataverse (предварительная версия)
[Данный раздел посвящен предварительному выпуску и может быть изменен.]
Используйте трассировку для устранения неполадок в малокодовых и полнокодовых подключаемых модулях. Трассировка позволяет записывать информацию времени выполнения и использовать ее в качестве вспомогательного средства для диагностики причин сбоев или для проверки определенных состояний во время разработки.
Важно!
- Это предварительная версия функции.
- Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.
Функция мониторинга подключаемых модулей в ускорителе Dataverse представляет собой усовершенствованное представление существующих возможностей трассировки и ведения журналов, доступных в Microsoft Dataverse для подключаемых модулей. Этот интерфейс облегчает процессы устранения неполадок и отладки на фазе разработки путем совмещения необходимых сведений в современном оформлении.
Все события, отображаемые в приложении, считываются из таблицы Трассировка в течение 24 часов следующими типами рабочих процессов:
- Подключаемые модули
- Пользовательские API
- Мгновенные и автоматизированные малокодовые подключаемые модули
Предварительные условия
У вас должны быть следующая роль безопасности и доступ к приложению "Ускоритель Dataverse":
Роль безопасности: по умолчанию привилегии, необходимые для включения журналов и использования приложения, есть у ролей безопасности "Настройщик системы" и "Системный администратор".
Также вы вы можете создать собственные роли с доступом к каждой возможности путем настройки следующих привилегий:
- Для чтения журналов требуется привилегия на чтение в отношении таблицы Трассировка на уровне организации.
- Для включения ведения журналов в среде требуется привилегия на запись в отношении параметра
PluginTraceLogSettingтаблицы "Организация" на уровне организации.
Ключевые функции
- Централизованный просмотр журналов: централизованный доступ к журналам трассировки, образующимся в результате выполнения пользовательских API Dataverse, малокодовых подключаемых модулей и полнокодовых подключаемых модулей в среде.
- Возможности фильтрации: удобная фильтрация истории журналов для быстрого поиска журналов, актуальных для ваших задач отладки.
Установка
Эта функция доступна в приложении "Ускоритель Dataverse". Инструкции по установке см. в статье об ускорителе Dataverse.
Как опробовать функцию мониторинга подключаемых модулей
Перейдите к функции Мониторинг подключаемых модулей (на левой панели навигации или на карточке функции на целевом экране).
Включение ведения журналов
Если в вашей среде не включено ведение журналов, на целевой странице отображается выключенное состояние с двумя вариантами включения ведения журналов: Все или Исключения. Выберите подходящий вариант исходя из своих потребностей; подробнее см. в статье о ведении журналов и трассировке.
При необходимости вы можете изменить эти параметры позже на экране Параметры, доступ к которому можно получить с панели команд главного экрана.
Совет
Трассировка и ведение журналов идеально подходят для отладки в ходе разработки подключаемых модулей. Для подключаемых модулей на этапе рабочих версий используйте Azure App Insights для мониторинга.
Просмотреть журналы
После включения ведения журналов события подключаемых модулей начинают появляться в основном списке, отображаемом на экране.
Совет
Если журналы не отображаются, вы можете создать и запустить новый малокодовый подключаемый модуль, чтобы увидеть журналы.
Фильтрация журналов
Используйте возможности фильтрации, чтобы быстро находить журналы, относящиеся к подключаемым модулям, над которыми вы работаете.
Выберите Фильтр в правой верхней части панели команд, чтобы открыть область фильтров. Также можно быстро фильтровать журналы по ключевым словам, используя строку поиска.
| Фильтр | Description |
|---|---|
| Полное имя | Выберите логическое имя подключаемого модуля. |
| Начинается до / после | Дата и время вызова подключаемого модуля. |
| Включить только исключения | Показывает выполнения со статусом "сбой". |
| Длительность мин. / макс. | Минимальный и максимальный диапазон длительности подключаемого модуля. |
| Type | Классификация рабочего процесса подключаемого модуля. К доступным типам относятся:
|
| Mode | Является плагин синхронным или асинхронным. |
Чтение подробностей журнала
Выберите конкретную запись журнала, чтобы просмотреть подробную информацию о выполнении плагина. Подробности журнала включают метку времени, имя подключаемого модуля, состояние выполнения, выходные параметры, сообщения об ошибках и многое другое. Поля блока сообщений и блока исключений отображаются под основными сведениями на панели и раскрываются, если в соответствующих столбцах есть данные.
Рекомендации
Изучение подробностей журнала
- Выберите конкретную запись журнала, чтобы просмотреть подробную информацию о выполнении плагина.
- Подробности журнала могут включать метку времени, имя подключаемого модуля, состояние выполнения, входные/выходные параметры, сообщения об ошибках и многое другое.
Устранение неполадок
- Используйте информацию, содержащуюся в журналах трассировки, для устранения проблем, возникающих во время выполнения подключаемого модуля.
- Анализируйте сообщения об ошибках, входные/выходные параметры и сведения о выполнении, чтобы определить основную причину проблемы.
- Используйте сообщения трассировки для получения полезных указателей. Запись в службу трассировки доступна в Dataverse SDK и в малокодовых плагинах в виде функции Trace в Power Fx.
Переходим к действиям
- На основе информации, полученной из журналов трассировки, примите соответствующие меры для устранения выявленных проблем с производительностью или ошибок.
- Такие меры могут включать в себя корректировку конфигураций подключаемых модулей, изменение логики кода или обращение за помощью к ресурсам поддержки.
Планирование тестирования
- Возьмите за привычку планировать тестовые случаи, которые вы можете выполнять с целью получения журналов трассировки для проверки работы подключаемых модулей во время разработки.
- Оперативно устраняйте обнаруженные проблемы или аномалии, чтобы поддерживать общую стабильность и надежность ваших подключаемых модулей Dataverse.
Мониторинг работы подключаемых модулей
- Регулярно отслеживайте работу подключаемых модулей в рабочей среде, просматривая журналы трассировки, зарегистрированные в Application Insights.
- Обращайте внимание на состояние выполнения, сообщения об ошибках и любые аномалиями, которые могут указывать на проблемы с производительностью или ошибки.
Вопросы и ответы
Какие привилегии необходимы для доступа к средству просмотра журналов трассировки?
Для просмотра журналов у вас должны быть как минимум права на чтение таблицы Trace.
Кто может включать ведение журналов в среде?
Системные администраторы с соответствующей ролью безопасности могут включать ведение журналов в своей среде. В частности, необходим доступ на запись к таблице "Организация" для обновления значения столбца PluginTraceLogSetting.
Можно ли фильтровать историю журналов, чтобы найти определенные журналы?
Да, средство просмотра журналов трассировки предоставляет возможности фильтрации, позволяя пользователям легко находить журналы, соответствующие их задачам отладки.
Во всех ли средах доступна функция мониторинга подключаемых модулей?
Эта функция предоставляется через ускоритель Dataverse и доступна во всех средах, где установлено это приложение. Приложение автоматически устанавливается во всех новых средах, но его также можно установить и в более старых средах, следуя инструкциям по установке.
После включения ведения журналов все равно отображается экран "Ведение журналов отключено"
Если у вас есть необходимые привилегии и вы уверены, что включили ведение журналов, обновите вкладку браузера. Вы можете проверить, включено ли ведение журналов, используя устаревший интерфейс.