Google Home エコシステム向け Cloud Logging

<ph type="x-smartling-placeholder"></ph> クラウドからクラウド    案件 をご覧ください。

統合のイベントログには、 Google Cloud LoggingCloud Logging を使用したログの探索、指標とアラートの作成、または ログをエクスポートして、他のアプリケーションに Google Cloud Pub/Sub

アクセス ロギング

Cloud LoggingGoogle Cloud Console, [すべてのプロダクトを表示] をクリックして、[オペレーション] に移動 >Logging

Cloud Logging に移動

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

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

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

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

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

イベントログ

Cloud-to-cloud プロジェクトは、Cloud で次のイベントをサポートしています ロギング:

Cloud Logging リソース イベント
Google アシスタント アクション プロジェクト SYNC インテント エラー
QUERY インテント エラー
EXECUTE インテント エラー
通知 エラー
アカウントのリンク エラー
Local Home SDK HandlerError

ログの同期

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

プロパティ 説明
requestId スマートホーム インテントのリクエスト ID。
httpLatencyMsec レスポンスを受信するまでにかかった時間。
status インテント レスポンスのステータス。

実行ログ

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

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

通知ログ

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

プロパティ 説明
requestId 通知リクエスト ID。
structName 通知構造体の名前(「ObjectDetection」など)。
status は、 ステータス 表示されます。

ログレベルの設定

Cloud-to-cloud プロジェクトは、デフォルトでエラーログを受け取るように設定されています。 デベロッパーが成功ログを受け取るように設定することもできます。 これは、特に重要なデータを収集する予定があり、 ログを処理できます。次の場合は、プロジェクトに追加料金が発生することがあります。 超過 ロギングの割り当て

プロジェクトのログレベルは、次の方法で制御できます。

  1. Actions on Google Console で、プロジェクト ページに移動します。

    Actions on Google コンソールに移動

  2. スマートホーム プロジェクトを選択します。

  3. [Develop](開発)タブを選択し、サイドバーの [Actions](アクション)をクリックします。

  4. [Log control ingestion](ログ制御の取り込み)プルダウン リストで [All](すべて)を選択します。

ログの除外

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

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

ログベースの指標

デベロッパーは ログベースの指標 ログ内のパターンを追跡および分析できますまた、 カスタム グラフを作成する アラートの設定 ログベースの指標に設定できます

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

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

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