Перегляд журналів помилок порталу

Примітка

З 12 жовтня 2022 року портали Power Apps перейменовано на Power Pages. Додаткова інформація: Microsoft Power Pages тепер у загальному доступі (блоґ)
Незабаром документацію порталів Power Apps буде перенесено та об’єднано з документацією Power Pages.

Адміністратори й розробники порталів використовують портали Power Apps, щоб створювати веб-сайти для своїх клієнтів. Розробники часто усувають проблеми під час розробки порталу. Для допомоги з усуненням можете скористатися докладними журналами про помилку для будь-яких питань на вашому порталі. Існує кілька способів отримання журналів помилок для порталів.

Примітка

Журнали помилок порталу Power Apps також використовуються для Power Pages. Додаткові відомості: Що таке Power Pages

Порада

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

Настроювана помилка

Якщо стається будь-яке виключення сервера на порталі, за замовчуванням відкривається сторінка настроюваної помилки зі зручним повідомленням про помилку. Щоб настроїти повідомлення про помилку, див. розділ Відображення повідомлення про настроювану помилку.

Проте радимо переглянути сторінку з детальною інформацією про помилки ASP.NET, що також відома як "жовтий екран смерті" (YSOD), щоб дізнатися про усунення помилок. Сторінка з детальною інформацією про помилку може показати повний список помилок сервера.

Щоб увімкнути YSOD, потрібно вимкнути настроювані помилки на порталі.

Примітка

Радимо вимикати настроювані помилки лише на стадії розробки та вмикати настроювані помилки після переходу в режим реального часу.

Додаткові відомості про настроювані помилки: Відображення сторінки настроюваної помилки

Вимкнути настроювану помилку

Можна вимкнути настроювані помилки на порталах для відображення детального повідомлення про виняток, якщо сталося будь-яке виключення сервера на порталі.

1. Відкрийте центр адміністрування порталів Power Apps.

2. Перейдіть Дії на порталі > Вимкнути настроювані помилки.

   

3. Виберіть Вимкнути у запиті підтвердження. Коли настроювані помилки вимкнуто, портал повторно запсукається і буде недоступним. Відобразиться повідомлення, коли настроювані помилки вимкнуто.

Ввімкнути настроювану помилку

Можна відстежувати настроювані помилки на порталах для відображення професійних на вигляд сторінок замість YSOD. Ця сторінка надає суттєву інформацію, якщо стається будь-який виняток у програмі.

1. Відкрийте центр адміністрування порталів Power Apps.

2. Перейдіть Дії на порталі > Увімкнути настроювані помилки.

   

3. Виберіть Увімкнути у запиті підтвердження. Коли настроювані помилки ввімкнуто, портал повторно запсукається і буде недоступним. Відобразиться повідомлення, коли настроювані помилки ввімкнуто.

Примітка

• Якщо змінити інсталяцію, до якої підключено ваш портал, параметр настроюваних помилок буде ввімкнуто. Ви повинні вимкнути настроювані помилки знову у разі необхідності.
• Не допускається вмикати або вимикати настроювані помилки, коли вносяться зміни до інсталяції, до якої підключено ваш портал; інакше відображається повідомлення про помилку.

Відобразити повідомлення про настроювану помилку

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

Щоб визначити настроювану помилку, використовуйте фрагмент вмісту Portal Generic Error. Вміст, визначений у цьому фрагменті відображається на сторінці повідомлення про помилку. Цей фрагмент вмісту недоступний у готовій програмі, і його слід створити. Фрагмент вмісту Тип може бути Текст або HTML. Щоб створити або змінити фрагмент вмісту, див. розділ Настроїти вміст за допомогою фрагментів вмісту.

Примітка

Якщо код liquid написано у фрагменті вмісту, його буде пропущено і він не буде відтворюватися.

Якщо увімкнути настроювані помилки, з'являється повідомлення із вказаною нижче структурою на сторінці повідомлення про помилку:

<Content Snippet>
<Error ID >
<Date and time>
<Portal ID>

Нижче наведено приклад повідомлення про помилку, що використовує фрагмент вмісту типу HTML:

Це настроювана помилка, збережіть квиток підтримки зі знімком екрана з повідомленням про помилку, натиснувши тут

Примітка

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

Відкрийте журнали помилок порталу

Після розробки та публікації порталу, вам все ще буде потрібно мати доступ до журналів порталу, щоб усувати проблеми, про які повідомили клієнти. Щоб відкрити журнали, налаштуйте портал на надсилання всіх помилок програми до облікового запису в сховищі BLOB-об’єктів Azure, який вам належить. Маючи доступ до журналів помилок порталу, ви можете швидко відповідати на запити клієнтів, оскільки матимете докладні відомості про проблеми. Щоб отримувати журнали помилок порталу в сховищі BLOB-об’єктів Azure, необхідно увімкнути ведення журналу діагностики в центрі адміністрування порталів Power Apps.

Примітка

