Skip to main content
SAPP의 로그 메뉴에서는 앱이 API를 호출하여 리소스의 쿼리를 실행한 내역을 확인할 수 있습니다. 쿼리가 실행될 때마다 정상 실행과 실패 내역이 자동으로 기록됩니다. 로그를 통해 언제, 어떤 사용자가, 어떤 API와 리소스를 사용했는지 확인하고 오류 원인을 점검할 수 있습니다.

​
로그 조회하기

프로젝트의 로그 메뉴에서 조회 조건을 설정한 뒤 조회를 선택합니다.
  • 시작일·종료일: 로그를 확인할 기간
  • 사용자: API를 실행한 사용자
  • 내역: 전체, query run, query error 등 실행 결과
실패한 실행만 확인하려면 내역에서 query error를 선택합니다.

​
로그에서 확인할 수 있는 정보

각 로그에는 다음 정보가 표시됩니다.
  • 일시: API가 실행된 날짜와 시간
  • 내역: 쿼리 실행 결과
  • 사용자: API를 실행한 사용자
  • Resource: 쿼리가 실행된 리소스
  • API: 호출된 API
  • 요약: 실행 환경, 처리된 행 수 또는 오류 메시지
Resource나 API 이름을 선택하면 해당 설정 화면으로 이동하여 연결 정보와 쿼리를 확인할 수 있습니다.

​
실행 결과 이해하기

​
query run

쿼리가 정상적으로 실행된 경우입니다.
각 항목은 다음을 의미합니다.
  • prod: 실행 환경
  • neon.hk: 사용된 리소스
  • rows 2: 조회되거나 변경된 행의 수
rows 0은 오류가 아닙니다. 조회 조건에 맞는 데이터가 없거나, 추가·수정·삭제된 행이 없을 때 표시될 수 있습니다.

​
query error

쿼리 실행에 실패한 경우입니다.
먼저 로그의 요약에 표시된 오류 메시지를 확인합니다. 이후 다음 항목을 순서대로 점검합니다.
  1. API에 등록된 쿼리가 올바른지
  2. 앱에서 필요한 파라미터를 전달했는지
  3. 리소스 연결과 인증 정보가 유효한지
  4. 테이블이나 컬럼 이름이 실제 데이터베이스와 일치하는지
  5. 실행 사용자에게 필요한 API 권한이 있는지
설정을 수정한 뒤 앱에서 같은 작업을 다시 실행합니다. 기존 로그는 변경되지 않으므로, 새 로그가 query run으로 기록되는지 확인합니다. 특히 실제 화면에서 환경, 권한 오류, 실행 시간, 요청 파라미터까지 표시되지 않는다면 해당 설명은 빼고, 현재 UI에서 직접 확인할 수 있는 정보만 안내해야 합니다.