文章目录
1. Grafana 简介
Grafana 是一款开源的监控与可观测性（observability）平台，2013 年 12 月由瑞典开发者 Torkel Ödegaard 作为个人业余项目创建——起因是对 Graphite 的界面不满意，希望做出更强大的时间序列指标可视化工具。2014 年，Raj Dutt 与 Anthony Woods 邀请 Ödegaard 共同创立 Grafana Labs（最初名为 raintank），此后项目迅速发展。如今 Grafana 在 GitHub 上已拥有约 7.6 万颗星标、1.4 万余次 Fork，全球用户超过 3500 万，是云原生观测领域当之无愧的事实标准。
Grafana 要解决的核心问题，是让分散在多套系统中的指标、日志和追踪数据能在同一个界面里统一查看与联动：无论是 Prometheus、Graphite、InfluxDB 等时序数据库，Loki、Elasticsearch 等日志系统，还是 MySQL、PostgreSQL 等关系型数据库，都能作为数据源接入，并通过灵活的仪表盘把数据可视化、配上告警，真正做到"一屏观测整个技术栈"。
Grafana 的核心特点：
- 海量数据源：支持 170+ 种数据源（如 Prometheus、Loki、Tempo、Mimir、Elasticsearch、CloudWatch、MySQL、PostgreSQL 等）和 120 种可视化面板
- 灵活仪表盘：模板变量（template variables）以下拉框形式出现，可构建动态、可复用的仪表盘
- 指标与日志联动：从指标一键切换到日志并保留标签过滤条件，支持日志实时流式查看
- 原生告警：可视化定义告警规则，持续评估并推送到 Slack、钉钉、PagerDuty 等渠道
- 插件生态
- 三种版本：免费开源的 OSS、商业订阅的 Enterprise、托管服务的 Grafana Cloud
2. v13.1.3 版本亮点
Grafana 13.1 于 2026 年 6 月发布，主打"用更少的配置搭建仪表盘、更安全地连接数据、在同一处获得整个技术栈的答案"，v13.1.3 是 13.1 系列的维护补丁版本，于 2026 年 8 月发布。
Git Sync 增强
- 从界面导入仪表盘（正式发布）：可直接把仪表盘 JSON 导入 Git Sync 预置的文件夹，走完预置导入流程后仪表盘会作为导入的一部分提交回仓库
- 根级同步（正式发布）：支持把仓库同步到 Grafana 实例的顶层，不再必须挂在某个父文件夹下
- README 展示（公开预览）：仓库中仪表盘旁的 README.md 会直接渲染在文件夹的仪表盘列表下方
- 签名提交（正式发布）：Git Sync 使用你的签名密钥自动为每次提交签名（支持 GPG、SSH、S/MIME），Git 提供商会标记为 Verified
仪表盘与可视化
- 快速过滤与数据分组（正式发布）：新的 Filter and Group by 控件把过滤与分组融为一体，无需配置模板变量即可快速探索数据
- 复制粘贴面板样式（正式发布）：从某个面板复制显示选项和字段样式，粘贴到同类型面板，无需手动重新配置
- 面板样式（正式发布）：一键把精心搭配的颜色、阈值和显示选项应用到时序、统计、仪表、柱状仪表等面板
- 章节级变量 / 多属性变量（正式发布）：变量可限定到其所属的行与标签页；一个变量可映射到多个值
- 时序转表格、注解聚类、序列可见性
- 新版查询编辑器（公开预览）：支持多选批量操作与堆叠视图，处理复杂面板更快
- 嵌套表格升级（公开预览）：重新设计了分组到嵌套表格转换的编辑器，支持嵌套子表字段覆盖
Grafana Assistant
- 随 Enterprise 预装（公开预览）：从 13.1 起 Grafana Assistant 在 Grafana Enterprise 中预装，无需安装插件
- 可直接查询 8 个新数据源：Snowflake、MongoDB、Oracle、Elasticsearch、Dynatrace、Honeycomb、Zabbix、Jira，可在同一段对话中跨数据库与观测数据提问
数据源与连接
- PDC 新增三个数据源：私有数据源连接（Private Data Source Connect，PDC）新增对 MQTT、GitHub、IBM Db2 的支持，可在私有网络与 Grafana Cloud 之间建立加密隧道
3. 获取安装包
如果访问 GitHub 不便，安装包及中文文档：https://hanshuixin.org/go/225J（内含 grafana-13.1.3.linux-amd64.tar.gz、README 中英对照、发布说明中英对照、LICENSE 和源码包）。
适用于 Linux x86_64（amd64）。
Grafana 其他版本：https://hanshuixin.org/resource/software_integrated_package/Linux/Grafana
Linux安装grafana-v13.1.3（grafana-13.1.3.linux-amd64）.zip├── grafana-13.1.3.linux-amd64.tar.gz ← 解压后运行├── Linux安装grafana-v13.1.3（grafana-13.1.3.linux-amd64）.pdf├── README/│ ├── README.md│ └── README-中文版.md├── 发布说明/│ ├── RELEASE-NOTES.md│ └── RELEASE-NOTES-中文版.md├── 源码/│ └── grafana-v13.1.3-源码.zip└── LICENSE
4. 安装
grafana-13.1.3.linux-amd64.tar.gz 是 Grafana 官方发布的 Linux x86_64 预编译二进制包，不绑定特定发行版，解压即可运行：
# 解压二进制包tar -xzf grafana-13.1.3.linux-amd64.tar.gz# 进入解压目录（内含 bin、conf 等目录）cd grafana-13.1.3# 启动 Grafana 服务（默认端口 3000）sudo ./bin/grafana server
启动后浏览器访问 http://localhost:3000 ，使用默认账号 admin / admin 登录，首次登录会提示修改密码。
4.1 生产环境配置（systemd 服务化）
生产环境建议将 Grafana 部署到统一目录，并以 systemd 服务托管，便于开机自启与统一管理：
# 将二进制部署到统一目录sudo mkdir -p /opt/grafanasudo cp -r grafana-13.1.3/* /opt/grafana/# 创建专用用户（无登录权限）并授权sudo useradd --system --no-create-home --shell /sbin/nologin grafanasudo chown -R grafana:grafana /opt/grafana
创建服务文件 /etc/systemd/system/grafana.service：
[Unit]Description=Grafana ServerAfter=network.target[Service]Type=simpleUser=grafanaGroup=grafanaExecStart=/opt/grafana/bin/grafana server --homepath=/opt/grafanaRestart=on-failureRestartSec=5[Install]WantedBy=multi-user.target
# 开机自启并启动sudo systemctl enable grafanasudo systemctl start grafana# 查看状态sudo systemctl status grafana
5. 使用
5.1 配置数据源
Grafana 通过"连接（Connections）→ 数据源（Data sources）“页面添加数据源。在界面中点"Add data source”，选择类型后填入连接信息即可。最常用的组合是：
- Prometheus：填入 URL（如
http://localhost:9090）即可采集指标 - Loki：填入日志服务地址，与 Prometheus 联动实现指标→日志跳转
- MySQL / PostgreSQL
也可以通过配置文件 conf/defaults.ini 或 provisioning 方式在启动时批量预置数据源，适合代码化交付。数据源添加后，即可在仪表盘和 Explore 面板中按数据源查询。
5.2 查询与探索数据
顶部"探索（Explore）"入口用于即席查询与对比：
指标查询（PromQL）：例如查看 5 分钟内某服务的请求速率
rate(http_requests_total{job="api"}[5m])
日志查询（LogQL）：例如按标签筛选并统计错误日志
支持分屏（Split）模式，并排比较不同时间范围、查询和数据源
5.3 创建仪表盘
在"仪表盘（Dashboards）"页面新建仪表盘并添加面板：
- 可视化类型：时序图（Time series）、统计（Stat）、仪表（Gauge）、表格（Table）、柱状图（Bar chart）等
- 模板变量：在仪表盘设置中定义变量（如
$instance、$env），会以顶部下拉框形式呈现，切换时全盘联动刷新 - 面板样式：一键应用配色、阈值与显示选项，快速统一仪表盘观感
- 仪表盘支持 JSON 导入导出，便于版本管理与团队共享
5.4 配置告警
在面板编辑中进入"告警（Alert）"页签即可可视化定义告警规则：
- 编写阈值表达式并设置评估周期（如每 1 分钟评估一次）
- 配置联系点（Contact point）：支持邮箱、Slack、钉钉、Webhook、企业微信等
- 定义通知策略（Notification policy）：按标签分组、路由与静默
- 告警触发后可关联 Playbook、查看历史状态，形成完整告警闭环
5.5 常用配置与监控
关键配置文件为 conf/defaults.ini 与 conf/custom.ini，常用配置项：
| | |
|---|
server.http_port | | 3000 |
server.root_url | | http://localhost:3000 |
security.admin_user | | admin |
auth.anonymous.enabled | | false |
alerting.enabled | | true |
修改配置后重启服务生效。Grafana 自身的运行状态可通过"管理（Administration）→ 状态（Stats）"页面查看，也可将其自身指标接入 Prometheus 做进一步监控。
