Логотип Performance HubPerformance Hub
Раздел сайта: Документация

Журналы аудита

На этой странице

Журналы аудита — это запись запросов к Performance Hub в вашей организации. Они охватывают запросы людей, работающих с Performance Hub в браузере или приложении, а также запросы подключённых инструментов, таких как API-ключи, ИИ-агенты, подключённые через MCP, и Model Router. С их помощью можно ответить на такие вопросы, как кто открыл дверь, почему изменение не сохранилось или когда интеграция перестала работать, — будь то офисы, магазины, кафе, площадки для мероприятий, клиники, кампусы или спортзалы.

Краткая справка

Где найти: Settings (значок шестерёнки, внизу слева) → Журналы аудита

Кто может использовать: вам нужна роль, которая включает Журналы аудита и Identity & Access Management в вашей организации, например Organisation Administrator. См. раздел Кто может использовать журналы аудита.

Назначение: просмотр того, кто что делал в Performance Hub, и выяснение причин сбоя запроса

Панель инструментов журналов аудита с кнопкой Window, пятью основными показателями и графиком Request TimelineПанель инструментов журналов аудита с кнопкой Window, пятью основными показателями и графиком Request Timeline

Рисунок 1. Панель инструментов журналов аудита: временное окно, основные показатели и хронология запросов

Что записывается в журнал

Каждая запись журнала — это один запрос к Performance Hub. В ней указано:

  • Кто выполнил запрос: адрес электронной почты пользователя.
  • Откуда: IP-адрес, а также браузер или инструмент, отправивший запрос.
  • Что было вызвано: метод (например, GET для чтения или POST для создания) и конечная точка, то есть часть Performance Hub, для которой предназначен запрос, например /api/door-gate-access/doors/front-entrance/unlock.
  • Результат: статус ответа, например 200 при успехе или 403, если у человека не было разрешения.
  • Сколько времени это заняло, в миллисекундах.
  • Источник: значок источника, например web для человека, работающего с Performance Hub, или api-key для интеграции. См. раздел Значки источников.

Для недавних запросов запись журнала также содержит отправленные и полученные данные. См. раздел Чтение записи журнала.

Две вкладки

ВкладкаНазначение
Панель инструментовИтоговые значения, частота ошибок и графики за временное окно, а также самые активные конечные точки и пользователи. Щёлкните график или строку, чтобы открыть соответствующие записи журнала.
LogsСами запросы. Фильтруйте список и выполняйте поиск по нему, открывайте запись журнала для просмотра подробностей и экспортируйте данные в CSV.

Кто может использовать журналы аудита

Вам нужна роль, которая включает Журналы аудита и Identity & Access Management в вашей организации, например Organisation Administrator. Если вы не видите пункт Журналы аудита в меню настроек, ваша роль его не включает.

  • Какие организации вы видите: организации, в которых ваша роль включает и Журналы аудита, и Identity & Access Management. На вкладке Logs отображается их количество, например "Viewing logs for 1 organisation".
  • Шаблоны ролей: шаблон Organisation Administrator включает Журналы аудита. Шаблоны Site Manager и Site Owner их не включают. См. раздел Шаблоны ролей.
  • Пользовательские роли: чтобы пользовательская роль могла использовать Журналы аудита, включите в её доступ к модулям и Журналы аудита, и Identity & Access Management. См. раздел Область доступа и доступ к модулям.

Журналы аудита показывают адреса электронной почты людей, IP-адреса и отправленные ими данные, поэтому предоставляйте доступ к ним только тем, кому он действительно нужен.

Сколько хранятся журналы

Срок хранения журналов аудита определяет, как долго они хранятся: 90 дней для каждой записи журнала и 7 дней для полных данных запроса и ответа.

В меню Range на вкладке Logs указано:

"Журналы аудита хранятся 90 дней. Полные полезные нагрузки запросов и ответов хранятся 7 дней, после чего остается короткий предварительный просмотр. Требуется более длинная история? Обратитесь в службу поддержки (может взиматься дополнительная плата)."

Таким образом, можно просматривать данные за последние 90 дней. В течение первых 7 дней запись журнала содержит полный запрос и ответ. После этого длинное содержимое сокращается до краткого фрагмента. См. раздел Через 7 дней: фрагменты.

Что можно делать