사용법
사용법로그 및 알림

로그 및 알림

로그는 각 GraphQL 쿼리 실행에 관련된 데이터를 표시합니다. 표시되는 정보는 다음과 같습니다.

  • 쿼리 이름
  • 쿼리에 전달된 변수
  • 실행 응답
  • 추가 컨텍스트 (오류 메시지 등)

로그는 wp-content/gato-ai-translations-for-polylang/logs 폴더에 저장됩니다.

로그는 번역이 완료되지 않을 때 무엇이 문제인지 파악하는 데 도움이 됩니다.

로그 설정

로그 설정은 Settings > Plugin Configuration > Logs & Notifications 에서 확인할 수 있습니다.

Logs & Notifications 설정
Logs & Notifications 설정

설정에서 다음 항목을 구성할 수 있습니다.

  • 로그 및 알림 활성화/비활성화 (기본적으로 둘 다 활성화됨)
  • 기록될 심각도 (기본값: 🔴 Error 및 🟡 Warning)
  • 알림을 트리거할 심각도 (기본값: 🔴 Error)

로그 심각도

심각도는 4가지입니다.

심각도설명
🔴 Error작업 완료를 방해하는 치명적인 문제
예: API 키가 누락됨
🟡 Warning작업에 영향을 미칠 수 있는 경미한 문제
예: 번역할 게시물이 없음
🔵 Info작업에 관한 일반적인 정보
예: API에 요청을 전송함
🟢 Debug디버깅 목적의 상세 정보
예: 작업이 성공적으로 완료됨

알림

설정된 심각도 중 하나에 해당하는 항목이 로그에 추가될 때마다 플러그인 메뉴(플러그인 이름 아래 및 Logs 메뉴 항목 아래)에 알림 배지가 표시됩니다.

알림 배지
알림 배지

이를 통해 번역이 실패했음을 파악하고, 로그를 확인하여 문제의 원인을 특정할 수 있습니다.

로그 접근

로그에 접근하려면 플러그인 메뉴에서 Logs 를 클릭합니다.

로그 탐색
로그 탐색

로그 항목을 클릭하면 해당 로그의 상세 내용을 확인할 수 있습니다.

단일 로그 보기
단일 로그 보기

로그 상세 화면에서 Download 버튼을 클릭하면 로그 파일을 다운로드할 수 있습니다.

역순 표시

로그를 역순(최신 항목이 먼저)으로 표시할 수 있어, 맨 아래로 스크롤하지 않고도 최신 항목을 확인할 수 있습니다.

활성화하려면 Reverse log order? 옵션을 활성화하세요.

Logs & Notifications 설정에서 역순 표시 활성화
Logs & Notifications 설정에서 역순 표시 활성화

Queries

각 로그 항목의 [Query "..."] 섹션은 실행된 쿼리를 나타냅니다.

  • "create-missing-translation-customposts": 커스텀 게시물의 번역 항목을 생성하는 쿼리
  • "translate-customposts": 커스텀 게시물을 번역하는 쿼리
  • "create-missing-translation-media": 미디어 항목의 번역 항목을 생성하는 쿼리
  • "translate-media": 미디어 속성을 번역하는 쿼리
  • 기타

로그 관리

로그가 디스크 공간을 과도하게 소비하지 않도록 정기적으로 로그를 삭제하는 것을 권장합니다.