macOS 下载、安装 Grafana，开源监控与可观测性平台，连接上百种数据源统一可视化（附安装包grafana-13.1.3.darwin-arm64.tar.gz）

发布于 2026/8/11 · 1 阅读

Grafana数据可视化监控告警仪表盘可观测性数据源Prometheus开源软件macOS

Grafana 是开源的监控与可观测性数据可视化平台，连接 Prometheus、Loki、MySQL 等上百种数据源，统一创建仪表盘、告警与可视化面板，是云原生时代监控体系的事实标准。

文章目录

1. Grafana 简介
2. v13.1.3 版本亮点

2.1 可观测性即代码（Git Sync 增强）
2.2 Grafana Assistant 扩展
2.3 仪表盘与可视化（正式可用）
2.4 其他改进

3. 获取安装包
4. 安装

4.1 开机自启（launchd 服务化，可选）

5. 使用

5.1 连接数据源
5.2 创建仪表盘与面板
5.3 设置告警
5.4 常用配置与运维

封面.png

1. Grafana 简介

Grafana 是一款开源的监控与可观测性（observability）数据可视化平台，由 Torkel Ödegaard 于 2013 年 12 月在其博客项目中启动，2014 年 1 月正式发布，最初源自他在 Orbitz 使用 Graphite 做指标可视化的工作积累，UI 参考了 Kibana 的早期版本。背后的公司最初叫 Raintank，后更名为 Grafana Labs（取 Graphite 与 Kibana 的组合）。如今 Grafana 已成为可观测性领域的事实标准：2022 年全球活跃实例超过 100 万，2024 年用户突破 2000 万、开源贡献者超过 2000 人，GitHub 上约 7.5 万颗星标；Grafana Labs 累计融资超 5 亿美元、2024 年估值达 60 亿美元，服务 Bloomberg、Salesforce、NASA、Wikimedia 等 5000 多家企业客户，并入选 2024 年 Gartner 可观测性平台魔力象限领导者。

Grafana 的核心设计理念是"查询、可视化、告警并理解你的指标，无论它们存储在哪里"。它本身不存储数据，而是在渲染时直接连接各类外部数据源执行查询，因此天然适合把散落在不同系统中的指标、日志、追踪数据汇聚到同一面"仪表盘"上，让团队围绕数据做决策。

Grafana 的核心特点：

丰富的可视化：快速灵活的客户端图表，面板插件提供多种可视化指标与日志的方式
动态仪表盘：用模板变量（template variables）创建动态、可复用的仪表盘，变量以仪表盘顶部下拉框呈现
探索指标与日志：通过临时查询和动态下钻探索数据，支持分屏对比不同时间范围、查询和数据源；可在保留标签过滤的前提下从指标无缝切换到日志，支持实时流式查看
可视化告警：以界面方式为关键指标定义告警规则，Grafana 持续评估并发送通知到 Slack、PagerDuty、OpsGenie 等系统
混合数据源：同一图表内按查询维度混合使用不同数据源，支持自定义数据源
生态与连接能力：支持 150 多种数据源（Prometheus、Loki、Elasticsearch、MySQL、PostgreSQL、InfluxDB、AWS CloudWatch、Graphite 等），与 Loki（日志）、Tempo（追踪）、Mimir（指标）共同构成完整的 LGTM 开源可观测性技术栈

2. v13.1.3 版本亮点

该版本汇集了 3 位贡献者 的 9 条 贡献。

Grafana v13.1 于 2026 年 6 月 23 日发布，围绕可观测性即代码、扩展 Grafana Assistant 数据源与简化仪表盘工作流三大方向。v13.1.3 发布于 2026 年 8 月 7 日，是 v13.1 系列的维护性补丁版本，主要包含缺陷修复与稳定性改进。

2.1 可观测性即代码（Git Sync 增强）

