# 로그

POS에는 두 가지 로그 인터페이스가 있습니다: **앱 내 로그 화면**(POS 애플리케이션 내부)과 **WP Admin 로그 페이지**(WordPress 내부). 이 둘을 함께 사용하면 디버깅과 감사를 위한 POS 활동의 전체 그림을 얻을 수 있습니다.

<!-- -->

## POS 애플리케이션 로그[​](#pos-application-logs "POS 애플리케이션 로그으로 직접 링크")

### 로그 접근하기[​](#accessing-logs "로그 접근하기으로 직접 링크")

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

### 인터페이스 개요[​](#interface-overview "인터페이스 개요으로 직접 링크")

#### 검색 및 필터[​](#search--filter "검색 및 필터으로 직접 링크")

* **로그 검색** - 메시지 내용으로 특정 로그 항목 찾기
* **로그 레벨 필터** - 로그 레벨(info, warn, error)로 필터링
* **표시 설정** - 표시할 열 구성

#### 로그 테이블[​](#log-table "로그 테이블으로 직접 링크")

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

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

### 로그 레벨[​](#log-levels "로그 레벨으로 직접 링크")

#### Info (회색)[​](#info-grey "Info (회색)으로 직접 링크")

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

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

#### Warning (주황)[​](#warning-orange "Warning (주황)으로 직접 링크")

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

* "세션을 새로 고칠 수 없습니다"
* "동기화 재시도"

#### Error (빨강)[​](#error-red "Error (빨강)으로 직접 링크")

해결해야 할 문제:

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

#### Audit (파랑)[​](#audit-blue "Audit (파랑)으로 직접 링크")

감사 로그 레벨은 POS가 수행한 데이터베이스 변경 사항을 기록하며, 각 수정의 전후 상태 전체를 캡처합니다. 이는 예를 들어 주문 생성, 재고 조정 또는 고객 업데이트 중에 무엇이 언제 변경되었는지 정확히 추적하는 데 유용합니다.

감사 항목에는 다음이 포함됩니다:

* **엔터티 유형** - 수정된 리소스(예: 주문, 제품, 고객)
* **작업** - 변경 유형(생성, 업데이트, 삭제)
* **이전 상태** - 변경 전의 이전 값
* **이후 상태** - 변경 후의 새 값

### 컨텍스트 데이터[​](#context-data "컨텍스트 데이터으로 직접 링크")

로그 항목의 확장 화살표를 클릭하면 자세한 JSON 컨텍스트를 볼 수 있습니다:

```
{

  "total": "6",

  "execution_time": "54.79 ms",

  "server_load": "[10.51, 10.42, 9.98]"

}
```

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

* **항목 수** - 영향을 받은 레코드 수
* **실행 시간** - 작업에 걸린 시간
* **서버 부하** - 서버 성능 지표
* **요청/응답 세부 정보** - API 문제 디버깅용

### 오류 코드[​](#error-codes "오류 코드으로 직접 링크")

많은 로그 항목에는 **오류 코드**(예: `API02004`, `DB01001`)가 포함됩니다. 이러한 코드는 [오류 코드](/ko/error-codes/.md) 문서에 직접 연결되며, 다음을 제공합니다:

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

### 일반적인 로그 항목[​](#common-log-entries "일반적인 로그 항목으로 직접 링크")

#### 동기화 작업[​](#sync-operations "동기화 작업으로 직접 링크")

```
[info] Fetched all IDs for products    {...} 3 items

[info] Synced new customers            {...} 1 item

[info] Fetched all IDs for taxes       {...} 3 items
```

이들은 정상적인 동기화 활동을 나타냅니다. 컨텍스트는 몇 개의 항목이 동기화되었는지 보여줍니다.

#### 권한 오류[​](#permission-errors "권한 오류으로 직접 링크")

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

이는 일반적으로 사용자가 리소스에 접근할 권한이 없음을 의미합니다. `WP Admin > POS > Settings > Access`에서 사용자 역할을 확인하세요.

#### 세션 문제[​](#session-issues "세션 문제으로 직접 링크")

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

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

