選取資訊主頁圖表的指標

本文說明如何在自訂資訊主頁上設定圖表,顯示專案收集的時間序列資料。圖表只能顯示數值時間序列資料。如要瞭解如何設定圖表的樣式,請參閱「設定圖表顯示選項」。

選取要顯示的資料

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

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

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

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

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

    您不一定能將監控篩選器轉換為其他介面所需的格式。因此,如果您切換至其他介面,系統可能會捨棄查詢。

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

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

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

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

使用選單建立查詢

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

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

如要使用選單建構查詢,請按照下列步驟操作:

  1. 在 Google Cloud 控制台中,前往「Dashboards」(資訊主頁) 頁面:

    前往「Dashboards」(資訊主頁)

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

  2. 在 Google Cloud 控制台的工具列中,選取您的 Google Cloud 專案。如要進行 App Hub 設定,請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
  3. 執行下列其中一個步驟:

    • 如要建立新的資訊主頁,請選取「建立資訊主頁」
    • 如要更新現有的資訊主頁,請在資訊主頁清單中找到所需資訊主頁,然後選取其名稱。
  4. 按一下工具列中的「新增小工具」圖示

  5. 在「新增小工具」對話方塊中,選取「指標」

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

    1. 在「指標」元素中,展開「選取指標」選單。

      「選取指標」選單包含有助於尋找可用指標類型的功能:

      • 如要尋找特定指標類型,請使用「篩選列」。舉例來說,如果您輸入 util,選單就會只顯示包含 util 的項目。如果項目通過不區分大小寫的「包含」測試,就會顯示。

      • 如要顯示所有指標類型 (包括沒有資料的指標),請按一下「有效」。根據預設,選單只會顯示有資料的指標類型。

    2. 依序從「資源」選單、「指標類別」選單和「指標」選單中選取所需項目,然後按一下「套用」

      舉例來說,如要繪製 Compute Engine 虛擬機器的 CPU 使用率圖表,您可以選取「VM 執行個體」、「執行個體」、「CPU 使用率」,然後點選「套用」

      「資源」選單會列出收集資料的資源。如果指標未針對資源編寫,請選取「未指定」

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

    顯示所選指標的圖表。

    先前的圖表包含的資料多於可以顯示的資料;圖表受限於 50 個可顯示的行。圖表會顯示通知,指出要顯示的資料太多。如要減少資料量,請使用「排序和限制」元素中的欄位。詳情請參閱「顯示離群值」。

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

  7. 選用:新增篩選器來限制要顯示哪些時間序列。下一節將說明篩選選項。

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

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

篩選圖表資料

篩選器可確保圖表只顯示符合某組條件的時間序列。套用篩選器後,圖表上的線條可能會減少,進而提升圖表效能。如要提升圖表的即時回應能力,另一種方法是設定匯總選項,並排序及限制顯示的時間序列數量。詳情請參閱「顯示離群值」。

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

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

依專案 ID 或資源容器篩選時,必須使用等號運算子 (=)。如要依其他標籤篩選,可以使用任何支援的比較子。通常可以篩選指標和資源標籤,以及資源群組

提供多個篩選條件時,對應圖表只會顯示符合「所有」條件 (即邏輯 AND) 的時間序列。

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

  1. 在「篩選器」元素中,按一下「新增篩選器」,然後從選單中選取選項。

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

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

    • 如要直接比較 (=!=),請從選單中選取值,或輸入值並按一下「確定」。您可以輸入 us-central1-a 等值,也可以建立以 starts_withends_with 開頭的篩選器字串。舉例來說,如要顯示任何 us-central1 區域的資料,可以輸入篩選字串 starts_with("us-central1")。如需篩選器字串的詳情,請參閱監控篩選器

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

    • 如要進行規則運算式比較 (=~!=~),請在「值」欄位中輸入 RE2 規則運算式,然後按一下「確定」。 舉例來說,規則運算式 us-central1-.* 符合所有 us-central1 區域。

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

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

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

新增多個篩選器時,請注意下列事項:

  • 您可以多次使用相同的標籤,針對值範圍指定篩選器。

  • 所有篩選條件都必須符合;這就構成了邏輯 AND

如要編輯篩選器的值或比較子,請在篩選器元素上按一下「選單」,進行變更,然後按一下「確定」

如要刪除篩選器,請按一下「取消」

撰寫 PromQL 查詢

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

  1. 在 Google Cloud 控制台中,前往「Dashboards」(資訊主頁) 頁面:

    前往「Dashboards」(資訊主頁)

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

  2. 在 Google Cloud 控制台的工具列中,選取您的 Google Cloud 專案。如要進行 App Hub 設定,請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
  3. 執行下列其中一個步驟:

    • 如要建立新的資訊主頁,請選取「建立資訊主頁」
    • 如要更新現有的資訊主頁,請在所有資訊主頁的清單中找到該資訊主頁,然後選取其名稱。
  4. 按一下工具列中的「新增小工具」圖示

  5. 在「新增小工具」對話方塊中,選取「指標」

  6. 在查詢建構工具窗格的工具列中,選取名稱為  MQL PromQL 的按鈕。

  7. 確認已在「Language」(語言) 切換按鈕中選取「PromQL」。語言切換按鈕位於同一工具列,可供你設定查詢格式。

  8. 選用:停用「自動執行」切換按鈕。

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

    avg(compute_googleapis_com:instance_cpu_utilization)
    

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

  10. 點選「執行查詢」

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

