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

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

エディション 指標
標準
  • 読み取り
  • 書き込み（削除を含む）
  • TTL 削除
  • ストリーム読み取り（Listen リクエスト）
  • ストリームの書き込み（StreamWrite 件のリクエスト、削除を含む）
Enterprise
  • ユニットの読み取り
  • 書き込みユニット（削除を含む）
  • TTL 削除単位または管理対象削除単位
  • Eventarc ユニット
  • ストリーム読み取りユニット（Listen ポーリング）
  • リアルタイム読み取りユニット（Listen ストリーミング アップデート）
  • ストリーム書き込みユニット（StreamWrite リクエスト、削除を含む）

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

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

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

必要なロール

使用状況分析ダッシュボードを表示するために必要な権限を取得するには、Datastore 閲覧者の付与を管理者に依頼してください。

プロジェクトに対する IAM ロール（roles/datastore.viewer）。

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

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

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

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

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

合計使用量と GroupBy 指標

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

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

  • 予約済みの名前: Firestore では、内部メタデータ用に、2 つのアンダースコア（__*__）で始まる名前が予約されています。これらの予約済みの名前に関連する使用量は、合計使用量に寄与しますが、GroupBy 使用量指標には含まれません。

    GroupBy ディメンション

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

    • コレクション: Firestore API が有効になっている場合に使用できます。
    • コレクション グループ: すべての API 構成で一般提供されています。

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

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

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

    コレクション グループ名
    		 使用状況データが集計される使用状況ディメンションに対応する値。コレクション名またはコレクション グループ名を指定できます。
    読み取りオペレーションの合計 非ストリーミング読み取りオペレーションの合計数。Standard エディションにのみ適用されます。
    書き込みオペレーションの合計 ストリーミング以外の書き込みオペレーションの合計数。削除オペレーションが含まれます。Standard エディションにのみ適用されます。
    ストリーム読み取りオペレーションの合計数 ストリーミング Listen リクエストに使用された読み取りオペレーションの合計数（最初のクエリ ポーリング、リアルタイム ドキュメント変更通知、スキップされた結果、インデックス読み取り、最小読み取り料金を含む）。Standard エディションにのみ適用されます。
    ストリーム書き込みオペレーションの合計数 StreamWrite リクエストに使用された書き込みオペレーションの合計数。削除オペレーションが含まれます。Standard エディションにのみ適用されます。
    TTL 削除オペレーションの合計 TTL 削除オペレーションの合計数。Standard エディションにのみ適用されます。
    読み取り単位の合計 非ストリーミング読み取りのトランシェ読み取りユニット（4 KiB トランシェ）の合計数。Enterprise エディションにのみ適用されます。
    書き込み単位の合計 非ストリーミング書き込みのトランシェ書き込みユニット（1 KiB トランシェ）の合計数。削除単位が含まれます。Enterprise エディションにのみ適用されます。
    TTL 削除オペレーションまたはマネージド削除オペレーションの合計 TTL 削除または管理対象削除の単位の合計数。Enterprise エディションにのみ適用されます。
    Eventarc ユニットの合計 Eventarc ユニットの合計数。Enterprise エディションにのみ適用されます。
    ストリーム読み取りユニットの合計 ストリーミング Listen リクエストのポーリング オペレーションに使用されたトランシェ読み取りユニット（4 KiB トランシェ）の合計数。Enterprise エディションにのみ適用されます。
    リアルタイム読み取りユニットの合計 Listen リクエストでストリーミング更新に使用されるリアルタイム読み取りユニット（1 KiB トランシェ）の合計数。Enterprise エディションにのみ適用されます。
    ストリーム書き込みユニットの合計 StreamWrite リクエストに使用されたトランシェ書き込みユニット（1 KiB トランシェ）の合計数。削除単位が含まれます。Enterprise エディションにのみ適用されます。
    読み取りバイト数の合計 スキャンされた合計バイト数。
    スキャンされたドキュメントの合計数 スキャンされたドキュメントの合計数。
    スキャンされたインデックス エントリの合計数 スキャンされたインデックス エントリの合計数。
    書き込まれたドキュメントの合計数 書き込まれたドキュメントの合計数。
    書き込まれたインデックス エントリの合計数 書き込まれたインデックス エントリの合計数。
    書き込まれたドキュメントの合計サイズ ドキュメントの書き込みの合計サイズ（バイト単位）。

    制限事項

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

    料金

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

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

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

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

      [データベース] に移動

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

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

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

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