## WP Admin 로그 페이지[​](#wp-admin-logs-page "WP Admin 로그 페이지으로 직접 링크")

POS 플러그인은 WordPress 관리 영역에 서버 측 로그 페이지도 제공합니다. 이 페이지는 서버에 기록된 POS 관련 경고 및 오류를 보여주며, POS 애플리케이션 자체에는 나타나지 않을 수 있는 문제를 진단하는 데 도움이 됩니다.

### WP Admin 로그 페이지 접근하기[​](#accessing-the-wp-admin-logs-page "WP Admin 로그 페이지 접근하기으로 직접 링크")

**WP Admin > POS > Settings**로 이동한 다음 **Tools** 탭을 선택하고 **Logs**를 클릭합니다.

### 읽지 않음 배지[​](#unread-badge "읽지 않음 배지으로 직접 링크")

로그 메뉴 항목에는 읽지 않은 로그 항목을 나타내는 배지가 표시됩니다:

* **빨간색 배지** - 읽지 않은 오류 레벨 항목이 있음
* **호박색 배지** - 읽지 않은 경고 레벨 항목이 있음(단, 오류는 없음)

로그 페이지를 방문하면 읽지 않음 카운트가 재설정됩니다. 카운트는 사용자별로 추적되므로 각 관리자는 자신의 읽지 않음 상태를 봅니다.

### 항목 필터링[​](#filtering-entries "항목 필터링으로 직접 링크")

레벨 필터를 사용하여 로그 항목을 좁힐 수 있습니다:

* **전체** - 모든 로그 항목 표시
* **오류** - 오류 레벨 항목만 표시
* **경고** - 경고 레벨 항목만 표시

### 확장 가능한 항목[​](#expandable-entries "확장 가능한 항목으로 직접 링크")

긴 로그 메시지는 약 100자에서 잘립니다. 항목을 클릭하면 확장되어 추가 컨텍스트 데이터와 함께 전체 메시지를 볼 수 있습니다.

### 페이지 매김[​](#pagination "페이지 매김으로 직접 링크")

로그 항목은 서버 측에서 페이지 매김됩니다. 페이지 매김 컨트롤을 사용하여 이전 항목을 탐색하세요.

### 치명적 오류 배너[​](#fatal-errors-banner "치명적 오류 배너으로 직접 링크")

서버에 `fatal-errors-*.log` 파일이 있으면 로그 페이지 상단에 경고 배너가 표시됩니다. 이 배너는 전체 치명적 오류 로그를 볼 수 있는 **WooCommerce > Status > Logs**로 연결됩니다. 치명적 오류는 일반적으로 POS API가 응답하지 못하게 하는 PHP 수준의 충돌입니다.

## 지원을 위한 로그 사용[​](#using-logs-for-support "지원을 위한 로그 사용으로 직접 링크")

지원을 요청할 때:

1. **문제 재현** - 문제를 일으키는 작업을 수행합니다
2. **로그 확인** - 오류(빨강) 또는 경고(주황)를 찾습니다
3. **컨텍스트 확장** - 전체 JSON 세부 정보를 가져옵니다
4. **오류 코드 기록** - 지원 요청에 이를 포함합니다
5. **관련 항목 복사** - 컨텍스트와 함께 로그 메시지를 공유합니다

## 성능 모니터링[​](#performance-monitoring "성능 모니터링으로 직접 링크")

로그에는 실행 시간과 서버 부하 지표가 포함됩니다. 다음 사항을 발견하면:

* **높은 실행 시간** - 서버가 과부하되었거나 느릴 수 있습니다
* **높은 서버 부하 값** - 서버 최적화를 고려하세요
* **빈번한 시간 초과** - 네트워크 연결을 확인하세요

## 관련 문서[​](#related-documentation "관련 문서으로 직접 링크")

[오류 코드자세한 오류 설명](/ko/error-codes/.md)

[문제 해결일반적인 문제 및 해결책](/ko/category/troubleshooting.md)

[지원도움 받기](/ko/support/.md)