仪表盘导入已配置文件夹：从界面直接将仪表盘 JSON 导入 Git Sync 托管的文件夹，支持配置文件路径、分支、提交信息与工作流；唯一性基于路径，不同路径可存在同标题仪表盘
根级同步：仪表盘无需包含文件夹即可在根层级同步，使配置托管与非托管的仪表盘并存
README.md 渲染：Git Sync 托管的文件夹默认内联渲染 README.md，文档上下文（链接、负责人说明、runbook）随文件夹一并交付
签名提交（正式可用）：Git Sync 现支持使用 GPG、SSH 或 S/MIME 密钥签名提交，Git 提供商将其标记为已验证，满足要求签名提交的分支保护规则

2.2 Grafana Assistant 扩展

更多数据源：Assistant 现可查询 Snowflake、Jira、Dynatrace、Oracle 等共 8 个新增数据源，让用户在可观测性栈、数据库与项目管理工具之间用一个问题完成跨源查询
在 Grafana Enterprise 中预装：Assistant 现随 Enterprise 版预装、无需安装插件；OSS 用户仍可通过安装插件并连接 Grafana Cloud 账户使用

2.3 仪表盘与可视化（正式可用）

快速筛选与分组：新增 Filter 与 Group by 仪表盘控件，无需配置模板变量即可筛选与分组，支持默认过滤器、过滤历史与面板级下钻
多属性变量：一个变量映射多个值，已在 OSS 与 Enterprise 中正式可用
时序转表格转换：将时序结果转换为带趋势迷你图的表格行
注解聚类：大规模注解探索能力改进，正式可用
复制粘贴面板样式：将同一类型面板的显示选项与字段样式复制到另一面板
面板样式：为时序、统计、仪表、条形仪表与条形图面板提供精选配色、阈值与显示选项
章节级变量：将变量作用域限定到特定行或标签页，而非整个仪表盘

2.4 其他改进

时序图例中按名称或标签过滤可见序列，无需编辑查询
嵌套表格支持灵活分组规则与字段覆盖
全新查询编辑器（公开预览）：支持多选、批量操作与堆叠视图
Private Data Source Connect 新增对 MQTT、GitHub 与 IBM Db2 数据源的支持

3. 获取安装包

如果访问 GitHub 不便，安装包及中文文档：https://hanshuixin.org/go/225K（内含 grafana-13.1.3.darwin-arm64.tar.gz、README 中英对照、发布说明中英对照和 LICENSE）。

适用于 macOS arm64（Apple Silicon，M 系列芯片）。

Grafana 其他版本：https://hanshuixin.org/resource/software_integrated_package/macOS/Grafana

macOS安装grafana-v13.1.3（grafana-13.1.3.darwin-arm64）.zip
├── grafana-13.1.3.darwin-arm64.tar.gz   ← 解压后运行
├── macOS安装grafana-v13.1.3（grafana-13.1.3.darwin-arm64）.pdf
├── 源码/
│   └── grafana-v13.1.3源码.zip        ← AGPL-3.0 源码包（grafana v13.1.3 完整源码）
├── README/
│   ├── README.md
│   └── README-中文版.md
├── 发布说明/
│   ├── RELEASE-NOTES.md
│   └── RELEASE-NOTES-中文版.md
└── LICENSE

4. 安装

grafana-13.1.3.darwin-arm64.tar.gz 是 Grafana 官方发布的 macOS arm64 预编译二进制包，解压即可运行：

# 解压二进制包（得到 grafana-13.1.3/ 目录）
tar -xzf grafana-13.1.3.darwin-arm64.tar.gz

# 进入解压目录
cd grafana-13.1.3

# 启动 Grafana 服务
./bin/grafana server

启动后访问 http://localhost:3000 打开 Grafana Web 界面，首次登录使用默认账号密码 admin / admin，系统会提示修改密码。如需停止服务，在终端按 Ctrl+C 即可。

4.1 开机自启（launchd 服务化，可选）

macOS 中可将 Grafana 托管为 launchd 启动项，实现登录后自启与崩溃自动拉起。先部署到统一目录：

# 部署二进制到统一目录
sudo mkdir -p /usr/local/grafana
sudo cp -r grafana-13.1.3 /usr/local/grafana/

