连接 Prometheus 数据源

本节将学习：添加 Prometheus 数据源、测试连接、以及配置认证。这是使用 Grafana 的第一步。

添加 Prometheus 数据源

添加 Prometheus 数据源的步骤是什么？

第一步：登录 Grafana。 访问 http://localhost:3000，登录 Grafana。

第二步：进入 Configuration > Data Sources。 点击左侧菜单的 Configuration，然后选择 Data Sources。

第三步：点击 Add data source。 点击右上角的 Add data source 按钮。

第四步：选择 Prometheus。 在数据源列表中选择 Prometheus。Prometheus 是 Grafana 默认支持的数据源。

第五步：配置连接信息。 配置数据源的连接信息。

配置项说明：

• Name： Prometheus。这是数据源的名称，可以在 Dashboard 中选择。
• URL： http://localhost:9090。这是 Prometheus 的地址，如果你的 Prometheus 在其他地方，修改这个地址。
• Access： Proxy。这是访问方式，Proxy 表示通过 Grafana 代理访问。也可以选择 Direct，表示直接访问。
• Auth： 根据需要配置认证。如果你的 Prometheus 需要认证，可以在这里配置。

第六步：保存配置。 点击 Save & Test，保存并测试连接。

连接架构： Grafana 通过 HTTP 连接到 Prometheus。Grafana 从 Prometheus 获取数据，然后在 Dashboard 中展示。

这就是添加 Prometheus 数据源的过程。

测试连接

测试连接的步骤是什么？

第一步：配置完成后，点击 Save & Test。 在数据源配置页面，点击 Save & Test 按钮。Grafana 会保存配置并测试连接。

第二步：Grafana 会自动测试连接。 Grafana 会向 Prometheus 发送测试请求，检查连接是否正常。

第三步：查看测试结果。 查看测试结果。

测试结果：

✅ 成功： 显示 "Data source is working"。这说明连接正常，可以使用了。

❌ 失败： 显示错误信息。根据错误信息，我们可以知道问题在哪里。

常见错误：

• Connection refused： Prometheus 未运行或地址错误。检查 Prometheus 是否运行，地址是否正确。
• Timeout： 网络问题或 Prometheus 响应慢。检查网络连接，或者增加超时时间。
• Authentication failed： 认证信息错误。检查认证配置。

测试查询： 在 Explore 中测试查询。

• 查询

  up

  。这会返回所有目标的状态。
• 或者在 Dashboard 中测试查询。选择一个时间范围，例如 Last 5 minutes。

这就是测试连接的过程。确保连接正常，才能正常使用。

配置认证

Grafana 支持哪些认证方式呢？

第一种方式：Basic Auth（基本认证）。 用户名和密码，适合简单的认证需求。

配置 Basic Auth：

Auth:
✅ Enable basic auth
Username: prometheus
Password: secret

这个配置展示了如何配置基本认证。启用基本认证，输入用户名和密码。

第二种方式：Bearer Token（令牌认证）。 使用令牌认证，适合 API 认证。

配置 Bearer Token：

Auth:
✅ Enable bearer token
Token: your-token-here

这个配置展示了如何配置令牌认证。启用令牌认证，输入令牌。

第三种方式：TLS/SSL（证书认证）。 使用证书认证，适合安全要求高的场景。

配置 TLS/SSL：

TLS/SSL:
✅ Enable TLS Client Auth
TLS Client Certificate: /path/to/cert.pem
TLS Client Key: /path/to/key.pem
TLS CA Certificate: /path/to/ca.pem

这个配置展示了如何配置证书认证。启用 TLS 客户端认证，配置证书、密钥、CA 证书。

选择认证方式： 根据你的安全需求选择认证方式。如果你的 Prometheus 在内部网络，可能不需要认证。如果在公网，建议使用认证。

这就是配置认证的方法。根据需求选择适合的认证方式。

本节小结

在本节中，我们学习了连接 Prometheus 数据源：

第一个是添加数据源。 Configuration > Data Sources > Add data source。选择 Prometheus，配置连接信息。

第二个是配置连接。 Name、URL、Access。这些是基本的连接配置。

第三个是测试连接。 Save & Test 按钮。确保连接正常，才能正常使用。

第四个是配置认证。 Basic Auth、Bearer Token、TLS/SSL。根据需求选择适合的认证方式。

连接流程： 登录 Grafana → 添加数据源 → 配置连接 → 测试连接 → 配置认证 → 保存配置。

这就是连接 Prometheus 数据源的过程。连接成功后，你就可以在 Grafana 中使用 Prometheus 数据了。

在下一节，我们将学习 Grafana 界面导航。学习 Dashboard、Explore、Alerting 的使用。