이 가이드에서는 Google Cloud 로그 탐색기에서 Chat 앱 오류 로그를 쿼리하는 방법을 설명합니다. 로그를 쿼리하여 다음을 수행합니다.
- 사용자에게 오류가 발생하는지 확인합니다.
- 오류가 얼마나 자주 발생하는지, 어떤 오류가 가장 자주 발생하는지 확인합니다.
- 오류를 수정하는 데 도움이 되는 자세한 오류 메시지와 로그 데이터를 읽습니다.
기본 요건
- Google Chat에 액세스할 수 있는 Google Workspace 계정
- 채팅 앱. 채팅 앱을 빌드하려면 이 quickstart을 따르세요.
- 채팅 앱의 오류 로깅을 사용 설정합니다.
오류 로그 쿼리
Google Cloud 콘솔에서 메뉴 > 제품 더보기 > Logging > 로그 탐색기를 클릭합니다.
필요한 경우 쿼리 빌더를 표시하려면 쿼리 표시를 사용 설정합니다.
채팅 앱 오류 로그에는 다음 쿼리를 입력합니다.
severity=ERROR resource.type="chat.googleapis.com/Project"
최근 오류를 보려면 쿼리 실행을 클릭합니다. 또는 발생하는 오류를 확인하려면 로그 스트림을 클릭합니다. 채팅 앱 오류 로그가 'Query results' 창에 표시됩니다.
Google Cloud 로그 탐색기와 쿼리 작성에 대한 자세한 내용은 로그 탐색기 문서에서 다음 가이드를 참조하세요.
로그에서 오류 메시지 읽기
오류 로그를 쿼리한 후 로그를 설명하는 JSON 페이로드로 구성된 개별 로그를 볼 수 있습니다. 채팅 앱 오류의 경우 JSON에는 jsonPayload.error.message
의 오류 메시지가 포함됩니다. 예를 들어 다음 샘플 로그에서 오류 메시지는 Apps Script 함수를 실행하지 못했음을 나타냅니다.
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
고려사항
Google Cloud 로그 탐색기에서 Chat 앱 오류 로그로 작업할 때 다음 고려사항에 유의하세요.
Google Chat 앱의 경우 현재 오작동하는 앱의 문제를 해결하는 데 도움이 되는 다음과 같은 심각도의 로그가 로그 탐색기에 포함되어 있습니다.
ERROR
관련 서비스의 로그는 채팅 앱을 디버깅하는 데도 도움이 됩니다. 예를 들어 채팅 앱이 Google Cloud Functions를 사용하여 배포된 경우 Cloud Functions 로그의 로그 탐색기도 확인하는 것이 좋습니다.
오류 메시지는 항상 영어로 작성됩니다.
Cloud Logging에는 비용이 발생합니다. Cloud Logging 가격 책정에 대한 자세한 내용은 Google Cloud 운영 제품군 가격 책정을 참조하세요.
관련 주제
오류 로그를 쿼리한 후 오류가 발견되면 다음 가이드에서 오류 수정에 관한 도움을 확인하세요.
- '앱이 응답하지 않습니다', 'Google Chat API는 Google Workspace 사용자만 사용할 수 있습니다', '사용자를 스페이스에서 제외할 수 있습니다'와 같은 Google Chat 앱 오류를 해결하는 방법을 알아보세요.
- 카드 메시지, 대화상자, 링크 미리보기가 렌더링되지 않거나 예상대로 작동하지 않는 등의 카드 오류를 해결하는 방법을 알아보세요.
- 디버깅 방법 알아보기