> ## 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、巡检数据库对象，识别性能与结构风险，并支持批量优化和治理进度跟踪。

性能巡检平台（PawSQL Performance Patroller）对已接入的数据库实例持续采集慢查询、巡检数据库对象，把分散的性能问题收敛为可量化、可跟踪、可批量优化的治理任务。它独立于优化平台的单条 SQL 优化流程，面向的是"一个实例上成百上千条慢 SQL 与对象缺陷"的持续治理场景。

<Frame caption="性能巡检平台概览：实例指标、近七天慢 SQL 与数据库巡检 Top 5">
  <img src="https://mintcdn.com/pawsql/cdtFYB4QMM1nGHhK/images/performance/patrol-dashboard.png?fit=max&auto=format&n=cdtFYB4QMM1nGHhK&q=85&s=f88c7500874085493fab393947c9cdf4" alt="性能巡检概览" width="1920" height="889" data-path="images/performance/patrol-dashboard.png" />
</Frame>

## 治理工作流

接入数据库实例是起点，随后沿「慢查询治理」与「对象巡检」两条线推进，最终通过治理进度跟踪收敛：

<Steps>
  <Step title="接入数据库实例">
    添加实例，填写连接信息并完成慢查询与巡检配置。
  </Step>
</Steps>

### 慢查询治理

<Steps>
  <Step title="慢查询采集">
    从数据库慢查询日志采集慢 SQL，可手动触发或按计划定时采集。
  </Step>

  <Step title="SQL 聚合与去重">
    对采集结果按 SQL 结构聚合去重，过滤出业务 SQL，形成治理清单。
  </Step>

  <Step title="批量分析与优化">
    对选中的慢 SQL 批量发起优化或 AI 优化，生成重写与索引建议。
  </Step>

  <Step title="创建优化任务工单">
    把选中的慢 SQL 打包成优化任务工单，配置参数并提交跟踪。
  </Step>
</Steps>

### 对象巡检

<Steps>
  <Step title="对象巡检任务">
    为实例配置巡检模板，手动或定时巡检数据库对象。
  </Step>

  <Step title="巡检任务报告">
    从数据库对象维度查看巡检发现的风险分布与 Top 问题。
  </Step>

  <Step title="创建巡检问题工单">
    把存在异常的对象打包成整改工单。
  </Step>
</Steps>

跟踪治理进度贯穿全程：通过优化状态、处置阶段和性能提升跟踪每条 SQL 与每个对象的治理进展。

```mermaid theme={null}
flowchart LR
    A["接入实例"] --> B["慢查询采集"]
    A --> C["对象巡检任务"]
    B --> D["聚合与去重"]
    D --> E["批量分析与优化"]
    E --> F["优化任务工单"]
    C --> G["巡检报告"]
    G --> H["巡检问题工单"]
    F --> I["跟踪治理进度"]
    H --> I
```

## 核心对象

| 对象     | 作用                              |
| ------ | ------------------------------- |
| 实例     | 已接入的目标数据库，保存连接信息、慢查询阈值与巡检模板配置   |
| 慢查询    | 从慢查询日志采集并聚合后的 SQL，带耗时、执行次数与治理状态 |
| 巡检模板   | 定义巡检时启用的审核规则与风险级别               |
| 数据库对象  | 实例中的表，带列数、行数、索引数与巡查异常数          |
| 巡检报告   | 汇总数据库对象数、风险级别分布与 Top 规则、Top 对象  |
| 优化任务工单 | 把一批慢 SQL 与优化配置打包成的可跟踪优化记录       |
| 巡检问题工单 | 把巡检发现的问题对象打包成的可跟踪整改记录           |

## 本分组包含

### 接入与跟踪

<CardGroup cols={2}>
  <Card title="接入数据库实例" href="/user-guide/performance/connect-instance" />

  <Card title="跟踪治理进度" href="/user-guide/performance/track-progress" />
</CardGroup>

### 慢查询治理

<CardGroup cols={2}>
  <Card title="慢查询采集" href="/user-guide/performance/collect-slow-sql" />

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

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

  <Card title="创建优化任务工单" href="/user-guide/performance/create-optimize-ticket" />
</CardGroup>

### 对象巡检

<CardGroup cols={2}>
  <Card title="对象巡检任务" href="/user-guide/performance/patrol-task" />

  <Card title="巡检任务报告" href="/user-guide/performance/reports" />

  <Card title="创建巡检问题工单" href="/user-guide/performance/create-patrol-ticket" />
</CardGroup>

## 按角色开始

| 角色      | 推荐页面      | 主要职责                |
| ------- | --------- | ------------------- |
| DBA     | 实例接入、巡检报告 | 维护实例连接与巡检模板，判断结构风险  |
| 性能优化工程师 | 慢查询、批量优化  | 分析慢 SQL、发起批量优化并跟踪提升 |
| 开发人员    | 慢查询、治理进度  | 处理归属本团队的慢 SQL 与对象缺陷 |
| 项目管理员   | 实例概览、配置   | 维护实例清单、采集/巡检计划与团队分工 |

## 开始前检查

* 目标数据库可被 PawSQL 服务端网络访问（连接校验在服务端执行）；
* 已获取数据库主机、端口、账号、密码与目标库名；
* 采集慢查询前已确认数据库慢查询日志已开启且可读；
* 巡检模板与目标数据库类型匹配；
* 当前用户具备添加实例与查看巡检数据的权限。

<Warning>
  巡检与优化建议用于辅助分析，不替代业务评审、测试验证、备份、审批与发布控制。
</Warning>

## 延伸阅读

* 优化平台单条 SQL 优化流程：[性能优化工作流](/user-guide/optimization/)
* 数据库上下文：[工作空间与上下文](/user-guide/workspaces/)