Журналы доступа
На этой странице
Вкладка Журналы доступа — это журнал аудита: каждая попытка разблокировки — успешная, отклоненная или неудачная, из мобильного приложения или выполненная администратором — записывается с указанием того, кто, какая дверь, когда, откуда и с каким результатом. На этой странице описаны чтение журнала, фильтрация, представление No visit recorded, экспорт в CSV и подробные сведения о событии.
Рисунок 1. Вкладка Журналы доступа
События хранятся примерно 13 месяцев, после чего удаляются автоматически. Удаление пользователя не удаляет его события — история сохраняется для журнала аудита.
Журналы доступа отделены от Журналов аудита, в которых записываются запросы, выполняемые во всем Performance Hub.
Фильтрация и поиск
Рисунок 2. Поиск, метки фильтров, столбцы, экспорт, автообновление и диапазон
| Элемент управления | Назначение |
|---|---|
| Search | «Search door, person, event ID…» — поиск по двери, человеку, идентификатору события, идентификатору команды, состоянию и причине отказа |
| View | Door events (журнал аудита) или No visit recorded (см. ниже) |
| State, Result, Door, Source, Partner, Reason | Метки фильтров, сужающие список по состоянию события, результату, двери, источнику запроса, партнеру по интеграции и причине отказа |
| Columns | Выбор столбцов, отображаемых в таблице; на кнопке указано, сколько столбцов включено |
| Экспорт CSV | Скачивание событий, соответствующих текущим фильтрам (см. Экспорт в CSV) |
| Live | Автоматическое обновление списка с обратным отсчетом до следующего обновления; кнопка рядом выполняет обновление сразу |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days или произвольные даты |
В заголовке отображается количество событий для текущего диапазона и фильтров. Для каждого диапазона загружается до 500 последних событий.
Состояния событий
| Метка состояния | Значение |
|---|---|
| Confirmed unlocked | Контроллер двери подтвердил срабатывание реле — дверь действительно разблокирована |
| Unlocked | Получено сообщение об успешной разблокировке |
| Admin Unlocked | Администратор инициировал разблокировку из Performance Hub (переопределение администратором). Записывается сразу после отправки команды |
| Denied | Запрос отклонен — см. столбец Reason (все причины) |
| Pending / Request received | Запрос еще обрабатывается (временное состояние — обычно разрешается в течение нескольких секунд) |
| Timed out | Команда разблокировки отправлена, но контроллер не подтвердил ее вовремя — обычно это проблемы с подключением у двери |
| Failed | Разблокировку не удалось выполнить из-за ошибки |
| Locked by staff | Сотрудник использовал Lock now, когда расписание автоматической разблокировки держало дверь открытой. Событие расписания, а не попытка разблокировки |
| Schedule resumed | Расписание автоматической разблокировки снова вступило в силу — при следующем изменении или после нажатия сотрудником Resume schedule. Событие расписания, а не попытка разблокировки |
В каждой строке отображаются метка времени, состояние, дверь, человек, расстояние до двери и задержка команды (если доступно), а для отклоненных событий — причина отказа.
Представление No visit recorded
Рисунок 3. Представление No visit recorded
Выберите для View значение No visit recorded, чтобы увидеть разовые Access Time Windows, добавленные администратором или интеграцией, в течение которых человек так и не разблокировал дверь (с учетом льготного периода). Столбцы: Person, Scheduled period, Source / partner, Status. Записи хранятся около 13 месяцев.
Например, офис может увидеть, какие подрядчики с разовым окном доступа так и не пришли.
Привязка к политикам доступа
События, разрешенные политикой, указывают названную политику, а также совпавшие аудиторию, цель и расписание. Для совпадений по расписанию также могут указываться конкретные начало и конец действующего периода.
Access Time Windows, принадлежащие администратору и интеграции, сохраняют собственные пути привязки (admin_time_window и source_time_window); они не переименовываются в Access Policies. Отказы по политике различают несовпадения цели, аудитории и неактивного расписания. Для будущего периода используется outside_access_time_window со структурированными сведениями о доступности, если они известны.
Сведения о событии
Нажмите любую строку, чтобы открыть диалоговое окно Access Details.
Рисунок 4. Диалоговое окно Access Details для разблокировки участником
В заголовке отображаются дверь, ее местоположение, результат, значок Admin override (если применимо) и причина отказа (если запрос отклонен). Поля, отображаемые при наличии данных:
| Поле | Примечания |
|---|---|
| Date / Time | Когда была сделана попытка |
| Coordinates | Местоположение, переданное телефоном, с точностью GPS (±N м); можно скопировать |
| Door / Gate | Название и местоположение двери |
| Person или Admin | Кто сделал попытку — для разблокировок администратором отображается учетная запись администратора |
| Device | Использованный телефон или устройство |
| IP Address | IP-адрес, с которого отправлен запрос; можно скопировать |
| Hold time | Как долго дверь оставалась разблокированной |
| Distance from door | Вычисленное расстояние от центра геозоны |
| Event ID / Command ID | Идентификаторы для передачи в службу поддержки; можно скопировать |
| Latency | Сколько времени потребовалось контроллеру, чтобы ответить на команду |
| Authorization source | Access Policy, постоянное разрешение, окно администратора или окно интеграции |
| Policy | Идентификатор/название политики, а также совпавшие аудитория, цель (дверь или Область доступа) и режим Anytime/Scheduled |
| Window / Source ID | Ограниченная привязка для активных окон по расписанию или окон источника |
| Active from / to | Конкретный период в секундах Unix, использованный для решения по окну; конец не включается |
Unlock Location отображает переданные координаты на карте со ссылкой Open in Google Maps. Если координат нет, отображается «No location captured — unlocked from the Performance Hub.» (переопределения администратором) или «No location data was reported for this unlock attempt.»
Экспорт в CSV
Нажмите Экспорт CSV, чтобы скачать события, соответствующие текущим фильтрам. Файл содержит поля идентификации, двери, результата, отказа, контроллера, интеграции и привязки к политике или окну. Если отфильтрованный список пуст, кнопка недоступна. В представлении No visit recorded кнопка Экспорт CSV скачивает этот список.
Советы
- Карточка Recent activity на вкладке Doors — это быстрый переход к этому журналу за последние 24 часа: нажатие события там сразу открывает его здесь.
- Разбираетесь с жалобой участника? Используйте метку State или Result, чтобы показать отклоненные попытки, найдите его по имени и прочитайте причину, а затем см. Устранение неполадок, где описано решение для каждой причины.
- При жалобах, связанных с политиками, проверьте название политики и ее параметры Who/Where/When. Для окон интеграции также проверьте давность данных источника и сопоставление
scope_key. - Серия событий Timed out на одной двери обычно означает, что у контроллера этой двери проблемы с сетью — проверьте его состояние на вкладке Doors.
- Ваш ИИ-агент может читать события дверей через MCP, например для приветствия каждого посетителя в лобби офиса. События дверей содержат идентификатор пользователя, а не имя или дату рождения.
Связанные страницы
- Справочник — все состояния и причины отказа
- Расписания политик доступа
- Устранение неполадок
- Doors