Google Chat 앱의 오류 로그 쿼리

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

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

기본 요건

오류 로그 쿼리

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

    로그 탐색기로 이동

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

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

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

  4. 최근 오류를 보려면 쿼리 실행 을 클릭합니다. 또는 오류가 발생할 때 보려면 로그 스트리밍 을 클릭합니다. 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 앱을 디버깅하는 데 도움이 될 수 있습니다. 예를 들어 Google Cloud Run 함수를 사용하여 Chat 앱을 배포하는 경우 로그 탐색기에서 Cloud Run 함수 로그도 확인합니다.

  • 오류 메시지는 항상 영어로 작성됩니다.

  • Cloud Logging에는 비용이 발생합니다. Cloud Logging 가격 책정에 대한 자세한 내용은 Google Cloud 운영 제품군 가격 책정을 참고하세요.

오류 로그를 쿼리한 후 오류가 발견되면 다음 가이드에서 오류 해결에 관한 도움말을 참고하세요.