使用状況の分析情報を分析する

このページでは、使用状況の分析情報を使用して、特定のデータベースの課金対象の使用量を分析する方法について説明します。このデータは、カスタム期間にわたって、コレクション、コレクション グループ、Namespace（Datastore モードに固有）などのディメンションで分類できます。表示される使用状況の分析情報の指標は、エディションまたはモードによって異なります。

エディション 指標
標準
  • 読み取り
  • 書き込み（削除を含む）
  • TTL 削除
Enterprise
  • 読み取り
  • 書き込み
  • TTL 削除
  • イベント

使用状況の分析情報の概要

使用状況の分析情報ダッシュボードを使用して、特定のデータベースの使用状況をモニタリングします。このダッシュボードは、次のことに役立ちます。

  • 詳細な使用状況のモニタリング: collection、collectionGroup、namespace などのディメンションで分類された課金対象のオペレーションをトラッキングします。
  • 費用の最適化: 請求額の高い使用状況を特定し、データ構造やクエリを 最適化して、全体的な請求額を削減できる場所を特定します。
  • 過去の傾向のトラッキング: 課金対象の使用状況の統計が 特定の期間にどのように変化するかをモニタリングします。

必要なロール

使用状況の分析情報ダッシュボードを表示するために必要な権限を取得するには、 プロジェクトに対する Datastore 閲覧者

（roles/datastore.viewer）IAM ロールを付与するよう管理者に依頼してください。

この事前定義ロールには、使用状況の分析情報ダッシュボードを表示するために必要な datastore.insights.get 権限が含まれています。

カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。

使用状況の分析情報ダッシュボード

使用状況の分析情報ダッシュボードは、主に次の 2 つのセクションで構成されています。

  • 合計使用量: データベース全体の集計指標（読み取り、書き込み、TTL 削除）を表示します。
  • GroupBy 使用量: 上位 100 個のディメンションで分類された指標を表示し、コレクション、コレクション グループ、Namespace でグループ化されます。

合計使用量と GroupBy の指標

GroupBy セクションの指標の合計が、合計使用量セクションに表示される指標と一致しない場合があります。この差異は、次の要因により発生することが想定されます。

  • GroupBy の上限（上位 100 件）: GroupBy セクションでは、上位 100 件のコレクション、コレクション グループ、Namespace の使用状況のみを項目別に表示できます。 アクティブでないディメンションによって生成された使用量は、合計使用量に反映されますが、GroupBy の使用状況指標には個別に表示されません。
  • 広範なオペレーションのサンプリング: 多数のコレクションに影響するリクエスト（複数のコレクションにまたがる結合、ListCollectionIds、ListDocuments、種類のないクエリなど）の場合、使用状況の分析情報ではコレクションをサンプリングし、使用量の多いコレクションを優先します。その結果、影響を受けるすべてのコレクションが GroupBy の使用状況指標に含まれるわけではありません。

  • 予約名: Cloud Firestore は、内部メタデータ用に 二重アンダースコア（__*__）で始まる名前を予約しています。これらの予約名に関連する使用量は合計使用量に反映されますが、GroupBy の使用状況指標には含まれません。

    GroupBy ディメンション

    GroupBy セクションでは、有効になっている API によって決定されるディメンションに基づいて使用状況の指標が整理されます。

    • コレクション: Cloud Firestore API が有効になっている場合に使用できます。
    • コレクション グループ: 通常、すべての API 構成で使用できます。

    使用状況の分析情報データ

    Google Cloud コンソールの使用状況の分析情報には、次の API メソッドから取得したデータが表示されます。

    • queryTopAggregatedInsightsData
    • queryTopTimeseriesInsightsData
    フィールド名 詳細
    コレクション名

    コレクション グループ名
    		 使用状況データが集計される使用状況ディメンションに対応する値。コレクション名またはコレクション グループ名を使用できます。
    読み取りオペレーションの合計数 読み取りオペレーションの合計数。Standard エディションにのみ適用されます。
    書き込みオペレーションの合計数 書き込みオペレーションの合計数。削除オペレーションも含まれます。Standard エディションにのみ適用されます。
    TTL 削除オペレーションの合計数 TTL 削除オペレーションの合計数。Standard エディションにのみ適用されます。
    読み取りオペレーションの合計数 トランシェ化された読み取りユニット（4 KiB トランシェ）の合計数。Enterprise エディションにのみ適用されます。
    書き込みオペレーションの合計数 トランシェ化された書き込みユニット（1 KiB トランシェ）の合計数。削除ユニットも含まれます。Enterprise エディションにのみ適用されます。
    TTL 削除オペレーションまたはマネージド削除オペレーションの合計数 TTL 削除ユニットまたはマネージド削除ユニットの合計数。Enterprise エディションにのみ適用されます。
    Eventarc ユニットの合計数 Eventarc ユニットの合計数。Enterprise エディションにのみ適用されます。
    読み取りバイト数の合計 スキャンされたバイト数の合計。
    スキャンされたドキュメントの合計数 スキャンされたドキュメントの合計数。
    スキャンされたインデックス エントリの合計数 スキャンされたインデックス エントリの合計数。
    書き込まれたドキュメントの合計数 書き込まれたドキュメントの合計数。
    書き込まれたインデックス エントリの合計数 書き込まれたインデックス エントリの合計数。
    書き込まれたドキュメント サイズの合計 ドキュメントの書き込みサイズの合計（バイト単位）。

    制限事項

    • 課金対象の読み取りと書き込みに寄与するストリーミング クエリは、API レスポンスの一部としてトラッキングされません。
    • Enterprise エディションのインポート/エクスポート、一括削除、復元、クローン、インデックスの作成など、課金対象の読み取りと書き込みに寄与する管理オペレーションの使用状況の分析情報はサポートされていません。
    • 下り（外向き）ネットワークとストレージの課金はサポートされていません。

    料金

    使用状況の分析情報に追加料金は発生しません。

    使用状況の分析情報を表示する

    Cloud Firestore データベースの使用状況の分析情報を表示するには、Google Cloud コンソールでデータベースの [Usage Insights] ペインを開きます。

    1. Google Cloud コンソールで [データベース] ページに移動します。

      [データベース] に移動

    2. データベースのリストからデータベースを選択します。

    3. ナビゲーション メニューで [使用状況の分析情報] をクリックします。

      Google Cloud コンソールのネイティブ モード データベースの使用状況分析情報

      [グループ化] プルダウンを使用して、コレクション、コレクション グループ、Namespace の使用状況の分析情報を表示します。過去 45 日間の使用状況の分析情報データを表示できます。