このページは Cloud Translation API によって翻訳されました。

Google Chat アプリのエラーログをクエリする

このガイドでは、Google Cloud ログエクスプローラで Chat アプリのエラーログをクエリする方法について説明します。ログをクエリ:

ユーザーにエラーが発生しているかどうかを確認する。
エラーの発生頻度と、最も発生頻度の高いエラーを確認できます。
エラーの修正に役立つ説明的なエラーメッセージとログデータを確認します。

前提条件

Google Chat へのアクセス権を持つ Google Workspace アカウント。
Chat 用アプリ。Chat 用アプリを作成するには、こちらのクイックスタートに沿って操作してください。
Chat 用アプリでエラーロギングを有効にします。

エラーログをクエリする

Google Cloud コンソールで [メニュー] をクリックします。 > その他のプロダクト > ロギング > [ログエクスプローラ] をクリックします。

[ログエクスプローラ] に移動
必要に応じて、[クエリを表示] をオンにしてクエリビルダーを表示します。
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 のオペレーションスイートの料金をご覧ください。