Grafana：监控面板

为什么需要 Grafana：从数据孤岛到统一观测

传统监控是割裂的：服务器指标看 Zabbix、日志查 ELK、云资源去云厂商控制台、链路追踪看 Jaeger，每个系统查询语法不同、界面不同，排障要在多个系统间来回切换，无法在一张图上对比指标与日志的因果关系。对同时负责多个服务的团队，这种割裂会直接拉长故障平均恢复时间（MTTR，即从故障发生到恢复的平均时长）。

Grafana 的解法是用统一的数据源抽象层把这些系统接入同一入口：官方与社区提供了 70+ 数据源插件，查询结果统一渲染成时间序列、柱状图、表格等面板；8.0 起内置统一告警（Unified Alerting），可以跨数据源定义规则，一处配置邮件、Slack、飞书、Webhook 等通知渠道。数据源不需要搬迁，Grafana 只负责读。

与同类工具的气质差异在于：Kibana 深度绑定 Elasticsearch，数据源单一；Datadog 是商业 SaaS 且按用量计费；Grafana 对数据源完全中立，后端只用 SQLite/PostgreSQL 存元数据，不碰业务时序数据。它聚焦「画图 + 告警」这件事本身，因此成为多数据源场景下的通用层。

安装与环境配置：3 步就绪

步骤一：安装。最快的方式是 Docker，一条命令启动；在 Debian/Ubuntu 上也可通过官方 apt 仓库安装为系统服务。

步骤二：配置。默认配置即可启动，生产环境建议通过环境变量或 grafana.ini 修改管理员初始密码（容器内对应 GF_SECURITY_ADMIN_PASSWORD）、监听地址与数据目录。

步骤三：验证。访问 /api/health 接口，返回 database: "ok" 即说明服务正常起效，随后即可用浏览器打开 Web 界面。

# 方式一：Docker（推荐，11.2.0 为当前最新正式版）docker run -d --name=grafana -p 3000:3000 \  -e GF_SECURITY_ADMIN_PASSWORD=admin123 \  grafana/grafana:11.2.0sleep 5curl http://localhost:3000/api/health# 期望输出：{"commit":"...","database":"ok","version":"11.2.0"} # 方式二：Debian/Ubuntu（apt 官方仓库）sudo apt-get install -y gnupg2 software-properties-commonsudo mkdir -p /etc/apt/keyrings/wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/nullecho "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.listsudo apt-get update && sudo apt-get install -y grafanasudo systemctl enable --now grafana-server

快速上手：5 分钟跑通第一个大盘

最小可用流程是「一个 Grafana + 一个能出数据的数据源」，不用自带采集，官方沙箱 play.grafana.org 可以直接体验。如果本机没有 Prometheus 目标可采，先用沙箱验证流程，再回来接真实数据源。

1. 按上节启动 Grafana，浏览器访问 http://localhost:3000，用 admin 与设置的密码登录（10.x 起首次登录会提示修改密码）。

2. 进入「连接 → 数据源 → 添加数据源」，类型选 Prometheus，URL 填 http://localhost:9090（指向已有的 Prometheus 服务），点击「保存并测试」。

3. 若暂时没有 Prometheus，跳过本步，打开 https://play.grafana.org 完成同样的添加数据源流程。

4. 在「仪表盘 → 新建 → 导入」中粘贴官方仪表盘 ID 1860（node_exporter 全览），加载后选择你的 Prometheus 数据源，点导入。

5. 打开大盘后，用右上角时间选择器切到「最近 15 分钟」并开启自动刷新，确认曲线上出现数据；再到「探索」页输入 PromQL 验证查询能力：rate(node_cpu_seconds_total[5m])。

出现指标曲线即说明链路通了。进阶技巧：把时间范围与主机标签做成仪表盘变量（如 instance），一个大盘即可在多个节点间动态切换；随后为该查询配置一条告警规则，就等于从「看图」升级到「被通知」。

核心能力详解：4 大支柱

支柱一：统一数据源与查询。Grafana 不存储业务时序数据，而是通过数据源插件对接外部系统，插件协议统一了连接、查询与返回格式。用户面对的是「选择数据源 → 写该数据源的原生查询」：Prometheus 写 PromQL、Loki 写 LogQL、数据库写 SQL。查询编辑器还支持变量、函数与区间宏（如 $__interval），让面板可以自适应时间范围与刷新频率。

