접근 로그

이 페이지의 내용

접근 로그 탭은 감사 기록입니다. 성공, 거부 또는 실패한 시도와 모바일 앱에서 한 시도 또는 관리자가 한 시도를 포함한 모든 잠금 해제 시도가 누가, 어떤 출입문을, 언제, 어디에서 열었는지와 결과와 함께 기록됩니다. 이 페이지에서는 로그 읽기, 필터링, No visit recorded 보기, CSV 내보내기, 이벤트 세부 정보 보기를 다룹니다.

접근 로그: 검색, 필터 칩, 열, 내보내기, 실시간 새로 고침, 날짜 범위

그림 1: 접근 로그 탭

이벤트는 약 13개월 동안 보관된 후 자동으로 삭제됩니다. 사용자를 삭제해도 해당 사용자의 이벤트는 삭제되지 않습니다. 감사 기록을 위해 이력이 유지됩니다.

접근 로그는 Performance Hub 전반의 요청을 기록하는 감사 로그와 별개입니다.

필터링 및 검색

접근 로그 도구 모음: View, State, Result, Door, Source, Partner, Reason 필터

그림 2: 검색, 필터 칩, 열, 내보내기, 실시간 새로 고침, 범위

컨트롤	수행하는 작업
Search	"Search door, person, event ID…": 출입문, 사람, 이벤트 ID, 명령 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 Policy 귀속

정책으로 승인된 이벤트에는 해당 정책의 이름과 일치한 대상자, 대상, 일정이 표시됩니다. 예약된 일치 항목에는 실제 활성 시작 및 종료 시간도 포함될 수 있습니다.

관리자 소유 및 통합 소유 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 m). 복사할 수 있습니다
Door / Gate	출입문 이름과 위치
Person 또는 Admin	시도한 사람. 관리자 잠금 해제에는 관리자의 계정이 표시됩니다
Device	사용한 휴대폰 또는 기기
IP Address	요청한 IP. 복사할 수 있습니다
Hold time	출입문이 잠금 해제된 상태로 유지된 시간
Distance from door	지오펜스 중심에서 계산한 거리
Event ID / Command ID	지원 에스컬레이션용으로 복사할 수 있는 식별자
Latency	컨트롤러가 명령에 응답하는 데 걸린 시간
Authorization source	Access Policy, 영구 권한, 관리자 시간 범위 또는 통합 시간 범위
Policy	정책 ID/이름과 일치한 대상자, 출입문/접근 범위 대상, 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 내보내기를 클릭하면 해당 목록을 다운로드합니다.

팁

Doors 탭의 Recent activity 카드는 이 로그의 24시간 바로 가기입니다. 그곳에서 이벤트를 클릭하면 이 로그의 해당 이벤트로 바로 이동합니다.
회원 불만을 조사하고 있습니까? State 또는 Result 칩으로 거부된 시도를 표시하고, 이름을 검색하고, 사유를 확인하십시오. 그런 다음 사유별 해결 방법은 문제 해결을 참조하십시오.
정책 관련 불만의 경우 정책 이름과 Who/Where/When을 확인하십시오. 통합 시간 범위의 경우 소스 경과 시간과 scope_key 매핑도 확인하십시오.
한 출입문에서 Timed out 이벤트가 연달아 발생하면 보통 해당 출입문의 컨트롤러에 네트워크 문제가 있다는 의미입니다. Doors 탭에서 상태를 확인하십시오.
AI 에이전트는 MCP를 통해 출입문 이벤트를 읽을 수 있습니다. 예를 들어 방문자별 사무실 로비 환영 화면에 사용할 수 있습니다. 출입문 이벤트에는 이름이나 생년월일이 아닌 사용자 ID가 포함됩니다.

참조: 모든 상태 및 거부 사유
Access Policy 일정
문제 해결
Doors