Home / Commands / grafana-util change inspect

grafana-util change inspect

這頁在說什麼

從自動發現或明確指定的輸入檢視 staged change package。

適合誰

適合 review-first 流程，想把 summary、preflight、plan 與 apply 清楚分開的人。

用途

從自動發現或明確指定的輸入檢視 staged change package。

當你想最快知道 staged package 裡到底有什麼時，先從這裡開始。
在 change check 或 change preview 前，先用它確認變更包規模。
如果 staged inputs 可能來自 mixed workspace artifacts，而不是單一 desired.json，它會比低階 summary 更自然。

--workspace：從 repo、export tree 或 provisioning tree 自動發現常見 staged inputs。
--desired-file：直接檢視單一 desired change file。
--dashboard-export-dir、--dashboard-provisioning-dir：明確指定 dashboard staged inputs。
--alert-export-dir、--datasource-provisioning-file：補充 alert 與 datasource staged inputs。
--source-bundle：直接檢視既有 source bundle，不走 per-surface 目錄。
--output-format：輸出成 text 或 json。
--output-file、--also-stdout：把輸出存成 review artifact。

# 用途：從 repo-local inputs 檢視 staged package。
grafana-util change inspect --workspace .

預期輸出：

CHANGE PACKAGE SUMMARY:
- dashboards: 5 modified, 2 added
- alerts: 3 modified
- datasources: 1 referenced inventory
- total impact: 11 operations

# 用途：直接從 export tree 檢視 staged package。
grafana-util change inspect --workspace ./dashboards/raw --output-format json

預期輸出：

{
  "kind": "grafana-utils-overview",
  "schemaVersion": 1,
  "sections": [
    {
      "title": "Dashboards"
    }
  ],
  "projectStatus": {}
}

這代表 inspect 已成功找到 staged inputs，並輸出共用的 overview 風格文件，而不是停在 discovery 失敗。