選取要在資訊主頁圖表中顯示的指標

如要控管 Cloud Monitoring 自訂資訊主頁上的圖表顯示哪些時間序列，以及如何合併這些時間序列，您可以選取數值指標類型，並設定篩選、對齊和分組選項。如要瞭解如何自訂圖表的視覺樣式，請參閱「設定圖表顯示選項」。

選取要顯示的資料

如要設定要在圖表上顯示的時間序列，您可以從選單中選取項目來建立查詢，也可以自行編寫查詢。編寫查詢時，請選取查詢語言，然後使用查詢編輯器或文字介面：

• Prometheus 查詢語言 (PromQL) 查詢會指定時間序列，以及這些時間序列的分組和對齊方式。PromQL 介面支援提供建議的編輯器。

  一般來說，PromQL 查詢無法轉換為其他介面可使用的形式。切換至 PromQL 分頁或從該分頁切換至其他分頁時，系統會捨棄未儲存的查詢。

• Monitoring 篩選器查詢會指定時間序列，但不包含分組或對齊陳述式。

  您可以使用 Monitoring 篩選器，指定 Monitoring 可繪製成圖表的任何時間序列。舉例來說，如要繪製 VM 上執行的程序數量圖表，您必須使用指定函式的 Monitoring 篩選器。

  Monitoring 篩選器不一定能轉換成其他介面所需的格式。因此，如果切換至其他介面，查詢可能會遭到捨棄。

查詢通常會指定指標類型、資源類型和篩選器：

• 「指標類型」可識別要從資源收集的測量結果。其中包含評估項目的說明，以及評估結果的解讀方式。「指標類型」有時也稱為「指標」。「CPU 使用率」就是指標的一例。如需概念資訊，請參閱「指標類型」。

• 「資源類型」會指定擷取指標資料的來源資源。「資源類型」有時稱為「受監控資源類型」或「資源」。「Compute Engine 虛擬機器 (VM) 執行個體」就是資源的一例。如需概念資訊，請參閱「受監控資源」。

• 篩選器可讓您從查詢結果中移除不符合特定條件 (例如資源類型或標籤值) 的資料。

  建議您盡可能篩選受監控資源類型上定義的標籤，而非指標類型上定義的標籤，尤其是查詢高基數指標時。如果資源標籤和指標標籤擷取的資訊相似，請在查詢中使用資源標籤。

  舉例來說，如果受監控資源包含 cluster 標籤，而指標包含擷取類似資訊的 kubernetes_cluster_name 標籤，請篩選資源 cluster 標籤。

PromQL 查詢包含分組和對齊陳述式。不過，當您編寫 Monitoring 篩選器或使用選單選取要繪製圖表的時間序列時，您可以使用選單設定分組和對齊設定。

注意： Google Cloud 控制台只能顯示數值資料。如要擷取類型為 String 的指標，請使用 API 中的方法，例如 timeSeries.list。

使用選單建構查詢

使用選單建立查詢是預設設定。一般來說，如果您選取指標和篩選器，然後切換至其他介面，系統會保留所選項目，並針對該介面重新設定格式。也就是說，透過選單建構的查詢可以轉換為 PromQL 查詢。

如要從其他介面返回選單導向介面，請選取「 Builder」。不過，系統會捨棄您的查詢。 也就是說，PromQL 查詢無法轉換為等效的選單導向表單。

如要使用選單建立查詢，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「 Dashboards」頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主專案或管理專案。

3. 執行下列其中一個步驟：

   • 如要建立新的資訊主頁，請選取「Create dashboard」(建立資訊主頁)。
   • 如要更新現有資訊主頁，請在資訊主頁清單中找到該資訊主頁，然後選取其名稱。

4. 在工具列中，按一下「 新增小工具」。

5. 在「Add widget」(新增小工具) 對話方塊中，選取 「Metric」(指標)。

