Випущено покращення аудиту

What's New

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

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

Тепер ім’я захоплюється разом з ID у момент події, тому воно зберігається після видалення і ви можете шукати за ним.

The Affected Column

З’явився новий стовпець Affected у таблиці, який показує особу або об’єкт, на який вплинула подія, за ім’ям. Для особи це відображається як jsmith (jsmith@example.com). Для налаштування віджету або групи модерації це ім’я, яке ви надали. Для медіа‑файлу це назва файлу, який ви завантажили.

Над таблицею є відповідне поле пошуку, Who or what was changed. Введіть ім’я, електронну адресу або ID, і воно знаходить події, що стосуються цієї особи або об’єкта. Вам не потрібно знати, який саме з трьох типів у вас є, і не треба спочатку шукати внутрішній ID.

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

Date Range

Рядок фільтрів тепер має випадаючий список Date Range з варіантами Last 30 Days, Last 90 Days, Last Year, All Time та Custom range, який відкриває вибір дат From і To.

Діапазон дат — це найпростіший спосіб звузити пошук, а поєднання його з іншими фільтрами — найшвидший спосіб знайти потрібне.

Managed Accounts

Якщо ваш обліковий запис керує іншими орендарями, є прапорець Include sub-tenants. При його встановленні пошук охоплює ваш обліковий запис і всі орендарі, якими він керує, в один прохід, зі стовпцем Tenant, що показує, з якого облікового запису походить кожна подія.

До цього часу журнал кожного орендаря можна було читати лише окремо, тому відповідь на питання «чи хтось торкався наших ресурсів цього тижня» вимагала перемикання між кожним з них по черзі.

Updates Now Record What Changed

Редагування учасника команди раніше записувало лише кінцевий набір дозволів. Це показувало, які дозволи є зараз, але не які були раніше, тому питання «хто зняв у цієї особи доступ до білінгу і коли» залишалося без відповіді.

Тепер події оновлення включають карту changes лише з полями, які фактично змінилися, кожне з попереднім і новим значенням. Незмінені поля виключені, тому зміна дозволу відображається одним рядком, а не стіною булевих значень.

Descriptions, and the Device Behind a Change

Деструктивні події тепер містять просте речення, що описує, що сталося, наприклад «Removed user from the account». Перегляди сторінок мали описи, а видалення — ні, що було помилкою.

Події, що змінюють щось, також записують браузер, яким була здійснена зміна. Сесії записуються у вигляді хешу, щоб дії однієї особи можна було пов’язати без збереження будь‑якої інформації, яку можна було б відтворити.

Other Improvements

• Декілька виправлень у пагінації та комбінаціях фільтрів.
• Події входу показували порожній стовпець Who. Ім’я користувача було в записі весь час, просто сторінка його не читала.
• Стовпець дії відображав події входу як N/A, бо Login відсутній у списку назв дій.
• Сторінки аудиту не могли назвати SSO‑користувачів, показуючи «Missing User». Тепер вони правильно розпізнаються.
• Сторінка працює значно швидше на облікових записах з довгою історією.

For the API

Endpoint /api/v1/audit-logs отримав відповідні фільтри: username, ip, crudType, resourceName, targetId, target для пошуку підрядка, а також includeManagedTenants. Відповіді тепер включають targetId, targetLabel та ua.

Два зміни, які варто зазначити, якщо ви вже викликаєте цей endpoint. before тепер працює самостійно, раніше його ігнорували, якщо не передавали after. А limit тепер обмежений 10 k зі значенням за замовчуванням 5 k. Раніше обмеження не було.

Documentation

The AuditLogs API guide covers the new query parameters, and the AuditLog structure reference covers the new fields.

If you haven't used the audit log before, the original release post walks through where it lives, who can read it, and how long entries are kept. All of that is unchanged.

In Conclusion

We're glad we can continue to improve FastComments. If you go looking for something in your log and can't find it, tell us below.

Cheers!