Audit log, export и retention

Результат

Вы сможете определить автора project action, выгрузить переносимую копию данных и настроить retention, не предполагая, что сохранённое значение уже что-то удалило.

Что потребуется

• По умолчанию Audit Log доступен с роли Viewer, но owner может повысить минимальную роль в Organization → Access control.
• Export & Retention доступен только admin и owner.
• До сокращения retention window сделайте export. Удаление по retention — не архив и не отменяется через UI.

Исследовать событие

1. Откройте Settings → Audit Log.
2. Используйте фильтры по actor email, точному action, From date или To date.
3. Нажмите строку, чтобы раскрыть полную запись list view.
4. Проверьте time, actor, action, resource, IP address, user agent и metadata.
5. Нажмите Load more, чтобы перейти дальше первых 50 событий.
6. Сопоставьте событие с Activity и внешней системой.

События отсортированы от новых к старым. Раскрытая запись UI намеренно не показывает все before/after states; более полное представление audit входит в JSON export.

Выгрузить данные проекта

1. Откройте Settings → Export & Retention.

2. Выберите:

3. Download JSON bundle — entities проекта и audit log в одном файле;

4. Download entities CSV — табличная выгрузка только entities.

5. Дождитесь browser download и сохраните файл в разрешённом хранилище.

6. Проверьте project, export timestamp и несколько ожидаемых записей до того, как считать файл пригодным архивом.

Download передаётся stream напрямую; отдельной страницы export job status нет. CSV из UI содержит только entities, потому что у entities и audit records нет общей схемы.

Настроить retention

1. В Export & Retention оставьте поле пустым, чтобы хранить ресурс бессрочно.
2. Для Audit log retention (days) укажите целое число от 1 до 3650.
3. Для Telegram history retention (days) укажите число от 1 до 3650 только после проверки Telegram pruning в deployment.
4. Нажмите Save.
5. Перезагрузите страницу и проверьте сохранённые значения.

Audit-log retention применяется ежедневным sweep, поэтому сокращение window не означает немедленного удаления.

Проверка Telegram deployment

Текущий web UI помечает Telegram history retention как Configured-only. В новых worker есть pruning workflow, но старый или неполностью настроенный deployment может только сохранять значение. Попросите platform operator подтвердить schedule до обещания срока удаления.

Как проверить результат

• Audit filters возвращают ожидаемого actor и временной диапазон.
• JSON bundle содержит entities и audit_log, CSV — entity columns.
• Retention fields сохраняются после reload.
• После подтверждённого daily sweep записи старше window отсутствуют, а новые сохранены.

Частые проблемы

Симптом	Вероятная причина	Что сделать
Вкладки Audit Log нет	Owner повысил минимальную роль	Попросите проверить Organization → Access control
Filter ничего не вернул	Action требует точного значения, неверен диапазон времени или выбран другой проект	Очистите filters, проверьте project и timezone, затем сужайте поиск
Export возвращает 403	Export доступен только admin и owner	Попросите администратора выполнить и безопасно сохранить export
Browser download не появился	Browser заблокировал download или request завершился ошибкой	Разрешите download, повторите один раз и проверьте inline error
Старые audit entries остались	Daily sweep ещё не запускался	Дождитесь следующего подтверждённого sweep
Telegram history хранится дольше значения	Setting сохранён, но pruning schedule не активен	Попросите оператора проверить worker version и schedule
Понадобилась удалённая запись	Retention удаляет данные и не создаёт архив	Восстанавливайте только из утверждённого export или backup через operator process

Следующий шаг

Примените security checklist и проверьте права ролей.