撰寫 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. 執行下列其中一個步驟:

    • 如要建立新的資訊主頁,請選取「建立資訊主頁」
    • 如要更新現有的資訊主頁,請在資訊主頁清單中找到所需資訊主頁,然後選取其名稱。
  4. 按一下工具列中的「新增小工具」圖示

  5. 在「新增小工具」對話方塊中,選取「指標」

  6. 按一下「指標」元素上的「說明」,然後選取「直接篩選模式」

    「指標」和「篩選器」元素會遭到刪除,並建立「篩選器」元素,供您輸入文字。

    如果您在切換至「直接篩選器模式」前選取了資源類型、指標或篩選器,這些設定就會顯示在「篩選器」元素中。

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

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

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

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

選擇圖表資料的顯示方式

選取時間序列資料後,下一步是決定如何顯示該資料。舉例來說,您要顯示每個時間序列,還是要合併時間序列?

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

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

合併時間序列

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

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

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

  • 如要合併時間序列,請在「Aggregation」元素中執行下列操作:

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

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

      函式選單支援常見的代數函式,例如平均值、最小值、最大值和總和。「計算時間序列」選項會計算符合指標和篩選器設定的時間序列數量。百分位數選項 (例如「第 99 個百分位數」) 是根據符合指標和篩選器設定的時間序列得出的統計值。

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

      圖表會重新整理,並顯示每個不重複標籤值組合的時間序列。舉例來說,如要顯示每個區域的時間序列,請將第二個選單設為「zone」

  • 如要設定資料點之間的間距,請按一下 「新增查詢元素」,選取「最小間隔」,然後輸入值。

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

顯示依 user_labels.version 分組的時間序列。

選取多個標籤時,系統會合併所選標籤具有相同值的時間序列。產生的圖表會顯示每個標籤值組合的時間序列。指定標籤的順序不拘。以下螢幕截圖顯示的圖表,是依據 user_labels.versionsystem_labels.machine_image 標籤合併時間序列的結果:

顯示依版本和機器映像檔分組的時間序列。

如圖所示,圖表會為每對標籤值顯示一個時間序列。按照每個標籤組合取得時間序列,表示這項技術建立的資料可能超出單一圖表可顯示的範圍。

顯示所有時間序列

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

對齊資料

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

設定對齊間隔

如要指定合併點的固定時間長度,請按一下查詢窗格中的 「新增查詢元素」,選取「最小間隔」,然後完成對話方塊。

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

下圖顯示特定 Google Cloud 專案中 Compute Engine VM 執行個體的 CPU 使用率。在這張圖片中,「最短間隔」欄位設為 1 minute

使用預設對齊設定的 VM 執行個體 CPU 使用率。

為進行比較,以下螢幕截圖說明將間隔從 1 minute 變更為 5 minutes 的效果:

使用預設值 (5 分鐘對齊週期) 的 VM 執行個體 CPU 使用率。

增加時間範圍後,產生的圖表點數會減少,從每個時間序列 60 個點減少到每個時間序列 10 個點。增加「最小間隔」欄位的值,可合併更多點,對繪製的資料產生平滑效果。

設定校正函式

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

如要指定對齊函式,請執行下列步驟:

  1. 在「Aggregation」(匯總) 元素中,展開第一個選單並選取「Configure aligner」(設定對齊器)。新增「對齊」函式和「分組」元素
  2. 展開「對齊功能」元素並進行選取。

雖然大多數支援的對齊函式都會執行常見的數學函式,但有些函式會執行較複雜的動作:

  • 下一個較舊:如要只保留對齊期間內最新的樣本,請選取「下一個較舊」。這項函式通常用於正常運作時間檢查,如果您只關心最近的值,這是個不錯的選擇。

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

  • 百分位數:如要在折線圖、堆疊面積圖或堆疊長條圖的繪圖類型中顯示分配指標,您必須選取要顯示的分配百分位數。如要指定這個百分位數,可以選取百分位數函式。您可以選取第 5、50、95 和 99 個百分位數。系統會使用校正週期內的所有資料點,計算指定的百分位數,藉此決定校正後的資料點。

    這項函式僅適用於具有分配資料類型的計量和差異指標。

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

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

  • rate:如要將累計或差異指標轉換為計量表指標,請使用這個函式。如果選擇這個函式,您可以將時間序列視為經過轉換,就像使用 delta 函式一樣,然後除以對齊週期。舉例來說,如果原始時間序列的單位是 MiB,對齊週期的單位是秒,則圖表的單位是 MiB/秒。詳情請參閱種類、型別和轉換

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

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

次要匯總項目

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

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

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

  1. 按一下「新增查詢元素」,然後選取「次要匯總」
  2. 設定「次要匯總」元素。

後續步驟