사용 매뉴얼
개요
대상 사용자: 캡스 출입통제시스템을 운영하는 보안 담당자 및 물리 보안 관리자
ADT캡스 앱을 통해 다음 업무를 수행할 수 있습니다.
- 대시보드를 통한 출입 패턴 실시간 모니터링
- 임직원별·출입문별 출입 이력 조회 및 이상 징후 확인
- 출입 실패 이벤트 분석을 통한 비인가 출입 시도 감지
기본 개념·용어
| 용어 | 의미 | 관련 리소스 |
|---|---|---|
| 출입 이벤트 | 임직원이 출입문에 카드를 태그할 때 발생하는 단위 로그 | — |
| 사번(emp_key) | 임직원 고유 식별자. 카드 소지자를 특정할 때 사용 | — |
| 출입문 ID | 출입문의 시스템 고유 식별자. 동일 이름의 출입문이 여럿일 때 구분에 활용 | — |
주요 화면·메뉴 경로
| 기능 | 경로 |
|---|---|
| 출입 로그 조회 | 분석 > 로그 |
| 쿼리 실행 | 분석 > 쿼리 |
| 대시보드 | 대시보드 > 대시보드 |
| 수집기 상태 확인 | 수집 > 수집기 |
| 로그 스키마 확인 | 수집 > 로그 스키마 |
대시보드·리포트
출입보안 대시보드
용도: 수집된 출입 로그를 시각화하여 출입 패턴·이상 징후를 한눈에 파악합니다.
주요 위젯:
| 위젯명 | 지표·질문 |
|---|---|
| ADT캡스 출입보안 사용 출입문 상위 10 | 출입 이벤트가 많은 출입문 순위 |
| ADT캡스 출입보안 출입실패사용자 상위 10 | 출입 실패 건수가 많은 사용자 순위 |
| ADT캡스 출입보안 출입결과 성공 추이 | 시간대별 출입 성공 이벤트 수 변화 |
| ADT캡스 출입보안 출입결과 실패 추이 | 시간대별 출입 실패 이벤트 수 변화 |
| ADT캡스 출입보안 최근 로그 | 최근 수집된 출입 이벤트 목록 |
작업 시나리오
시나리오 1: 특정 임직원 출입 이력 조회
목적: 사번으로 대시보드를 필터링하여 특정 임직원의 출입 이력을 확인하고, 비인가 구역 접근 여부를 파악하거나 방문 이력을 증빙합니다.
사전 조건:
- ADT캡스 수집기가 정상 동작 중이고 데이터가 수집된 상태
- 조회 대상 임직원의 사번 확인
수행 절차:
- 대시보드 > 대시보드에서 ADT캡스 출입보안 대시보드를 엽니다.
- 우측 상단 필터 아이콘을 클릭해 필터 패널을 엽니다.
- 대시보드 필터의 시간 필터에서 조회 기간을 설정합니다.
- 데이터셋 필터 내 사번 필터에 조회할 임직원의 사번을 입력합니다.
결과 확인:
필터 적용 시 모든 차트와 ADT캡스 출입보안 최근 로그 테이블이 해당 사번 기준으로 갱신됩니다.
- 최근 로그 테이블에서 출입문별 성공·실패 이력을 확인합니다.
결과 = 실패건이 특정 출입문에서 반복되면 비인가 출입 시도로 간주해 추가 확인이 필요합니다.
실패 대응:
| 증상 | 원인 | 해결 |
|---|---|---|
| 필터 후 데이터 없음 | 사번 형식 불일치 또는 수집 미동작 | 사번 형식 확인, 수집 > 수집기 상태 확인 |
시나리오 2: 출입 실패 이벤트 분석
목적: 결과 필터로 출입 실패 이벤트만 추려 비인가 출입 시도 패턴을 파악합니다.
사전 조건:
- ADT캡스 수집기가 정상 동작 중이고 데이터가 수집된 상태
수행 절차:
- 대시보드 > 대시보드에서 ADT캡스 출입보안 대시보드를 엽니다.
- 우측 상단 필터 아이콘을 클릭해 필터 패널을 엽니다.
- 대시보드 필터의 시간 필터에서 조회 기간을 설정합니다.
- 데이터셋 필터 내 결과 필터에서 실패를 선택합니다.
결과 확인:
필터 적용 시 모든 차트와 최근 로그 테이블이 출입 실패 이벤트 기준으로 갱신됩니다.
- ADT캡스 출입보안 출입실패사용자 상위 10 위젯에서 실패 건수가 많은 사용자를 확인합니다.
- ADT캡스 출입보안 출입결과 실패 추이 위젯에서 시간대별 실패 이벤트 급증 여부를 확인합니다.
- 하단 최근 로그 테이블에서 실패 건의 사번·출입문을 확인하고, 반복 발생 임직원은 시나리오 1의 사번 필터로 상세 조회합니다.
실패 대응:
| 증상 | 원인 | 해결 |
|---|---|---|
| 필터 후 데이터 없음 | 조회 기간 내 출입 실패 이벤트 없음 | 정상. 조회 기간을 늘려 재확인 |
| 특정 출입문 데이터 없음 | 해당 출입문이 수집 대상에 미포함 | 캡스 시스템에서 해당 출입문 이벤트 생성 확인 |
| 건수가 예상과 다름 | 폴링 주기로 인한 최신 데이터 지연 | 60초 폴링 주기 감안 후 재조회 |
주의사항
- 폴링 지연: 기본 폴링 주기는 60초입니다. 수집기 설정에서 상한 조건(
DATEADD)을 적용한 경우 최대 수 시간의 수집 지연이 발생할 수 있습니다. 실시간 모니터링이 필요하다면 상한 조건을 제거하거나 줄이세요. - 카드 ID와 사번 구분:
card_id(카드 물리 ID)와emp_key(사번)는 다른 값입니다. 임직원 조회 시emp_key또는emp_name을 사용하세요.
FAQ
Q. 수집기가 실행 중인데 대시보드에 데이터가 표시되지 않습니다.
A. 최초 실행 후 첫 번째 폴링이 완료될 때까지 최대 60초가 소요됩니다. 수집 > 수집기에서 수집기 상태가 동작 중인지 확인하고, ADTCAPS 테이블에 데이터가 쌓이는지 확인하세요.
Q. 동일 이벤트가 중복 수집됩니다.
A. JDBC 증분 수집에서 추적 컬럼(event_datetime)의 값이 동일한 레코드가 여럿 있을 경우 중복 수집이 발생할 수 있습니다. 원본 DB에서 event_datetime 값의 유일성을 확인하세요.
관련 문서
- 설치 매뉴얼 — 최초 설치 및 DB 접속 프로파일·수집기 설정
- 출입보안 로그 스키마 — 수집 필드 정의 및 샘플값
- 대시보드 필터 사용 가이드 — 대시보드 필터·사용자 정의 변수·데이터셋 필터 상세 설명