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

Примеры расследований

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

Эти примеры показывают, как с помощью раздела Журналы аудита ответить на типичные вопросы. В каждом примере приведены вопрос, нужные фильтры и действия, а также то, на что следует обратить внимание. Те же шаги подходят для площадки любого типа, поэтому адаптируйте фильтры к своему вопросу.

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

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

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

Назначение: переход от вопроса к запросам, которые на него отвечают

Кто разблокировал главный вход?

Спортзал или досуговый центр: главный вход был разблокирован удаленно, и дежурный менеджер хочет знать, кто это сделал и почему.

  1. На вкладке Logs щелкните Endpoint, введите /api/door-gate-access/* и нажмите Apply. В списке останутся только запросы Door & Gate Access.
  2. Задайте в Range период, включающий время разблокировки.
  3. Щелкните запрос, конечная точка которого заканчивается на /front-entrance/unlock.

Вкладка Logs, отфильтрованная по /api/door-gate-access/*, с открытым запросом на разблокировку главного входаВкладка Logs, отфильтрованная по /api/door-gate-access/*, с открытым запросом на разблокировку главного входа

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

На что обратить внимание: в поле User указано, кто разблокировал дверь, в данном случае oscar.tran@example.com. В Request POST Body показана указанная причина, "Member forgot access card", а в Response Body видно, что дверь была разблокирована.

Дальнейшие действия: проверьте собственную запись двери в разделе Журналы доступа модуля Door & Gate Access, где регистрируется каждая попытка разблокировки двери, в том числе из мобильного приложения.

Почему сотрудник не смог изменить роль другого пользователя?

Физиотерапевтическая клиника: координатор попытался назначить коллеге новую роль, но это не удалось.

  1. На вкладке Logs щелкните Status и выберите 403 Forbidden.
  2. Щелкните запрос 403 Forbidden, выполненный во время изменения роли.
  3. В разделе AI Error Summary нажмите Generate summary.

AI Error Summary с объяснением, что у человека, вносившего изменение, не было разрешения назначать эту рольAI Error Summary с объяснением, что у человека, вносившего изменение, не было разрешения назначать эту роль

Рисунок 2. Сводка объясняет, почему изменение роли было отклонено

На что обратить внимание: в сводке сказано, что у человека "does not have permission to assign that role". Сверьте это с Response Body, где указано "You don't have permission to assign this role." В Request POST Body видно, какую роль пытались назначить.

Дальнейшие действия: попросите Organisation Administrator внести изменение или проверьте роль этого человека. См. разделы Изменение ролей пользователя и Шаблоны ролей.

Интеграция с системой бронирования перестала синхронизироваться ночью

Аквацентр или муниципальный объект: отметки о посещении из системы бронирования перестали появляться ночью.

  1. На вкладке Logs щелкните Endpoint, введите /partner/v1/* и нажмите Apply.
  2. Задайте в Range значение Last 24 hours.
  3. Посмотрите на статус в начале каждой строки, затем щелкните неудачные запросы, чтобы прочитать их Response Body.

На что обратить внимание: запросы со значком api-key от integrations@example.org. Здесь в списке видны 429 Too Many Requests, когда интеграция отправила слишком много запросов за короткое время, и 503 Service Unavailable. Отметьте, когда начались сбои и были ли после них успешные запросы.

Дальнейшие действия: нажмите Экспорт CSV и отправьте файл партнеру по интеграции, чтобы он проверил свою сторону. См. раздел Экспорт журналов и страницу Ошибки Partner API.

Веб-хук не сохранился

Кафе, магазин или заведение гостеприимства: менеджер настроил веб-хук для отправки сведений о посетителях в другую систему, но он не сохранился.

  1. На вкладке Logs щелкните Email и введите полный адрес электронной почты менеджера, в данном случае leo.hargreaves@example.com.
  2. Найдите два запроса POST, выполненных, когда менеджер сохранял веб-хук: 400 Bad Request и 201 Created к одной и той же конечной точке.
  3. Щелкните 400 Bad Request, затем 201 Created, выполненный несколькими минутами позже, и сравните их.

На что обратить внимание: в Response Body запроса 400 сказано "url must start with https://". В его Request POST Body адрес не начинается с https://. В запросе 201 менеджер добавил https://, и веб-хук сохранился.

Дальнейшие действия: для неудачного запроса нажмите Generate summary, чтобы получить объяснение простым языком. См. раздел AI Error Summary.

Что делал уходящий сотрудник на прошлой неделе?

Офис или коворкинг: перед уходом сотрудника его руководитель хочет получить запись о его недавних действиях.

  1. На вкладке Logs щелкните Email и введите полный адрес электронной почты этого человека.
  2. Задайте в Range значение Last 7 days.
  3. Прокрутите список до конца, чтобы загрузились все запросы. В экспорт попадают только загруженные строки.
  4. Нажмите Экспорт CSV, затем Export.

На что обратить внимание: на изменения, а не на чтение данных. Поочередно задайте в Method значения POST, PUT, PATCH или DELETE, чтобы увидеть запросы, которые что-то создавали, изменяли или удаляли. Если что-то выглядит неожиданно, откройте запрос и прочитайте его Request POST Body.

Дальнейшие действия: когда сотрудник уйдет, отзовите его доступ. См. раздел Удаление пользователей. Храните CSV-файл в соответствии с политикой вашей организации.

На какой площадке было больше всего неудачных запросов?

Оператор с несколькими площадками: вчера на нескольких площадках возникли проблемы, и головной офис хочет понять, с чего начать.

  1. На вкладке Панель инструментов задайте в Window период, охватывающий этот день.
  2. На диаграмме Errors Over Time щелкните интервал с наибольшим числом ошибок. Откроется вкладка Logs с неудачными запросами за это время.
  3. Щелкните Объект, поочередно выберите каждую площадку и сравните количество неудачных запросов на каждой.

На что обратить внимание: на площадку, где сбоев намного больше, чем на остальных, или на сбои на одной конечной точке. Откройте несколько ее запросов и прочитайте Response Body или нажмите Generate summary.

Дальнейшие действия: другие диаграммы описаны в разделе Панель инструментов, а площадки вашей организации — в разделе Объекты.