> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pawsql.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> PawSQL 是一个产品：Cloud 是公网部署形态，Engine / Optimizer / Auditor / Advisor / Patroller 是同一产品的组件与交付形态，不是彼此独立的产品。 / PawSQL is a single product: Cloud is the public deployment form, while Engine / Optimizer / Auditor / Advisor / Patroller are components and delivery forms of the same product, not separate products.
> 术语以站内术语表为准：SQL 审核对应英文 SQL Review，查询重写对应 Query Rewrite，索引推荐对应 Index Recommendation；英文内容统一用 Review，不用 Audit。 / Use the site glossary for terminology: 审核 is SQL Review, 重写 is Query Rewrite, 索引推荐 is Index Recommendation; English content uses Review, never Audit.
> 引用能力范围或版本支持时以对应页面为准；标注 unknown、或 status 非 published 的内容表示尚未经产品核实，不应作为事实引用。 / Cite capability scope and version support from the corresponding page; content marked unknown, or with a status other than published, is not yet product-verified and must not be cited as fact.

# 慢查询采集

> 在慢查询配置步骤检测数据库慢查询日志并完成采集配置，通过手动采集或定时采集把慢 SQL 汇聚到巡检平台。

慢 SQL 采集是把数据库慢查询日志中的 SQL 汇聚到巡检平台、形成治理清单的关键步骤。采集发生在接入实例向导的「慢查询配置」步骤，接入完成后也可在慢查询页随时手动采集或配置定时采集。

## 目标

把数据库慢查询日志中的慢 SQL 汇聚到巡检平台，形成治理清单。

## 慢查询配置步骤

数据库连接通过后，向导进入「慢查询配置」。该步骤先检测目标数据库的慢查询日志配置，通过后再设置采集参数。

<Frame caption="慢查询配置：先检测数据库慢查询日志配置">
  <img src="https://mintcdn.com/pawsql/cdtFYB4QMM1nGHhK/images/performance/patrol-slow-query-config.png?fit=max&auto=format&n=cdtFYB4QMM1nGHhK&q=85&s=7946a0fffdefa5f1c308f18d498f4b3d" alt="慢查询配置" width="1920" height="889" data-path="images/performance/patrol-slow-query-config.png" />
</Frame>

<Frame caption="检测成功后展示慢查询日志状态与采集配置项">
  <img src="https://mintcdn.com/pawsql/cdtFYB4QMM1nGHhK/images/performance/patrol-slow-query-config-verified.png?fit=max&auto=format&n=cdtFYB4QMM1nGHhK&q=85&s=e971cf3f7f229fb4a04298e9b4450faf" alt="慢查询检测成功" width="1920" height="889" data-path="images/performance/patrol-slow-query-config-verified.png" />
</Frame>

### MySQL 慢查询日志要求

以 MySQL 为例，采集依赖 `slow_query_log` 相关配置。检测通过时页面展示的参数（实测示例）包括：

| 参数                | 示例值     | 说明                                    |
| ----------------- | ------- | ------------------------------------- |
| `slow_query_log`  | `ON`    | 慢查询日志已开启                              |
| `log_output`      | `TABLE` | 慢查询写入表（`mysql.slow_log`），便于 PawSQL 读取 |
| `long_query_time` | `1.0`   | 慢查询阈值（秒）                              |

若检测失败，按页面「实例设置指南」开启慢查询日志，或确认账号具备读取慢查询日志的权限。

## 手动采集

在慢查询页点击「手动采集」立即触发一次采集。采集由服务端执行，完成后页面更新概要数据。

<Frame caption="慢查询页：概要、图表、筛选与「手动采集」「批量操作」">
  <img src="https://mintcdn.com/pawsql/cdtFYB4QMM1nGHhK/images/performance/patrol-slow-queries-data.png?fit=max&auto=format&n=cdtFYB4QMM1nGHhK&q=85&s=92f4004ed783f3f4a8db3a4d4e59dc2f" alt="慢查询页" width="1920" height="889" data-path="images/performance/patrol-slow-queries-data.png" />
</Frame>

采集完成后，概要区展示本次采集结果（实测示例）：

| 指标     | 示例值                   | 说明                     |
| ------ | --------------------- | ---------------------- |
| 慢查询阈值  | `1.000s`              | 采集使用的慢查询判定阈值           |
| 慢SQL数  | `27`                  | 采集到的慢 SQL 总数（含非业务 SQL） |
| 业务SQL数 | `23`                  | 过滤非业务 SQL 后的数量         |
| 最新采集时间 | `2026-09-15 11:16:30` | 最近一次采集完成时间             |

## 定时采集

在慢查询页顶部开启「定时采集」开关，设置采集周期（每 N 天）与执行时间（在 HH:MM），点击「更新」保存。开启后平台按计划自动采集，无需手动触发。

## 采集范围与口径

* 采集的 SQL 来自数据库慢查询日志，因此日志未开启或阈值过高的 SQL 不会被采集；
* 「慢SQL数」与「业务SQL数」的差异来自是否过滤内部/系统 SQL，详见[SQL 聚合与去重](/user-guide/performance/aggregate-dedup)；
* 采集是增量汇聚，重复采集会刷新「最新采集时间」并更新清单。

## 预期结果

采集完成后，慢查询页概要区展示慢查询阈值、慢SQL数、业务SQL数与最新采集时间。

## 提交前检查

* [ ] 数据库慢查询日志已开启；
* [ ] 慢查询阈值符合治理目标（阈值过低会引入大量噪音）；
* [ ] 账号具备读取慢查询日志的权限；
* [ ] 手动采集完成后概要数据已更新。

## 常见问题

| 现象              | 优先检查                                 |
| --------------- | ------------------------------------ |
| 检测失败            | 慢查询日志未开启、`log_output` 非 `TABLE`、账号权限 |
| 采集后无数据          | 慢查询阈值内无 SQL、日志为空、采集任务是否完成            |
| 慢SQL数与业务SQL数不一致 | 「只展示业务SQL」过滤开关，见 SQL 聚合与去重           |

## 延伸阅读

<CardGroup cols={2}>
  <Card title="SQL 聚合与去重" href="/user-guide/performance/aggregate-dedup" />

  <Card title="批量分析与优化" href="/user-guide/performance/batch-optimize" />
</CardGroup>