帮你快速理解、总结文档立即下载

快速体验指南

最近更新时间:2026-09-02 17:15:00
我的收藏
DatabaseClaw 的容量预测、数据库巡检、慢 SQL 治理、告警主动分析等核心分析能力,均可通过定时任务结果推送实现常态化的自动分析。如您需要快速体验上述能力或调试输出效果,可直接在控制台对话中发起分析,确认输出效果符合预期后,再将其沉淀为定时任务。
教程
说明
订阅数据库告警,由 DatabaseClaw 自动完成诊断分析并推送至 IM 群聊。
通过定时任务对数据库实例进行周期性智能巡检,输出健康报告。
对 CPU、磁盘、内存等维度进行趋势预测与风险判断,输出结构化的容量预测报告。
将 DatabaseClaw 的数据库运维能力集成至已有 AI Agent 工作流。
多业务部门共用 DatabaseClaw 时的 IM 接入与实例资源隔离方案。

控制台对话体验

登录 DatabaseClaw 控制台并进入实例对话页面后,您可以直接使用自然语言发起容量预测、数据库巡检、慢 SQL 治理、告警主动分析等场景分析,快速查看输出效果。具体操作请参见使用对话功能

指定实例范围

发起分析时,建议在提示词中明确实例范围,可按地域业务标签具体实例 ID 指定:
指定实例范围时建议增加地域属性(可填写多个)。数据库实例信息按地域存储,如不指定地域,系统会轮询查询所有地域,运行耗时将相应增加。
实例分布在多个地域时,可结合业务标签圈定同一业务的全部实例,避免逐个填写实例 ID。

场景提示词速查

以下示例提示词可直接复制到对话输入框或定时任务的“执行内容”中,按需替换实例范围、地域与标签后即可运行。

容量预测

对 CPU、磁盘、内存等资源指标进行趋势预测与风险判断,输出结构化容量预测报告。完整操作示例请参见容量预测实践教程
对话体验 - 示例 1(按地域指定):
执行 Redis 容量预测:
实例范围:广州与北京地域所有 Redis 实例
对话体验 - 示例 2(按业务标签指定):
执行 MySQL 容量预测:
实例范围:通过标签筛选,标签键"业务"=标签值"线上生产"的广州地域 MySQL 实例
定时任务推送示例(含告警格式):
执行 MySQL 容量预测:
实例范围:通过标签筛选,标签键"业务"=标签值"线上生产"的广州地域 MySQL 实例
1)全部健康,无风险则跳过推送
2)有告警(突增异常、阈值异常),按以下格式输出:
**【MySQL 容量告警】**
分析范围:
总实例数:{total_instance_count} 个 | 风险实例数:{risky_instance_count} 个 | 健康实例数:{healthy_instance_count} 个
**告警详情:**
**{{instance_id}} - {{告警概述}}**
> 实例:{{instance_name}}
> 证据:{{key_evidence}} + {{趋势变化}}
> 建议:{{action}}

数据库巡检

对指定数据库实例进行周期性健康巡检,支持跨产品组合(如 Redis + MongoDB),输出健康报告与风险清单。完整操作示例请参见数据库智能巡检实践教程
对话体验 - 示例 1(按地域指定):
分别对广州地域的 Redis 和 MongoDB 实例进行巡检
对话体验 - 示例 2(按业务标签指定):
分别对广州地域的 Redis 和 MongoDB,标签键"业务"=标签值"线上生产"的实例进行巡检
定时任务推送示例(含巡检日报格式):
分别对广州地域的 Redis 和 MongoDB 实例进行巡检,并推送概要信息与报告链接(将 Redis 和 MongoDB 报告压缩成 zip,提供 zip 的 COS 链接),使用 markdown 链接

**【数据库健康巡检日报】{日期}**
报告地址:[点击查看详细报告]({报告链接})

**巡检总览**
> **Redis**:实例总数 {redis总数}| 紧急 {紧急数}| 警告 {警告数}| 正常 {正常数}
**MongoDB**:实例总数 {mongo总数} 个实例| 紧急 {紧急数}| 警告 {警告数}| 正常 {正常数}

**风险趋势**:{新增风险数} 个,(较上周期 {变化说明})

**巡检结论**
**总结**:一句话说明整体健康率、紧急问题集中在什么类型、是否有新增
**趋势**:与上个周期对比,紧急/警告数量的变化方向(上升/下降/持平),给出简短判断

**紧急风险 TOP 10**
>(跨引擎统一按紧急程度排序,最多列 10 条,每条只写一行,格式如下:)
序号. **[Redis/Mongo] 实例 ID** — 核心现象,关键数字或状态词(如"持续未恢复""新增""较昨日 +xx%")

【生成规则】
- P0 条目严格一行,不展开"现象/证据/建议"多段结构,除非只有 1 条 P0 且需要重点强调
- 输出要求:每行之间必须空一行(双换行),确保 Markdown 正确渲染换行

应用慢 SQL 治理

对指定实例进行慢查询专项分析,输出慢 SQL 排行、诊断结论与优化建议。
对话体验 - 示例 1(按地域指定):
对广州地域(ap-guangzhou)的 MongoDB 实例进行慢查询专项分析。
对话体验 - 示例 2(按业务标签指定):
对广州地域(ap-guangzhou)标签键"业务"=标签值"线上生产"的 MongoDB 实例进行慢查询专项分析。
定时任务推送示例(含执行步骤与周报格式):
对广州地域(ap-guangzhou)的 MongoDB 实例进行慢查询专项分析。

