架构师之Grafana基础入门

Grafana 基础入门教程

一、安装部署 Grafana

1. Docker 方式安装

# 拉取最新镜像
docker pull grafana/grafana

# 启动容器（映射端口 3000，数据持久化到本地）
docker run -d \
  --name=grafana \
  -p 3000:3000 \
  -v /path/to/grafana-data:/var/lib/grafana \
  grafana/grafana

• 访问地址：http://localhost:3000（默认账号：admin/admin）。
• 验证安装：登录后进入主页即表示成功。

2. 二进制包安装（Linux）

# 下载并解压
wget https://dl.grafana.com/oss/release/grafana-10.1.5.linux-amd64.tar.gz
tar -zxvf grafana-10.1.5.linux-amd64.tar.gz
cd grafana-10.1.5

# 启动服务
./bin/grafana-server web

• 访问地址：http://localhost:3000。

二、添加首个数据源（Prometheus）

1. 配置 Prometheus

确保已安装并运行 Prometheus（默认端口 9090），配置示例：

# prometheus.yml
global:
  scrape_interval: 15s
scrape_configs:
  - job_name: 'node'
    static_configs:
      - targets: ['localhost:9100']  # 假设 Node Exporter 运行在 9100 端口

2. 在 Grafana 中添加数据源

1. 登录 Grafana → 左侧菜单 Connections → Data sources → Add data source。
2. 选择 Prometheus。
3. 填写配置：
   • URL：http://localhost:9090
   • Access：Server（默认）
4. 点击 Save & test，显示绿色提示即表示连接成功。

三、创建简单时序图

1. 新建仪表盘

1. 左侧菜单 Dashboards → New → New Dashboard → Add visualization。
2. 选择数据源 Prometheus。

2. 编写查询语句

示例查询（CPU 使用率）：

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

操作步骤：

1. 在 Metric 输入框中粘贴上述 PromQL。
2. 点击 Run query 预览数据。

3. 配置图表样式

• 图表类型：右上角选择 Time series（折线图）。
• 标题设置：
  • 面板标题：CPU 使用率监控
  • Y 轴单位：percent（百分比）
• 保存面板：点击右上角 Save → 输入仪表盘名称（如 Node Monitoring）。

四、仪表盘布局调整

1. 拖拽调整面板大小与位置

• 点击面板标题 → 拖动右下角调整大小。
• 拖动面板标题栏移动位置。

2. 使用行（Rows）组织面板

1. 在仪表盘页面点击 Add → Row → 输入行名称（如 系统资源）。
2. 将相关面板拖入同一行，保持布局整洁。

3. 设置时间范围与刷新间隔

• 右上角时间选择器：
  • 默认 Last 6 hours，可自定义范围（如 2023-10-01 00:00:00 至 now）。
• 自动刷新：点击刷新图标旁的下拉菜单，选择间隔（如 5s）。

五、使用变量（Variables）实现动态过滤

1. 创建变量

1. 进入仪表盘设置 → Variables → Add variable。
2. 配置变量：
   • Name：instance
   • Label：选择实例
   • Type：Query
   • Data source：Prometheus
   • Query：label_values(node_cpu_seconds_total, instance)

2. 在查询中使用变量

修改 CPU 使用率查询，按实例过滤：

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

• 效果：仪表盘顶部出现下拉框，选择不同实例查看对应 CPU 使用率。

3. 变量高级用法

• 多选变量：勾选 Multi-value，允许同时选择多个实例。
• 默认值：在 Default value 中设置 All 或指定实例。

六、实用技巧与注意事项

1. 保存与共享仪表盘

• 保存：点击右上角 Save 按钮。
• 共享：
  • 生成链接：点击 Share → Link。
  • 导出 JSON：点击 Share → Export → 保存为 JSON 文件。

2. 常见问题排查

• 数据源连接失败：检查 Prometheus 是否运行，网络是否互通。
• 无数据展示：确认 PromQL 语法正确，时间范围包含数据点。

3. 扩展学习

• 官方文档：Grafana OSS and Enterprise | Grafana documentation
• 示例仪表盘：https://grafana.com/grafana/dashboards/（搜索 Node Exporter 导入模板）。

通过本教程，您已完成 Grafana 的基础入门操作。下一步可探索告警配置、插件安装（如地图可视化）和复杂数据源（如 MySQL）集成。