このページでは、使用状況の分析情報を使用して、特定のデータベースの課金対象の使用状況を分析する方法について説明します。このデータは、カスタム期間にわたって、コレクション、コレクション グループ、名前空間(Datastore モードに固有)などのディメンションで分類できます。表示される使用状況の分析情報の指標は、エディションまたはモードによって異なります。
| エディション | 指標 |
| 標準 |
|
| Enterprise |
|
使用状況の分析情報の概要
使用状況分析ダッシュボードを使用して、特定のデータベースの使用状況をモニタリングします。このダッシュボードは、次のことに役立ちます。
- 詳細な使用状況をモニタリングする:
collection、collectionGroup、namespaceなどのディメンション別に課金対象のオペレーションを追跡します。 - 費用を最適化する: 請求額の高い使用量を特定して、データ構造やクエリを最適化し、全体的な請求額を削減できる場所を特定します。
- 過去の傾向を追跡する: 課金対象の使用統計情報が特定の期間にどのように変化するかをモニタリングします。
必要なロール
使用状況の分析情報ダッシュボードを表示するために必要な権限を取得するには、Datastore 閲覧者を付与するよう管理者に依頼してください。
プロジェクトに対する IAM ロール(roles/datastore.viewer)。
この事前定義ロールには、使用状況の分析情報ダッシュボードを表示するために必要な datastore.insights.get 権限が含まれています。
カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。
使用状況の分析情報ダッシュボード
[使用状況の分析情報] ダッシュボードは、主に次の 2 つのセクションで構成されています。
- 合計使用量: データベース全体の集計指標(読み取り、書き込み、TTL 削除)が表示されます。
- GroupBy Usage: 上位 100 個のディメンションで分類された指標が表示されます。コレクション、コレクション グループ、名前空間でグループ化されます。
合計使用量と GroupBy 指標
[GroupBy] セクションの指標の合計が、[Total Usage] セクションに表示される指標と一致しない場合があります。この差異は、次の要因により発生することが想定されます。
- GroupBy の上限(上位 100 件): GroupBy セクションは、上位 100 件のコレクション、コレクション グループ、Namespace の使用状況のみを項目化するように制限されています。アクティブでないディメンションによって生成された使用量は、合計使用量の数値に貢献しますが、GroupBy 使用状況指標に個別に表示されることはありません。
- 広範なオペレーションのサンプリング: 多数のコレクションに影響するリクエスト(複数のコレクション間の結合、
ListCollectionIds、ListDocuments、種類を指定しないクエリなど)の場合、使用状況の分析情報はコレクションをサンプリングし、使用量が最も多いコレクションを優先することがあります。そのため、影響を受けるすべてのコレクションが GroupBy の使用状況の指標に含まれるわけではありません。 予約済みの名前: Cloud Firestore は、内部メタデータ用に 2 つのアンダースコア(__*__)で始まる名前を予約しています。これらの予約済みの名前に関連する使用量は、合計使用量に加算されますが、GroupBy 使用量指標には含まれません。
GroupBy ディメンション
[GroupBy] セクションでは、有効な API によって決定されるディメンションに基づいて使用状況の指標を整理します。
- コレクション: Cloud Firestore API が有効になっている場合に使用できます。
たとえば、主に Firestore MongoDB 互換オペレーションを使用するデータベースでは、使用状況の内訳がデフォルトで [コレクション] になります。
使用状況の分析情報データ
Google Cloud コンソールの使用状況の分析情報には、次のフィールドが表示されます。
フィールド名 詳細 コレクション名
コレクション グループ名使用状況データが集計される使用状況ディメンションに対応する値。これは、コレクション名またはコレクション グループ名です。 読み取りオペレーションの合計 読み取りオペレーションの合計数。Standard エディションにのみ適用されます。 書き込みオペレーションの合計 書き込みオペレーションの合計数。削除オペレーションも含まれます。Standard エディションにのみ適用されます。 TTL 削除オペレーションの合計 TTL 削除オペレーションの合計数。Standard エディションにのみ適用されます。 読み取り単位の合計 トランシェされた読み取りユニット(4 KiB トランシェ)の合計数。Enterprise エディションにのみ適用されます。 書き込み単位の合計 トランシェされた書き込みユニットの合計数(1 KiB トランシェ)。削除ユニットも含まれます。Enterprise エディションにのみ適用されます。 TTL 削除単位または管理対象の削除単位の合計 TTL 削除単位またはマネージド削除単位の合計数。Enterprise エディションにのみ適用されます。 Eventarc ユニットの合計 Eventarc ユニットの合計数。Enterprise エディションにのみ適用されます。 読み取りバイト数の合計 スキャンされた合計バイト数。 スキャンされたドキュメントの合計数 スキャンされたドキュメントの合計数。 スキャンされたインデックス エントリの合計数 スキャンされたインデックス エントリの合計数。 書き込まれたドキュメントの合計数 書き込まれたドキュメントの合計数。 書き込まれたインデックス エントリの合計数 書き込まれたインデックス エントリの合計数。 書き込まれたドキュメント サイズの合計 ドキュメントの合計書き込みサイズ(バイト単位)。 制限事項
- 課金対象の読み取りと書き込みに寄与するストリーミング クエリは、API レスポンスの一部として追跡されません。
- Enterprise エディションのインポート / エクスポート、一括削除、復元、クローン、インデックス ビルドなどの管理オペレーション(課金対象の読み取りと書き込みに寄与)の使用状況の分析情報はサポートされていません。
- 下り(外向き)ネットワークとストレージの課金はサポートされていません。
料金
使用状況の分析情報に追加料金は発生しません。
使用状況の分析情報を表示する
Cloud Firestore データベースの使用状況の分析情報を表示するには、Google Cloud コンソールでデータベースの [使用状況の分析情報] ペインを開きます。
Google Cloud コンソールで [データベース] ページに移動します。
データベースのリストからデータベースを選択します。
ナビゲーション メニューで [使用状況の分析情報] をクリックします。
[グループ化] プルダウンを使用して、コレクション、collectionGroup、または名前空間の使用状況の分析情報を表示します。使用状況の分析情報データは、過去 45 日分まで表示できます。