Google Workspace 부가기능에 대한 오류 로그 쿼리

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

이 가이드에서는 Cloud 로그 탐색기에서 부가기능 오류 로그를 쿼리하는 방법을 설명합니다. 이를 통해 다음 작업을 할 수 있습니다.

  • 사용자에게 오류가 발생하는지 확인합니다.
  • 오류가 얼마나 자주 발생하는지, 가장 자주 발생하는 오류는 무엇인지 확인합니다.
  • 문제를 해결하는 데 도움이 되는 설명 오류 메시지를 읽습니다.

기본 요건

애드온 오류 로그를 쿼리하기 전에 다음을 확인하세요.

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

부가기능 오류 로그 쿼리

부가기능의 로그를 가져오려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔을 엽니다. 
  2. 'Google Cloud Platform' 옆에 있는 아래쪽 화살표 를 클릭하고 부가기능 프로젝트를 선택합니다.
  3. 왼쪽 상단에서 메뉴 > 로깅을 클릭합니다. 로그 탐색기가 열립니다.

  4. 애드온 오류 로그의 경우 쿼리 빌더에 다음 쿼리를 입력합니다.

    severity>=ERROR
protoPayload.serviceName="gsuiteaddons.googleapis.com"

  5. 최근 오류를 확인하려면 쿼리 실행을 클릭합니다. 또는 오류가 발생할 때 오류를 확인하려면 로그 스트림을 클릭합니다. 부가기능 오류 로그가 '쿼리 결과' 창에 표시됩니다.

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

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

기본적으로 오류 로깅은 사용 설정되어 있습니다. 오류 로깅이 사용 설정된 경우 매니페스트 파일에는 다음이 포함됩니다.

"exceptionLogging": "STACKDRIVER",

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

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

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

고려사항

Cloud Logs Explorer에서 부가기능 오류 로그를 사용할 때는 다음 사항을 고려하세요.

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