로그
POS에는 두 가지 로그 인터페이스가 있습니다: 앱 내 로그 화면(POS 애플리케이션 내부)과 WP Admin 로그 페이지(WordPress 내부). 이 둘을 함께 사용하면 디버깅과 감사를 위한 POS 활동의 전체 그림을 얻을 수 있습니다.
POS 애플리케이션 로그
로그 접근하기
왼쪽 탐색 서랍(심장 박동 아이콘)에서 로그 화면을 엽니다.
인터페이스 개요
검색 및 필터
- 로그 검색 - 메시지 내용으로 특정 로그 항목 찾기
- 로그 레벨 필터 - 로그 레벨(info, warn, error)로 필터링
- 표시 설정 - 표시할 열 구성
로그 테이블
각 로그 항목은 다음을 보여줍니다:
| 열 | 설명 |
|---|---|
| 시간 | 이벤트가 발생한 시간 |
| 레벨 | 심각도: info (회색), warn (주황), error (빨강) |
| 메시지 | 사람이 읽을 수 있는 이벤트 설명 |
| 컨텍스트 | 추가 세부 정보가 포함된 확장 가능한 JSON |
| 코드 | 오류 코드(문서 링크) |
로그 레벨
Info (회색)
정상 작업 및 성공적인 이벤트:
- "제품의 모든 ID를 가져왔습니다"
- "새 고객을 동기화했습니다"
- "세금의 모든 ID를 가져왔습니다"
Warning (주황)
주의가 필요할 수 있는 비치명적인 문제:
- "세션을 새로 고칠 수 없습니다"
- "동기화 재시도"
Error (빨강)
해결해야 할 문제:
- "죄송합니다. 리소스를 나열할 수 없습니다" (권한 문제)
- "API 요청 실패"
- "데이터베이스 동기화 오류"
Audit (파랑)
감사 로그 레벨은 POS가 수행한 데이터베이스 변경 사항을 기록하며, 각 수정의 전후 상태 전체를 캡처합니다. 이는 예를 들어 주문 생성, 재고 조정 또는 고객 업데이트 중에 무엇이 언제 변경되었는지 정확히 추적하는 데 유용합니다.
감사 항목에는 다음이 포함됩니다:
- 엔터티 유형 - 수정된 리소스(예: 주문, 제품, 고객)
- 작업 - 변경 유형(생성, 업데이트, 삭제)
- 이전 상태 - 변경 전의 이전 값
- 이후 상태 - 변경 후의 새 값
컨텍스트 데이터
로그 항목의 확장 화살표를 클릭하면 자세한 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 > Settings > Access에서 사용자 역할을 확인하세요.
세션 문제
[warn] Unable to refresh session {...} API02007
POS가 인증 세션을 새로 고칠 수 없었습니다. 로그아웃 후 다시 로그인해야 할 수 있습니다.
WP Admin 로그 페이지
POS 플러그인은 WordPress 관리 영역에 서버 측 로그 페이지도 제공합니다. 이 페이지는 서버에 기록된 POS 관련 경고 및 오류를 보여주며, POS 애플리케이션 자체에는 나타나지 않을 수 있는 문제를 진단하는 데 도움이 됩니다.
WP Admin 로그 페이지 접근하기
WP Admin > POS > Settings로 이동한 다음 Tools 탭을 선택하고 Logs를 클릭합니다.
읽지 않음 배지
로그 메뉴 항목에는 읽지 않은 로그 항목을 나타내는 배지가 표시됩니다:
- 빨간색 배지 - 읽지 않은 오류 레벨 항목이 있음
- 호박색 배지 - 읽지 않은 경고 레벨 항목이 있음(단, 오류는 없음)
로그 페이지를 방문하면 읽지 않음 카운트가 재설정됩니다. 카운트는 사용자별로 추적되므로 각 관리자는 자신의 읽지 않음 상태를 봅니다.
항목 필터링
레벨 필터를 사용하여 로그 항목을 좁힐 수 있습니다:
- 전체 - 모든 로그 항목 표시
- 오류 - 오류 레벨 항목만 표시
- 경고 - 경고 레벨 항목만 표시
확장 가능한 항목
긴 로그 메시지는 약 100자에서 잘립니다. 항목을 클릭하면 확장되어 추가 컨텍스트 데이터와 함께 전체 메시지를 볼 수 있습니다.
페이지 매김
로그 항목은 서버 측에서 페이지 매김됩니다. 페이지 매김 컨트롤을 사용하여 이전 항목을 탐색하세요.
치명적 오류 배너
서버에 fatal-errors-*.log 파일이 있으면 로그 페이지 상단에 경고 배너가 표시됩니다. 이 배너는 전체 치명적 오류 로그를 볼 수 있는 WooCommerce > Status > Logs로 연결됩니다. 치명적 오류는 일반적으로 POS API가 응답하지 못하게 하는 PHP 수준의 충돌입니다.
지원을 위한 로그 사용
지원을 요청할 때:
- 문제 재현 - 문제를 일으키는 작업을 수행합니다
- 로그 확인 - 오류(빨강) 또는 경고(주황)를 찾습니다
- 컨텍스트 확장 - 전체 JSON 세부 정보를 가져옵니다
- 오류 코드 기록 - 지원 요청에 이를 포함합니다
- 관련 항목 복사 - 컨텍스트와 함께 로그 메시지를 공유합니다
성능 모니터링
로그에는 실행 시간과 서버 부하 지표가 포함됩니다. 다음 사항을 발견하면:
- 높은 실행 시간 - 서버가 과부하되었거나 느릴 수 있습니다
- 높은 서버 부하 값 - 서버 최적화를 고려하세요
- 빈번한 시간 초과 - 네트워크 연결을 확인하세요