Якщо змінити інсталяцію Dataverse, до якої підключений ваш портал, діагностичне журналювання буде вимкнуто. Необхідно ввімкнути діагностичне журналювання ще раз.

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

1. Відкрийте центр адміністрування порталів Power Apps.

2. Послідовно виберіть елементи Дії на сторінці > Увімкнути діагностичне журналювання.

   

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

   • Рядок підключення послуги сховища BLOB-об'єктів Azure: URL-адреса служби сховища BLOB-об'єктів Azure для зберігання журналів помилок порталу. Максимальна довжина URL-адреси складає 2048 символів. Якщо URL-адреса перевищує 2048 символів, з'являється повідомлення про помилку. Додаткові відомості про рядок підключення: Настроювання рядків підключення сховища Azure
   • Виберіть період збереження: тривалість зберігання журналів помилок порталу у сховищі BLOB-об'єктів. Журнали помилок будуть видалені по завершенню вказаного періоду. Можна вибрати один із зазначених нижче варіантів:
     • Один день
     • Сім днів
     • 30 днів
     • 60 дн.
     • 90 днів
     • 180 дн.
     • Завжди

   За замовчуванням термін зберігання становить 30 днів.

   

4. Виберіть Налаштувати.

Після того, як настроєно діагностичне журналювання, новий контейнер BLOB-об'єктів журналу телеметрії створюється для вашого облікового запису у сховищі Azure, а журнали записуються у файли BLOB-об'єктів, які зберігаються в контейнері. На знімку екрана нижче показано контейнер BLOB-об’єкта журналів телеметрії в Azure Storage Explorer:

Коли діагностичне журналювання увімкнено, стають доступними такі дії:

• Оновлення конфігурації діагностичного журналювання: Дає змогу змінити або видалити конфігурацію діагностичного журналювання для порталу.
• Вимкнення діагностичного журналювання: Дає змогу вимкнути конфігурацію діагностичного журналювання для порталу.

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

1. Відкрийте центр адміністрування порталів Power Apps.

2. Перейдіть до Дії порталу > Оновити конфігурацію діагностичного журналювання.

   

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

   • Бажаєте оновити рядок підключення служби сховища BLOB-об'єктів Azure?: Дає змогу вказати, чи слід оновити рядок підключення служби сховища BLOB-об'єктів Azure. За замовчуванням це значення вибрано.
   • Рядок підключення послуги сховища BLOB-об'єктів Azure: URL-адреса служби сховища BLOB-об'єктів Azure для зберігання журналів помилок порталу. Максимальна довжина URL-адреси може складати 2048 символів. Якщо URL-адреса перевищує 2048 символів, з'являється повідомлення про помилку. Це поле відображатиметься тільки якщо вибрано позначку Бажаєте оновити рядок підключення служби сховища BLOB-об'єктів Azure?. Додаткові відомості про рядок підключення: Настроювання рядків підключення сховища Azure
   • Виберіть період збереження: тривалість зберігання журналів помилок порталу у сховищі BLOB-об'єктів. Журнали помилок будуть видалені по завершенню вказаного періоду. Можна вибрати один із зазначених нижче варіантів:
     • Один день
     • Сім днів
     • 30 днів
     • 60 дн.
     • 90 днів
     • 180 дн.
     • Завжди

   За замовчуванням термін зберігання становить 30 днів.

   

4. Виберіть Оновити.

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

1. Відкрийте центр адміністрування порталів Power Apps.

2. Послідовно виберіть елементи Дії на сторінці > Вимкнути діагностичне журналювання.

   

3. Виберіть Вимкнути у запиті підтвердження.

Відображення помилки компонента plug-in

Інший поширений сценарій під час розробки порталу – це помилка, що виникає через спеціальний компонент plug-in і бізнес-логіку, прописану у вашому середовищі Dataverse. Ці помилки зазвичай можна відкрити через вимкнення настроюваних помилок або ввімкнення діагностичного журналювання. У деяких випадках можна швидше відобразити ці помилки безпосередньо на порталі, щоб швидше діагностувати проблему. Це можна зробити, налаштувавши портал на відображення настроюваних помилок компонентів plug-in у Dataverse на екрані порталу.

Для перегляду настроюваних помилок плагінів, створіть параметр сайту Site/EnableCustomPluginError та встановіть у значення True. Настроювані помилки плагінів відображатимуться на екрані замість універсальної помилки. Повідомлення відображатиме тільки частину з повідомленням із помилки плагіну, а не повне трасування стека.

Нижче наведені екрани, де відображатимуться настроювані помилки плагінів:

• Список
  • Отримання записів
• Базова форма
  • Отримати
  • Створення/оновлення тощо
• Багатокрокові форми
  • Отримати
  • Створення/оновлення тощо

Якщо параметра сайту немає, то він розглядатиметься як ХИБНІСТЬ за замовчуванням, а помилки компонентів plug-in не відображатимуться.

Див. також

Обслуговування та усунення несправностей порталу Power App

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).