如何采集数据库¶
通过 DataKit 配置对应的数据库采集器，将数据库实例和性能数据上报到当前工作空间，再进入基础设施 > 数据库查看。
1. 准备 DataKit¶
- 在能够访问目标数据库的主机上安装 DataKit，使用目标工作空间提供的安装命令；已有 DataKit 时，确认其数据上报到该工作空间。
- 确保 DataKit 所在主机能够连接数据库地址和端口，并按对应采集器文档准备采集账号、权限及依赖。
- 旧版采集器可能不支持当前数据库页面的完整数据，请按对应采集器文档检查版本要求并升级。
2. 选择并配置采集器¶
根据数据库类型打开配置指南，完成前置条件和采集器配置：
| 数据库 | 采集器配置 | 查询、会话与执行计划采集 |
|---|---|---|
| MySQL | MySQL 配置 | 开启 DBM，配置 performance_schema、采集权限及所需子项。 |
| PostgreSQL | PostgreSQL 配置 | 数据库性能指标采集，配置扩展、权限及所需 DBM 子项。 |
| Oracle | Oracle 配置 | 开启 DBM，按需配置查询指标、活动查询和执行计划。 |
| SQL Server | SQL Server 配置 | 开启 DBM，按需配置查询指标、活动查询和执行计划。 |
| MongoDB | MongoDB 配置 | 开启 DBM；执行计划需单独启用，并开启 Activity 或 Slow Operations 作为采样来源。 |
| Redis | Redis 配置 | 仅支持数据库查看器。 |
在 DataKit 安装目录的 conf.d/samples 下，复制对应的 <采集器名称>.conf.sample 为 <采集器名称>.conf，按指南填写数据库连接地址、采集账号和密码等配置。容器部署方式请使用对应指南中的 Kubernetes 配置。
仅配置基础指标采集，不代表已开启查询、会话和执行计划采集。需要这些数据时，请完成表中相应的 DBM 配置。
3. 重启并验证采集¶
- 保存配置，按 DataKit 服务管理重启 DataKit。
- 通过 DataKit Monitor检查对应采集器的运行情况；如有错误，结合 DataKit 日志检查连接、权限和配置。
- 在目标工作空间进入基础设施 > 数据库 > 查看器，选择对应数据库类型，确认实例是否出现，再进入实例详情查看已采集的数据。
- 需要跨实例分析 SQL 时，进入查询分析。执行计划需在相应采集功能开启且产生符合采样条件的查询后查看。
常见问题¶
| 现象 | 检查项 |
|---|---|
| 查看器没有数据库实例 | 确认 DataKit 上报的工作空间、采集器是否启用、数据库连接与账号权限，以及采集器版本。 |
| 有实例，但没有查询或会话数据 | 检查对应 DBM 开关、子项、数据库扩展和权限，并确认数据库在所选时间范围内有符合采集条件的查询活动。 |
| 没有执行计划 | 检查对应采集器的执行计划配置、权限与采样条件；MongoDB 还需启用执行计划及至少一个采样来源。 |