6. 在查詢窗格的工具列中，執行下列操作：

   1. 在「Metric」(指標) 元素中，展開「Select a metric」(選取指標) 選單。

      「Select a metric」(選取指標) 選單包含多項功能，可協助您找出可用的指標類型：

      • 如要尋找特定指標類型，請使用「Filter bar」(篩選列)。舉例來說，如果輸入 util，選單就只會顯示包含 util 的項目。如果項目通過不區分大小寫的「包含」測試，就會顯示。
      • 如要顯示所有指標類型 (包括沒有資料的指標類型)，請按一下 「Active」(有效)。根據預設，選單只會顯示含有資料的指標類型。

   2. 從「Resources」(資源) 選單、「Metric categories」(指標類別) 選單和「Metrics」(指標) 選單中選取所需項目，然後按一下「Apply」(套用)。

      舉例來說，如要繪製 Compute Engine 虛擬機器的 CPU 使用率圖表，您可以依序選取「VM instance」(VM 執行個體)、「Instance」(執行個體)、「CPU utilization」(CPU 使用率)，然後點選「Apply」(套用)。

      「Resources」(資源) 選單會列出收集資料的資源。如果指標未寫入資源，請選取「Unspecified」(未指定)。

   完成上一個步驟後，圖表會顯示可用的時間序列：

   

   前一個圖表包含的資料超過可顯示的數量；圖表最多只能顯示 50 條線。圖表會顯示通知，指出資料過多，無法顯示。如要減少資料量，請使用「Sort & limit」(排序和限制) 元素中的欄位。詳情請參閱「顯示離群值」。

   您也可以使用篩選和匯總選項，減少圖表中的資料量。這些技巧會使圖表更適於診斷與分析，並且可以增強使用者介面本身的效能與反應能力。

7. 選用：新增篩選器，限制要顯示的時間序列。下一節將說明篩選選項。

8. 選用：設定時間序列的分組和對齊方式。詳情請參閱「選擇圖表資料的顯示方式」。

9. 如要將變更套用至資訊主頁，請按一下工具列中的「Apply」(套用)。如要捨棄變更，請按一下「取消」。

篩選圖表資料

篩選器可確保只有符合一組條件的時間序列才會繪製成圖表。套用篩選器後，圖表中的線條數量可能會減少，進而提升圖表效能。另一個提高圖表回應速度的方法，是設定匯總選項，以及排序和限制顯示的時間序列數量。詳情請參閱「顯示離群值」。

篩選器由標籤、比較運算子和值組成。舉例來說，如要比對 zone 標籤開頭為 "us-central1" 的所有時間序列，可以使用篩選器 zone=~"us-central1.*"，透過規則運算式執行比較。比較運算子有四種：

• 等於 =
• 不等於，!=
• 規則運算式比對，=~
• 規則運算式不相符，!=~

依專案 ID 或資源容器篩選時，必須使用等號運算子 (=)。依其他標籤篩選時，則可使用任何支援的比較運算子。一般來說，您可以篩選指標和資源標籤，以及資源群組。

如果提供多個篩選條件，對應的圖表只會顯示符合「所有」條件的時間序列，也就是邏輯 AND。

如要在使用 Google Cloud 控制台的選單型介面時新增篩選器，請按照下列步驟操作：

1. 在「Filter」(篩選器) 元素中，按一下「Add filter」(新增篩選器)，然後從選單中選取所需選項。

   選單只會列出專案中現有資源的使用者中繼資料標籤，例如 user_labels。如要依已刪除資源的標籤篩選，請編寫 PromQL 查詢或 Monitoring 篩選器查詢。

2. 如要變更比較項目，請從「比較子」選單中選取值。

3. 在「值」欄位中，輸入或選取值：

   • 如要直接比較 = 或 !=，請從選單中選取值，或輸入值，然後按一下「Ok」。您可以輸入 us-central1-a 等值，也可以建立開頭為 starts_with 或 ends_with 的篩選器字串。舉例來說，如要顯示任何 us-central1 區域的資料，可以輸入篩選器字串 starts_with("us-central1")。如要進一步瞭解篩選器字串，請參閱「Monitoring 篩選器」。

     選單項目是從接收到的時間序列衍生而來，因此當受監控資源未產生所選指標的資料時，您必須輸入標籤值。

   • 如要進行規則運算式比較 (=~ 或 !=~)，請在「Value」(值) 欄位中輸入 RE2 規則運算式，然後按一下「Ok」(確定)。例如，規則運算式 us-central1-.* 會比對所有 us-central1 區域。

     如要比對任何以「a」結尾的美國可用區，可以使用規則運算式 ^us.*.a$。

     您無法使用規則運算式篩選 project_id 資源標籤。

     舉例來說，如要只查看其中一個 us-central1 區域的時間序列，請套用 zone=~"us-central1.*" 篩選器。

