Google Workspace 부가기능의 쿼리 오류 로그

게시된 Google Workspace 부가기능이 오류를 반환하면 부가기능 인터페이스에서 '부가기능을 실행하는 중에 문제가 발생했습니다'라는 일반 메시지를 반환합니다. 그러나 이러한 오류는 Cloud 로그 탐색기에 로깅됩니다.

이 가이드에서는 Cloud 로그 탐색기에서 부가기능 오류 로그를 쿼리하여 다음을 수행하는 방법을 설명합니다.

  • 사용자에게 오류가 발생하는지 확인합니다.
  • 오류가 얼마나 자주 발생하는지, 어떤 오류가 가장 자주 발생하는지 확인합니다.
  • 문제를 해결하는 데 도움이 되는 자세한 오류 메시지를 읽어봅니다.

기본 요건

부가기능 오류 로그를 쿼리하기 전에 다음을 실행합니다.

  • 부가기능의 Google Cloud 프로젝트에서 'Cloud Logging API'를 사용 설정합니다. API를 사용 설정하려면 Cloud 프로젝트 만들기 및 API 사용 설정을 참고하세요.
  • Google Workspace Marketplace에 부가기능을 게시합니다. Marketplace에 부가기능을 게시하려면 앱 게시를 참고하세요.

부가기능 오류 로그 쿼리

부가기능에 대한 로그를 가져오려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔을 엽니다. 
  2. 'Google Cloud Platform' 옆의 아래쪽 화살표 를 클릭하고 부가기능 프로젝트를 선택합니다.
  3. 왼쪽 상단에서 메뉴 > Logging을 클릭합니다. 로그 탐색기가 열립니다.
  4. 부가기능 오류 로그의 경우 쿼리 빌더에서 다음 쿼리를 입력합니다.

    severity>=ERROR
    protoPayload.serviceName="gsuiteaddons.googleapis.com"
    
  5. 최근 오류를 보려면 쿼리 실행을 클릭합니다. 또는 발생하는 오류를 확인하려면 로그 스트림을 클릭합니다. 부가기능 오류 로그는 '쿼리 결과' 창에 표시됩니다.

Cloud 로그 탐색기와 쿼리 작성에 대한 자세한 내용은 다음을 참조하세요.

오류 로깅 사용 설정 또는 중지

기본적으로 오류 로깅은 사용 설정되어 있습니다. 오류 로깅이 사용 설정된 경우 매니페스트 파일의 내용은 다음과 같습니다.

"exceptionLogging": "STACKDRIVER",

오류 로깅을 사용 중지하려면 매니페스트 파일에서 "exceptionLogging": "STACKDRIVER",을 다음 줄로 바꿉니다.

// Disable error logging
"exceptionLogging": "NONE"

오류 로깅을 다시 사용 설정하려면 "exceptionLogging": "NONE""exceptionLogging": "STACKDRIVER",로 바꿉니다.

고려사항

Cloud 로그 탐색기에서 부가기능 오류 로그로 작업할 때 다음 고려사항에 유의하세요.

  • 부가기능은 로그 탐색기의 오류만 기록합니다. 다른 로그 유형은 기록되지 않습니다.
  • 오류 메시지는 항상 영어로 작성됩니다.
  • Cloud Logging에는 비용이 발생합니다. Cloud Logging 가격 책정에 대한 자세한 내용은 Google Cloud 관측 가능성 가격 책정을 참조하세요.