이 가이드에서는 Google Cloud 로그 탐색기에서 채팅 앱 오류 로그를 쿼리하는 방법을 설명합니다. 로그를 쿼리하여 다음 작업을 실행합니다.
- 사용자에게 오류가 발생하는지 확인합니다.
- 오류가 얼마나 자주 발생하고 가장 빈번한지 확인할 수 있습니다.
- 설명적인 오류 메시지를 읽고 오류를 수정하는 데 도움이 되는 데이터를 기록합니다.
기본 요건
- Google Chat에 액세스할 수 있는 Google Workspace 계정
- 채팅 앱 채팅 앱을 빌드하려면 이 빠른 시작을 따르세요.
- 채팅 앱에 오류 로깅을 사용 설정합니다.
쿼리 오류 로그
Google Cloud 콘솔에서 메뉴를 클릭합니다. <ph type="x-smartling-placeholder">> 제품 더보기 > 로깅 > 로그 탐색기를 클릭합니다.
</ph>필요한 경우 쿼리 표시를 사용 설정하여 쿼리 빌더를 표시합니다.
Chat 앱 오류 로그의 경우 다음 쿼리를 입력합니다.
severity=ERROR resource.type="chat.googleapis.com/Project"
최근 오류를 보려면 쿼리 실행을 클릭합니다. 또는 발생하는 오류를 확인하려면 로그 스트림을 클릭합니다. '쿼리 결과'에 Chat 앱 오류 로그가 표시됨 창을 닫을 수 있습니다.
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 로그 탐색기에서 채팅 앱 오류 로그로 작업할 때 다음 고려사항에 유의하세요.
Google Chat 앱의 경우 현재 로그 탐색기에는 오작동 앱 문제를 해결하는 데 도움이 되는 다음과 같은 심각도의 로그가 포함됩니다.
ERROR
관련 서비스의 로그는 채팅 앱을 디버그하는 데에도 도움이 될 수 있습니다. 예를 들어 Google Cloud Functions를 사용하여 채팅 앱을 배포한 경우 로그 탐색기에서 Cloud Functions 로그도 확인하는 것이 좋습니다.
오류 메시지는 항상 영어로 작성됩니다.
Cloud Logging을 사용하면 비용이 발생합니다. Cloud Logging 가격 책정에 대한 자세한 내용은 Google Cloud 운영 제품군 가격 책정을 참조하세요.
관련 주제
오류 로그를 쿼리한 후 오류가 발견되면 다음 가이드를 참조하여 오류를 해결하세요.
- '앱이 응답하지 않음', 'Google Chat API는 Google Workspace 사용자만 사용할 수 있습니다' 또는 '스페이스에서 사용자를 제외할 수 있음'과 같은 Google Chat 앱 오류를 해결하는 방법을 알아보세요.
- 카드 메시지, 대화상자, 링크 미리보기가 예상대로 렌더링되지 않거나 작동하지 않는 등의 카드 오류를 해결하는 방법을 알아보세요.
- 디버깅 방법 알아보기