支柱二：可视化与仪表盘。内置三十余种面板：时间序列、状态历史、仪表盘（gauge）、柱状图、热力图、日志、表格等。仪表盘支持模板变量、图层联动、注释（annotation，在曲线上标记发版/告警事件）与数据链接。权限体系分组织、团队、文件夹三级，可精确控制谁能看、谁能改、谁能导出。

支柱三：统一告警。8.0 起告警引擎内置化，支持 PromQL、SQL、log 查询等多数据源规则；一条规则会评估出多个告警实例（如「每台主机的 CPU 都独立评估」）。通知链路为：告警规则 → 通知策略（notification policy）→ 联系点（contact point），联系点可对接邮件、Slack、Webhook、飞书等渠道，并支持静默（silence）与抑制，避免故障风暴刷屏。

支柱四：配置即代码。所有资源都可通过 Provisioning（配置文件声明）或 HTTP API 管理：数据源、仪表盘、告警规则、联系点、通知策略均可写成 YAML 随代码仓库版本化，配合 Terraform Provider 做基础设施即代码（IaC）。插件管理用 grafana-cli，如 grafana-cli plugins install grafana-piechart-panel。

生产部署与监控：从上线到运维

方式一：Docker Compose 最小生产栈。Prometheus 负责采集与存储，node-exporter 暴露主机指标，Grafana 负责展示。三个容器挂载命名卷即可，适合中小团队快速落地。

方式二：Kubernetes Helm 部署。使用官方 Chart，支持 Ingress、持久卷、副本数配置，并能通过 sidecar 自动加载 ConfigMap 中的 Provisioning 文件——这是生产环境推荐路径：

方式三：高可用（HA）配置。生产环境至少 2 个副本，并满足三个条件：外部共享数据库（PostgreSQL/MySQL，不能用默认 SQLite）、共享存储（仪表盘、快照、插件写入 S3/EFS 一类存储）、多副本间开启 HA 告警协调（Alerting 在副本间自动做主备，通过 gossip 协议同步状态）。前面加负载均衡，告警通知不会重复发送。

可观测性方面，Grafana 自身暴露 /metrics（Prometheus 格式），可被 Prometheus 抓取后回画自己的面板；启用以结构化日志输出，并叠加 OpenTelemetry 支持将内部请求链路送给 Tempo。重点观察 http_request_duration_seconds 等延迟指标与 grafana_alerting_* 告警评估系列指标，防止「监控系统本身挂了」。

<p class="para-label">避坑清单：</p>

<ul class="dash-list"><li>默认账号密码或匿名访问未处理：首次登录后立即修改 admin 密码，生产环境接入企业 SSO（LDAP/OAuth2），并在「安全 → 匿名访问」中确认匿名浏览处于关闭状态。</li><li>SQLite 直接上生产：默认 SQLite 只适合单机体验，多副本或并发写面板时会锁库报 500；生产必须切换到 PostgreSQL/MySQL 作为元数据库。</li><li>升级前不备份：主版本升级会迁移元数据库，先备份 grafana.db 与配置文件，并用 grafana-cli 核对已安装插件是否兼容新版本。</li><li>告警通知渠道单一：只配一个邮箱或 Webhook，渠道故障时告警直接丢失；应为同一联系点配置多种通知方式，并用通知策略区分级别、做升级与收口。</li></ul>

# docker-compose.yml：Prometheus + node-exporter + Grafana 最小栈services:  prometheus:    image: prom/prometheus    ports: ["9090:9090"]  node-exporter:    image: prom/node-exporter  grafana:    image: grafana/grafana:11.2.0    ports: ["3000:3000"]    volumes:      - ./grafana-data:/var/lib/grafana

helm repo add grafana https://grafana.github.io/helm-chartshelm upgrade --install grafana grafana/grafana --namespace monitoring --create-namespace

版本迭代

Grafana 以约 6 周为周期快速迭代，从 2022 年的 9.x 演进到 2025 年的 11.x；官方明确了两条主线：仪表盘架构向面板化（Scenes）重构、告警引擎向统一告警收敛，同时 9.5 与 10.4 被标记为长期支持（LTS）版本，生产用户可长期固定在 LTS 上。

AI 应用场景

常见误区

面试题