LedgerPort가 레코드를 동기화할 때마다 로그 항목이 생성됩니다. 이 로그는 무엇이 동기화되었고, 무엇이 실패했으며, 그 이유는 무엇인지 이해하는 주요 도구입니다. 이 가이드에서는 로그를 찾는 위치, 각 열의 의미, 특정 문제를 찾을 때 범위를 좁히는 방법을 안내합니다.
감사 로그 찾기
LedgerPort 대시보드를 통해
- app.ledgerport.com에 로그인합니다.
- 왼쪽 사이드바에서 감사 로그를 클릭합니다.
현재 비즈니스의 모든 동기화 활동 목록이 표시되며, 가장 최근 항목이 맨 위에 정렬됩니다.
Shopify 앱 내에서
- 설치된 LedgerPort 앱으로 이동합니다.
- 이제 감사 로그를 클릭할 수 있습니다. 이를 통해 각 제품의 동기화 상태를 확인하고 진행할 수 있습니다.
로그 열 이해하기
감사 로그의 각 행은 단일 레코드에 대한 단일 동기화 시도를 나타냅니다. 각 열이 알려주는 내용은 다음과 같습니다.
엔티티 유형: 동기화된 레코드의 종류입니다. 일반적인 유형에는 주문, 제품, 고객, 지급, 일일 요약이 포함됩니다.
상태: 동기화 시도의 결과입니다.
- 동기화됨 – 레코드가 성공적으로 QuickBooks로 전송되었습니다.
- 오류 – 동기화에 실패했습니다. 해당 행에는 오류 이유가 포함됩니다.
- 대기 중 – 레코드가 큐에 있으며 아직 처리되지 않았습니다.
- 보류 중 – 레코드가 특정 결제 또는 이행 상태와 같은 동기화 트리거 조건이 충족될 때까지 기다리고 있습니다.
날짜: 동기화 시도가 이루어진 시점입니다.
참조: 레코드와 관련된 Shopify 주문 번호, 제품 이름 또는 고객 이름입니다.
오류 세부 정보: 오류 행에 표시됩니다. 이 열에는 동기화가 실패한 이유가 표시됩니다. 행을 클릭하여 확장하고 전체 오류 메시지를 확인하세요.
로그 필터링
로그 항목이 많은 경우 필터링을 사용하면 원하는 항목을 빠르게 찾을 수 있습니다.
상태별 필터링
상태 필터를 사용하여 오류만, 성공한 동기화만 또는 보류 중인 레코드만 표시합니다.
- 감사 로그 페이지 상단에서 상태 드롭다운을 클릭합니다.
- 실패한 레코드만 보려면 오류를 선택합니다.
- 목록이 즉시 업데이트됩니다.
이것은 일일 오류 확인을 위한 가장 빠른 방법입니다. 오류로 필터링하면 주의가 필요한 모든 항목을 볼 수 있습니다.
엔티티 유형별 필터링
엔티티 유형 필터를 사용하여 주문만 또는 제품만과 같은 특정 유형의 레코드로 로그를 좁힙니다.
- 엔티티 유형 드롭다운을 클릭합니다.
- 검토하려는 유형(주문, 제품, 고객, 지급, 일일 요약 등)을 선택하세요.
특정 카테고리를 문제 해결할 때 유용합니다. 예를 들어, 고객이 주문이 QuickBooks에 없다고 보고하는 경우 주문으로 필터링하고 주문 번호를 검색하세요.
날짜 범위별 필터
날짜 필터를 사용하여 특정 시간 창에 집중하세요.
- 날짜 필터를 클릭하세요.
- 시작 날짜와 종료 날짜를 설정하세요.
- 로그에는 해당 범위 내의 항목만 표시됩니다.
연결이 끊어진 후 특히 유용합니다. 연결이 끊어진 기간을 포함하도록 날짜 범위를 설정하여 다시 동기화해야 하는 모든 레코드를 찾으세요.
로그 검색
특정 주문이나 고객을 찾고 있다면 감사 로그 페이지 상단의 검색창을 사용하세요.
- 검색창을 클릭하세요.
- Shopify 주문 번호, 제품 이름 또는 고객 이름을 입력하세요.
- 입력하는 동안 일치하는 항목이 나타납니다.
오류 메시지 읽기
동기화에 실패하면 로그의 오류 메시지가 무엇이 잘못되었는지 구체적으로 알려줍니다. 읽으려면:
- 오류 상태인 행을 찾으세요.
- 행을 클릭하여 확장하세요.
- 오류 세부 정보 필드를 읽으세요. "QuickBooks에서 고객을 찾을 수 없음" 또는 "제품이 매핑되지 않음"과 같은 원인을 설명합니다.
대부분의 오류 메시지는 직접 수정으로 이어집니다. 오류 및 해결 방법 전체 목록은 일반적인 동기화 오류 및 해결 방법을 참조하세요.
실패한 레코드 다시 동기화
오류를 수정한 후 다음 자동 동기화를 기다리지 않고 영향을 받은 레코드를 다시 푸시할 수 있습니다.
- 왼쪽 사이드바에서 수동 동기화를 클릭합니다.
- 엔티티 유형(주문, 제품, 고객 등)을 선택하세요.
- 실패한 레코드를 찾기 위해 필터링하거나 검색하세요.
- 선택하고 선택 항목 동기화를 클릭하세요.
플랜별 로그 보존
로그를 얼마나 오래 사용할 수 있는지는 플랜에 따라 다릅니다.
| 요금제 | 로그 보존 |
|---|---|
| 무료 | 7일 |
| 성장 | 30일 |
| 확장 | 90일 |
| 기업용 | 무제한 |
| 에이전시 | 90일 |
보존 기간 외의 문제를 조사해야 하는 경우 LedgerPort에서 해당 로그 항목을 찾을 수 없습니다. 로그를 더 오래 보존하려면 결제에서 요금제를 업그레이드하세요.
팁: 성장 요금제를 사용 중이고 30일 이상 자주 조회해야 하는 경우, Scale($79/월) 요금제로 업그레이드하면 로그 보존 기간이 90일로 연장되고 동기화 빈도도 더 빨라집니다(60분당 1회에서 15분당 1회).
문제가 발생하면 문의해 주시면 지원팀에서 기꺼이 도와드리겠습니다.
