跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

指标和分析

最后更新 查看 MarkdownAgent 设置

D1 提供数据库分析功能,允许您检查账户中所有和/或每个数据库的查询量、查询延迟和存储大小。

Cloudflare 仪表板 ↗ 图表中显示的指标从 Cloudflare 的 GraphQL Analytics API 查询。您可以通过 GraphQL 或 HTTP 客户端以编程方式访问这些指标。

指标

D1 目前导出以下指标:

指标 GraphQL 字段名 描述
读取查询(qps) readQueries 针对数据库发出的读取查询数量。这是原始读取查询数量,不用于计费。
写入查询(qps) writeQueries 针对数据库发出的写入查询数量。这是原始写入查询数量,不用于计费。
读取行数(计数) rowsRead 查询中读取(扫描)的行数。有关行计数方式的更多详情,请参阅定价。
写入行数(计数) rowsWritten 查询中写入的行数。
查询响应(字节) queryBatchResponseBytes 序列化查询响应的总响应大小,包括所有/任何列名、行和元数据。以字节为单位报告。
查询延迟(毫秒) queryBatchTimeMs 服务器端总查询响应时间,包括响应序列化。以毫秒为单位报告。
存储空间(字节) databaseSizeBytes 数据库的最大大小。以字节为单位报告。

指标可查询(并保留)过去 31 天的数据。

行计数

D1 通过 Workers Binding API 为每个独立查询返回读取行数、写入行数(或两者)。

行计数是对该查询读取(扫描)或写入的行数的精确计数。 检查行计数以了解给定查询的性能和成本,包括是否可以通过使用索引减少读取行数。使用查询计数了解数据库的总流量,并判断哪些数据库处于活跃使用状态。

有关行计数方式的更多详情,请参阅定价文档。

在仪表板中查看指标

D1 的每个数据库分析可在 Cloudflare 仪表板中查看。要查看数据库的当前和历史指标:

  1. 在 Cloudflare 仪表板中,前往 D1 页面。

    前往 D1 SQL database(D1 SQL 数据库) ↗
  2. 选择一个现有 D1 数据库。

  3. 选择 Metrics(指标) 选项卡。

您可以选择要查询的时间窗口。默认为过去 24 小时。

通过 GraphQL API 查询

您可以通过 GraphQL Analytics API 以编程方式查询 D1 数据库的分析数据。此 API 查询与 Cloudflare 仪表板相同的数据集,并支持 GraphQL 内省。

D1 的 GraphQL 数据集需要带有 Cloudflare 账户 ID 的 accountTag 过滤器,包括:

  • d1AnalyticsAdaptiveGroups
  • d1StorageAdaptiveGroups
  • d1QueriesAdaptiveGroups

示例

要查询给定 $databaseId 的 readQueries、writeQueries 总和,按 databaseId 和 date 分组:

query D1ObservabilitySampleQuery(
    $accountTag: string!
    $start: Date
    $end: Date
    $databaseId: string
) {
    viewer {
        accounts(filter: { accountTag: $accountTag }) {
            d1AnalyticsAdaptiveGroups(
                limit: 10000
                filter: { date_geq: $start, date_leq: $end, databaseId: $databaseId }
                orderBy: [date_DESC]
            ) {
                sum {
                    readQueries
                    writeQueries
                }
                dimensions {
                    date
                    databaseId
                }
            }
        }
    }
}

要查询每个数据库的平均 queryBatchTimeMs 和第 90 百分位 queryBatchTimeMs:

query D1ObservabilitySampleQuery2(
    $accountTag: string!
    $start: Date
    $end: Date
    $databaseId: string
) {
    viewer {
        accounts(filter: { accountTag: $accountId }) {
            d1AnalyticsAdaptiveGroups(
                limit: 10000
                filter: { date_geq: $start, date_leq: $end, databaseId: $databaseId }
                orderBy: [date_DESC]
            ) {
                quantiles {
                    queryBatchTimeMsP90
                }
                dimensions {
                    date
                    databaseId
                }
            }
        }
    }
}

要查询账户范围的 readQueries 和 writeQueries:

