用 Helm 在 Kubernetes 上部署 Grafana

在 Kubernetes 安裝 Grafana Helm chart,設定 PVC 持久化、預先佈建 Prometheus 資料來源與儀表板,並透過 Ingress 啟用 TLS。

最佳實務
Prometheus 指標與儀表板視覺化示意

Grafana Pod 換掉之後,儀表板可能不見,Prometheus 的指標卻還在。兩套系統儲存的內容不同。Prometheus 保留時間序列,Grafana 把介面建立的儀表板、使用者與其他設定寫到自己的資料庫。持久磁碟區讓資料庫跟著下一個 Pod 使用;預先佈建則能讓新執行個體從版控檔案重建資料來源與儀表板。

這篇用 Helm 在 Kubernetes 上部署 Grafana,接上 Prometheus,再處理一個常見情況:Grafana 開得起來,面板卻是空的。範例固定使用社群 chart 14.4.0,內含 Grafana 13.3.0,支援 Kubernetes 1.25 起的 1.x 版本。範例的 Kubernetes 資訊清單已用本機 Helm 渲染檢查。

安裝 Grafana 並從本機登入

如果只需要暫時確認功能,可用 Grafana 社群 chart 的預設值安裝。如果會在這裡建立要保留的儀表板,第一次安裝就套用下一節的持久化設定。

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

讀取自動產生的初始管理員密碼,再把本機連接埠轉送到 Grafana Service。預設 Service 接收 80 埠的請求,送到容器的 3000 埠。

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 登入。Secret 裡存的是初始登入資訊。若已在 Grafana 修改過密碼,目前的密碼就可能不同。

將 Grafana 資料庫放在 PVC

單一副本使用預設 SQLite 時,將持久磁碟區掛載到 Grafana 資料目錄。先確認叢集能配置所需的儲存空間。範例的 Deployment 策略使用 Recreate,舊 Pod 停止後才啟動新 Pod,升級時會短暫中斷。

在 monitoring 命名空間準備 grafana-bootstrap Secret,設定 admin-user 與 admin-password 兩個鍵。把以下內容存成 values.yaml。密碼留在 Secret,不必寫入 values 檔。

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"

這個 URL 對應的是在 monitoring 命名空間、以 prometheus 為 release 名稱安裝的獨立 Prometheus chart。由 Grafana 伺服器連線。如果你的安裝方式不同,用 kubectl -n monitoring get svc 確認實際的 Service 與連接埠。

確認儀表板查得到資料

chart 在 Pod 初始化時下載 Node Exporter Full 的第 46 版。檔案提供者從 chart 存放 JSON 的目錄讀取。叢集必須能連到下載位址;若無法連外,移除 gnetId 下載項目,改用 ConfigMap 掛載審查過的 JSON。

套用設定,接著查看 PVC:

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_uname_info,確認 Prometheus 有收到 Node Exporter 指標,再到儀表板選取這個 Prometheus 資料來源。若面板仍沒有資料,先核對時間範圍與篩選條件。

如果也要把 Kubernetes 指標送到觀測雲,先在 DataKit 的 KubernetesPrometheus 收集器(簡體中文)啟用註解探索,並在要抓取的 Pod 或 Service 加上註解。Prometheus 和 DataKit 各自選擇抓取目標,Grafana 仍向 Prometheus 的 Service 發出查詢。

透過 Ingress 開放存取

把以下設定存成 ingress.yaml,在 Helm 指令的 -f values.yaml 後加上 -f ingress.yaml。將 private-web 換成控制器實際使用的 IngressClass,將 DNS 指到該控制器,並在同一命名空間提供涵蓋該網域的 TLS Secret。root_url 應填瀏覽器實際使用的 HTTPS URL。

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 和資料來源的權限。連接埠轉送仍可用於本機排查。

已由 kube-prometheus-stack 管理 Grafana 時

先看 stack 的 values 是否啟用 grafana.enabled。如果已啟用,修改既有 release 裡的 grafana: 區塊。子 chart 版本由 stack 的相依套件設定決定,要以實際版本的 values 為準。

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

這仍然是 SQLite 單一副本。多副本需要共用 PostgreSQL 或 MySQL,Grafana Alerting 的高可用性要另外設定。

部署後的常見問題

Pod 換掉後為何找不到儀表板?

未啟用持久化時,Grafana 的資料目錄在 Pod 的暫存磁碟區。只存在該資料庫的儀表板可能隨舊 Pod 消失。若預先佈建的來源檔案還在,Grafana 可以重建對應的儀表板。既有環境改用 PVC 前,先匯出或備份所需資料。新磁碟區不會自動接收舊資料。

忘了管理員密碼,怎麼重設?

還能登入時直接到 Grafana 修改。復原時用 grafana cli admin reset-admin-password,讓指令使用執行個體實際的設定與資料目錄,才能寫到正確的資料庫。修改 Kubernetes Secret 只會改變初始登入資訊;既有帳號的密碼要在 Grafana 重設。

可以用 Git 管理儀表板嗎?

可以把 JSON 存在 Git,再透過 ConfigMap 提供佈建檔案。也可讓 GitOps 控制器建立帶有指定標籤的 ConfigMap,由 sidecar.dashboards.enabled 啟用的 sidecar 監看。來源檔案更新後,Grafana 可能覆蓋介面儲存的編輯。Grafana 儀表板佈建文件

延伸閱讀 · 用 Grafana 視覺化 Prometheus 指標

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

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

立即開始

选择观测云版本

代码托管平台