本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Grafana 版本之間的差異
建立 Grafana 工作區時,您必須選擇要建立的 Grafana 版本。您可以選擇與 Grafana 版本 8、9 和 10 相容的版本。這些都已新增先前版本的功能。下列主題說明第 9 版和第 10 版中的變更,包括第 10 版中的變更,這些變更可能會中斷您在第 9 版中使用的功能。
注意
您可以在 使用 Grafana 第 8 版、 使用 Grafana 第 9 版和 使用 Grafana 第 10 版主題中閱讀使用 Grafana 工作區的版本特定文件。
如需各版本的詳細備註,以及 Grafana 實驗室的詳細資訊,請參閱 Grafana 實驗室文件中 Grafana 的新功能
Grafana 第 10 版
Grafana 第 10 版已新增下列功能。
-
關聯 – 關聯定義如何使用某個資料來源中的資料來查詢另一個資料來源中的資料,並允許探索視覺效果輕鬆執行與顯示資料相關的查詢。如需詳細資訊,請參閱Grafana 第 10 版中的相關性。
-
子資料夾 – 組織儀表板時,您現在可以使用子資料夾來建立巢狀階層。如需詳細資訊,請參閱建立儀表板資料夾。
-
提醒 – Grafana 提醒現在支援靜音提醒。此外,Grafana 提醒不會再傳送通知 3 次。
-
提醒升級預覽 – 從傳統儀表板提醒升級至 Grafana 提醒之前,您可以查看提醒的外觀,甚至在遷移時套用變更。如需詳細資訊,請參閱將傳統儀表板提醒遷移至 Grafana 提醒。Grafana Labs 已宣布 Grafana 11 版及更高版本將不再支援傳統儀表板提醒。
-
支援套件 – 支援套件提供簡單的方法來收集 Grafana 工作區的相關資訊,以便與產品支援共用。您可以快速建立支援套件,其中包含遷移、外掛程式、設定等相關資料。如需詳細資訊,請參閱收集支援的資訊。
-
新的視覺效果 – 有三個新的視覺效果可用。XY Chart、Datagrid 和 Trend 面板都適用於與第 10 版相容的工作區。第 9 版工作區也可以使用 XY 圖表。
-
PagerDuty – 企業外掛程式現在包含 PagerDuty 的外掛程式。
-
轉換重新設計 – 轉換索引標籤具有改善的使用者體驗和視覺化設計。轉換是分類的,每個轉換類型都有一個圖例,協助您選擇正確的轉換類型。
-
Prometheus 指標百科全書 – Prometheus 查詢建置器中 Prometheus 指標的指標下拉式清單已取代為分頁且可搜尋的指標百科全書。
-
API 金鑰 UI 已停止 – 服務帳戶是驗證 Grafana HTTP APIs 呼叫的建議方式。做為 Grafana 實驗室終止 API 金鑰的一部分,您無法再透過工作區使用者介面建立 API 金鑰。您只能透過 API AWS APIs 金鑰。
如需 Grafana 實驗室終止 API 金鑰的詳細資訊,請參閱 Grafana GitHub 問題清單中 API 金鑰的 APIKeys: Sunsetting
。
重大變更
Grafana 10.4 版包含從 Grafana 9.5 版到 10.4 版的變更。Grafana 10.0 和 10.3 版有一些變更,在某些情況下可能會中斷功能。更新至新版本時,建議您在非生產環境中進行測試,然後再更新生產工作區。
下列變更可能會影響部分更新至 Grafana 第 10 版的使用者。
-
角度已停止 – 未來 Grafana 版本將不再支援使用角度的外掛程式。在第 10 版中,使用角的面板會顯示橫幅,指出其使用已停止的功能,以通知他們未來版本無法運作。
-
CloudWatch 中的別名已移除 – CloudWatch 查詢編輯器中的別名模式已由 Label (動態標籤) 取代。
開啟任何使用別名欄位的儀表板,然後儲存它。別名會自動遷移至標籤。
-
需要升級較舊的外掛程式 – Athena 和 Amazon Redshift 資料來源的外掛程式必須在 Grafana v10 工作區中更新。Athena 資料來源外掛程式必須是 2.9.3 版或更新版本;Amazon Redshift 資料來源外掛程式必須是 1.8.3 版或更新版本。
如需安裝或升級外掛程式的資訊,請參閱 使用外掛程式目錄尋找外掛程式。
-
不再支援 DoiT BigQuery 外掛程式 – 不再支援 DoiT BigQuery 資料來源外掛程式。請改用官方 Grafana Labs BigQuery 資料來源外掛程式。
-
轉換變更 – Grafana 第 10 版已對欄位名稱和金鑰進行一些錯誤修正變更。如需完整詳細資訊,請參閱 Grafana 實驗室文件中的轉換中斷變更
。 -
資料來源許可 APIs – 用於存取資料來源許可的端點已變更。如需完整詳細資訊,請參閱 Grafana 實驗室文件中的資料來源許可變更
。
如需中斷變更以及影響外掛程式開發人員變更的詳細資訊,請參閱 Grafana 實驗室文件中的下列主題:
Grafana 第 9 版
Grafana v9 中新增了下列功能。
-
提醒:Grafana 受管提醒規則現在支援群組名稱。
-
探索:從探索檢視中建立儀表板。
-
Prometheus 查詢:Prometheus 查詢的新查詢建置器 (使用 PromQL) 可讓您更輕鬆地撰寫查詢。
-
Loki 查詢:Loki 查詢的新查詢建置器 (使用 LogQL) 可讓您更輕鬆地撰寫查詢。
-
API 字符/服務帳戶:服務帳戶可簡化 Grafana 中的機器存取,協助您管理 API 字符。
-
外掛程式管理:您可以啟用外掛程式管理,以在工作區中安裝、移除或更新社群外掛程式。這可讓您存取更多資料來源和視覺化效果,並讓您控制您使用的每個外掛程式的版本。
-
指標追蹤:設定追蹤資料來源,以使用查詢和標籤新增指標的連結。
-
Canvas 面板:具有靜態和動態元素的新面板視覺效果,可用來建立具有影像和一般文字的資料驅動型自訂面板。
-
重組界面:在 Grafana 主控台中以更輕鬆的導覽更新 UI。
-
CloudWatch:Amazon CloudWatch 資料來源現在可以監控跨 AWS 帳戶 和跨 的指標 AWS 區域。
-
日誌:日誌詳細資訊的界面已改善。
-
一般:整體錯誤修正和次要改進。
重大變更
Grafana 9.4 版包含一系列新功能和改進功能,以舊版為基礎。此版本有一些變更,在某些情況下可能會中斷功能。更新至新版本時,建議您在非生產環境中進行測試,然後再更新生產工作區。
下列變更可能會影響部分更新至 Grafana 9.4 版的使用者。如需這些變更的詳細清單,請參閱 GitHub 上的 Grafana 9.4 變更日誌
-
API 已停止 –
/api/tsdb/query
API 已移除。必要動作:請
/api/ds/query
改用 。請參閱 Grafana 公有文件和 GitHub 上的問題編號 49916中的查詢資料來源 。 -
API 端點變更 – 數個提醒 API 端點現在需要資料來源 UID,而不是數值 ID。
受影響的端點:
api/v1/rule/test
、api/prometheus/
、api/ruler/
、api/alertmanager/
必要動作:更新 API 呼叫以使用資料來源 UID 做為路徑參數。請參閱 GitHub 上的問題 #48070
、#48052 、#48046 和 #47978 。 -
已移除 Azure Monitor 查詢 – 不再支援 Application Insights 和 Insight Analytics 查詢。
在 Grafana 8.0 中已棄用,在 9.0 中已移除。已棄用的查詢將不會執行。
必要動作:請參閱 Grafana 公有文件中的 Azure Monitor 資料來源
以取得遷移指引。 -
已移除瀏覽器存取模式 – InfluxDB 和 Prometheus 資料來源不再提供瀏覽器存取模式。
必要動作:在資料來源組態中切換至伺服器存取模式。InfluxDB:在 8.0.0 中已棄用,在 9.2.0 中已移除。請參閱 GitHub 上的問題編號 53529
。Prometheus:在 7.4.0 中已棄用,在 9.2.0 中已移除。請參閱 GitHub 上的問題編號 50162 。 -
儀表板設定存取受限 – 編輯面板時,您無法再開啟儀表板設定。
當面板編輯模式處於作用中狀態時,儀表板設定會鎖定。在存取儀表板設定之前關閉面板編輯模式。請參閱 GitHub 上的問題編號 54746
。 -
資料來源密碼加密 – 不再支援未加密的密碼。
必要動作:使用
secureJsonData.password
和secureJsonData.basicAuthPassword
。先前在 8.1.0 版中已終止。請參閱 GitHub 上的問題編號 49987。 -
預設資料來源行為 – 預設資料來源選擇不再影響現有的面板。
預設資料來源僅適用於新的面板。變更預設值不會更新現有的儀表板。先前儲存的面板會保留其資料來源組態。請參閱 GitHub 上的問題編號 45132
。 -
Elasticsearch 間隔屬性已變更 – 已更新 Elasticsearch 7.x 的查詢間隔規格。
從
interval
變更為fixed_interval
屬性。提供與 Elasticsearch 8.x 的一致性。大多數查詢不會顯示可見的變更。請參閱 GitHub 上的問題編號 50297。 -
Elasticsearch 原始文件模式已停止 – 在 Elasticsearch 資料來源中顯示模式變更。
必要動作:請改用原始資料模式。請參閱 GitHub 上的問題編號 62236
。 -
Elasticsearch 版本支援 – 不再支援較舊的 Elasticsearch 版本。
必要動作:將 Elasticsearch 升級至 7.10.0 版或更新版本。低於 7.10.0 的版本已過end-of-life 請參閱 GitHub 上的問題編號 48715
。 -
探索 URL 格式已停止 – 精簡探索 URLs 將在未來的版本中移除。
必要動作:更新硬式編碼連結以使用標準 URL 格式。精簡 URLs:
&left=["now-1h","now"...]
。標準 URLs:&left={"datasource":"test"...}
。請參閱 GitHub 上的問題編號 50873。 -
GitHub OAuth 顯示變更 – GitHub 名稱和登入顯示已更新。
GitHub 名稱會顯示為 Grafana 名稱。GitHub 登入會顯示為 Grafana 登入。改善使用者識別清晰度。請參閱 GitHub 上的問題編號 45438
。 -
熱度圖面板實作已更新 – 從 9.1.0 開始,熱度圖面板會使用新的實作。
大幅改善渲染效能。儲存貯體會放置在合理的邊界 (1 公尺、5 公尺、30 秒) 上。不再支援圓形儲存格。
必要動作:升級後測試您的熱度圖面板。視需要將
useLegacyHeatmapPanel
功能旗標設定為 true,以停用新實作。?__feature.useLegacyHeatmapPanel=true
新增至儀表板 URLs進行測試。請參閱 GitHub 上的問題編號 50229。 -
InfluxDB 後端遷移 – InfluxDB 資料剖析行為已變更。
InfluxDB 後端遷移功能切換 (
influxdbBackendMigration
) 會因後端處理問題而重新引入。根據預設,InfluxDB 資料會在前端剖析。如果您升級至 9.4.4 並在 InfluxDB 資料上新增轉換,這些面板將無法轉譯。必要動作:移除受影響的面板並重新建立,或編輯
panel.json
或Time
中的time
欄位dashboard.json
。請參閱 GitHub 上的問題編號 64842。 -
日誌訊息格式已更新 – 日誌訊息結構已變更。
lvl
現在是level
。現在是eror
,現在dbug
是error
和debug
。增加時間戳記精確度。選擇不與oldlog
功能切換 (暫時) 搭配使用。請參閱 GitHub 上的問題編號 47584。 -
Loki 資料格式最佳化 – Loki 記錄資料使用更有效率的資料框架格式。
具有標籤欄的單一資料影格,而不是單獨的資料影格。探索和記錄面板的運作方式不會變更。其他面板或轉換可能需要調整。
必要動作:使用擷取欄位轉換將標籤取代為欄位轉換。 請參閱 GitHub 上的問題編號 47153
。 -
NaN 值處理 – 跨 Prometheus 和 Loki 資料來源的一致
NaN
表示。NaN
值會保留為 ,NaN
而不是轉換為null
。使用者應該大多看不到變更。同時影響儀表板和提醒路徑。請參閱 GitHub 上的問題 #49475和 #45389 。 -
密碼重設連結無效 – 升級後,現有的密碼重設連結將無法運作。
升級前傳送的密碼重設連結無效。使用者必須請求新的密碼重設連結。連結會在 2 小時後過期。請參閱 GitHub 上的問題編號 42334
。 -
預留標籤字首 – 保留開頭
grafana_
為 的標籤。grafana_
可能會覆寫以 開頭的手動設定標籤。目前的預留標籤:grafana_folder
(包含提醒的資料夾標題)。請參閱 GitHub 上的問題編號 50262。 -
轉換改進 – 透過 regex 轉換重新命名現在支援全域模式。
全域模式使用 格式
/<stringToReplace>/g
。有些轉換的行為可能不同。將先前行為的相符字串以正斜線包裝:(.*)
變成/(.*)/
。請參閱 GitHub 上的問題編號 48179。