Кто и что изменил в организации
Читайте журнал аудита — какие изменения настроек он записывает, кто может его открыть и как найти запись.
3 мин чтения
Журнал аудита — это история изменений в организации: что изменено, кем и когда. Эта страница — о странице журнала аудита в консоли.
Где находится журнал
Откройте Настройки, затем Журнал аудита. Журнал один на всю организацию. Он не зависит от проекта, выбранного в шапке.
Журнал открывается человеку, у которого есть разрешение management:read и доступ ко всем проектам организации. У участника с ролью Владелец или Администратор он есть всегда. У участника с ролью Разработчик или Финансы — когда его доступ к проектам — Все проекты. API-ключ прочитать журнал не может: API отвечает 403 с кодом project_access_restricted.
Что записывается
Запись появляется при каждом успешном изменении настроек — сделано оно в консоли или через API.
| Где | Что записывается |
|---|---|
| Организация и проекты | Организация обновлена, проект создан или обновлён |
| Участники и приглашения | Изменены роль или доступ участника, участник удалён, приглашение отправлено, отправлено повторно или отозвано |
| API-ключи | Ключ создан, прошёл ротацию или отозван |
| Политики, вебхуки и правила оповещения | Созданы, обновлены или удалены |
| Подключения | Подключение создано, обновлено, удалено, включено, выключено или проверено, заданы его лимиты, оно поставлено на паузу или пауза снята |
| Пулы провайдеров | Пул создан, обновлён или удалён, подключение добавлено в пул, обновлено в нём или убрано из него |
| AI-флоу | Флоу создан, обновлён, проверен, опубликован или откачен, сохранён его черновик, он привязан к операции или отвязан от неё |
| Согласования | Запрос одобрен или отклонён |
| Бюджеты | Бюджет создан, изменён или отправлен в архив |
| Клиенты | Клиент добавлен, заблокирован, разблокирован или удалён, сохранены настройки счёта, кредиты пополнены, списаны или скорректированы, задана цена в кредитах |
Запись хранит метод и путь запроса и никогда — его тело. Секрет в журнал не попадает.
Что не записывается
Запрос, который только читает.
Изменение, которое отклонено или завершилось ошибкой.
То, что ваше приложение отправляет, чтобы запускать флоу: запросы к флоу и вызовы моделей, которые они делают. Они — на странице Операции.
Принятие оповещения.
То, что человек делает со своей учётной записью: вход и выход, смена пароля или электронной почты, завершение сессий, переключение организации или проекта, создание организации и выход из неё, принятие приглашения и отказ от него.
Прочитать запись
Самые новые записи — вверху.
| Колонка | Что показывает |
|---|---|
| Действие | Что сделано — словами, а под ними код действия |
| Ресурс | Вид того, что изменено, и его сокращённый id |
| Кто | Имя участника или API-ключ, которым сделано изменение |
| IP-адрес | Адрес, с которого пришёл запрос |
| Когда | Время изменения |
Нажмите строку, чтобы открыть запись целиком. В ней добавляются полный id ресурса, человек или API-ключ действовал, метод и путь запроса и id самой записи. Id копируется нажатием на него.
Найти запись
Все действия и Все ресурсы сужают журнал до одного действия или до одного вида ресурса.
Период — За всё время, Сегодня, Последние 7 дней, Последние 30 дней или Свой период… с двумя датами. День начинается и кончается по часам вашего браузера.
Поле поиска просматривает только уже загруженные строки. Нажмите Показать ещё, чтобы загрузить более старые записи, — и поиск охватит и их.
Обновить читает журнал заново.
Что читать дальше
Участники и приглашения — роли и что такое доступ к проектам.
Управление API-ключами — ключи, изменения которых записывает журнал.
Коды ошибок — каждый код API — что он значит и что делать.