Google Chat 앱의 오류 로그 쿼리

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

  • 사용자에게 오류가 발생하는지 확인합니다.
  • 오류가 얼마나 자주 발생하는지, 어떤 오류가 가장 자주 발생하는지 확인합니다.
  • 오류를 수정하는 데 도움이 되는 자세한 오류 메시지와 로그 데이터를 읽습니다.

기본 요건

오류 로그 쿼리

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

    로그 탐색기로 이동

  2. 필요한 경우 쿼리 빌더를 표시하려면 쿼리 표시를 사용 설정합니다.

  3. 채팅 앱 오류 로그에는 다음 쿼리를 입력합니다.

    severity=ERROR
resource.type="chat.googleapis.com/Project"

  4. 최근 오류를 보려면 쿼리 실행을 클릭합니다. 또는 발생하는 오류를 확인하려면 로그 스트림을 클릭합니다. 채팅 앱 오류 로그가 '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 운영 제품군 가격 책정을 참조하세요.

오류 로그를 쿼리한 후 오류가 발견되면 다음 가이드에서 오류 수정에 관한 도움을 확인하세요.