ADT캡스

개요

ADT캡스 앱은 캡스 출입통제시스템의 출입 이벤트 뷰 테이블을 JDBC 폴링 방식으로 정기 수집하여 출입보안 로그를 로그프레소 소나에 정규화·저장합니다.

적용 범위

요구 사항

ADT캡스 DB 설정

단계 1: DB 계정·권한 준비

출입 이벤트 뷰 테이블에 SELECT 권한을 가진 읽기 전용 계정을 준비합니다.

단계 2: 수집 대상 확인

수집 대상 뷰 테이블과 증분 폴링 기준 컬럼을 확인합니다.

로그프레소 수집 설정

단계 1: DB 접속 프로파일 추가

시스템 > 접속 프로파일 > 추가:

항목을 모두 입력한 뒤, 접속 테스트 버튼을 통해 정상적으로 접속되는지 확인합니다.

단계 2: 수집기 추가

수집 > 수집기 > 추가에서 아래 값을 입력합니다.

수집기의 상세 설정에서 아래 값을 입력합니다.

SQL:

SELECT
    CONVERT(DATETIME, e_datetime, 120) AS event_datetime,
    e_mode_name AS category,
    CASE e_result WHEN 1 THEN '성공' WHEN 0 THEN '실패' END AS result,
    e_doorname AS door_name,
    e_idno AS emp_key,
    e_name AS emp_name,
    e_Card AS card_id,
    e_doorid AS door_id,
    e_mode AS category_code
FROM {출입 이벤트 뷰 테이블}
$where
ORDER BY event_datetime

수집 검증

수집기를 활성화하면 첫 번째 폴링은 조건절을 무시하고 설정한 SQL로 조회된 전체 데이터를 수집합니다. 이후 폴링부터는 직전 수집 시점 이후에 추가된 행만 가져오므로 중복 없이 신규 이벤트를 수집합니다.

수집기 활성화 후 수집 > 수집기에서 해당 수집기의 수집 건수를 확인하거나 테이블을 조회하여 수집을 확인합니다.

• 정상: 수집 건수가 1 이상.
• 비정상: 수집 건수가 0이거나 오류 상태이면 DB 접속 프로파일 테스트, WHERE 조건·시간 컬럼 설정, 폴링 주기, JDBC 디버그 로그를 재확인합니다.

참고 자료

• 로그프레소 소나 공식 문서
• 접속 프로파일 설정 가이드
• 수집기 설정 가이드