grafana-util docs
Home / Commands / grafana-util alert list-mute-timings

grafana-util alert list-mute-timings

這頁在說什麼

列出目前 Grafana 線上的靜音時段。

什麼時候看這頁

  • 檢視單一 org 或所有可見 org 的靜音時段清單。
  • 以文字、表格、CSV、JSON 或 YAML 格式輸出。

適合誰

適合要檢查告警規則、通知路由、contact point 與 staged 變更的人。

目的

列出目前 Grafana 線上的靜音時段。

使用時機

  • 檢視單一 org 或所有可見 org 的靜音時段清單。
  • 以文字、表格、CSV、JSON 或 YAML 格式輸出。

主要旗標

  • --org-id 會列出某個 Grafana org ID 的靜音時段。
  • --all-orgs 會彙整所有可見 org 的清單。
  • --output-format 控制輸出格式，可選 text、table、csv、json 與 yaml。
  • --no-header 省略表頭列。

說明

  • 可重複執行的單一 org 清單查詢優先用 --profile。
  • --all-orgs 最好搭配管理員憑證支援的 --profile 或直接 Basic auth，因為 token 權限可能只看到部分資料。

採用前後對照

  • 之前：得進 Grafana UI 才知道有哪些 mute timing，而且還要自己比對 scope。
  • 之後：一次列出清單，就能拿去比對、審閱或交給 CI。

成功判準

  • 你預期的 mute timing 會出現在輸出裡。
  • 查詢範圍和你指定的 org / profile 一致。
  • 輸出格式可以直接交給人看或給腳本處理。

失敗時先檢查

  • 如果清單看起來不完整，先確認 token 權限是不是只看得到部分 org。
  • --all-orgs 少資料時，改用管理員支援的 profile 或 Basic auth。
  • 先確認 org / profile，再把空清單當成真的沒有資料。

範例

# 用途：列出目前 Grafana 線上的靜音時段。
grafana-util alert list-mute-timings --profile prod --output-format table
# 用途：列出目前 Grafana 線上的靜音時段。
grafana-util alert list-mute-timings --url http://localhost:3000 --basic-user admin --basic-password admin --all-orgs --output-format yaml
# 用途：列出目前 Grafana 線上的靜音時段。
grafana-util alert list-mute-timings --url http://localhost:3000 --token "$GRAFANA_API_TOKEN" --output-format json

相關命令