本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Grafana 版本之間的差異
<a name="version-differences"></a>

[建立 Grafana 工作區](AMG-create-workspace.md)時，您必須選擇要建立的 Grafana 版本。您可以選擇與 Grafana 版本 8、9、10 和 12 相容的版本。這些都已新增先前版本的功能。下列主題說明 9、10 和 12 版的變更，包括可能會中斷您在先前版本中使用的功能的變更。

**注意**  
您可以在 [使用 Grafana 第 12 版](using-grafana-v12.md)、[使用 Grafana 第 9 版](using-grafana-v9.md)、 和 [使用 Grafana 第 8 版](using-grafana-v8.md)主題中閱讀使用 Grafana [使用 Grafana 第 10 版](using-grafana-v10.md)工作區的版本特定文件。

如需各版本的詳細備註，以及 Grafana 實驗室的詳細資訊，請參閱 [Grafana 實驗室文件中 Grafana 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/)。 **

## Grafana 第 12 版
<a name="version-diff-v12"></a>

Grafana 第 12 版已新增下列功能。

**向下切入應用程式**
+ **Metrics Drilldown** – 探索 Prometheus 指標資料的無查詢point-and-click體驗。請參閱 [指標向下切入](v12-drilldown-metrics.md)。
+ **Logs Drilldown** – 透過磁碟區和文字模式瀏覽 Loki 日誌的無查詢體驗。請參閱 [日誌向下切入](v12-drilldown-logs.md)。
+ **Traces Drilldown** – 探索分散式 Tempo 追蹤的無查詢體驗。請參閱 [追蹤向下切入](v12-drilldown-traces.md)。
+ **Profiles Drilldown** – 瀏覽 Pyroscope 分析資料的無查詢體驗。請參閱 [設定檔向下切入](v12-drilldown-profiles.md)。

**儀表板和視覺化**
+ **以場景為基礎的儀表板** – 儀表板轉譯引擎已使用 Scenes 架構重建，提供更好的效能、更好的範本變數支援，以及更靈活的配置。
+ **新的資料表視覺化** – 資料表面板已完全重建，以改善效能和新功能，包括 CSS 儲存格樣式、資料表欄位產生工具提示、改善頁尾、互動式按鈕的新動作儲存格類型，以及 Cell Inspect 中的自動格式化儲存格值。
+ **Canvas 視覺化改善** – Canvas 面板現在支援一鍵式資料連結和動作、動態連線方向、停用工具提示的功能，以及平移和縮放改善功能，讓您更能控制互動式資料驅動的配置。
+ **視覺化動作** – 您現在可以將互動式動作新增至可觸發 API 呼叫或導覽至 URLs視覺化，並支援自訂變數、一鍵式資料連結，以及資料表視覺化的新動作儲存格類型。
+ **具有條件式格式的彩色資料表列** – 資料表視覺化現在支援資料列層級條件式格式，可讓您根據資料值為整個資料列著色。
+ **統計視覺化百分比變更** – 統計面板現在使用可設定的顏色模式選項顯示百分比變更，讓您更輕鬆地快速查看趨勢。
+ **長條圖中的圖例支援** – 長條圖視覺化現在支援圖例，改善顯示多個序列時的可讀性。
+ **狀態時間軸分頁** – 狀態時間軸視覺化現在支援分頁，讓您更輕鬆地導覽大型資料集。
+ **重新設計的儀表板篩選條件 – **儀表板清單篩選條件已重新設計，可提供更直覺的瀏覽體驗。
+ **切換變數類型** – 新的切換變數類型可讓您在查詢中的值之間快速切換，簡化儀表板互動。
+ **查詢變數的靜態選項** – 查詢變數現在支援靜態選項，可讓您進一步控制變數值，而不需要資料來源查詢。
+ **增強型臨機操作篩選條件** – 臨機操作篩選條件現在可改善跨資料來源的支援，讓您更輕鬆地動態篩選儀表板資料。
+ **使用 Cron 語法進行更好的時間區域控制** – 註釋現在支援時間區域的 Cron 語法，提供更精確的時間型註釋控制。
+ **改善了 geomap 效能** – Geomap 視覺化現在可大幅提升效能最佳化的轉譯速度。
+ **導覽書籤** – 您現在可以在導覽選單中將常用頁面加入書籤，以便快速存取。
+ **從查詢設定閾值顏色** – 來自查詢轉換的 Config 現在支援根據查詢結果動態設定閾值顏色。
+ **增強型自訂貨幣格式** – 新的自訂貨幣格式選項可讓您使用精確的小數控制來顯示確切的財務值。
+ **伺服器可設定的快速時間範圍** – 管理員現在可以設定儀表板時間選擇器中可用的快速時間範圍選項。
+ **公告橫幅** – 管理員現在可以顯示公告橫幅，將重要資訊傳達給工作區使用者。

