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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<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

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

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

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

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

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

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

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

5. З’явиться бічна панель із заголовком Увімкнути діагностичне ведення журналу, введіть такі значення:

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

     • Один день

     • Сім днів

     • 30 днів

     • 60 дн.

     • 90 днів

     • 180 дн.

     • Завжди

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

     Нотатка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Перегляд помилок на стороні сервера в розширенні DevTools

Ви можете переглядати повідомлення про помилки на стороні сервера та потенційні рішення за допомогою Power Pages розширення DevTools. Також ви можете налагодити код на стороні сервера, записавши в журнал власні повідомлення. Дізнайтеся більше в Power Pages розширенні DevTools: записуйте власні повідомлення за допомогою рідини.