# Як переглянути журнал змін налаштувань?

Журнал змін налаштувань показує, хто і коли змінив критичні параметри платформи — теми, ролі, поля клієнта, email відправника та інші сутності. Це допомагає швидко з’ясувати причину неочікуваної зміни під час розслідування інциденту.

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

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

## Що важливо знати

- **Функція вимкнена за замовчуванням** — root-адміністратор увімкне її в **Налаштуваннях інстансу** (категорія **System**, перемикач **Settings Audit Trail**).
- **Пункт меню** «Журнал змін налаштувань» у бічному меню **лише для root-адміністратора**. Якщо функцію не увімкнено, на сторінці з’явиться повідомлення, що журнал вимкнено.
- **Інші ролі** — якщо адміністратор надав право перегляду журналу, відкрийте сторінку напряму за адресою **`/settings-page/settings-audit`** (пункту в меню може не бути).
- **Зберігання записів** — система автоматично видаляє старі записи (типовий термін — близько 180 днів).

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

- [x] Ви увійшли в систему як root-адміністратор або користувач із правом перегляду журналу.
- [x] Root-адміністратор увімкнув **Settings Audit Trail** у налаштуваннях інстансу.

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

### 1. Увімкнути журнал (лише root-адміністратор)

1. Перейдіть до **Налаштувань** (`/settings-page`).
2. У бічному меню відкрийте **«Налаштування інстансу»**.
3. Прокрутіть до блоку перемикачів функцій і розгорніть категорію **System**.
4. Увімкніть **Settings Audit Trail**.
5. Оновіть сторінку журналу, якщо вона вже була відкрита.

Детальніше про роботу з налаштуваннями інстансу — [Як налаштувати параметри інстансу](/uk/settings/how-to/configure-instance.md).

### 2. Відкрити журнал змін

**Якщо ви root-адміністратор:**

1. Перейдіть до **Налаштувань** (`/settings-page`).
2. У бічному меню розгорніть групу **«Технічна діагностика»**.
3. Оберіть **«Журнал змін налаштувань»**.
4. Відкриється таблиця з останніми змінами.

**Якщо у вас є право перегляду, але ви не root:**

1. Увійдіть у систему під обліковим записом із відповідною роллю.
2. Відкрийте в браузері **`/settings-page/settings-audit`**.

### 3. Переглянути записи

У таблиці для кожної зміни відображаються:

- **Час** — коли відбулася дія.
- **Актор** — хто виконав зміну.
- **Модуль** — де знаходиться сутність (наприклад, операторська панель, налаштування, Fast Line Pro).
- **Сутність** — що саме змінили (тема, роль, тег тощо).
- **Дія** — створення, зміна або видалення.
- **Опис** — короткий підсумок зміни.

### 4. Переглянути деталі зміни

1. Розгорніть рядок у таблиці (клік по рядку).
2. У блоці **«Зміни полів»** побачите таблицю «поле / було / стало».
3. Якщо детальний перелік полів недоступний, з’явиться повідомлення **«Немає детального diff»** або аналогічне.

### 5. Відфільтрувати записи

1. Задайте **період** у полі діапазону дат.
2. Оберіть **модуль**, **тип сутності**, **дію** або **актера** у відповідних списках.
3. Введіть текст у поле **пошуку**, щоб знайти запис за назвою або описом.
4. Натисніть **«Оновити»**, якщо потрібно примусово перезавантажити дані.

### 6. Надати доступ іншій ролі (за потреби)

1. Перейдіть до **Налаштувань** → **Ролі**.
2. Відкрийте роль, якій потрібен доступ до журналу.
3. Увімкніть право на перегляд журналу змін налаштувань (якщо воно доступне в списку прав).
4. Збережіть роль.

## Що відбувається після

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

## Як переконатися, що все вдалось

- Після увімкнення функції сторінка показує таблицю записів, а не повідомлення про вимкнений журнал.
- Зробіть тестову зміну (наприклад, створіть тему) і перевірте, що з’явився новий запис з дією «Створення».
- Розгорніть запис і переконайтеся, що блок **«Зміни полів»** показує колонки **«Поле / Було / Стало»**.
- Перевірте, що фільтри зменшують список до очікуваних записів.

## Пов'язані матеріали

- [Налаштувати параметри інстансу](/uk/settings/how-to/configure-instance.md)
- [Налаштувати ролі](/uk/settings/how-to/configure-roles.md)
- [Переглянути стан системи](/uk/settings/how-to/view-system-status.md)

## Важливі примітки

- ⏳ **Без увімкнення функції** зміни не потрапляють у журнал — спочатку увімкніть **Settings Audit Trail** в налаштуваннях інстансу.
- 📋 **Що фіксується:** теми, теги, ролі, боти, поля клієнта, email відправника, кастомні модулі, агенти та бази знань Fast Line Pro, Action Jail, чеклісти контролю якості, файли, шаблони розсилок та інші критичні сутності операторської панелі.