本頁面說明如何使用 PromQL 程式碼編輯器。編輯器可在 Google Cloud 控制台中使用，並提供建議和其他工具，協助您建立有效的 PromQL 查詢。
本頁未涵蓋 PromQL 語言；如需 PromQL 相關資訊，建議您參閱開放原始碼文件。以下資源可協助您快速上手：
存取程式碼編輯器
您可以在 Google Cloud 控制台的下列頁面中存取 PromQL：
- Metrics Explorer
- 建立資訊主頁時新增小工具
如要在使用 Metrics Explorer 時開啟程式碼編輯器，請按照下列步驟操作：
-
前往 Google Cloud 控制台的 leaderboard「Metrics Explorer」頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在查詢建構工具窗格的工具列中，選取名稱為 code MQL 或 code PromQL 的按鈕。
- 確認「Language」切換鈕中已選取「PromQL」。語言切換鈕位於可讓您設定查詢格式的工具列中。
完成查詢後，您可以設定圖例或變更資料顯示方式。如需詳細資訊，請參閱以下頁面：
使用程式碼編輯器
如要使用程式碼編輯器，請在文字欄位中輸入查詢內容，然後點選「Run Query」。
自動完成
當您輸入查詢時，編輯器會顯示一長串語法有效的完成項目。您可以按下 Control+Space 手動顯示自動完成選單，並按下 Escape 關閉選單。
如要瀏覽選項清單，請使用方向鍵。按下 Enter 即可插入所選選項。
如要插入所有可用選項通用的前置字串，請按下 Tab。
尋找與取代
編輯器支援「尋找並取代」功能。如要尋找查詢中的字詞並視需要進行取代，請按下 Control+F (或 Mac 上的 Command+F)。下列螢幕截圖顯示這項功能：
編輯器控制項
編輯器有兩個控制項，可決定與查詢的互動方式。
根據預設，只有在您點選「執行查詢」時，系統才會執行查詢。您可以設定編輯器，讓系統在您輸入內容時自動執行查詢，但這個選項預設為停用。
如要啟用自動執行選項，請使用「自動執行」切換鈕。啟用這個選項後，編輯器的運作方式如下：
- 系統不會顯示「Run Query」按鈕。
- 輸入內容時，系統會持續顯示錯誤訊息。
如果游標位於查詢結尾，但查詢未完成且沒有錯誤，編輯器會在控制列中顯示黃色三角形。如果有空間，系統也會顯示「Incomplete query」文字。
編輯器不會嘗試評估不完整的查詢。
程式碼編輯器和圖表區域之間也有抓握條。使用這個列，變更兩個區域的相對大小。
儲存圖表
儲存圖表的方式取決於建立圖表的內容：
- 透過 Metrics Explorer。
- 建立或編輯自訂資訊主頁時。
儲存 Metrics Explorer 圖表
您可以透過 Metrics Explorer 中的程式碼編輯器，將圖表儲存至自訂資訊主頁。如要儲存圖表，請按照下列步驟操作：
-
前往 Google Cloud 控制台的 leaderboard「Metrics Explorer」頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在查詢建構工具窗格的工具列中，選取名稱為 code MQL 或 code PromQL 的按鈕。
- 確認「Language」切換鈕中已選取「PromQL」。語言切換鈕位於可讓您設定查詢格式的工具列中。
- 在編輯器中輸入您的查詢。
如果您未啟用程式碼編輯器的自動執行選項，請在儲存圖表之前，按一下「Run Query」執行查詢。根據預設，自訂資訊主頁會定期儲存變更。如果您沒有先執行查詢，程式碼編輯器會儲存您上次執行的查詢。
按一下 [Save Chart] (儲存圖表)。
如要繼續儲存圖表，請按照下列步驟操作：
- 為圖表命名，名稱請使用描述性文字。
- 選取新圖表的資訊主頁。
- 按一下對話方塊中的「儲存」。
將圖表儲存至自訂資訊主頁
如要將新圖表儲存至資訊主頁，請按照下列步驟操作：
為圖表命名，名稱請使用描述性文字。
如果您未啟用程式碼編輯器的自動執行選項，請在儲存圖表之前，按一下「Run Query」執行查詢。根據預設，自訂資訊主頁會定期儲存變更。如果您沒有先執行查詢，程式碼編輯器會儲存您上次執行的查詢。
如果您尚未為資訊主頁啟用自動儲存功能，請按一下「Save」(儲存)。
Google Cloud 控制台支援自訂資訊主頁的網頁層級篩選器。這些篩選器支援自訂資訊主頁的 PromQL 圖表。
退出程式碼編輯器
如要不儲存查詢而退出程式碼編輯器，請按一下其他選取器分頁。編輯器中的所有查詢文字都會遭到捨棄，但您可以選擇將查詢文字儲存到剪貼簿。