統合のイベントログには、Google Cloud Logging からアクセスできます。Cloud Logging を使用すると、Google Cloud Pub/Sub を使用してログを探索し、指標とアラートを作成できます。また、ログを他のアプリケーションにエクスポートすることもできます。
アクセス ロギング
Google Cloud Console から Cloud Logging にアクセスするには、[すべての商品を表示] をクリックし、[オペレーション] > [ロギング] に移動します。
ロギングデータへのアクセスは、Actions プロジェクトの Identity and Access Management（IAM）で管理されます。データロギングのロールと権限の詳細については、Cloud Logging のアクセス制御をご覧ください。
ログエントリは、Cloud Logging の保持ポリシーに従って 30 日間保持され、削除のスケジュールが設定されています。ログ エクスプローラのインターフェースを使用して、オンデマンドでエントリを削除することもできます。
ログを効果的に使用する方法について詳しくは、トラブルシューティング ガイドの「ログを検索する」をご覧ください。
Cloud Logging は、以下のリソースタイプを提供します。
| リソースの種類 | 表示名 | 説明 | ラベル |
|---|---|---|---|
assistant_action_project |
Google アシスタント アクション プロジェクト | アシスタント アクションに関連付けられた Google Cloud プロジェクトのコンテナ。 |
|
実行ログ
次の表に、executionLog エントリのスキーマを示します。
| プロパティ | 説明 |
|---|---|
requestId |
一意のリクエスト ID（例: 5325511189174727525）。 |
latencyMsec |
レスポンスを受信するまでの経過時間（例: 6000）。 |
executionType |
リクエストに使用されるトランスポート（CLOUD や MATTER など、統合によって異なる）。 |
actionType |
ユーザーが行った操作を示すインジケーター（例: QUERY、EXECUTE）。EXECUTE アクションでは、サポートされているトレイトのフルフィルメントに対して発行されるコマンドを含めます（例: ONOFF_OFF）。
|
trait |
（省略可）このユーザー アクションに関連付けられたトレイト。 |
deviceTypes |
イベントの影響を受けるデバイスタイプのリスト（例: LIGHT）。 |
isSuccess |
リクエストが正常なレスポンスを受け取ったかどうか。 |
fallbackToCloud |
ローカル フルフィルメントからのエラー発生後にリクエストをクラウド フルフィルメントにルーティングするかどうか。 |
statusType |
インテント レスポンスのステータス（SUCCESS、PENDING、OFFLINE など）を示します。ERROR レスポンスの場合、このプロパティにはフルフィルメントが提供する errorCode が含まれます。 |
externalDebugString |
このユーザー アクションに関連付けられた詳細なデバッグ メッセージ（省略可）。 |
locale |
リクエストに関連付けられた言語コード。 |
ログの除外
デベロッパーは、ロギングクエリ言語を使用してログの除外を作成し、ログをより柔軟にカスタマイズできます。ログクエリ クエリはログ エクスプローラでも使用されるため、ログ エクスプローラを使用してクエリを作成できます。
除外フィルタの作成手順については、こちらのガイドをご覧ください（_Default シンクの除外フィルタを設定）。
ログベースの指標
デベロッパーはログベースの指標を使用して、ログ内のパターンを追跡して分析できます。また、ログベースの指標でカスタムグラフを作成し、アラートを設定することもできます。
スマートホームのログベースの指標を初めて使用する際は、カウンタ指標の作成でログベースの指標の作成方法を参照してください。
関連リソース
プロジェクトでの Cloud Logging の使用方法について詳しくは、次のドキュメントをご覧ください。