如果你曾因为调试慢速或代价高昂的查询而倍感沮丧，那么我们有一个好消息要告诉你。通过 PlanetScale Insights，你现在可以直接在 PlanetScale 仪表盘中分析并调试指定时段内的单个查询性能，无需离开当前界面。

什么是 PlanetScale Insights

Insights 是我们仪表盘内查询统计工具的下一代功能升级。此更新引入了一个交互式图表，可以将你的 PlanetScale 数据库查询性能映射到选定的时间范围，帮助你快速调试。此外，我们新增了一个部分，用于展示过去24小时内针对数据库运行的所有活跃查询的重要指标。

Insights 的基于时间的图表

通过新的 Insights 图表，你可以一目了然地监控以下指标：

  • 读取的行数（Rows read）
  • 写入的行数（Rows written）
  • 查询延迟（Query latency）
  • 每秒查询数（Queries per second）

你可以将鼠标悬停在图表的某个点上，查看以10分钟为增量的指标数据。这将显示选定时间段内读取的总行数、写入的总行数、延迟或每秒的查询数量。

此外，部署请求也会显示在图表上，从而让你快速看到最新的模式更改对性能的影响。

过去24小时内的查询

我们还添加了一个新的部分，显示过去24小时内运行在你的数据库上的所有查询。

如果你的活动查询数较多，可以通过在图表上拖动光标选择较短的时间范围来缩小分析范围。

每个查询都会提供以下指标：

  • 查询运行次数（Number of times the query has run）
  • 查询运行总时长（Total time the query has run）
  • 单次查询时间（Time per query）
  • 返回的行数（Rows returned）
  • 读取的行数（Rows read）
  • 影响的行数（Rows affected）

我们特别兴奋地介绍”每个查询读取的行数”（Rows read per query）这一新功能！PlanetScale 的计费其中一项基础是每月读取的总行数，因此 Insights 是一个非常有价值的工具，可以帮助你监控查询对读取行数的影响。

此外，你可以点击某个查询以进一步深入分析。在单个查询页面上，你可以找到该查询运行缓慢的实例（如果有）。我们还新增了一个生成查询的 EXPLAIN 计划的新界面，并提供在 Web 控制台中打开的选项。

定价和可用性

各计划的可用性如下：

  • Scaler Pro — 可访问过去7天的全部 Insights 数据
  • Enterprise — 可自定义数据保留时间范围

要访问 Insights，进入你的 PlanetScale 仪表盘，选择数据库并点击 “Insights” 标签。

Insights 的实战应用

为了更好地展示 Insights 的强大功能，让我们看一个实战应用案例。

在这个例子中，我们将使用我们自己的开源 Beam 项目的数据库进行实际操作。

假设我们在生产数据库上进行了模式变更部署，之后注意到文章页面加载速度比平时慢。与其耗费数小时寻找问题查询，我们可以直接进入 Insights 页面进行调试。

首先，我们查看图表以识别任何异常，例如读取或写入行数的峰值。如果性能影响与某次部署同时发生，部署请求会显示在图表的异常峰值旁边。这提供了一个直接的线索，指向可能导致性能问题的模式更改。

示例调试过程

根据图表，我们看到在合并部署请求 #289 时出现了一个大峰值。此信息让我们确信这次性能影响确实与数据库问题有关。

接下来，我们可以进一步深入，通过查看“过去24小时内的查询”表格。我们按“读取的行数”（Rows read）进行排序，快速定位最大的查询，并尝试找到与图表上峰值匹配的查询。

在表格顶部，我们看到一个查询特别显眼——读取了 1,043,729 行，远超过预期。点击该查询后，会显示详细视图，其中包括过去24小时内所有运行缓慢的实例。

仔细观察，我们发现该查询自上次部署以来就一直运行缓慢——与我们在图表上看到的部署请求完全匹配。打开该部署请求后，我们可以查看具体做了哪些更改。

问题解决与验证

此时，我们已经定位到问题查询，并将其与部署请求中的模式变更关联起来。有了这些信息，我们可以创建一个新的开发分支，尝试修复问题。在开发过程中，我们可以返回 Insights 图表验证我们的更改是否有效。

最后，将更改部署到生产环境后，我们再次返回 Insights 页面确认生产环境的性能恢复正常。

通过 PlanetScale Insights，调试性能问题变得更加直观、高效。


引入 PlanetScale Insights：高级查询监控插图

关注公众号：程序新视界，一个让你软实力、硬技术同步提升的平台

除非注明，否则均为程序新视界原创文章，转载必须以链接形式标明本文链接

本文链接：https://choupangxia.com/2025/08/02/planetscale-insights/