Google Chat 앱의 오류 로그 쿼리

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

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

기본 요건

쿼리 오류 로그

  1. Google Cloud 콘솔에서 메뉴를 클릭합니다. <ph type="x-smartling-placeholder"></ph> &gt; 제품 더보기 &gt; 로깅 &gt; 로그 탐색기를 클릭합니다.

    로그 탐색기로 이동

  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 운영 제품군 가격 책정을 참조하세요.

오류 로그를 쿼리한 후 오류가 발견되면 다음 가이드를 참조하여 오류를 해결하세요.