주 콘텐츠로 건너뛰기
버전: 1.x

로그

로그 화면은 POS 내 시스템 활동을 기록합니다. 문제를 디버깅하고 백그라운드에서 일어나는 일을 이해하는 데 필수적인 도구입니다.

로그 접근하기​

왼쪽 탐색 메뉴(심장 박동 아이콘)에서 로그 화면을 엽니다.

인터페이스 개요​

검색 및 필터​

  • 로그 검색 - 메시지 내용별 특정 로그 항목 찾기
  • 로그 수준 필터 - 로그 수준(info, warn, error)으로 필터링
  • 표시 설정 - 보이는 열 구성

로그 테이블​

각 로그 항목은 다음을 보여줍니다:

열설명
시간이벤트가 발생한 시각
수준심각도: info (회색), warn (주황), error (빨간색)
메시지이벤트에 대한 사람이 읽을 수 있는 설명
상황추가 세부정보가 포함된 확장 가능한 JSON
코드오류 코드 (문서 링크)

로그 수준​

정보 (회색)​

정상적인 작업 및 성공적인 이벤트:

  • "모든 제품의 ID를 가져왔습니다"
  • "새 고객을 동기화했습니다"
  • "모든 세금의 ID를 가져왔습니다"

경고 (주황)​

주의가 필요할 수 있는 비치명적인 문제:

  • "세션을 새로 고칠 수 없습니다"
  • "동기화를 위한 재시도"

오류 (빨간색)​

해결해야 할 문제:

  • "죄송합니다, 리소스를 나열할 수 없습니다" (권한 문제)
  • "API 요청 실패"
  • "데이터베이스 동기화 오류"

상황 데이터​

어떤 로그 항목에서든 확장 화살표를 클릭하여 자세한 JSON 상황을 확인합니다:

{
  "total": "6",
  "execution_time": "54.79 ms",
  "server_load": "[10.51, 10.42, 9.98]"
}

이 데이터에는 다음이 포함됩니다:

  • 항목 수 - 영향을 받은 레코드 수
  • 실행 시간 - 작업 수행에 소요된 시간
  • 서버 로드 - 서버 성능 지표
  • 요청/응답 세부정보 - API 문제 디버깅을 위한 것

오류 코드​

많은 로그 항목에는 오류 코드(예: API02004, DB01001)가 포함되어 있습니다. 이러한 코드는 오류 코드 문서에 직접 연결되며, 여기에는:

  • 오류에 대한 자세한 설명
  • 일반적인 원인
  • 문제 해결 단계

일반 로그 항목​

동기화 작업​

[info] Fetched all IDs for products    {...} 3 items
[info] Synced new customers            {...} 1 item
[info] Fetched all IDs for taxes       {...} 3 items

이 항목들은 정상적인 동기화 활동을 나타냅니다. 상황은 얼마나 많은 항목이 동기화되었는지를 보여줍니다.

권한 오류​

[error] Sorry, you cannot list resources    {...} API02004

이는 일반적으로 사용자가 리소스에 접근할 권한이 없음을 의미합니다. WP Admin > POS > 설정 > 접근에서 사용자 역할을 확인하십시오.

세션 문제​

[warn] Unable to refresh session    {...} API02007

POS가 인증 세션을 새로 고칠 수 없었습니다. 로그아웃 후 다시 로그인해야 할 수 있습니다.

지원을 위한 로그 사용​

지원 요청 시:

  1. 문제 재현 - 문제를 일으키는 행동 수행
  2. 로그 확인 - 오류(빨간색) 또는 경고(주황)를 찾기
  3. 상황 확장 - 전체 JSON 세부정보 가져오기
  4. 오류 코드 메모 - 지원 요청에 이를 포함하기
  5. 관련 항목 복사 - 상황과 함께 로그 메시지 공유하기

성능 모니터링​

로그에는 실행 시간 및 서버 로드 지표가 포함됩니다. 다음을 주의하십시오:

  • 높은 실행 시간 - 서버가 과부하되었거나 느림
  • 높은 서버 로드 값 - 서버 최적화 고려
  • 자주 발생하는 타임아웃 - 네트워크 연결을 확인

관련 문서​