HandyCafe Docs
owner

로그

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

페이지는 탭으로 나뉘어 있습니다. 각 탭은 서로 다른 기록 집합을 다룹니다.

내용
시스템 로그 이 페이지에서 설명하는 일반 이벤트 로그
거래 캐셔 근무별로 기록된 금전 이동
휴지통 다른 페이지에서 삭제되어 복구를 위해 보관되는 기록
감사 변조를 막은 민감한 변경 기록
IP 로그 법적 보존을 위해 일별 파일로 보관되는 접속 기록. IP 로그 및 접속 기록을 참고하세요
변조 이벤트 클라이언트가 보고한 안티치트 탐지
HWID 블랙리스트 세션을 열 수 없도록 차단된 하드웨어 ID
Steam VAC 회원 계정에 대한 Steam 차단 확인

탭은 설정 > 보기에서 개별적으로 끌 수 있습니다. 모든 탭을 끄면 내비게이션 메뉴에서 로그 항목이 사라집니다. 보기 설정을 참고하세요.

감사 탭

감사 탭은 책임 추적에 중요한 변경을 기록합니다. 권한 및 역할 변경, 금액 조정, 상품 변경, 설정 변경, 데이터 삭제, 콘솔 작업이 여기 포함됩니다.

감사 기록은 수정할 수 없습니다. 각 기록은 바로 앞 기록과 연결되는 무결성 서명으로 보호됩니다. 탭 상단에는 검증 결과가 표시됩니다. 기록이 변조되었다면 패널이 연결 고리가 끊어진 첫 기록을 알려 줍니다.

감사 기록은 범주나 작업으로 필터링할 수 있습니다. 자유 텍스트 검색은 수행자와 대상을 대상으로 합니다.

성능

로그 뷰어는 가상 리스트 렌더링을 사용하여 수천 개의 항목을 표시할 때도 부드러운 성능을 유지합니다. 이는 언제든지 화면에 보이는 행만 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 이벤트 연결을 통해 로그 이벤트를 수신하므로 페이지를 수동으로 새로 고칠 필요가 없습니다. 로그 캐시는 최근 항목을 스크롤할 때 반복적인 데이터베이스 쿼리를 줄여 성능을 향상시킵니다.