**轉換**
+ **依值篩選中的子字串比對程式** – 依值篩選轉換現在包含子字串比對程式，可讓您更輕鬆地根據部分文字比對篩選資料。
+ **趨勢線轉換** – 新的趨勢線轉換可讓您透過新增趨勢線並將平均值移動到視覺化效果來找出資料中的模式。
+ **所有數字欄位的二進位轉換** – 您現在可以一次將相同的二進位轉換套用至資料表中的所有數字欄位，以減少重複的組態。
+ **擷取欄位的新 regex 選項** – 擷取欄位轉換現在支援規則表達式，從文字資料提供更強大的欄位擷取。
+ **轉換更新** – 已新增多個轉換改進，包括跨轉換管道的新模式和可用性增強。
+ **所有轉換中的儀表板變數** – 現在所有轉換類型都支援儀表板變數，以擴展資料處理管道的靈活性。

**提醒**
+ **保持 Grafana 受管警示的最後狀態** – 警示規則現在可以設定為在查詢未傳回資料或錯誤時保持其最後狀態，以防止不必要的警示狀態變更。
+ **警示詳細資訊檢視重新設計** – 警示規則詳細資訊檢視已重新設計，具有更清晰的配置和更可行的資訊。
+ **警示範本選取**器 – 警示 UI 中的新範本選取器可讓您更輕鬆地選擇和套用通知範本。
+ **改善暫停提醒可見**性 – 暫停提醒規則現在更清楚地顯示在 UI 中，更容易識別哪些規則未主動評估。
+ **僅適用於 Grafana 受管警示：規則特定的靜音** – 您現在可以建立適用於具有精細許可的特定警示規則的靜音，以提供更精準的警示抑制。
+ **Grafana 受管警示的錄製規則** – Grafana 受管警示現在可使用錄製規則，可讓您預先計算常用查詢以獲得更好的效能。這會取代已棄用的記錄查詢功能。請參閱 [設定錄製規則](v12-alerting-configure-recordingrules.md)。
+ **提醒規則版本歷史記錄** – 提醒規則現在會維護版本歷史記錄，可讓您追蹤變更並還原至先前的組態。
+ **Grafana 受管警示規則「復原」狀態** – 警示規則現在支援「復原」狀態，指出警示條件何時不再觸發，但尚未恢復正常。
+ **警示規則改進** – Grafana 受管警示規則包含多個可用性改進，包括更新的清單頁面、作用中的時間間隔、從 Prometheus YAML 匯入規則的能力，以及重新設計的設定頁面。

**探索 和 日誌**
+ **新的日誌視覺化** – 新的日誌視覺化面板使用新的欄位選取器元件來改善日誌轉譯，以自訂要顯示的欄位。
+ **JSON Log Line Viewer** – Logs Drilldown 應用程式現在包含結構化日誌行的 JSON 檢視器，可讓您更輕鬆地檢查 JSON 格式的日誌資料。
+ **探索中的 Loki** – Loki 查詢現在支援向前搜尋，可讓您從最舊到最新的搜尋日誌。
+ **探索中的關聯** – 您現在可以直接從探索將關聯新增至外部 URLs，以便在資料來源和外部系統之間無縫導覽。請參閱 [Grafana 第 12 版中的相關性](v12-correlations.md)。

