이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Chat 앱의 오류 로그 쿼리

이 가이드에서는 Google Cloud 로그 탐색기에서 Chat 앱 오류 로그를 쿼리하는 방법을 설명합니다. 로그를 쿼리하여 다음 작업을 수행할 수 있습니다.

사용자에게 오류가 발생하는지 알아봅니다.
오류가 발생하는 빈도와 가장 빈번하게 발생하는 오류를 확인합니다.
오류를 해결하는 데 도움이 되는 설명 오류 메시지와 로그 데이터를 읽습니다.

기본 요건

Google Chat에 액세스할 수 있는 Google Workspace 계정
Chat 앱. Chat 앱을 빌드하려면 이 빠른 시작을 따르세요.
Chat 앱에 오류 로깅을 사용 설정합니다.

오류 로그 쿼리

Google Cloud 콘솔에서 메뉴 > 제품 더보기 > Logging > 로그 탐색기를 클릭합니다.

로그 탐색기로 이동
필요한 경우 쿼리 빌더를 표시하려면 쿼리 표시를 사용 설정합니다.
Chat 앱 오류 로그의 경우 다음 쿼리를 입력합니다.
```
severity=ERROR
resource.type="chat.googleapis.com/Project"
```
최근 오류를 보려면 쿼리 실행을 클릭합니다. 또는 오류가 발생할 때 이를 확인하려면 로그 스트리밍을 클릭합니다. Chat 앱 오류 로그가 '쿼리 결과' 창에 표시됩니다.

Google Cloud 로그 탐색기 및 쿼리 작성에 대해 자세히 알아보려면 로그 탐색기 문서의 다음 가이드를 참고하세요.

로그에서 오류 메시지 읽기

오류 로그를 쿼리한 후 로그를 설명하는 JSON 페이로드로 구성된 개별 로그를 볼 수 있습니다. Chat 앱 오류의 경우 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
관련 서비스의 로그도 Chat 앱을 디버그하는 데 도움이 될 수 있습니다. 예를 들어 Chat 앱이 Google Cloud Functions를 사용하여 배포된 경우 로그 탐색기에서 Cloud Functions 로그도 확인하는 것이 좋습니다.
오류 메시지는 항상 영어로 작성됩니다.
Cloud Logging에는 비용이 발생합니다. Cloud Logging 가격 책정에 관한 자세한 내용은 Google Cloud 운영 제품군 가격 책정을 참고하세요.