query D1ObservabilitySampleQuery3(
    $accountTag: string!
    $start: Date
    $end: Date
    $databaseId: string
) {
    viewer {
        accounts(filter: { accountTag: $accountTag }) {
            d1AnalyticsAdaptiveGroups(
                limit: 10000
                filter: { date_geq: $start, date_leq: $end, databaseId: $databaseId }
            ) {
                sum {
                    readQueries
                    writeQueries
                }
            }
        }
    }
}

查询 insights

D1 提供指标,帮助您了解和调试查询性能。您可以通过 GraphQL 的 d1QueriesAdaptiveGroups 或 wrangler d1 insights 命令访问这些指标。

D1 捕获您的查询字符串,以便更轻松地分析跨查询执行的指标。绑定参数不会被捕获,以移除任何敏感信息。

wrangler d1 insights 会从 GraphQL Analytics API 读取数据。如果使用 API 令牌,该令牌必须具有 Account Analytics Read 权限。

传入数据库名称、绑定或 ID,可获取该数据库的热门查询。省略此参数则会针对整个帐户运行,并获取帐户中所有 D1 数据库的热门查询:

# Top queries for one database
npx wrangler d1 insights <database_name_or_id>

# Top queries across every D1 database in the account
npx wrangler d1 insights

针对整个帐户运行时,每个结果还会包含 databaseId 字段,其中是执行该查询的数据库 ID。若要查找数据库名称,请运行 npx wrangler d1 info <database_id>。

选项 描述
--time-period 获取从当前时间到指定时间范围的数据,例如 30m、12h 或 7d(默认值:1d,最大值:31d)。
--sort-type 您想要排序 insights 的操作。在 sum 和 avg 之间选择(默认:sum)。
--sort-by 您想要排序 insights 的字段。在 time、reads、writes 和 count 之间选择(默认:time)。
--sort-direction 排序方向。在 ASC 和 DESC 之间选择(默认:DESC)。
--json 布尔值,指定是否以干净的 JSON 返回结果(默认:false)。
--limit 要获取的查询数量上限。针对整个帐户运行时,此限制适用于所有数据库(默认值:5)。

按执行次数查找帐户中所有数据库的前 3 条查询:

npx wrangler d1 insights --sort-type=sum --sort-by=count --limit=3 --json
[
  {
    "query": "SELECT \"Order\".Id, \"Order\".CustomerId, \"Order\".OrderDate,\n            SUM(OrderDetail.UnitPrice * OrderDetail.Quantity) AS TotalAmount\n          FROM \"Order\"\n          JOIN OrderDetail ON OrderDetail.OrderId = \"Order\".Id\n          GROUP BY \"Order\".Id\n          ORDER BY \"Order\".Id DESC\n          LIMIT ?",
    "avgRowsRead": 1244521,
    "totalRowsRead": 11040145791,
    "avgRowsWritten": 0,
    "totalRowsWritten": 0,
    "avgDurationMs": 259.2086358584151,
    "totalDurationMs": 2299439.8087000004,
    "numberOfTimesRun": 8871,
    "queryEfficiency": 1.6070439952399358e-05,
    "databaseId": "7c9e2b14-3f6a-4d8e-9b21-5a0c8f3e6d47"
  },
  {
    "query": "SELECT * FROM \"Order\" WHERE OrderDate BETWEEN ? AND ?",
    "avgRowsRead": 16818,
    "totalRowsRead": 148553394,
    "avgRowsWritten": 0,
    "totalRowsWritten": 0,
    "avgDurationMs": 5.4971649382995595,
    "totalDurationMs": 48556.45790000001,
    "numberOfTimesRun": 8833,
    "queryEfficiency": 0.019146152931383043,
    "databaseId": "2e4f6a81-9c3d-4b7e-a512-8d0f3c6b9e15"
  },
  {
    "query": "SELECT * FROM Customer WHERE Id = ?",
    "avgRowsRead": 1,
    "totalRowsRead": 8714,
    "avgRowsWritten": 0,
    "totalRowsWritten": 0,
    "avgDurationMs": 0.318006288730778,
    "totalDurationMs": 2771.1067999999996,
    "numberOfTimesRun": 8714,
    "queryEfficiency": 1,
    "databaseId": "b5d18e3a-6f29-4c04-8e7b-1a9c2d5f7e60"
  }
]

