Google Chat 앱의 오류 로그 쿼리

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

  • 사용자에게 오류가 발생하는지 확인합니다.
  • 오류가 발생하는 빈도와 가장 빈번하게 발생하는 오류를 확인합니다.
  • 설명적인 오류 메시지를 읽고 오류를 수정하는 데 도움이 되는 데이터를 기록합니다.

기본 요건

오류 로그 쿼리

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

    로그 탐색기로 이동

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

  3. Chat 앱 오류 로그의 경우 다음 쿼리를 입력합니다.

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

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

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