新增多個篩選器時，請注意下列事項：

• 您可以多次使用同一個標籤，為一系列的值指定篩選條件。

• 必須符合所有篩選條件，這些條件構成邏輯 AND。

如要編輯篩選器的值或比較運算子，請在篩選器元素上按一下「Menu」(選單) 圖示 ，進行變更，然後按一下「Ok」(確定)。

如要刪除篩選器，請按一下 「Cancel」(取消)。

編寫 PromQL 查詢

如要輸入 PromQL 查詢，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「 Dashboards」頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主專案或管理專案。

3. 執行下列其中一個步驟：

   • 如要建立新的資訊主頁，請選取「Create dashboard」(建立資訊主頁)。
   • 如要更新現有資訊主頁，請在所有資訊主頁清單中找到該資訊主頁，然後選取其名稱。

4. 在工具列中，按一下「 新增小工具」。

5. 在「Add widget」(新增小工具) 對話方塊中，選取 「Metric」(指標)。

6. 在查詢建立工具窗格的工具列中，選取名為 「PromQL」PromQL的按鈕。

7. 選用：停用「自動執行」切換鈕。

8. 在查詢編輯器中輸入查詢。舉例來說，如要繪製 Google Cloud 專案中 VM 執行個體的平均 CPU 使用率圖表，請使用下列查詢：

   avg(compute_googleapis_com:instance_cpu_utilization)
   

   如要進一步瞭解如何使用 PromQL，請參閱「Cloud Monitoring 中的 PromQL」。

9. 點選「執行查詢」。

   啟用「自動執行」切換鈕後，系統不會顯示「執行查詢」按鈕。

編寫 Monitoring 篩選器查詢

如要執行下列任一操作，請務必使用直接篩選器模式，以便輸入 Monitoring 篩選器：

• 顯示服務水準目標 (SLO)。
• 顯示虛擬機器 (VM) 上執行的程序數量。
• 顯示尚未有資料的自訂指標。
• 根據尚未有資料的標籤篩選時間序列。

「Monitoring 篩選器」(或「指標篩選器」) 是 Monitoring 用來識別要繪製成圖表的時間序列的運算式。舉例來說，下列運算式會產生圖表，顯示名稱包含 nginx 的程序數量：

select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
resource.type="gce_instance"

您也可以使用 Monitoring 篩選器，依資源和指標類型找出時間序列。下列運算式會產生圖表，顯示 us-east1-b 區域中所有 Google Cloud 虛擬機器執行個體的記錄項目數量：

metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance"
resource.label."zone"="us-east1-b"

如要輸入 Monitoring 篩選器，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「 Dashboards」頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主專案或管理專案。

3. 執行下列其中一個步驟：

   • 如要建立新的資訊主頁，請選取「Create dashboard」(建立資訊主頁)。
   • 如要更新現有資訊主頁，請在資訊主頁清單中找到該資訊主頁，然後選取其名稱。

4. 在工具列中，按一下「 新增小工具」。

5. 在「Add widget」(新增小工具) 對話方塊中，選取 「Metric」(指標)。

6. 按一下「Metric」(指標) 元素上的 「Help」(說明)，然後選取「Direct Filter Mode」(直接篩選模式)。

   「Metric」(指標) 和「Filter」(篩選器) 元素會刪除，並建立可輸入文字的「Filters」(篩選器) 元素。

   如果您在切換至「Direct Filter Mode」(直接篩選器模式) 之前，已選取資源類型、指標或篩選器，這些設定會顯示在「Filters」(篩選器) 元素中。

7. 在「Filters」(篩選器) 元素的文字區域中，輸入 Monitoring 篩選運算式。如需語法資訊，請參閱下列文件：

   • Monitoring 篩選器
   • 程序健康狀態篩選器
   • 擷取服務等級目標資料

   使用直接篩選模式時，如果沒有符合篩選條件的資料，系統會顯示錯誤。常見的錯誤訊息包括 Chart definition invalid 和 No data is available for the selected timeframe.

