📚 课程目录第2章 Grafana安装与部署

Grafana仪表盘数据报表模板与Python数据分析实践 - 第2节

2.1 Grafana 安装方式对比

Grafana 支持多种安装方式，适用于不同的操作系统和环境需求。选择哪种方式取决于你的运维习惯、网络环境以及对版本控制的要求。以下是三种主流安装方式的对比：

安装方式	适用场景	优点	缺点
Docker	容器化环境、微服务架构、快速测试	环境隔离、启动快、版本切换方便	需先安装 Docker，对宿主机资源有额外开销
二进制包	Linux 服务器、离线环境、自定义安装路径	无依赖、直接运行、便于集成到自动化脚本	手动管理升级和配置文件
包管理器	Debian/Ubuntu、CentOS/RHEL 等主流发行版	自动处理依赖、方便更新、符合系统标准	仓库版本可能滞后，需添加官方源

推荐策略： 个人学习或快速原型推荐使用 Docker 方式；生产环境建议使用包管理器或二进制包，便于与配置管理工具（如 Ansible、Puppet）集成。

2.1.1 Docker 安装（推荐）

Docker 是最简洁的安装方式，一条命令即可启动 Grafana 容器。确保宿主机已安装 Docker Engine。

# 拉取并启动 Grafana 容器
docker run -d \
  --name=grafana \
  -p 3000:3000 \
  -v grafana-storage:/var/lib/grafana \
  grafana/grafana:latest

参数说明：

-d：后台运行容器
--name=grafana：指定容器名称
-p 3000:3000：将宿主机 3000 端口映射到容器 3000 端口
-v grafana-storage:/var/lib/grafana：持久化数据卷，防止容器删除后配置丢失

  验证安装： 执行 docker ps 查看容器状态，若显示 Up 状态则启动成功。访问 http://localhost:3000 即可看到登录页面。

2.1.2 二进制包安装

适用于 Linux 系统，无需包管理器。以下以 Linux AMD64 为例：

# 下载最新稳定版
wget https://dl.grafana.com/oss/release/grafana-10.4.2.linux-amd64.tar.gz

# 解压
tar -zxvf grafana-10.4.2.linux-amd64.tar.gz

# 进入目录并启动
cd grafana-10.4.2
./bin/grafana server

二进制包默认使用 conf/defaults.ini 作为配置文件，可通过 --config 参数指定自定义配置。

2.1.3 包管理器安装（APT/YUM）

以 Ubuntu/Debian 系统为例，需先添加 Grafana 官方 APT 仓库：

# 安装依赖
sudo apt-get install -y software-properties-common wget

# 添加 Grafana GPG 密钥
wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -

# 添加稳定版仓库
sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"

# 更新并安装
sudo apt-get update
sudo apt-get install grafana

# 启动服务
sudo systemctl daemon-reload
sudo systemctl start grafana-server
sudo systemctl enable grafana-server

CentOS/RHEL 系统使用 YUM 仓库，步骤类似，只需将仓库地址替换为 https://packages.grafana.com/oss/rpm。

2.2 初次启动与登录

无论使用哪种安装方式，Grafana 默认监听 3000 端口。启动成功后，打开浏览器访问 http://<服务器IP>:3000。

2.2.1 默认登录凭据

字段	默认值
用户名	`admin`
密码	`admin`

首次登录后，系统会强制要求修改密码。建议设置强密码并妥善保管。

安全提示： 生产环境中务必修改默认密码，并考虑配置 LDAP、OAuth 等外部认证方式。避免将 3000 端口直接暴露在公网。

2.2.2 登录流程 SVG 图

下图展示了从浏览器访问到进入 Grafana 主界面的完整流程：

2.3 基本界面导航

成功登录后，你将进入 Grafana 主界面。左侧边栏是核心导航区域，包含以下主要功能模块：

2.3.1 左侧导航菜单

图标/菜单项	功能说明	常用操作
搜索（🔍）	全局搜索仪表盘、面板、数据源	快速定位已有资源
仪表盘	管理所有仪表盘，创建、编辑、导入/导出	新建仪表盘、管理文件夹
数据源	配置和管理数据源连接（Prometheus、MySQL、InfluxDB 等）	添加数据源、测试连接
告警	配置告警规则、查看告警历史	创建告警、设置通知渠道
配置	系统设置、用户管理、s、插件管理	修改默认设置、创建
管理	组织管理、用户权限、团队管理	添加用户、分配权限

2.3.2 界面布局 SVG 图

下图展示了 Grafana 主界面的核心布局结构：

2.3.3 核心操作步骤

完成安装和登录后，建议按以下顺序熟悉界面：

添加数据源： 点击左侧 数据源 → 添加数据源，选择你使用的数据库类型（如 Prometheus、MySQL、InfluxDB），填写连接信息并点击 保存 & 测试。
创建仪表盘： 点击左侧 仪表盘 → 新建仪表盘 → 添加面板，在面板编辑器中编写查询语句并选择可视化类型（折线图、柱状图、表格等）。
导入模板： 点击左侧 仪表盘 → 导入，输入 Grafana 官方模板 ID（如 1860 用于 Node Exporter），或上传 JSON 模板文件。
设置告警： 在面板编辑中切换到告警选项卡，配置触发条件和通知渠道（邮件、Slack、Webhook 等）。

新手建议： 初次使用可先导入官方模板库中的示例仪表盘，观察数据源配置和面板写法，再逐步尝试自定义创建。Grafana 官方社区提供了大量高质量的仪表盘模板，覆盖系统监控、业务指标、日志分析等场景。

2.4 安装与部署常见问题

问题	可能原因	解决方案
Docker 容器启动后无法访问	端口映射错误或防火墙未放行	检查 `docker ps` 确认端口映射；检查宿主机防火墙规则
包管理器安装后服务未启动	未执行 `systemctl start`	执行 `sudo systemctl start grafana-server` 并设置开机自启
登录提示“Invalid credentials”	密码错误或数据库损坏	重置密码：`grafana-cli admin reset-admin-password <新密码>`
数据源测试连接失败	网络不通、认证信息错误、数据库未启动	检查数据源地址、端口、用户名密码；确保数据库服务正常运行

数据持久化： 使用 Docker 部署时务必挂载数据卷，否则容器删除后所有配置、仪表盘、数据源信息将丢失。生产环境建议同时备份 /var/lib/grafana 目录。