ご案内: 新しいデベロッパー プレビュー プログラムがまもなくリリースされます。こちらからお申し込みのうえ、新しいツールを試してフィードバックをいち早くご利用ください。

Cloud Logging が重要

統合のイベントログには、Google Cloud Logging からアクセスできます。Cloud Logging を使用して、ログを調べる、指標とアラートを作成する、Google Cloud Pub/Sub を使用して他のアプリケーションにログをエクスポートする。

アクセス ロギング

Google Cloud Console から Cloud Logging にアクセスするには、[すべてのプロダクトを表示] をクリックし、[オペレーション] > [ロギング] に移動します。

Cloud Logging に移動

ロギングデータへのアクセスは、Actions プロジェクトの Identity and Access Management(IAM)で管理されます。ロギングデータのロールと権限の詳細については、Cloud Logging のアクセス制御をご覧ください。

ログエントリは、Cloud Logging の保持ポリシーに従って 30 日間保持され、削除される予定です。ログ エクスプローラのインターフェースを使用して、エントリをオンデマンドで削除することもできます。

ログを効果的に使用する方法について詳しくは、トラブルシューティング ガイドの「ログを検索する」をご覧ください。

Cloud Logging は、次のリソースタイプを提供します。

リソースの種類 表示名 説明 ラベル
assistant_action_project Google アシスタント アクション プロジェクト アシスタント アクションに関連付けられた Google Cloud プロジェクトのコンテナ。
  • project_id: このリソースに関連付けられた現在のプロジェクトの ID(例: my-project)。

実行ログ

次の表に、executionLog エントリのスキーマを示します。

プロパティ 説明
requestId 一意のリクエスト ID(例: 5325511189174727525)。
latencyMsec レスポンスを受け取るまでの経過時間(例: 6000)。
executionType リクエストに使用されるトランスポート(統合に応じて CLOUDMATTER など)。
actionType ユーザーが行ったアクション(任意)を示すインジケーター(例: QUERYEXECUTE)。EXECUTE アクションの場合、サポートされているトレイト(ONOFF_OFF など)をフルフィルメントに対して発行するコマンドを含めます。
trait (省略可)このユーザー アクションに関連付けられたトレイト。
deviceTypes イベントの影響を受けるデバイスタイプのリスト(例: LIGHT)。
isSuccess リクエストが正常なレスポンスを受け取ったかどうか。
fallbackToCloud ローカル フルフィルメントからのエラー後にリクエストがクラウド フルフィルメントに転送されたかどうか。
statusType インテント レスポンスのステータス(SUCCESSPENDINGOFFLINE など)を示します。ERROR レスポンスの場合、このプロパティにはフルフィルメントが提供する errorCode が含まれます。
externalDebugString このユーザー アクションに関連付けられた、詳細なデバッグ メッセージ(省略可)。
locale リクエストに関連付けられた言語コード。

ログの除外

デベロッパーは、ロギングクエリ言語を使用してログの除外を作成し、より柔軟にログをカスタマイズできます。Logging のクエリ言語もログ エクスプローラで使用されるため、ログ エクスプローラを使用してクエリを作成できます。

除外フィルタの作成手順については、こちらのガイドをご覧ください(_Default シンクの除外フィルタを構成)。

ログベースの指標

デベロッパーはログベースの指標を使用して、ログ内のパターンを追跡して分析できます。また、ログベースの指標にカスタムグラフを作成し、アラートを設定することもできます。

スマートホームのログベースの指標を初めて使用する際は、カウンタ指標の作成でログベースの指標の作成方法を参照してください。

プロジェクトでの Cloud Logging の使用方法について詳しくは、次のドキュメントをご覧ください。

  • 料金: 割り当てと超過費用の詳細。
  • 割り当てと上限: ロギングの使用量に関する制限と保持ポリシーについて説明しています。
  • 高度なログクエリ: ログデータのクエリと分析を、高度な式を使用して行う方法について説明しています。