创建 plist 文件 ~/Library/LaunchAgents/com.grafana.plist（用户级，登录后自启；如需开机即启动、不依赖登录，则放到 /Library/LaunchDaemons/）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.grafana</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/grafana/grafana-13.1.3/bin/grafana</string>
        <string>server</string>
        <string>--homepath=/usr/local/grafana/grafana-13.1.3</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/usr/local/grafana/grafana.log</string>
    <key>StandardErrorPath</key>
    <string>/usr/local/grafana/grafana.err.log</string>
</dict>
</plist>

加载并启动服务：

# 加载 launchd 服务并启动
launchctl load ~/Library/LaunchAgents/com.grafana.plist

# 启动 / 停止 / 查看状态
launchctl start com.grafana
launchctl stop com.grafana
launchctl list | grep grafana

5. 使用

5.1 连接数据源

Grafana 本身不存储数据，需要先连接数据源。登录后在左侧菜单进入"Connections > Data sources"点击 "Add data source"，选择类型并填写连接信息。以最常用的 Prometheus 为例：

URL 填 Prometheus 服务地址，如 http://localhost:9090
点击 "Save & Test" 验证连通性

常见数据源一览：

数据源	用途	连接参数示例
Prometheus	指标（metrics）	URL: `http://localhost:9090`
Loki	日志（logs）	URL: `http://localhost:3100`
MySQL	关系数据库	Host、Database、User、Password
PostgreSQL	关系数据库	Host、Database、User、Password
InfluxDB	时序数据库	URL、Token、Org、Bucket

5.2 创建仪表盘与面板

连接数据源后即可创建仪表盘：

左侧菜单进入 "Dashboards"，点击 "New > New Dashboard" 新建仪表盘
点击 "Add visualization" 添加面板，选择数据源并编写查询（如 PromQL：rate(http_requests_total[5m])）
右侧面板选项中选择可视化类型（时序图、统计、仪表、条形图等）
返回仪表盘，点击右上角保存；可为仪表盘添加模板变量，让同一个仪表盘通过顶部下拉框在不同环境、服务间切换

面板数据来源多样化：除查询外，还可以为同一面板混合多个查询、切换混合数据源，构建复合视图。

5.3 设置告警

Grafana 的可视化告警在界面即可完成配置：

在面板编辑中切换到 "Alert" 标签页，点击 "Create alert rule" 新建告警规则
基于面板查询定义阈值条件，例如 CPU 使用率超过 90%：
```
avg(rate(node_cpu_seconds_total{mode="idle"}[5m])) < 0.1
```
设置评估间隔与"for"持续时间，避免瞬时抖动误报
配置通知渠道（Contact points）：进入 "Alerting > Contact points" 添加 Slack、Webhook、邮件、钉钉等渠道
在 "Alerting > Notification policies" 设置通知路由规则，让不同告警分发到不同渠道

告警触发后，Grafana 会按通知策略将告警推送到对应渠道，形成完整的告警闭环。

5.4 常用配置与运维

Grafana 的配置文件为解压目录下的 conf/defaults.ini（默认值，勿直接修改），自定义配置请复制为 conf/custom.ini 后修改，或用环境变量覆盖（格式 GF_<SECTION>_<KEY>）：

# 修改 HTTP 端口为 8080
GF_SERVER_HTTP_PORT=8080 ./bin/grafana server

# 修改数据目录
GF_PATHS_DATA=/data/grafana ./bin/grafana server

常用运维操作：

# 查看版本
./bin/grafana --version

# 安装插件（如官方时钟面板插件）
./bin/grafana cli plugins install grafana-clock-panel

# 列出已安装插件
./bin/grafana cli plugins ls

Grafana 的配置与资源采用 provisioning（预置配置）机制，把数据源、仪表盘、告警规则等以 YAML 文件形式放到 conf/provisioning/ 目录下，随配置即代码（Git Sync）自动同步，适合团队统一管理。数据目录默认位于解压目录下的 data/，包含内置 SQLite 数据库（grafana.db）、插件与会话数据，备份时注意保留该目录。