**資料來源**
+ **Amazon Managed Service for Prometheus 資料來源遷移** – 從此版本開始，Core Prometheus 外掛程式中的 Sigv4 身分驗證支援已棄用。當您升級至 Grafana 12 版時，先前使用 Core Prometheus 外掛程式的所有 Amazon Managed Service for Prometheus 資料來源都會自動遷移至 Amazon Managed Service for Prometheus 外掛程式。使用這些資料來源的任何儀表板都會自動更新，以反映此變更。
+ **使用 PPL 和 SQL 的 Amazon CloudWatch Logs Insights** – 除了標準查詢語言之外，您現在可以使用 PPL (Piped Processing Language) 和 SQL 語法查詢 Amazon CloudWatch Logs Insights。
+ **Amazon CloudWatch Metric Insights 跨帳戶支援** – Amazon CloudWatch Metric Insights 現在支援跨帳戶可觀測性，可讓您跨多個帳戶查詢指標 AWS 帳戶。
+ **Amazon CloudWatch Logs 異常偵測和模式分析** – Amazon CloudWatch 資料來源現在支援日誌異常偵測和模式分析，以識別日誌資料中的異常模式。
+ **OpenSearch PPL 和範例查詢** – OpenSearch 資料來源現在支援 PPL 語言和範例查詢，以便於建立查詢。
+ **MSSQL Windows Active Directory 身分驗證** – Microsoft SQL Server 資料來源現在支援 Windows Active Directory (Kerberos) 身分驗證。
+ **移除舊的 Tempo 和 Loki 搜尋** – 舊版 Tempo 搜尋和 Loki 搜尋介面已移除，以享有 TraceQL 支援的搜尋體驗。
+ **BigQuery 服務帳戶模擬** – BigQuery 資料來源現在支援服務帳戶模擬，以進行更靈活的身分驗證。
+ **Google Sheets 範本變數** – Google Sheets 資料來源現在支援動態資料查詢的範本變數。
+ **SQL 資料來源的時間序列巨集支援** – SQL 資料來源的視覺化查詢建置器現在支援時間序列巨集，簡化以時間為基礎的查詢。
+ **Databricks 中的 Unity Catalog 支援** – Grafana Databricks 外掛程式現在支援 Unity Catalog 統一的資料控管。
+ **Honeycomb 原始查詢支援** – Honeycomb 資料來源現在支援進階查詢功能的原始查詢。
+ **GitHub 應用程式身分驗證** – GitHub 資料來源現在支援 GitHub 應用程式身分驗證，做為個人存取字符的替代方案。

