数据源
数据源是平台一切可观测能力的"进水口"。指标查询、日志检索、告警规则、链路分析等功能,都是从这里接入的外部监控系统读取数据。您需要先在本模块登记好数据源(指标库、日志库、链路库),后续各功能页面才能选择并使用它们。
功能简介
数据源模块用于集中登记与管理平台对接的外部数据服务,当前支持三类:
- Prometheus:时序指标库,支撑"指标查询"、告警规则、拓扑与服务指标等。
- Elasticsearch(ELK):日志库,支撑"日志查询"与日志分析。
- Jaeger:链路库,支撑第 7 章 APM 的调用链(Trace)查询。
每个数据源可独立启用/禁用,并可配置访问地址、超时时间、认证信息等。启用后即可在对应的查询与告警页面被选用。
进入路径
左侧主导航 → 数据源(菜单最下方,数据库图标)。页面地址为 /datasources。
提示:新增、编辑、删除数据源需要"数据源写入"权限;仅有查看权限的用户只能浏览列表。
界面总览
页面顶部为"数据源管理"标题栏,右上角为"添加数据源"按钮;下方是已登记数据源的列表表格,展示名称、类型、地址、状态与操作入口。
界面元素说明
列表字段
| 字段 | 含义 |
|---|---|
| 名称 | 数据源的自定义名称,前面带类型图标(Prometheus/Elasticsearch/Jaeger),便于在其他页面下拉选择时识别 |
| 类型 | 数据源类别标签:Prometheus、Elasticsearch 或 Jaeger |
| 地址 | 数据源的接入地址(URL),即平台访问该服务的入口 |
| 状态 | "已启用"(绿点)表示可被查询/告警使用;"已禁用"表示暂不可用 |
| 操作 | 「编辑」修改配置,「删除」移除该数据源(删除前会二次确认) |
添加/编辑数据源面板字段
| 字段 | 含义 |
|---|---|
| 类型 | 选择 Prometheus、Elasticsearch 或 Jaeger,决定下方可填写的配置项 |
| 名称 | 数据源显示名称,建议使用可辨识的命名,如 prod-prometheus |
| 地址 URL | 数据源访问地址,如 http://prometheus.example.nip.io:9090;不同类型有对应的示例占位 |
| 超时(秒) | 单次查询的最长等待时间,默认 30 秒,可填 1–600 |
| 索引模式 | 仅 Elasticsearch 显示,指定默认检索的索引通配,如 logs-* |
| 版本 | 仅 Elasticsearch 显示,选择 7.x 或 8.x,以匹配日志库版本 |
| 启用 Basic Auth | 勾选后展开"用户名""密码",用于需要账号密码认证的数据源 |
| 用户名 / 密码 | Basic Auth 的认证凭据(仅在勾选上一项后出现) |
| 启用 | 是否启用该数据源;不勾选则登记后暂不参与查询与告警 |
操作步骤
- 进入 数据源 页面,点击右上角「添加数据源」。
- 在弹出的配置面板中,先选择「类型」(Prometheus / Elasticsearch / Jaeger)。
- 填写「名称」与「地址 URL」;如为 Elasticsearch,再填写「索引模式」并选择「版本」。
- 如目标服务需要账号密码,勾选「启用 Basic Auth」并填入「用户名」「密码」。
- 按需调整「超时(秒)」,确认「启用」为勾选状态。
- 点击「创建」保存。列表中即出现新数据源,状态显示为"已启用"。
- 后续如需修改,在列表操作列点击「编辑」;确认不再使用可点击「删除」并在确认框中确认。
常见问题 / 注意事项
- 地址填写:请填写平台服务器可直接访问的地址;若数据源部署在内网,请确保网络互通,否则查询会超时或报错。
- 类型要选对:指标类请选 Prometheus,日志类请选 Elasticsearch,链路类请选 Jaeger。类型选错会导致对应查询页面无法在下拉中列出该数据源。
- 禁用而非删除:临时不用时建议将「启用」取消勾选,而非删除,便于日后快速恢复。
- 认证失败:若查询提示未授权(401),多为「启用 Basic Auth」未开启或用户名/密码有误,请回到编辑面板核对。
- 删除影响:删除数据源后,依赖它的查询、告警规则、仪表盘可能失效,删除前请确认无关联使用。