# Як переглядати логи виконання тестів сценарію

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

## Коли знадобиться

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

## Основні поняття

- **Логи виконання** — записи про події, які відбулися під час тестування сценарію: повідомлення системи, помилки, попередження, інформаційні записи.
- **Джерело логу** — місце, звідки прийшов лог: `logger` (системний логер) або `console` (консольні записи з коду).
- **Тип логу** — рівень важливості: `info`, `error`, `warn`, `debug`, `log`, `exception`.
- **Нода** — елемент сценарію, для якого збираються логи.

## Перед початком

- У вас є доступ до модуля Конструктор сценаріїв.
- Ви вже запустили тест сценарію (через кнопку "Тест" або "Запустити тест").
- Тест завершився (успішно або з помилкою).

## Як переглянути логи

### 1. Відкрийте деталі виконання тесту

1. У Конструкторі сценаріїв знайдіть список запущених тестів (розділ "Runs" або "Виконання").
2. Виберіть потрібний тест зі списку.
3. Відкрийте деталі виконання — натисніть на тест або кнопку "Деталі".

### 2. Перегляньте логи для конкретної ноди

1. У деталях виконання знайдіть список нод, які виконувалися під час тесту.
2. Виберіть ноду, для якої потрібно подивитися логи.
3. Відкрийте діалог деталей виконання ноди — натисніть на ноду або кнопку "Деталі виконання".
4. Перейдіть на вкладку **"Logs"** (Логи).

### 3. Використовуйте фільтри для пошуку

У вкладці "Logs" доступні фільтри:

- **Джерело** — виберіть `logger` (системні логи) або `console` (консольні записи).
- **Тип** — виберіть рівень важливості: `info`, `error`, `warn`, `debug`, `log`, `exception`.
- **Тільки помилки** — увімкніть, щоб показати лише записи з помилками та винятками.

### 4. Прочитайте інформацію з логів

Кожен лог містить:

- **Джерело та тип** — теги вгорі запису показують, звідки прийшов лог і його рівень важливості.
- **Повідомлення** — основний текст логу (що сталося).
- **Модуль та файл** — для системних логів (`logger`) показується модуль і файл, звідки прийшов лог.
- **Stack trace** — для помилок показується повний стек викликів, що допомагає знайти місце помилки.
- **Дані** — структуровані дані (якщо є) — можна розгорнути через "Data".

## Що означають типи логів

- **`error`** / **`exception`** — критичні помилки, які перервали виконання або вказують на проблему. Завжди показуються.
- **`warn`** — попередження про потенційні проблеми або неочікувану поведінку.
- **`info`** — інформаційні записи про нормальну роботу системи.
- **`log`** — звичайні записи з консольних викликів у коді.
- **`debug`** — детальні записи для діагностики (показуються тільки в режимі детального логування).

## Режим детального логування

За замовчуванням показуються тільки помилки та важливі записи. Щоб побачити всі логи (включно з `info`, `log`, `debug`):

1. Зверніться до адміністратора системи.
2. Попросіть увімкнути налаштування `workflow_logs_verbose` в системних налаштуваннях.
3. Після увімкнення всі логи будуть зберігатися та відображатися.

## Поради з використання

- Почніть з фільтру "Тільки помилки" — це допоможе швидко знайти проблемні місця.
- Переглядайте логи в хронологічному порядку — вони відсортовані від найстаріших до найновіших.
- Звертайте увагу на `stack trace` у помилках — там вказано точне місце в коді, де виникла проблема.
- Використовуйте інформацію про модуль та файл — це допомагає зрозуміти, яка частина системи викликала лог.

## Пов'язані інструкції

- [Як створити сценарій](/uk/scenariodialog/how-to/create-scenario.md)
- [Як використати дію в сценарії](/uk/scenariodialog/how-to/use-action-in-scenario.md)
- [Як переглянути історію сценарію](/uk/scenariodialog/how-to/view-scenario-history.md)