HandyCafe Docs
owner

로그

로그 페이지는 HandyCafe의 모든 시스템 이벤트에 대한 포괄적인 감사 추적을 제공합니다. 세션 시작부터 캐셔 로그인까지 모든 중요한 작업이 여기 기록되어 책임 추적, 문제 해결 및 규정 준수를 위한 자료로 사용됩니다.

성능

로그 뷰어는 가상 리스트 렌더링을 사용하여 수천 개의 항목을 표시할 때도 부드러운 성능을 유지합니다. 이는 언제든지 화면에 보이는 행만 DOM에 렌더링되도록 하여, 1,000개 이상의 로그 기록을 처리해도 인터페이스 성능이 저하되지 않도록 합니다.

로그 항목 필드

각 로그 항목에는 다음과 같은 필드가 포함됩니다:

필드 설명
타임스탬프 이벤트가 발생한 날짜와 시간
소스 이벤트를 생성한 시스템 구성 요소
카테고리 이벤트의 분류 (아래 카테고리 참조)
액션 특정 작업 유형 (아래 일반 작업 참조)
PC 관련된 클라이언트 PC 또는 콘솔, 해당되는 경우
IP 이벤트와 관련된 IP 주소
멤버 관련된 멤버, 해당되는 경우
캐셔 이벤트를 유발했거나 근무 중인 캐셔
메시지 발생한 일에 대한 사람이 읽을 수 있는 설명

로그 카테고리

이벤트는 8개의 카테고리로 분류됩니다:

  1. 서버 -- 서버 시작, 종료, 구성 변경 및 시스템 수준 이벤트.
  2. 클라이언트 -- 클라이언트 연결, 연결 해제 및 상태 변경.
  3. 캐셔 -- 캐셔 로그인, 로그아웃 및 관리 작업.
  4. 멤버 -- 멤버 등록, 프로필 업데이트 및 계정 변경.
  5. 세션 -- 세션 수명 주기 이벤트 (시작, 중지, 일시 중지, 재개).
  6. 콘솔 -- 콘솔 관련 이벤트 (추가, 제거, 세션 할당).
  7. 주문 -- 주문 생성, 수정 및 종료 이벤트.
  8. 결제 -- 결제 처리, 환불 및 금융 거래 이벤트.

일반 로그 작업

로그에 자주 나타나는 작업은 다음과 같습니다:

  • startSession -- 클라이언트 또는 콘솔에서 새로운 세션이 시작됨.
  • stopSession -- 활성 세션이 종료됨.
  • pauseSession -- 실행 중인 세션이 일시 중지됨.
  • resumeSession -- 일시 중지된 세션이 재개됨.
  • consoleAdded -- 새로운 게임 콘솔이 시스템에 등록됨.
  • newMemberAdded -- 새로운 멤버 계정이 생성됨.
  • orderCreated -- 새로운 제품 주문이 접수됨.
  • orderClosed -- 주문이 완료되고 종료됨.
  • cashierLogin -- 캐셔가 시스템에 로그인함.
  • cashierLogout -- 캐셔가 로그아웃함.
  • serverStarted -- HandyCafe 서버 애플리케이션이 시작됨.
  • clientConnected -- 클라이언트 PC가 서버에 연결됨.
  • clientDisconnected -- 클라이언트 PC가 서버에서 연결 해제됨.

필터링 및 검색

카테고리 필터

하나 이상의 카테고리를 선택하여 로그 표시를 좁힐 수 있습니다. 예를 들어, 세션 및 결제 이벤트만 표시하여 금융 활동을 감사할 수 있습니다.

액션 필터

특정 작업 유형으로 필터링하여 특정 이벤트를 빠르게 찾을 수 있습니다.

날짜 범위 필터

특정 기간으로 로그 보기를 제한할 수 있습니다. 다른 필터와 결합하여, 알려진 시간 창 동안 발생한 사건을 조사하기가 용이합니다.

정렬 옵션

로그 항목을 오름차순 또는 내림차순으로 정렬할 수 있습니다. 타임스탬프(최신 항목 우선)로 정렬하는 것이 기본 설정입니다.

텍스트 검색

자유 텍스트 검색 상자는 모든 필드와 일치하여 특정 호스트 이름, IP 주소, 멤버 이름 또는 로그 메시지의 키워드를 검색할 수 있습니다.

권한

로그 페이지에 대한 접근은 다음 권한에 의해 제어됩니다:

권한 설명
LOG_VIEW 로그 페이지에 접근하기 위해 필요
LOG_DISPLAY_FULL 전체 로그 기록을 볼 수 있음
LOG_DISPLAY_TODAY 오늘의 항목만 보기를 제한
LOG_DELETE 로그 항목 삭제 가능

LOG_VIEWLOG_DISPLAY_TODAY 권한을 가진 캐셔는 오늘의 이벤트를 검토할 수 있지만, 과거 데이터를 볼 수는 없습니다. LOG_DISPLAY_FULL 권한이 있는 사용자만 전체 로그 아카이브를 탐색할 수 있습니다.

실시간 업데이트

새로운 로그 이벤트는 발생 시 자동으로 뷰어에 나타납니다. 시스템은 TCP 이벤트 연결을 통해 로그 이벤트를 수신하므로 페이지를 수동으로 새로 고칠 필요가 없습니다. 로그 캐시는 최근 항목을 스크롤할 때 반복적인 데이터베이스 쿼리를 줄여 성능을 향상시킵니다.