**身分驗證和安全性**
+ **遷移至服務帳戶的 API 金鑰** – API 金鑰已完全棄用，並自動遷移至服務帳戶，從而改善安全性和管理功能。請參閱 [使用服務帳戶](v12-authenticating-grafana-apis.md#v12-service-accounts)。
+ **OAuth 和 SAML 工作階段處理改進** – 已改善 OAuth 和 SAML 身分驗證提供者的工作階段處理，以提高可靠性和安全性。
+ **Entra Workload Identity 支援** – Grafana 現在支援在 Azure 環境中進行身分驗證的 Microsoft Entra Workload Identity。
+ 適用於 **Alertmanager 和 Mimir 的 OAuth2 ** – 您現在可以在 vanilla Alertmanager 和 Mimir 資料來源的 HTTP 設定中設定 OAuth2 身分驗證。

**Accessibility**
+ **GeoMap 鍵盤支援** – GeoMap 視覺化現在支援鍵盤導覽，以提高可存取性。
+ **面板快速鍵鍵盤支援** – 儀表板面板現在支援常見動作的鍵盤快速鍵。
+ **標題和減少動作改善** – 已改善螢幕閱讀器的標題結構，並針對偏好最少動畫的使用者新增減少動作支援。

**突破性變更**

**重要**  
**舊版提醒已完全移除** – 舊版提醒已在 Amazon Managed Grafana v12 中完全移除，具有舊版提醒設定的工作區將無法啟動。您必須先從舊版警示遷移至 Grafana 警示，才能升級至 v12。請參閱 [將傳統儀表板提醒遷移至 Grafana 提醒](v10-alerting-use-grafana-alerts.md) 和 [傳統儀表板提醒](old-alerts-overview.md)。

**重要**  
**已移除 AngularJS 支援** – Amazon Managed Grafana v12 中已完全移除 AngularJS 支援，因此不會載入以 Angular 為基礎的外掛程式，且使用它們的儀表板會顯示錯誤。升級之前，您必須將所有以角度為基礎的外掛程式遷移至 React 替代方案。如需管理工作區中的外掛程式[使用外掛程式目錄尋找外掛程式](grafana-plugins.md#plugin-catalog)，請參閱 。

**重要**  
**已移除 API 金鑰** – API 金鑰在 Amazon Managed Grafana v12 中完全移除，有利於服務帳戶，現有 API 金鑰將無法再運作。在升級之前，您必須建立服務帳戶以取代所有 API 金鑰，並更新自動化以使用服務帳戶字符。請參閱 [使用服務帳戶](v12-authenticating-grafana-apis.md#v12-service-accounts)。

**重要**  
**警示規則評估結果限制** – 每個警示規則的查詢評估結果數量現在限制為 500。如果警示規則的條件查詢產生的結果超過此限制，則評估會產生錯誤。若要在此錯誤發生時接收提醒，請在提醒規則的設定`Error`下將 `Alert state if execution error or timeout` 設定為 。請參閱 [提醒規則的狀態和運作狀態](v12-alerting-explore-state.md)。

**重要**  
**註釋限制為 300 萬** – 現在每個工作區的註釋數量限制為 300 萬。如果建立超過 300 萬個註釋，最舊的註釋會先刪除。
+ **輸入資料來源已移除** – 輸入資料來源外掛程式已完全移除，因此您必須在升級之前將受影響的儀表板遷移至 TestData 資料來源。請參閱 Grafana 實驗室[文件中的 TestData ](https://grafana.com/docs/grafana/latest/datasources/testdata/) 文件。 **
+ **查詢篩選行為變更** –「停用查詢」按鈕現在是「隱藏回應/顯示回應」，且隱藏的查詢回應不會再傳回至面板，因此如果資料在升級後遺失，請檢閱查詢組態並更新面板。請參閱 *Grafana 實驗室文件中*的[查詢篩選變更](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v11-0/#data-sources-query-filtering-changes)。
+ **資料來源 UIDs必須遵循更嚴格的格式** – 資料來源 UIDs 現在只能使用英數字元、連字號和底線，因此您應該在升級之前更新任何不合規UIDs 及其儀表板參考。請參閱 *Grafana 實驗室文件中*的[更嚴格的資料來源 UID 格式](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-0/#enforcing-stricter-data-source-uid-format)。
+ **重複面板的面板檢視 URLs已變更** – 檢視個別重複面板的 URL 格式已變更，舊URLs 將傳回「找不到面板」錯誤，因此請在檢視模式中開啟面板來更新任何書籤或自動化，以取得新的 URLs。請參閱 *Grafana 實驗室文件中*的[面板檢視 URL 變更](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v11-0/#changes-to-how-the-panel-view-url-is-generated-for-repeated-panels)。
+ **具有正斜線的資料夾需要逸出的配對器** – 子資料夾的引入可能會中斷與包含正斜線的資料夾繫結的提醒規則，因此請使用逸出的配對器更新通知政策 （例如，`grafana_folder=MyFolder\/sub-folder`)，或重新命名資料夾以在升級之前移除正斜線。請參閱 [建立儀表板資料夾](v12-dash-managing-dashboards.md#v12-dash-create-dashboard-folder) 和 [設定通知政策](v12-alerting-configure-notification-policies.md)。
+ **警示範本 \$1value 變數行為變更** – 警示通知範本中的`$value`變數現在會在查詢單一資料來源時傳回查詢值，因此請檢閱使用 的警示範本`$value`，並視需要更新格式。請參閱 [格式化標籤和註釋](v12-alerting-overview-labels-templating.md)。
+ **提醒規則存取許可放寬** – 存取提醒規則的許可要求已放寬。請參閱 Grafana Labs 文件中的 [使用許可](Grafana-permissions.md) 和 Grafana v11.1 中的新功能。 [https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-1/#removes-requirement-of-datasourcesquery-permission-for-reading-rules](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-1/#removes-requirement-of-datasourcesquery-permission-for-reading-rules) **
+ **預設啟用錄製規則** – 現在預設在 Grafana 提醒中啟用錄製規則。請參閱 [設定錄製規則](v12-alerting-configure-recordingrules.md)。
+ 已**移除內部 Alertmanager 組態 POST 端點** – 已移除內部 Grafana Alertmanager 組態的 POST 端點，因此您必須在升級之前更新 API 整合以使用新的佈建端點 （例如 `POST /api/v1/provisioning/alert-rules`)。
+ 已**擴展檢視器和編輯器許可** – 檢視器現在可以讀取和寫入註釋，而編輯器可以建立和刪除註釋。請參閱 [使用許可](Grafana-permissions.md)。
+ **建立者許可已變更** – 授予資源建立者的許可 （例如儀表板或資料夾） 已變更，因此請在升級後檢閱您的存取控制設定。請參閱 *Grafana 實驗室文件中*[的變更建立者許可](https://grafana.com/whats-new/2025-10-16-change-to-creator-permissions/)。
+ 已**移除與 API 金鑰相關聯的許可** – 在完整遷移至服務帳戶的過程中，先前與 API 金鑰相關聯的許可已移除。請參閱 *Grafana 實驗室文件中*[的移除 API 金鑰相關許可](https://grafana.com/whats-new/2025-10-03-removal-of-api-key-associated-permissions/)。
+ **SNS 聯絡點遷移** – SNS 聯絡點會自動遷移至較新的 SNS 標記。此遷移不需要任何手動動作。不過，SNS 的聯絡點設定結構描述已變更。如需更新請求格式的範例，[建立通知管道](v12-Grafana-API-AlertingNotificationChannels.md#v12-Grafana-API-AlertNotificationChannels-Create)請參閱 。
+ **警示規則評估結果限制** – 每個警示規則的查詢評估結果數量現在限制為 500。如果警示規則的條件查詢產生的結果超過此限制，則評估會產生錯誤。若要在此錯誤發生時接收提醒，請在提醒規則的設定`Error`下將 `Alert state if execution error or timeout`設定為 。
+ **從 Core Prometheus 外掛程式移除 SigV4 身分驗證** – Core Prometheus 外掛程式中的 SigV4 身分驗證支援已移除。當您升級至 Grafana 12 版時，先前使用 Core Prometheus 外掛程式的所有 Amazon Managed Service for Prometheus 資料來源都會自動遷移至 Amazon Managed Service for Prometheus 外掛程式。使用這些資料來源的任何儀表板都會自動更新，以反映此變更。請參閱 [連線至 Amazon Managed Service for Prometheus 資料來源](amazon-prometheus-data-source.md)。

Amazon Managed Grafana v12 包含從開放原始碼 Grafana v11.0 到 v12.4 的功能。如需 AWS特定功能，請參閱 Amazon Managed Grafana 使用者指南。如需新功能的詳細資訊，請參閱 [Grafana Labs 文件中的適用於 v11.x 和 v12.x 的 Grafana 中的新功能](https://grafana.com/docs/grafana/latest/whatsnew/)。 **版本 11.x 和 12.x 包含可能會中斷功能的變更，因此請在非生產環境中進行測試，然後再更新生產工作區。

如需中斷變更的詳細資訊，請參閱 *Grafana 實驗室文件中*的下列主題：

**Grafana 12**
+ [Grafana v12.4 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-4/)
+ [Grafana v12.3 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-3/)
+ [Grafana v12.2 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-2/)
+ [Grafana v12.1 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-1/)
+ [Grafana v12.0 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-0/)

**Grafana 11**
+ [Grafana v11.6 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-6/)
+ [Grafana v11.5 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-5/)
+ [Grafana v11.4 中的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-4/)
+ [Grafana v11.3 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-3/)
+ [Grafana v11.2 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-2/)
+ [Grafana v11.1 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-1/)
+ [Grafana v11.0 的新功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-0/)

## Grafana 第 10 版
<a name="version-diff-v10"></a>

Grafana 第 10 版已新增下列功能。
+ **關聯** – 關聯定義如何使用某個資料來源中的資料來查詢另一個資料來源中的資料，並允許探索視覺效果輕鬆執行與顯示資料相關的查詢。如需詳細資訊，請參閱[Grafana 第 10 版中的相關性](v10-correlations.md)。
+ **子資料夾** – 組織儀表板時，您現在可以使用子資料夾來建立巢狀階層。如需詳細資訊，請參閱[建立儀表板資料夾](v10-dash-managing-dashboards.md#v10-dash-create-dashboard-folder)。
+ **提醒** – Grafana 提醒現在支援靜音提醒。此外，Grafana 提醒不會再傳送通知 3 次。
+ **提醒升級預覽** – 從傳統儀表板提醒升級至 Grafana 提醒之前，您可以查看提醒的外觀，甚至在遷移時套用變更。如需詳細資訊，請參閱[將傳統儀表板提醒遷移至 Grafana 提醒](v10-alerting-use-grafana-alerts.md)。Grafana Labs 已宣布 Grafana 11 版及更高版本將不再支援傳統儀表板提醒。
+ **支援套件** – 支援套件提供簡單的方法來收集 Grafana 工作區的相關資訊，以便與產品支援共用。您可以快速建立支援套件，其中包含遷移、外掛程式、設定等相關資料。如需詳細資訊，請參閱[收集支援的資訊](support-bundles.md)。
+ **新的視覺**效果 – 有三個新的視覺效果可用。[XY Chart](v10-panels-xychart.md)、[Datagrid](v10-panels-datagrid.md) 和 [Trend 面板](v10-panels-trend.md)都適用於與第 10 版相容的工作區。第 9 版工作區也可以使用 XY 圖表。
+ **PagerDuty** – 企業外掛程式現在包含 PagerDuty 的外掛程式。
+ **轉換重新設計** – 轉換索引標籤具有改善的使用者體驗和視覺化設計。轉換會分類，每個轉換類型都有一個圖例，協助您選擇正確的轉換類型。
+ **Prometheus 指標百科全書** – Prometheus 查詢建置器中 Prometheus 指標的指標下拉式清單已取代為分頁且可搜尋的指標*百科全書*。
+ **API 金鑰 UI 已停止** – [服務帳戶](v12-authenticating-grafana-apis.md#v12-service-accounts)是驗證 Grafana HTTP APIs 呼叫的建議方式。作為 Grafana 實驗室終止 API 金鑰的一部分，您無法再透過工作區使用者介面建立 API 金鑰。您只能透過 API AWS APIs 金鑰。

  如需有關 Grafana 實驗室終止 API 金鑰的詳細資訊，請參閱 Grafana GitHub 問題清單中 [API 金鑰的 APIKeys： Sunsetting](https://github.com/grafana/grafana/issues/53567)。

**突破性變更**

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 版或更新版本。

  如需安裝或升級外掛程式的資訊，請參閱 [使用外掛程式目錄尋找外掛程式](grafana-plugins.md#plugin-catalog)。
+ **不再支援 DoiT BigQuery 外掛程式** – 不再支援 DoiT BigQuery 資料來源外掛程式。請改用官方 Grafana Labs BigQuery 資料來源外掛程式。
+ **轉換變更** – Grafana 第 10 版已對欄位名稱和金鑰進行一些錯誤修正變更。如需完整詳細資訊，請參閱 Grafana 實驗室文件中的[轉換中斷變更](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-3/#transformations)。
+ **資料來源許可 APIs** – 用於存取資料來源許可的端點已變更。如需完整詳細資訊，請參閱 Grafana 實驗室文件中的[資料來源許可變更](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-3/#data-source-permissions)。

如需中斷變更的詳細資訊，請參閱 *Grafana 實驗室文件中*的下列主題：
+ [中斷 Grafana v10.0 中的變更](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-0/)
+ [中斷 Grafana v10.3 中的變更](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-3/)

## Grafana 第 9 版
<a name="version-diff-v9"></a>

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 變更日誌](https://github.com/grafana/grafana/blob/release-9.4.17/CHANGELOG.md)。
+ **API 已停止** – `/api/tsdb/query` API 已移除。

  **必要動作：**請`/api/ds/query`改用 。請參閱 *Grafana 公有文件*和 *GitHub* 上的問題[編號 49916](https://github.com/grafana/grafana/issues/49916) 中的[查詢資料來源](https://grafana.com/docs/grafana/latest/http_api/data_source/#query-a-data-source)。
+ **API 端點變更** – 數個提醒 API 端點現在需要資料來源 UID，而不是數值 ID。

  **受影響的端點：**`api/v1/rule/test`、`api/prometheus/`、`api/ruler/`、 `api/alertmanager/`

  **必要動作：**更新 API 呼叫以使用資料來源 UID 做為路徑參數。請參閱 *GitHub* 上的問題 [\$148070](https://github.com/grafana/grafana/issues/48070)、[\$148052](https://github.com/grafana/grafana/issues/48052)、[\$148046](https://github.com/grafana/grafana/issues/48046) 和 [\$147978](https://github.com/grafana/grafana/issues/47978)。
+ **已移除 Azure Monitor 查詢** – 不再支援 Application Insights 和 Insight Analytics 查詢。

  在 Grafana 8.0 中已棄用，在 9.0 中已移除。已棄用的查詢將不會執行。

  **必要動作：**請參閱 *Grafana 公有文件中*的 [Azure Monitor 資料來源](https://grafana.com/docs/grafana/latest/datasources/azuremonitor/deprecated-application-insights/)以取得遷移指引。
+ **已移除瀏覽器存取模式** – InfluxDB 和 Prometheus 資料來源不再提供瀏覽器存取模式。

  **必要動作：**在資料來源組態中切換至伺服器存取模式。InfluxDB：在 8.0.0 中已棄用，在 9.2.0 中已移除。請參閱 *GitHub* 上的問題[編號 53529](https://github.com/grafana/grafana/issues/53529)。Prometheus：在 7.4.0 中已棄用，在 9.2.0 中已移除。請參閱 *GitHub* 上的問題[編號 50162](https://github.com/grafana/grafana/issues/50162)。
+ **儀表板設定存取受限** – 編輯面板時，您無法再開啟儀表板設定。

  當面板編輯模式處於作用中狀態時，儀表板設定會鎖定。在存取儀表板設定之前關閉面板編輯模式。請參閱 *GitHub* 上的問題[編號 54746](https://github.com/grafana/grafana/issues/54746)。
+ **資料來源密碼加密** – 不再支援未加密的密碼。

  **必要動作：**使用 `secureJsonData.password`和 `secureJsonData.basicAuthPassword`。先前在 8.1.0 版中已終止。請參閱 *GitHub* 上的問題[編號 49987](https://github.com/grafana/grafana/issues/49987)。
+ **預設資料來源行為** – 預設資料來源選擇不再影響現有的面板。

  預設資料來源僅適用於新的面板。變更預設值不會更新現有的儀表板。先前儲存的面板會保留其資料來源組態。請參閱 *GitHub* 上的問題[編號 45132](https://github.com/grafana/grafana/issues/45132)。
+ **Elasticsearch 間隔屬性已變更** – 已更新 Elasticsearch 7.x 的查詢間隔規格。

  從 `interval`變更為 `fixed_interval` 屬性。提供與 Elasticsearch 8.x 的一致性。大多數查詢不會顯示可見的變更。請參閱 *GitHub* 上的問題[編號 50297](https://github.com/grafana/grafana/issues/50297)。
+ **Elasticsearch 原始文件模式已停止** – 在 Elasticsearch 資料來源中顯示模式變更。

  **必要動作：**請改用**原始資料**模式。請參閱 *GitHub* 上的問題[編號 62236](https://github.com/grafana/grafana/issues/62236)。
+ **Elasticsearch 版本支援** – 不再支援較舊的 Elasticsearch 版本。

  **必要動作：**將 Elasticsearch 升級到 7.10.0 版或更新版本。低於 7.10.0 的版本已過end-of-life 請參閱 *GitHub* 上的問題[編號 48715](https://github.com/grafana/grafana/issues/48715)。
+ **探索 URL 格式已停止** – 精簡探索 URLs 將在未來的版本中移除。

  **必要動作：**更新硬式編碼連結以使用標準 URL 格式。精簡 URLs：`&left=["now-1h","now"...]`。標準 URLs：`&left={"datasource":"test"...}`。請參閱 *GitHub* 上的問題[編號 50873](https://github.com/grafana/grafana/issues/50873)。
+ **GitHub OAuth 顯示變更** – GitHub 名稱和登入顯示已更新。

  GitHub 名稱會顯示為 Grafana 名稱。GitHub 登入會顯示為 Grafana 登入。改善使用者識別清晰度。請參閱 *GitHub* 上的問題[編號 45438](https://github.com/grafana/grafana/issues/45438)。
+ **熱度圖面板實作已更新** – 從 9.1.0 開始，熱度圖面板會使用新的實作。

  大幅改善渲染效能。儲存貯體會放置在合理的邊界 (1 公尺、5 公尺、30 秒） 上。不再支援圓形儲存格。

  **必要動作：**升級後測試您的熱度圖面板。視需要將`useLegacyHeatmapPanel`功能旗標設定為 true，以停用新實作。`?__feature.useLegacyHeatmapPanel=true` 新增至儀表板 URLs進行測試。請參閱 *GitHub* 上的問題[編號 50229](https://github.com/grafana/grafana/issues/50229)。
+ **InfluxDB 後端遷移** – InfluxDB 資料剖析行為已變更。

  InfluxDB 後端遷移功能切換 (`influxdbBackendMigration`) 會因後端處理問題而重新引入。根據預設，InfluxDB 資料會在前端剖析。如果您升級至 9.4.4 並在 InfluxDB 資料上新增轉換，這些面板將無法轉譯。

  **必要動作：**移除受影響的面板並重新建立，或編輯 `panel.json`或 `Time`中的 `time` 欄位`dashboard.json`。請參閱 *GitHub* 上的問題[編號 64842](https://github.com/grafana/grafana/issues/64842)。
+ **日誌訊息格式已更新** – 日誌訊息結構已變更。

  `lvl` 現在是 `level`。現在是 `eror`，現在`dbug`是 `error`和 `debug`。時間戳記精確度增加。選擇不與`oldlog`功能切換 （暫時） 搭配使用。請參閱 *GitHub* 上的問題[編號 47584](https://github.com/grafana/grafana/issues/47584)。
+ **Loki 資料格式最佳化** – Loki 記錄資料使用更有效率的資料框架格式。

  具有**標籤**欄的單一資料影格，而不是單獨的資料影格。探索和記錄面板的運作方式不會變更。其他面板或轉換可能需要調整。

  **必要動作：**使用擷取**欄位轉換將標籤取代為**欄位轉換。 ****請參閱 *GitHub* 上的問題[編號 47153](https://github.com/grafana/grafana/issues/47153)。
+ **NaN 值處理** – 跨 Prometheus 和 Loki 資料來源的一致`NaN`表示。

  `NaN` 值會保留為 ，`NaN`而不是轉換為 `null`。使用者應該大多看不到變更。同時影響儀表板和提醒路徑。請參閱 *GitHub* 上的問題 [\$149475](https://github.com/grafana/grafana/issues/49475) 和 [\$145389](https://github.com/grafana/grafana/issues/45389)。
+ **密碼重設連結失效** – 升級後，現有的密碼重設連結將無法運作。

  升級前傳送的密碼重設連結無效。使用者必須請求新的密碼重設連結。連結會在 2 小時後過期。請參閱 *GitHub* 上的問題[編號 42334](https://github.com/grafana/grafana/issues/42334)。
+ **預留標籤字首** – 保留開頭`grafana_`為 的標籤。

  `grafana_` 可能會覆寫以 開頭的手動設定標籤。目前的預留標籤： `grafana_folder` （包含提醒的資料夾標題）。請參閱 *GitHub* 上的問題[編號 50262](https://github.com/grafana/grafana/issues/50262)。
+ **轉換改進** – 透過 **regex 轉換重新命名**現在支援全域模式。

  全域模式使用 格式 `/<stringToReplace>/g`。有些轉換的行為可能不同。將先前行為的相符字串以正斜線包裝： `(.*)`變成 `/(.*)/`。請參閱 *GitHub* 上的問題[編號 48179](https://github.com/grafana/grafana/issues/48179)。