分析使用情况数据分析

本页面介绍了如何使用用量分析洞见来分析特定数据库的可计费使用量。您可以按集合、集合组或命名空间（特定于 Datastore 模式）等维度在自定义时间段内细分这些数据。显示的使用情况数据分析指标因版本或模式而异：

版本 指标
标准
  • 读取
  • 写入（包括删除）
  • TTL 删除
  • 流式读取（Listen 个请求）
  • 流式写入（StreamWrite 个请求，包括删除）
企业
  • 读取单元
  • 写入单元数（包括删除）
  • TTL 删除或托管式删除单元
  • Eventarc 单元
  • 流式读取单元（Listen 轮询）
  • 实时读取单元（Listen 流式更新）
  • 流式写入单位（StreamWrite 个请求，包括删除）

用量数据分析概览

使用用量分析信息中心监控特定数据库的用量。此信息中心可帮助您：

  • 监控精细用量：按 collection、collectionGroup 或 namespace 等维度跟踪可计费操作。
  • 优化费用：确定高额账单用量，以确定可以在哪些方面优化数据结构或查询，并降低总体账单金额。
  • 跟踪历史趋势：监控计费使用情况统计信息在特定时间范围内的变化。

所需的角色

如需获得查看用量分析信息中心所需的权限，请让您的管理员为您授予 Datastore Viewer

(roles/datastore.viewer) IAM 角色。

此预定义角色包含查看用量分析信息中心所需的 datastore.insights.get 权限。

您也可以使用自定义角色或其他预定义角色来获取此权限。

使用情况分析洞见信息中心

“用量数据分析”信息中心分为两个主要部分：

  • 总用量：显示整个数据库的汇总指标（读取、写入、流读取、流写入和 TTL 删除）。
  • 分组依据用量：显示按前 100 个维度细分并按集合、集合组或命名空间分组的指标。

总用量和 GroupBy 指标

请务必注意，“GroupBy”部分中的指标总和可能与“总用量”部分中显示的指标不一致。由于以下因素， 这种差异是正常的：

  • GroupBy 限制（前 100 个）：GroupBy 部分仅限于列出前 100 个集合、集合组或命名空间的使用情况。由活跃度较低的维度产生的使用量会计入总使用量，但不会单独列在 GroupBy 使用量指标中。
  • 对广泛操作进行采样：对于影响大量集合的请求（例如，跨多个集合的联接、ListCollectionIds、ListDocuments、不分类查询），使用情况数据分析可能会对集合进行采样，并优先考虑使用率最高的集合。因此，并非所有受影响的集合都会包含在 GroupBy 用量指标中。

  • 预留名称： Cloud Firestore 会为内部元数据预留带有双下划线前缀 (__*__) 的名称。与这些预留名称相关的用量会计入总用量，但不会包含在 GroupBy 用量指标中。

    GroupBy 维度

    “分组依据”部分根据已启用的 API 确定的维度来整理用量指标：

    • 集合：在 Cloud Firestore API 启用后可用。
    • 集合组：在所有 API 配置中正式发布。

    用量数据分析数据

    Google Cloud 控制台上的使用情况数据分析会显示来自以下 API 方法的数据：

    • queryTopAggregatedInsightsData
    • queryTopTimeseriesInsightsData
    字段名称 详细信息
    集合名称

    集合组名称
    		 与汇总用量数据所对应的用量维度相对应的值。这可以是集合名称或集合组名称
    总读取操作次数 非流式读取操作的总次数。仅适用于标准版。
    总写入操作次数 非流式写入操作总数。包括删除操作。仅适用于标准版。
    数据流读取操作总数 用于流式传输 Listen 请求的读取操作总数（包括初始查询轮询、实时文档更改通知、跳过的结果、索引读取和最低读取费用）。仅适用于标准版。
    数据流写入操作总数 用于 StreamWrite 请求的写入操作总数。包括删除操作。仅适用于标准版。
    总 TTL 删除操作数 TTL 删除操作总数。仅适用于标准版。
    总读取单元数 非流式读取的分批读取单位（4 KiB 分批）总数。仅适用于企业版。
    总写入单元数 非流式写入的分批写入单位（以 1 KiB 为一个单位）总数。包括删除单位。仅适用于企业版。
    TTL 删除或托管式删除操作总数 TTL 删除或托管式删除单元的总数。仅适用于企业版。
    Eventarc 单元总数 Eventarc 单元总数。仅适用于企业版。
    总数据流读取单元数 在流式 Listen 请求中用于轮询操作的分批读取单位（4 KiB 分批）总数。仅适用于企业版。
    实时读取单元总数 Listen 请求中用于流式更新的实时读取单位（1 KiB 分批）总数。仅适用于企业版。
    总数据流写入单元数 用于 StreamWrite 请求的分批写入单位（1 KiB 分批）总数。包括删除单位。仅适用于企业版。
    总读取字节数 扫描的总字节数。
    扫描的文档总数 扫描的文档总数。
    扫描的索引条目总数 扫描的索引条目总数。
    写入文档总数 写入的文档总数。
    写入的索引条目总数 写入的索引条目总数。
    写入的文档大小总和 文档写入总大小（以字节为单位）。

    限制

    • 不支持企业版中导入/导出、批量删除、恢复、克隆和索引构建等管理员操作（会产生可计费的读取和写入操作）的使用情况数据分析。
    • 不支持网络出站流量和存储空间结算。

    价格

    使用情况分析不会产生额外费用。

    查看用量数据分析

    如需查看 Cloud Firestore 数据库的用量分析，请在 Google Cloud 控制台中打开数据库的用量分析窗格。

    1. 在 Google Cloud 控制台中，转到数据库页面。

      前往“数据库”

    2. 从数据库列表中选择一个数据库。

    3. 在导航菜单中，点击用量分析。

      Google Cloud 控制台中原生模式数据库的用量数据分析

      使用分组依据下拉菜单查看集合、collectionGroup 或命名空间的使用情况数据分析。您最多可以查看过去 45 天的使用情况数据分析。