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

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

Порада

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

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

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

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

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

Нотатка

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

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

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

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

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

2. У розділі Ресурси виберіть Сайти Power Pages.

3. Виберіть веб-сайт.

4. У меню Дії сайту виберіть пункт Вимкнути настроювані помилки.

1. Виберіть Вимкнути у запиті підтвердження. Поки триває процес вимкнення настроюваних помилок, веб-сайт буде недоступним через перезавантаження.

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

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

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

2. У розділі Ресурси виберіть Сайти Power Pages.

3. Виберіть веб-сайт.

4. У меню Дії сайту виберіть пункт Увімкнути настроювані помилки.

5. Виберіть Увімкнути у запиті підтвердження. При увімкненні настроюваних помилок веб-сайт повторно запускається і буде деякий час недоступним.

Нотатка

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

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

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

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

Нотатка

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

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

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

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

This is a custom error, file a support ticket with screenshot of error by clicking here

Нотатка

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

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

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

Нотатка

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

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

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

2. У розділі Ресурси виберіть Сайти Power Pages.

3. Виберіть веб-сайт.

4. У меню Дії сайту виберіть пункт Увімкнути ведення журналу діагностики.

5. На бічній панелі з назвою Ввімкнення діагностичного журналювання, що з'явиться, введіть такі значення:

   • Виберіть період збереження: тривалість зберігання журналів помилок порталу у сховищі BLOB-об'єктів. Журнали помилок будуть видалені по завершенню вказаного періоду. Можна вибрати один із зазначених нижче варіантів:

     • Один день
     • Сім днів
     • 30 днів
     • 60 дн.
     • 90 днів
     • 180 дн.
     • Завжди

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

   • Рядок підключення послуги сховища BLOB-об'єктів Azure: URL-адреса служби сховища BLOB-об'єктів Azure для зберігання журналів помилок веб-сайту. Максимальна довжина URL-адреси складає 2048 символів. Якщо URL-адреса перевищує 2048 символів, з'являється повідомлення про помилку. Додаткові відомості про рядок підключення: Настроювання рядків підключення сховища Azure

     

6. Виберіть Увімкнути.

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

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

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

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

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

2. У розділі Ресурси виберіть Сайти Power Pages.

3. Виберіть веб-сайт.

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

5. На панелі «Оновлення конфігурації діагностичного журналювання» введіть такі значення:

   • Бажаєте оновити рядок підключення служби сховища BLOB-об'єктів Azure?: дає змогу вказати, чи слід оновити рядок підключення служби сховища BLOB-об'єктів Azure. За замовчуванням не вибрано.

   • Виберіть період збереження: тривалість зберігання журналів помилок веб-сайту у сховищі BLOB-об'єктів. Журнали помилок будуть видалені по завершенню вказаного періоду. Можна вибрати один із зазначених нижче варіантів:

     • Один день
     • Сім днів
     • 30 днів
     • 60 дн.
     • 90 днів
     • 180 дн.
     • Завжди

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

   • Рядок підключення послуги сховища BLOB-об'єктів Azure: URL-адреса служби сховища BLOB-об'єктів Azure для зберігання журналів помилок веб-сайту. Максимальна довжина URL-адреси може складати 2048 символів. Якщо URL-адреса перевищує 2048 символів, з'являється повідомлення про помилку. Це поле відображатиметься тільки якщо вибрано позначку Бажаєте оновити рядок підключення служби сховища BLOB-об'єктів Azure?. Додаткові відомості про рядок підключення: Настроювання рядків підключення сховища Azure

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

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

2. У розділі Ресурси виберіть Сайти Power Pages.

3. Виберіть веб-сайт.

4. У меню Дії сайту виберіть пункт Вимкнути діагностичне журналювання.

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

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

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

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

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

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

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