8. 選用：設定時間序列的分組和對齊方式。詳情請參閱「選擇圖表資料的顯示方式」。

如要返回選單導向介面，請按一下「 離開直接篩選器模式」。

注意： 如果您輸入 Monitoring 篩選器，然後切換至其他介面，系統會捨棄 Monitoring 篩選器。

選擇圖表資料的顯示方式

選取時間序列資料後，下一步是決定資料的顯示方式。例如，您要顯示每個時間序列，還是要合併時間序列？

本節說明如何設定匯總欄位。匯總包含校正時間序列中的資料點，以及合併不同的時間序列。如需匯總的詳細說明，請參閱「篩選和匯總：操控時間序列」。

• 如要瞭解檢視選項，請參閱「設定圖表顯示選項」。
• 如要進一步瞭解如何與圖表互動，請參閱「探索圖表資料」。

如果您已使用 PromQL 選取要繪製圖表的資料，則不適用本節內容。

合併時間序列

您可以合併不同的時間序列，減少指標傳回的資料量。如要合併多個時間序列，通常需要指定一或多個標籤和函式。系統會將所有指定標籤值相同的時間序列分組，然後使用您指定的函式，將這些時間序列合併為新的時間序列。

Aggregation 元素中的設定可以變更圖表顯示的時間序列數量。這個元素的預設設定取決於您選取的指標類型。如要修改顯示方式，請執行下列任一操作：

• 如要顯示所有時間序列，請在「Aggregation」(匯總) 元素中，確認第一個選單設為「Unaggregated」(未匯總)，第二個選單設為「None」(無)。

• 如要合併時間序列，請在「Aggregation」(匯總) 元素中執行下列操作：

  1. 展開第一個選單，然後選取函式。

     圖表會重新整理，並顯示單一時間序列。舉例來說，如果選取「Mean」(平均值)，顯示的時間序列會是所有時間序列的平均值。

     函式選單支援常見的代數函式，例如平均值、最小值、最大值和總和。「Count time series」(計算時間序列) 選項會計算符合指標和篩選器設定的時間序列數量。百分位數選項 (例如「99th percentile」(第 99 個百分位數)) 是從符合指標和篩選器設定的時間序列中衍生的統計值。

  2. 如要合併具有相同標籤值的時間序列，請展開第二個選單，然後選取一或多個標籤。

     圖表會重新整理，並針對每個不重複的標籤值組合顯示一個時間序列。舉例來說，如要依可用區顯示時間序列，請將第二個選單設為「zone」(可用區)。

• 如要設定資料點之間的間距，請按一下 「Add query element」(新增查詢元素)，選取「Min Interval」(最小間隔)，然後輸入值。

舉例來說，如果您將函式設為「Sum」，並選取標籤 user_labels.version，則標籤 user_labels.version 的每個值都會有一個時間序列。每個時間序列中的資料點，都是根據特定版本個別時間序列的所有值總和計算得出：

如果選取多個標籤，系統會合併所選標籤值相同的時間序列。產生的圖表會針對每個標籤值組合顯示一個時間序列。標籤的指定順序不拘。下列螢幕截圖顯示的圖表，是依 user_labels.version 和 system_labels.machine_image 標籤合併時間序列：

如圖所示，圖表會為每組標籤值顯示一個時間序列。由於您會為每個標籤組合取得時間序列，因此這項技術建立的資料量，可能會超過您在單一圖表上能有效呈現的資料量。

顯示所有時間序列

如要顯示所有時間序列，請在「Aggregation」(匯總) 元素中，將第一個選單設為「Unaggregated」(未匯總)，並將第二個選單設為「None」(無)。

對齊資料

校正程序會將 Monitoring 收到的時間序列資料，轉換為資料點間隔固定的新時間序列。校正程序包括收集在固定時間長度內收到的所有資料點、套用函式來合併這些資料點，以及為結果指派時間戳記。該函式可能會計算所有樣本的平均值，或擷取所有樣本的最大值。

設定對齊間隔

