Просмотр журналов ошибок портала

Как администратор портала или разработчик, вы можете использовать порталы Power Apps для создания веб-сайта для клиентов. Одна обычная задача для разработчика — это отладка проблем при разработке портала. Чтобы помочь в отладке, можно получить доступ к подробным журналам ошибок для любых проблем на портале. Существует несколько способов получения журналов ошибок для порталов.

Совет

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

Настраиваемая ошибка

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

Однако для целей отладки лучше просматривать подробную страницу ошибки ASP.NET, которая также известна как "желтый экран смерти" (YSOD). Подробная страница ошибки помогает получить полный стек ошибки сервера.

Желтый экран смерти

Чтобы включить YSOD, необходимо отключить настраиваемые ошибки на вашем портале.

Примечание

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

Дополнительные сведения о настраиваемой ошибке: Отображение страницы настраиваемой ошибки

Отключение настраиваемой ошибки

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

  1. Откройте Центр администрирования порталов Power Apps.

  2. Выберите Действия портала > Отключить настраиваемые ошибки.

    Отключение настраиваемой ошибки

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

Включение настраиваемой ошибки

Можно включить настраиваемые ошибки на порталах для отображения профессионального выглядящей страницы вместо страницы YSOD. На этой странице приведены содержательные сведения, если возникло любое исключение в приложении.

  1. Откройте Центр администрирования порталов Power Apps.

  2. Выберите Действия портала > Включить настраиваемые ошибки.

    Включение настраиваемой ошибки

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

Примечание

  • Если изменить экземпляр, к которому подключен портал, настраиваемые ошибки включаются. Необходимо снова отключить настраиваемые ошибки, если это требуется.
  • Не следует включать или отключать настраиваемые ошибки во время изменения экземпляра, к которому подключен портал; в противном случае отображается сообщение об ошибке.

Отображение сообщения о настраиваемой ошибке

Можно настроить портал для отображения настраиваемой ошибки профессионального вида вместо общей ошибки.

Для определения настраиваемой ошибки используйте фрагмент содержимого Portal Generic Error. Содержимое, определенное в этом фрагменте, отображается на странице ошибки. Этот фрагмент содержимого не доступен в готовом виде, и пользователь должен создать его. Для параметра Тип фрагмента содержимого может быть задано значение Текст или HTML. Для создания или редактирования фрагмента содержимого см. раздел Настройка содержимого с помощью фрагментов содержимого.

Примечание

Если во фрагмент содержимого включен код Liquid, он пропускается и не отображается.

Если настраиваемые ошибки включены, это сообщение отображается в следующей структуре на странице ошибки:

Ниже приведен пример настраиваемого сообщения об ошибке с использованием фрагмента содержимого с типом HTML:

Это настраиваемая ошибка, создайте билет службы поддержки с примером экрана ошибки, нажав здесь

Настраиваемое сообщение об ошибке

Примечание

Если порталу не удается извлечь фрагмент содержимого, поскольку он не может установить соединение с Microsoft Dataverse или если фрагмент содержимого недоступен в Dataverse, появляется сообщение об ошибке.

Доступ к журналам ошибок портала

После того как портал разработан и опубликован, все еще требуется иметь возможность получить доступ к журналам портала для устранения проблем, о которых сообщают клиенты. Для получения доступа к этим журналам можно настроить портал таким образом, чтобы он отправлял все ошибки приложений на принадлежащую вам учетную запись хранилища больших двоичных объектов Azure. Обращаясь к журналам ошибок портала, можно эффективно реагировать на запросы клиентов, так как у вас имеются сведения о проблеме. Чтобы получать журналы ошибок портала в свое хранилище больших двоичных объектов Azure, необходимо разрешить ведение журнала диагностики из центра администрирования порталов Power Apps.

Примечание

Если изменить экземпляр Dataverse, к которому подключен портал, ведение журналов диагностики отключается. Необходимо снова включить ведение журнала диагностики.

