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

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

참고: Apps Script의 경우 부가기능이 테스트로 배포되면 모두 Cloud 로그 탐색기와 부가기능 인터페이스입니다.

예를 들어 부가기능 테스트 배포에는 TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn]와 같은 오류 메시지가 표시될 수 있습니다.

이와 같은 오류 메시지가 도움이 되기는 하지만 추가 정보는 확인할 수 있습니다 가장 좋은 방법은 참조하세요. 테스트에 관한 자세한 정보는 자세한 내용은 Google Workspace 부가기능 테스트 및 디버그

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

• 사용자에게 오류가 발생하는지 확인합니다.
• 오류가 얼마나 자주 발생하고 가장 빈번한지 확인할 수 있습니다.
• 문제 해결에 도움이 되는 설명 오류 메시지를 읽습니다.

기본 요건

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

• 'Cloud Logging API' 사용 설정 부가기능의 Google Cloud 프로젝트입니다. API를 사용 설정하려면 다음을 참조하세요. Cloud 프로젝트를 만들고 API를 사용 설정합니다.
• Google Workspace 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 로그에서 부가기능 오류 로그로 작업할 때 탐색기의 경우 다음 고려사항에 유의하세요.

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