Observer записывает запись журнала аудита для каждой операции создания, обновления и удаления данных дел. Журналы аудита предназначены только для добавления — их нельзя редактировать или удалять.

Что фиксируется

КатегорияФиксируемые операции
ЛюдиСоздание, обновление, удаление записей о лицах
Записи поддержкиСоздание, обновление, удаление консультаций
Записи о миграцииСоздание, обновление, удаление записей о передвижениях
ДомохозяйстваСоздание, обновление, удаление домохозяйств и членов
ЗаметкиСоздание, обновление, удаление заметок к делу
ДокументыЗагрузка, обновление метаданных, удаление документов
ЖивотныеСоздание, обновление, удаление записей о животных
РазрешенияНазначение, обновление, отзыв разрешений проекта

События аутентификации (вход, выход, обновление токена) не входят в журнал аудита проекта — они отображаются в серверных журналах.

Просмотр журнала аудита

Доступ к журналу аудита имеют только менеджеры и владельцы проекта.

GET /projects/:project_id/audit?page=1&per_page=50
ПараметрОписание
pageНомер страницы (по умолчанию 1)
per_pageРезультатов на странице (по умолчанию 50)
actor_idФильтр по пользователю, внёсшему изменение
startФильтр по дате (ГГГГ-ММ-ДД)
endФильтр по дате (ГГГГ-ММ-ДД)

Формат ответа

Каждая запись аудита содержит:

{
  "id": "01J...",
  "project_id": "01J...",
  "actor_id": "01J...",
  "actor_ip": "192.168.1.1",
  "action": "create",
  "entity_type": "person",
  "entity_id": "01J...",
  "created_at": "2024-06-15T10:30:00Z"
}
ПолеОписание
actor_idПользователь, выполнивший действие
actor_ipIP-адрес запроса
actioncreate, update или delete
entity_typeТип записи (person, support_record, note и т.д.)
entity_idULID затронутой записи

Аудит в веб-интерфейсе

  1. Откройте проект
  2. Нажмите Журнал аудита в навигации
  3. Отфильтруйте по диапазону дат или пользователю
Для доступа к журналу аудита требуется роль manager или owner в проекте. Консультанты и наблюдатели не могут видеть журнал аудита.