Включить ведение журнала диагностики

  1. Откройте Центр администрирования порталов Power Apps.

  2. Выберите Действия портала > Включить ведение журнала диагностики.

    Включить ведение журнала диагностики

  3. В окне Включить ведение журнала диагностики введите следующие значения:

    • Строка подключения к службе хранилища BLOB-объектов Azure. URL-адрес службы хранилища больших двоичных объектов Azure для хранения журналов ошибок портала. Длина этого URL-адреса не должна превышать 2048 символов. Если URL-адрес длиннее 2048 символов, появляется сообщение об ошибке. Дополнительные сведения о строке подключения: Настройка строк подключения службы хранилища Azure
    • Выбор периода удержания. Длительность хранения журналов ошибок портала в хранилище больших двоичных объектов. Журналы ошибок удаляются после выбранной длительности. Можно выбрать одно из следующих значений:
      • 1 день
      • 7 дней
      • 30 дня
      • 60 дня
      • 90 дня
      • 180 дня
      • Всегда

    Период хранения по умолчанию: 30 дней.

    Окно включения ведения журнала диагностики

  4. Щелкните Настроить.

После настройки ведения журналов диагностики в учетной записи хранилища Azure создается новый контейнер больших двоичных объектов telemetry-logs, и журналы записываются в файлы больших двоичных объектов, хранящиеся в этом контейнере. На следующем снимке экрана показан контейнер больших двоичных объектов telemetry-logs в обозревателе службы хранилища Azure.

Учетная запись хранилища больших двоичных объектов Azure

Если функция ведения журнала диагностики включена успешно, следующее действие становится доступным:

  • Обновить конфигурацию ведения журнала диагностики. Позволяет обновить или удалить конфигурацию ведения журнала диагностики для портала.
  • Отключить ведение журнала диагностики. Позволяет отключить конфигурацию ведения журнала диагностики для портала.

Обновление ведения журнала диагностики

  1. Откройте Центр администрирования порталов Power Apps.

  2. Выберите Действия портала > Обновить конфигурацию ведения журнала диагностики.

    Обновить конфигурацию ведения журнала диагностики

  3. В окне "Обновить конфигурацию ведения журнала диагностики" введите следующие значения:

    • Обновить строку подключения к службе хранилища BLOB-объектов Azure?. Позволяет указать, требуется ли обновить строку подключения службы хранилища больших двоичных объектов Azure. По умолчанию, он выбран.
    • Строка подключения к службе хранилища BLOB-объектов Azure. URL-адрес службы хранилища больших двоичных объектов Azure для хранения журналов ошибок портала. Длина этого URL-адреса может быть не более 2048 символов. Если URL-адрес длиннее 2048 символов, появляется сообщение об ошибке. Это поле отображается только в том случае, если установлен флажок Обновить строку подключения к службе хранилища BLOB-объектов Azure?. Дополнительные сведения о строке подключения: Настройка строк подключения службы хранилища Azure
    • Выбор периода удержания. Длительность хранения журналов ошибок портала в хранилище больших двоичных объектов. Журналы ошибок удаляются после выбранной длительности. Можно выбрать одно из следующих значений:
      • 1 день
      • 7 дней
      • 30 дня
      • 60 дня
      • 90 дня
      • 180 дня
      • Всегда

    Период хранения по умолчанию: 30 дней.

    Окно обновления конфигурации ведения журнала диагностики

  4. Нажмите Обновить.

Отключить ведение журнала диагностики

  1. Откройте Центр администрирования порталов Power Apps.

  2. Выберите Действия портала > Отключить ведение журнала диагностики.

    Отключить ведение журнала диагностики

  3. В сообщении подтверждения щелкните Отключить.

Ошибка отображения подключаемого модуля

Другой сценарий, который часто происходит при разработке портала, — это ошибка, вызываемая настраиваемыми подключаемыми модулями и бизнес-логикой, созданными в вашей среде Dataverse. Доступ к этим ошибкам обычно возможен при отключении настраиваемых ошибок или включении ведения журнала диагностики. Тем не менее в некоторых случаях быстрее отображать эти ошибки непосредственно на портале для более быстрой диагностики проблемы. Чтобы это сделать, можно настроить портал для отображения ошибок настраиваемых подключаемых модулей из Dataverse на экране портала.

Для отображения ошибок настраиваемых подключаемых модулей создайте параметр сайта Site/EnableCustomPluginError и установите для него значение True. Ошибки настраиваемых подключаемых модулей будут отображаться на экране, а не в виде общей ошибки. Ошибка будет отображаться только сообщение ошибки подключаемого модуля, а не всю трассировку стека.

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

  • Список сущностей
    • Извлечение записей
  • Форма сущности
    • Извлечь
    • Создание или обновление и т. п.
  • Веб-формы
    • Извлечь
    • Создание или обновление и т. п.

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

См. также

Microsoft Learn: обслуживание и устранение неполадок портала Power Apps

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

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