如要指定合併資料點的固定時間長度，請按一下查詢窗格中的「 Add query element」(新增查詢元素)，選取「Min Interval」(最短間隔)，然後完成對話方塊。

舉例來說，假設某項指標的取樣週期為一分鐘。如果圖表設定為顯示 1 小時的資料，則圖表可以顯示所有 60 個資料點。如果「Min Interval」(最小間隔) 欄位設為 10 minutes，圖表會顯示 6 個資料點。不過，如果將圖表設為顯示一週的資料，圖表中的資料點就會過多，因此系統會自動修改合併資料點的時間間隔。在這個範例中，修改後的間隔為一小時。

以下螢幕截圖顯示特定 Google Cloud 專案中 Compute Engine VM 執行個體的 CPU 使用率。在下圖中，「Min Interval」(最短間隔) 欄位設為 1 minute：

為方便比較，以下螢幕截圖說明將間隔從 1 minute 變更為 5 minutes 的效果：

增加週期後，產生的圖表點數會減少，從每個時間序列 60 點減少到 10 點。增加「Min Interval」(最短間隔) 欄位的值，可合併更多資料點，讓繪製的資料更平滑。

設定校正函式

選取匯總函式時，Cloud Monitoring 會為您選取校正函式。Cloud Monitoring 會根據您選取的指標類型和匯總函式，決定最佳的校正函式。不過，您可以指定對齊函式，覆寫 Cloud Monitoring 的選擇。

如要指定對齊函式，請按照下列步驟操作：

1. 在「Aggregation」(匯總) 元素中，展開第一個選單，然後選取「Configure aligner」(設定校準器)。校正函式和分組元素已新增。
2. 展開「Alignment function」(校正函式) 元素，然後選取所需選項。

雖然大多數支援的對齊函式會執行常見的數學函式，但有些會執行更複雜的操作：

• next older：如要僅保留對齊週期內最新的樣本，請選取「next older」。這個函式通常與運作時間檢查搭配使用，如果您只關心最新值，這個函式是不錯的選擇。

  這項函式僅適用於量測計指標。

• 百分位數：如要在折線圖、堆疊面積圖或堆疊長條圖的圖表類型上顯示分布指標，您必須選取要顯示的分布百分位數。指定這個百分位數的方法之一，是選取百分位數函式。您可以選取第 5、50、95 和 99 個百分位數。系統會使用對齊週期內的所有資料點，計算指定的百分位數，藉此決定對齊資料點。

  這個函式僅適用於具有分布資料類型的量測指標和差異指標。

• delta：如要將累計指標或 delta 指標轉換為每個對齊週期有一個樣本的 delta 指標，請使用這個函式。使用這項函式時，可能會發生資料內插。如需範例，請參閱「種類、類型和轉換」。

  這個函式僅適用於累計和差異指標。

• rate：如要將累計或 delta 指標轉換為量測指標，請使用這個函式。如果選擇這個函式，可以將時間序列視為使用 delta 函式轉換，然後除以對齊週期。舉例來說，如果原始時間序列的單位是 MiB，而對齊週期的單位是秒，則圖表的單位是每秒 MiB。詳情請參閱「種類、類型和轉換」。

  這個函式僅適用於累計和差異指標。

如要進一步瞭解可用的對齊函式，請參閱 API 參考資料中的 Aligner。

次要匯總項目

如果有多個時間序列已代表匯總，您可以選擇「Secondary Aggregator」(次要匯總工具)，將圖表上的所有時間序列縮減為單一時間序列。舉例來說，如果依可用區分組資料，圖表會顯示每個可用區的時間序列。如要建立含有單一時間序列的圖表，請使用次要匯總欄位。

某些指標類型可選擇轉換資料。如果這個選項可用，且您將「Transform」(轉換) 欄位設為「None」(無) 以外的值，則所有其他欄位都是次要匯總設定。

如果可以設定次要匯總欄位，請按照下列步驟存取這些欄位：

1. 按一下 「Add query element」(新增查詢元素)，然後選取「Secondary aggregation」(次要匯總)。
2. 設定「Secondary aggregation」(次要匯總) 元素。

後續步驟

• 探索圖表資料
• 使用者定義指標總覽
• 設定圖例欄名稱
• 設定圖表顯示選項