3. 配置数据源

任务目标

在Grafana中完成Prometheus数据源的添加与配置，并通过Grafana内置的测试机制验证连接成功，确保后续仪表盘能够正常读取指标数据。

前置条件

• 已安装并运行Grafana（本案例基于Grafana 10.x，访问地址默认 http://localhost:3000）
• 已安装并运行Prometheus，且其HTTP API端口（默认9090）可从Grafana所在主机访问
• Prometheus中至少有一个正在运行的采集目标（如node_exporter），以便验证数据可用性

操作步骤与配置

Grafana数据源配置支持两种方式：通过Web UI手动配置，或通过配置文件预置。以下分别给出两种方式的完整实现。

方式一：通过Web UI配置（推荐用于交互式验证）

1. 登录Grafana，进入 Connections → Data sources，点击 Add data source。
2. 选择 Prometheus 类型。
3. 在 HTTP 区域填写URL：http://localhost:9090（若Prometheus在其他主机，替换为对应IP或域名）。
4. 其他选项保持默认（如Scrape interval设为15s，与Prometheus默认抓取间隔一致）。
5. 点击页面底部的 Save & Test。

方式二：通过配置文件预置（适合自动化/代码化场景）

编辑Grafana配置文件 conf/defaults.ini 或自定义配置文件 conf/custom.ini，在 [datasources] 段落中添加以下内容：

[datasources]
; 启用配置文件中定义的数据源
enabled = true

[[datasources]]
name = Prometheus
type = prometheus
url = http://localhost:9090
access = proxy
is_default = true
editable = true

修改配置后需重启Grafana服务：sudo systemctl restart grafana-server（或使用你安装方式对应的重启命令）。

验证方法与判定标准

无论采用哪种配置方式，最终验证路径相同：

1. 进入 Connections → Data sources，找到名为 Prometheus 的数据源。
2. 点击该数据源进入详情页，点击右上角 Save & Test 按钮（若已通过UI保存过，此按钮会显示为 Test）。
3. 观察返回结果：

• 通过条件：页面显示绿色提示 Successfully queried the Prometheus API.，且下方出现 “Prometheus returned a successful response” 字样。
• 数据可用性验证：在Grafana左侧菜单进入 Explore，数据源选择 Prometheus，在查询框中输入 up，点击 Run query。若返回结果中 up 指标存在且值为 1 的时间序列，说明Prometheus数据源连接正常且数据可用。

常见问题排查

• 连接超时：检查Prometheus地址是否可从Grafana主机访问（curl http://localhost:9090/api/v1/status/config），并确认防火墙规则。
• 401/403错误：若Prometheus启用了认证，需在数据源配置的 HTTP Headers 或 Auth 区域添加对应凭据。
• 数据源显示为“无法获取标签”：通常是因为Prometheus的 --web.enable-lifecycle 未开启，但Grafana基础查询不受影响；若需使用标签浏览器，需在Prometheus启动参数中添加该选项。

完成上述配置并通过测试后，即可在仪表盘面板中选用该数据源创建可视化图表。