用 Helm 在 Kubernetes 上部署 Grafana

Helm 部署 Grafana 到 K8s:grafana chart 安装、持久化配置、数据源与仪表盘的 provisioning、Ingress 暴露与安全注意事项。

最佳实践
Prometheus 指标与仪表盘可视化示意

Grafana 是 Prometheus 数据可视化的标准搭档。用 Helm 在 K8s 上部署时,持久化和数据源预置解决的是不同问题:持久化让 Grafana 自己的数据库跨 Pod 重建保留,预置让数据源和仪表盘能从版本化配置重新加载。Grafana Pod 的重建不影响 Prometheus 存储的指标。

快速安装

独立安装使用 Grafana 社区 chart 仓库。下面固定 chart 14.4.0(Grafana 13.3.0,chart 要求 Kubernetes 1.25 及以上的 1.x 版本)。这一步用于临时验证,需要保留数据的环境直接使用下一节的配置。

helm repo add grafana-community https://grafana-community.github.io/helm-charts
helm repo update grafana-community

helm upgrade --install grafana grafana-community/grafana \
  --version 14.4.0 --namespace monitoring --create-namespace

获取初始管理员密码:

kubectl -n monitoring get secret grafana \
  -o jsonpath='{.data.admin-password}' | base64 -d; printf '\n'

本地验证:

kubectl -n monitoring port-forward svc/grafana 3000:80

浏览器打开 http://localhost:3000,用 admin 和上面取到的初始密码登录。已有数据库时,当前管理员密码可能已经改过。

生产配置:values.yaml

先在 monitoring 创建 grafana-bootstrap Secret,提供 admin-user 和 admin-password 两个键,避免把密码写进 Helm values。这里以单副本、默认 SQLite 和一个 PVC 为例。集群需要可用的持久存储,升级采用 Recreate,旧 Pod 停止后再启动新 Pod,这段时间会有短暂中断。

replicas: 1
deploymentStrategy:
  type: Recreate
persistence:
  enabled: true
  size: 10Gi
admin:
  existingSecret: grafana-bootstrap
  userKey: admin-user
  passwordKey: admin-password
datasources:
  datasources.yaml:
    apiVersion: 1
    datasources:
      - name: Prometheus
        uid: prometheus
        type: prometheus
        access: proxy
        url: http://prometheus-server.monitoring.svc:80
        isDefault: true
dashboardProviders:
  dashboardproviders.yaml:
    apiVersion: 1
    providers:
      - name: default
        orgId: 1
        type: file
        options:
          path: /var/lib/grafana/dashboards/default
dashboards:
  default:
    node-exporter:
      gnetId: 1860
      revision: 46
      curlOptions: "-sSLf"

prometheus-server.monitoring.svc:80 对应在 monitoring 命名空间以 prometheus 为 release 名的独立 Prometheus chart示例。先用 kubectl -n monitoring get svc 核对实际 Service、端口及命名空间。这里的 URL 由 Grafana 服务端访问。

Node Exporter Full 固定在修订版 46。chart 会在 Pod 初始化时下载 JSON,集群需要能访问下载地址。面板中选用 Prometheus 数据源,该 Prometheus 还要已经抓到 node_exporter 指标。若无外网,移除 gnetId 下载项,改用已审阅的 JSON 和 ConfigMap 提供文件。

helm upgrade --install grafana grafana-community/grafana \
  --version 14.4.0 --namespace monitoring --create-namespace \
  -f values.yaml
kubectl -n monitoring get pvc,svc

检查 PVC 是否为 Bound;进入 Grafana 的 Explore,选择 Prometheus 后执行 up。能看到其他目标不代表 node_exporter 已经接通,可再查 node_uname_info。若已有临时实例,切换到 PVC 前先导出或备份现有数据,挂载新 PVC 不会自动迁移原数据。

对外暴露:Ingress

将下面保存为 ingress.yaml,与上一节 values.yaml 一起应用,在同一条 Helm 命令上追加 -f ingress.yaml。将 private-web 替换为实际 IngressClass。域名要指向对应控制器,TLS Secret 要位于同一命名空间并覆盖该域名。

ingress:
  enabled: true
  ingressClassName: private-web
  hosts: [grafana.example.com]
  tls:
    - secretName: grafana-tls
      hosts: [grafana.example.com]
grafana.ini:
  server:
    root_url: https://grafana.example.com/

安全提醒:用户能访问的数据取决于 Grafana 与数据源的权限配置,其中可能包含内部拓扑信息。启用认证、HTTPS,按需要限制访问来源。port-forward 适合本地调试。

与 kube-prometheus-stack 的关系

如果你装了 kube-prometheus-stack,先检查 grafana.enabled。启用时由 stack 管理 Grafana,不用再装独立 chart,在 stack 的 values 里定制 grafana: 段落即可:

grafana:
  enabled: true
  deploymentStrategy:
    type: Recreate
  persistence:
    enabled: true
  admin:
    existingSecret: grafana-bootstrap
    userKey: admin-user
    passwordKey: admin-password

子 chart 版本跟随 stack 的依赖定义。上面的配置依然只针对单副本 SQLite;多副本应按 Grafana 高可用文档配置共享 PostgreSQL 或 MySQL,并单独检查告警高可用。

常见问题(FAQ)

Q:Pod 重建后我的仪表盘全没了?

A:先看仪表盘来自数据库还是预置文件。默认未启用持久化时,Grafana 数据目录使用临时卷,在旧 Pod 被替换后,数据库里的自建仪表盘可能丢失。预置文件还在的话,仪表盘可在启动时重建;之后打开 PVC 无法找回旧临时卷里的数据。

Q:admin 密码忘了怎么重置?

A:能登录就通过 Grafana 改密码,无法登录时使用 Grafana CLI 的 grafana cli admin reset-admin-password。运行时要使用实例实际的配置和数据目录,确保命中正在使用的数据库。改 Kubernetes Secret 或 Helm values 只会改变初始凭据配置,不会重置数据库中的现有密码。

Q:能用 GitOps 管理仪表盘吗?

A:能。用 dashboardProviders 和 ConfigMap 提供 JSON,或通过 GitOps 工具把 Git 里的 JSON 同步为带匹配标签的 ConfigMap,再让 sidecar.dashboards.enabled 启用的 sidecar 发现它们。预置文件更新后,Grafana 可覆盖界面中保存的改动。Grafana provisioning

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台