Grafana 仪表盘

LinuxBeginner
立即练习

介绍

在本实验中,你将学习使用 Grafana 创建监控仪表盘的基础知识。Grafana 是一个流行的开源监控和可观测性平台,无论指标存储在何处,它都能让你对其进行查询、可视化、告警和探索。

你将使用已准备的配置文件启动一个监控栈,其中包括:

  • Grafana:用于构建仪表盘的可视化工具。
  • Prometheus:作为 Grafana 数据源的时序数据库。
  • Node Exporter:一个代理程序,用于从宿主机收集硬件和操作系统指标,并将其暴露给 Prometheus 进行抓取。

你的目标是从零开始构建一个简单的仪表盘,用于实时显示实验环境的 CPU 使用率。

启动并了解监控栈

在此步骤中,你将启动 Grafana、Prometheus 和 Node Exporter。Node Exporter 暴露系统指标,Prometheus 收集指标,Grafana 显示指标。配置文件和数据源预配文件已为你准备好。

cd /home/labex/project

每个固定标签都指定了本实验使用的版本。下载可能需要几分钟。请等待每条命令返回提示符。如果拉取失败,重新执行同一条拉取命令;Docker 会复用已完成的镜像层。下载未完成时不要继续。

docker pull prom/prometheus:v3.3.0
docker pull prom/node-exporter:v1.9.1
docker pull grafana/grafana:11.6.0

docker network create 创建一个允许容器按名称互相解析的网络。docker run -d 在后台启动容器;--name 指定名称,--network 加入网络,-p 将主机端口映射到容器端口。-v 挂载已准备的配置文件;:ro 后缀使挂载只读。

docker network create monitoring-net
docker run -d --name node-exporter --network monitoring-net -p 9100:9100 prom/node-exporter:v1.9.1
docker run -d --name prometheus --network monitoring-net -p 9090:9090 -v /home/labex/project/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro prom/prometheus:v3.3.0
docker run -d --name grafana --network monitoring-net -p 8080:3000 -v /home/labex/project/grafana/provisioning:/etc/grafana/provisioning:ro grafana/grafana:11.6.0

这些 curl 选项会报告 HTTP 失败,并对暂时的启动错误最多重试 30 次,每次间隔两秒。容器运行后可能仍在初始化,因此必须等待健康检查成功再继续。

curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:9090/-/ready
curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:8080/api/health

Prometheus 应报告服务已就绪,Grafana 应返回 "database": "ok"。使用以下命令检查容器:

docker ps

三个指定名称的容器都应为 Up。选择实验的 Grafana 标签页。如果内嵌登录被阻止,使用其在浏览器中打开控件打开新的浏览器标签页。使用用户名 admin 和密码 admin 登录,然后在修改密码页面点击 Skip。这些凭据仅用于本次临时实验。

打开 Connections → Data sources,确认存在 Prometheus。其预配文件通过共享 Docker 网络连接到 http://prometheus:9090。保持监控栈运行,让 Prometheus 在你编写 CPU 查询之前收集多个样本。

在 Grafana 中创建新仪表盘

在此步骤中,你将创建一个空仪表盘并添加首个可视化面板。仪表盘将多个面板按网格排列,每个面板展示一个数据查询的结果。

在左侧栏打开 Dashboards,点击 New 并选择 New dashboard。

在空仪表盘中点击 Add visualization,然后在数据源选择器中选择 Prometheus。这会告诉新面板应该将查询发送到哪里。

你现在应该看到面板编辑器,包括可视化预览、查询编辑器和显示选项。下一步将输入 CPU 查询。

添加带有 CPU 使用率 PromQL 查询的面板

在这一步中,你将向仪表盘添加一个面板,并使用 PromQL(Prometheus 查询语言)查询来获取 CPU 使用率数据。

你应该已经处于上一步的面板编辑器中。

在编辑器底部,你会找到查询部分。Prometheus 数据源应该已经默认选中。 将查询编辑器切换到 Code,然后输入以下 PromQL 查询。你可以直接复制粘贴。

100 - (avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

让我们解析一下这个查询:

  • node_cpu_seconds_total{mode="idle"}:这是来自 Node Exporter 的一个指标,用于统计 CPU 处于“空闲”状态的总秒数。
  • rate(...[5m]):此函数计算过去 5 分钟内空闲时间每秒的平均增长率。结果是一个 0 到 1 之间的值,代表 CPU 空闲时间的比例。
  • avg by (instance):这会对结果进行聚合,如果你有多个 CPU 或机器,这非常有用。
  • * 100:这会将小数转换为百分比(例如,0.95 变为 95%)。
  • 100 - ...:最后,我们用 100 减去空闲百分比,得到活跃的 CPU 使用率百分比。

点击 Run queries。计算 rate 至少需要两次抓取;如果监控栈刚启动,请等待约 30 秒后再次运行查询。顶部预览区域应显示 CPU 使用率随时间变化的图表。

你的面板现在已经显示数据了,但可以通过更好的标签和格式进行优化,你将在下一步中完成这些操作。

自定义并保存仪表盘

在此步骤中,你将为 CPU 面板添加标题,将数值格式设为百分比,并保存仪表盘。清晰的标签能让结果更容易理解。

在右侧 Panel options 中,将 Title 准确设置为 CPU Usage %。

在 Standard options 下打开 Unit,搜索 percent,选择 **Misc / Percent (0-100)**。查询已返回 0 到 100 之间的数值,因此此单位只添加百分号,不会重新缩放数值。

点击 Back to dashboard,保留面板并返回仪表盘。此时仪表盘尚未永久保存。

点击 Save dashboard。在保存对话框中输入准确的标题 My System Dashboard,然后点击 Save。实验使用此标题查找你保存的仪表盘。

确认保存的仪表盘包含 CPU Usage % 面板,并显示 CPU 图表和百分比单位。

总结

在本实验中,你成功地从零开始构建了 Grafana 仪表盘。你先使用准备好的配置文件启动监控栈,然后练习了以下操作:

  • 探索了由 Grafana、Prometheus 和 Node Exporter 容器组成的环境。
  • 导航 Grafana UI 以创建一个新的空白仪表盘。
  • 添加了一个可视化面板,并编写了 PromQL 查询以从 Prometheus 数据源获取 CPU 使用率数据。
  • 自定义了面板标题和单位格式,以提高可读性。
  • 保存了完成的仪表盘以供将来使用。

你现在已经掌握了在 Grafana 中创建可视化的基本工作流程。你可以在此基础上,通过向仪表盘添加更多面板来监控其他系统指标,如内存使用率、磁盘 I/O 或网络流量。