**执行步骤:**
1. 使用 MongoDB 周巡检能力,仅执行慢查询巡检,分析窗口设为最近 7 天,对每个实例进行 TOP 10 的慢查询模板分析。
2. 生成两份产物:
- **统计分析报告(HTML)**:跨实例汇总,含慢操作类型分布饼图、按总耗时排序的 TOP 10 慢 SQL 柱状图、按实例维度的慢查询数量热力表、高频 namespace 排行
- **详细诊断报告(Markdown)**:每实例一节(本轮无慢查询的实例不输出详情节),含 TOP 10 慢 SQL 表格,表格按平均执行时间倒序排序,每个慢 SQL 附 DatabaseClaw 诊断结论与优化建议
3. 将两个报告压缩成 zip,上传至对象存储(COS),生成预签名下载链接。
4. 输出以下 brief 推送消息:

**【MongoDB 慢查询分析周报】{日期}**
报告地址:[点击查看详细报告]({报告链接})

**分析总览**
> **范围**:{地域} {实例总数} 个 MongoDB 实例
> **慢查询覆盖**:{有慢查实例数} 个实例存在慢查询,共采集 {慢查模板总数} 条
> **TOP 10 慢 SQL**:跨实例按平均耗时排序,取最慢 10 条

**慢查询 TOP 10(跨实例排序)**
>(每条一行,格式如下:)
序号. **实例 ID** — NS: {namespace},操作: {op},平均耗时: {平均执行时间 s},执行次数: {count} 次

**关键发现**
> **总结**:一句话说明慢查询主要集中在哪类操作(find/aggregate/group 等)、哪个 namespace 最频繁、是否有索引缺失迹象

【生成规则】
- brief 中 TOP 10 每行之间必须空一行(双换行),确保 Markdown 正确渲染
- HTML 报告内嵌 CSS,不依赖外部资源,单文件可直接浏览器打开
- 如某实例无慢查询,在详细报告中标注"本轮无慢查询",不纳入 TOP 10 排序

告警主动分析

订阅数据库告警事件,由 DatabaseClaw 自动完成诊断分析并推送结论。完整操作示例请参见告警主动诊断推送至 IM 实践教程
对话体验 - 示例 1(按地域指定,订阅 DBbrain + 可观测):
对广州地域所有 MongoDB 实例进行告警订阅分析,仅订阅高危告警(DBbrain 的致命告警,可观测平台的 Serious 告警),分析后按照以下格式推送结果:
对话体验 - 示例 2(按业务标签指定,仅订阅可观测):
对广州地域(ap-guangzhou)标签键"业务"=标签值"线上生产"的实例进行告警订阅分析,仅订阅可观测平台的高危告警(Serious 级别),分析后按照以下格式推送结果:
定时任务推送示例(MySQL 告警订阅格式):
对广州地域所有 MySQL 实例进行告警订阅分析,仅订阅高危告警(DBbrain 的致命告警,可观测平台的 Serious 告警),分析后按照以下格式推送结果:

**【MySQL 告警订阅分析】**
**报告链接**[查看完整报告]({{cos链接}}),使用 markdown 链接格式
**分析时间**
**实例范围**
**分析窗口**
**数据源**:显示订阅的告警数据源与告警策略等级
**告警概要**:一句话概述告警分布与涉及实例数
——————
无风险跳过推送,如有风险则按照以下格式推送:
**{{instance_id}} - {{告警概述}}**
> 实例:{{instance_name}}
> 分析:一句话简述 {{core_issue}} + {{key_evidence}}
> 建议:{{action}}
说明:
报告内容与推送格式可根据运维习惯,通过调整提示词修改输出效果。

通过 Webhook 进行信息推送

容量预测、数据库巡检、慢 SQL 治理、告警主动分析均可通过定时任务实现主动分析推送。本节以 Webhook 推送为例说明通用流程,完整操作示例(含提示词参考)请参见容量预测实践教程

步骤一:前置准备

下表列出了开始本实践前需满足的条件:
条件
说明
腾讯云账号
已完成实名认证。
腾讯云数据库 AI 服务
已开通腾讯云数据库 AI 服务,并创建了 DatabaseClaw 实例,参见 创建 DatabaseClaw 实例
数据库实例
至少已创建一个云数据库实例(MySQL、Redis、MongoDB 等),且实例处于运行状态。
推送目标
已在目标 IM 平台创建群机器人并获取其 Webhook 地址;或已准备一个可公网访问、支持接收 HTTP POST 请求的自有系统回调地址。

步骤二:准备 IM 推送通道

在目标 IM 平台创建群机器人并获取其 Webhook 地址。以企业微信为例,具体操作请参见接入企业微信;飞书、钉钉操作同理,参见接入飞书接入钉钉。接入方式的整体说明参见接入 Channel 功能简介

步骤三:创建定时任务

2. 在左侧导航栏选择 DatabaseClaw > 实例管理,单击目标实例卡片进入对话页面。
3. 在对话页面顶部工具栏,单击定时任务
4. 在右侧弹框上方单击创建任务
5. 根据页面提示配置定时任务。创建时将结果投递设置为 Webhook,并填写 Webhook 地址;任务参数的详细说明参见管理定时任务
“执行内容”可参考控制台对话体验中的提示词进行编写,完整示例参见容量预测实践教程的操作示例。

步骤四:验证推送效果

定时任务完成后,会将分析报告推送至已配置的 IM 群聊窗口。
说明:
创建定时任务验证推送效果时,“执行内容”描述中可先不增加“无风险跳过推送”描述内容,验证通过后再修改。

常见问题

Q1:报告中的 COS 下载链接过期了怎么办?

容量预测报告的 COS 预签名下载链接有效期为 24 小时。链接过期后,需重新执行一次容量预测任务生成新报告,或在 DatabaseClaw 对话中重新请求获取下载链接。

Q2:如何修改或删除已创建的定时任务?

可通过 DatabaseClaw 控制台的定时任务列表进行管理,具体操作请参见管理定时任务