每个结果都包含执行该查询的数据库的 databaseId。

查找平均执行时间最长的前 3 个查询:

npx wrangler d1 insights <database_name> --sort-type=avg --sort-by=time --limit=3
⛅️ wrangler 3.95.0
-------------------

-------------------
🚧 `wrangler d1 insights` is an experimental command.
🚧 Flags for this command, their descriptions, and output may change between wrangler versions.
-------------------

[
  {
    "query": "SELECT * From Customers",
    "avgRowsRead": 0,
    "totalRowsRead": 0,
    "avgRowsWritten": 0,
    "totalRowsWritten": 0,
    "avgDurationMs": 1.0225,
    "totalDurationMs": 1.0225,
    "numberOfTimesRun": 1,
    "queryEfficiency": 0
  },
  {
    "query": "SELECT tbl_name as name,\n                   (SELECT ncol FROM pragma_table_list(tbl_name)) as num_columns\n            FROM sqlite_master\n            WHERE TYPE = \"table\"\n              AND tbl_name NOT LIKE \"sqlite_%\"\n              AND tbl_name NOT LIKE \"d1_%\"\n              AND tbl_name NOT LIKE \"_cf_%\"\n            ORDER BY tbl_name ASC;",
    "avgRowsRead": 2,
    "totalRowsRead": 4,
    "avgRowsWritten": 0,
    "totalRowsWritten": 0,
    "avgDurationMs": 0.49505,
    "totalDurationMs": 0.9901,
    "numberOfTimesRun": 2,
    "queryEfficiency": 0
  },
  {
    "query": "SELECT * FROM Customers",
    "avgRowsRead": 4,
    "totalRowsRead": 4,
    "avgRowsWritten": 0,
    "totalRowsWritten": 0,
    "avgDurationMs": 0.1873,
    "totalDurationMs": 0.1873,
    "numberOfTimesRun": 1,
    "queryEfficiency": 1
  }
]

查找过去 7 天内帐户中所有数据库写入行数最多的前 3 条查询:

npx wrangler d1 insights --sort-type=sum --sort-by=writes --limit=3 --time-period=7d --json
[
  {
    "query": "INSERT INTO OrderDetail (Id, OrderId, ProductId, UnitPrice, Quantity, Discount) VALUES (?, ?, ?, ?, ?, ?)",
    "avgRowsRead": 0,
    "totalRowsRead": 0,
    "avgRowsWritten": 3,
    "totalRowsWritten": 453720,
    "avgDurationMs": 0.41,
    "totalDurationMs": 62008.4,
    "numberOfTimesRun": 151240,
    "queryEfficiency": 0,
    "databaseId": "7c9e2b14-3f6a-4d8e-9b21-5a0c8f3e6d47"
  },
  {
    "query": "INSERT INTO \"Order\" (Id, CustomerId, EmployeeId, OrderDate, ShipVia, Freight) VALUES (?, ?, ?, ?, ?, ?)",
    "avgRowsRead": 0,
    "totalRowsRead": 0,
    "avgRowsWritten": 1,
    "totalRowsWritten": 48906,
    "avgDurationMs": 0.38,
    "totalDurationMs": 18584.28,
    "numberOfTimesRun": 48906,
    "queryEfficiency": 0,
    "databaseId": "7c9e2b14-3f6a-4d8e-9b21-5a0c8f3e6d47"
  },
  {
    "query": "UPDATE Product SET UnitsInStock = UnitsInStock - ? WHERE Id = ?",
    "avgRowsRead": 1,
    "totalRowsRead": 37118,
    "avgRowsWritten": 1,
    "totalRowsWritten": 37118,
    "avgDurationMs": 0.29,
    "totalDurationMs": 10764.22,
    "numberOfTimesRun": 37118,
    "queryEfficiency": 0,
    "databaseId": "2e4f6a81-9c3d-4b7e-a512-8d0f3c6b9e15"
  }
]

每个结果都包含执行该查询的数据库的 databaseId。

若要查找帐户中成本最高的数据库和查询,并了解如何修复,请参阅查找缓慢且成本高昂的查询。

这篇文档对您有帮助吗?