本文說明如何在自訂資訊主頁上設定圖表,顯示專案收集的時間序列資料。圖表只能顯示數值時間序列資料。如要瞭解如何設定圖表的樣式,請參閱「設定圖表顯示選項」。
選取要顯示的資料
如要設定要在圖表上顯示的時間序列,您可以從選單中選取項目來建構查詢,也可以自行編寫查詢。撰寫查詢時,請選取查詢語言,然後使用查詢編輯器或以文字為基礎的介面:
Prometheus 查詢語言 (PromQL) 查詢會指定時間序列,以及這些時間序列的分組和對齊方式。PromQL 介面支援提供建議的編輯器。
一般來說,PromQL 查詢無法轉換為其他介面可用的表單。切換至 PromQL 分頁或從該分頁切換時,系統會捨棄未儲存的查詢。
監控篩選器查詢會指定時間序列,但不包含分組或對齊陳述式。
Monitoring 篩選器可指定 Monitoring 可繪製成圖表的任何時間序列。舉例來說,如要繪製 VM 上執行的程序數量圖表,您必須使用指定函式的監控篩選器。
您不一定能將監控篩選器轉換為其他介面所需的格式。因此,如果您切換至其他介面,系統可能會捨棄查詢。
查詢通常會指定指標類型、資源類型和篩選器:
指標類型會識別要從資源收集的測量值。當中包含評估項目的說明,以及如何解讀評估結果。指標類型有時也稱為指標。例如「CPU 使用率」。如需概念資訊,請參閱指標類型。
資源類型會指定要從哪個資源擷取指標資料。資源類型有時也稱為受控資源類型或資源。舉例來說,「Compute Engine 虛擬機器 (VM) 執行個體」就是一種資源。如需概念資訊,請參閱「受監控資源」。
PromQL 查詢包含分組和對齊陳述式。不過,當您編寫 Monitoring 篩選器或使用選單選取要繪製圖表的時間序列時,可透過選單設定分組和對齊方式。
使用選單建立查詢
根據預設,您可以使用選單建構查詢。一般來說,如果您選取指標和篩選器,然後切換至其他介面,系統會保留您的選取項目,並重新格式化以適用於該介面。也就是說,透過選單建構的查詢可以轉換為 PromQL 查詢。
如要從其他介面返回選單導向介面,請選取「Builder」tune。不過,系統會捨棄您的查詢。 也就是說,PromQL 查詢無法轉換為對等的選單導向表單。
如要使用選單建構查詢,請按照下列步驟操作:
-
在 Google Cloud 控制台中,前往「Dashboards」(資訊主頁)
頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中,選取您的 Google Cloud 專案。如要進行 App Hub 設定,請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
執行下列其中一個步驟:
- 如要建立新的資訊主頁,請選取「建立資訊主頁」。
- 如要更新現有的資訊主頁,請在資訊主頁清單中找到所需資訊主頁,然後選取其名稱。
按一下工具列中的「新增小工具」圖示 add。
在「新增小工具」對話方塊中,選取「指標」leaderboard。
在查詢窗格的工具列中,執行下列操作:
在「指標」元素中,展開「選取指標」選單。
「選取指標」選單包含有助於尋找可用指標類型的功能:
如要尋找特定指標類型,請使用filter_list「篩選列」。舉例來說,如果您輸入
util
,選單就會只顯示包含util
的項目。如果項目通過不區分大小寫的「包含」測試,就會顯示。如要顯示所有指標類型 (包括沒有資料的指標),請按一下「有效」
。根據預設,選單只會顯示有資料的指標類型。
依序從「資源」選單、「指標類別」選單和「指標」選單中選取所需項目,然後按一下「套用」。
舉例來說,如要繪製 Compute Engine 虛擬機器的 CPU 使用率圖表,您可以選取「VM 執行個體」、「執行個體」、「CPU 使用率」,然後點選「套用」。
「資源」選單會列出收集資料的資源。如果指標未針對資源編寫,請選取「未指定」。
完成上一個步驟後,圖表會顯示可用的時間序列:
先前的圖表包含的資料多於可以顯示的資料;圖表受限於 50 個可顯示的行。圖表會顯示通知,指出要顯示的資料太多。如要減少資料量,請使用「排序和限制」元素中的欄位。詳情請參閱「顯示離群值」。
您也可以使用篩選和匯總選項,減少圖表資料量。這些技巧會使圖表更適於診斷與分析,並且可以增強使用者介面本身的效能與反應能力。
選用:新增篩選器來限制要顯示哪些時間序列。下一節將說明篩選選項。
選用:設定時間序列的分組和對齊方式。詳情請參閱「選擇圖表資料的顯示方式」。
如要將變更套用至資訊主頁,請在工具列中按一下「套用」。如要捨棄變更,請按一下「取消」。
篩選圖表資料
篩選器可確保圖表只顯示符合某組條件的時間序列。套用篩選器後,圖表上的線條可能會減少,進而提升圖表效能。如要提升圖表的即時回應能力,另一種方法是設定匯總選項,並排序及限制顯示的時間序列數量。詳情請參閱「顯示離群值」。
篩選器由標籤、比較器和值組成。舉例來說,如要比對 zone
標籤開頭為 "us-central1"
的所有時間序列,可以使用 zone=~"us-central1.*"
篩選器,該篩選器會使用規則運算式執行比較。比較子運算子有四種:
- 等於
=
- 不等於,
!=
- 規則運算式比對,
=~
- 規則運算式不相符,
!=~
依專案 ID 或資源容器篩選時,必須使用等號運算子 (=)
。如要依其他標籤篩選,可以使用任何支援的比較子。通常可以篩選指標和資源標籤,以及資源群組。
提供多個篩選條件時,對應圖表只會顯示符合「所有」條件 (即邏輯 AND
) 的時間序列。
如要在 Google Cloud 控制台使用選單型介面時新增篩選器,請按照下列步驟操作:
在「篩選器」元素中,按一下「新增篩選器」,然後從選單中選取選項。
如要變更比較項目,請從「比較器」選單中選取值。
在「值」欄位中輸入或選取值:
如要直接比較 (
=
或!=
),請從選單中選取值,或輸入值並按一下「確定」。您可以輸入us-central1-a
等值,也可以建立以starts_with
或ends_with
開頭的篩選器字串。舉例來說,如要顯示任何us-central1
區域的資料,可以輸入篩選字串starts_with("us-central1")
。如需篩選器字串的詳情,請參閱監控篩選器。由於選單項目是從收到的時間序列衍生而來,因此當受監控資源未產生所選指標的資料時,您必須輸入標籤的值。
如要進行規則運算式比較 (
=~
或!=~
),請在「值」欄位中輸入 RE2 規則運算式,然後按一下「確定」。 舉例來說,規則運算式us-central1-.*
符合所有us-central1
區域。如要比對以「a」結尾的任何美國區域,可以使用
^us.*.a$
這個規則運算式。您無法使用規則運算式篩選
project_id
資源標籤。舉例來說,如要只查看其中一個
us-central1
區域的時序資料,請套用zone=~"us-central1.*"
篩選器。
新增多個篩選器時,請注意下列事項:
您可以多次使用相同的標籤,針對值範圍指定篩選器。
所有篩選條件都必須符合;這就構成了邏輯
AND
。
如要編輯篩選器的值或比較子,請在篩選器元素上按一下「選單」arrow_drop_down,進行變更,然後按一下「確定」。
如要刪除篩選器,請按一下「取消」cancel。
撰寫 PromQL 查詢
如要輸入 PromQL 查詢,請按照下列步驟操作:
-
在 Google Cloud 控制台中,前往「Dashboards」(資訊主頁)
頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中,選取您的 Google Cloud 專案。如要進行 App Hub 設定,請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
執行下列其中一個步驟:
- 如要建立新的資訊主頁,請選取「建立資訊主頁」。
- 如要更新現有的資訊主頁,請在所有資訊主頁的清單中找到該資訊主頁,然後選取其名稱。
按一下工具列中的「新增小工具」圖示 add。
在「新增小工具」對話方塊中,選取「指標」leaderboard。
在查詢建構工具窗格的工具列中,選取名稱為 code MQL 或 code PromQL 的按鈕。
確認已在「Language」(語言) 切換按鈕中選取「PromQL」。語言切換按鈕位於同一工具列,可供你設定查詢格式。
選用:停用「自動執行」切換按鈕。
在查詢編輯器中輸入查詢。舉例來說,如要繪製 Google Cloud 專案中 VM 執行個體的平均 CPU 使用率圖表,請使用下列查詢:
avg(compute_googleapis_com:instance_cpu_utilization)
如要進一步瞭解如何使用 PromQL,請參閱「在 Cloud Monitoring 中使用 PromQL」。
點選「執行查詢」
啟用「自動執行」切換按鈕後,系統不會顯示「執行查詢」按鈕。
撰寫 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 篩選條件,請按照下列步驟操作:
-
在 Google Cloud 控制台中,前往「Dashboards」(資訊主頁)
頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中,選取您的 Google Cloud 專案。如要進行 App Hub 設定,請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
執行下列其中一個步驟:
- 如要建立新的資訊主頁,請選取「建立資訊主頁」。
- 如要更新現有的資訊主頁,請在資訊主頁清單中找到所需資訊主頁,然後選取其名稱。
按一下工具列中的「新增小工具」圖示 add。
在「新增小工具」對話方塊中,選取「指標」leaderboard。
按一下「指標」元素上的「說明」help_outline,然後選取「直接篩選模式」。
「指標」和「篩選器」元素會遭到刪除,並建立「篩選器」元素,供您輸入文字。
如果您在切換至「直接篩選器模式」前選取了資源類型、指標或篩選器,這些設定就會顯示在「篩選器」元素中。
在「Filters」(篩選條件) 元素的文字區域中,輸入 Monitoring 篩選條件運算式。如需語法資訊,請參閱下列文件:
如果使用直接篩選模式,但沒有符合篩選條件的資料,系統就會顯示錯誤。常見的錯誤訊息包括
Chart definition invalid
和No data is available for the selected timeframe.
選用:設定時間序列的分組和對齊方式。詳情請參閱「選擇圖表資料的顯示方式」。
如要返回選單導向介面,請按一下 tune「離開直接篩選器模式」。
選擇圖表資料的顯示方式
選取時間序列資料後,下一步是決定如何顯示該資料。舉例來說,您要顯示每個時間序列,還是要合併時間序列?
本節說明如何設定彙整欄位。匯總作業包括校正時間序列中的資料點,以及合併不同的時間序列。如需匯總的詳細說明,請參閱「篩選和匯總:操控時間序列」。
如果您已選取要使用 PromQL 繪製圖表的資料,本節內容就不適用。
合併時間序列
您可以結合不同的時間序列,藉此減少傳回的指標資料量。如要合併多個時間序列,通常需要指定一或多個標籤和函式。系統會將指定標籤值相同的所有時間序列分組,然後使用您指定的函式,將這些時間序列合併為新的時間序列。
彙整元素中的設定可以變更圖表顯示的時間序列數量。這個元素的預設設定取決於您選取的指標類型。如要修改顯示方式,請執行下列任一操作:
如要顯示每個時間序列,請在「Aggregation」(匯總) 元素中,確認第一個選單設為「Unaggregated」(未匯總),第二個選單設為「None」(無)。
如要合併時間序列,請在「Aggregation」元素中執行下列操作:
展開第一個選單,然後選取函式。
圖表會重新整理,並顯示單一時間序列。舉例來說,如果選取「平均值」,顯示的時間序列就是所有時間序列的平均值。
函式選單支援常見的代數函式,例如平均值、最小值、最大值和總和。「計算時間序列」選項會計算符合指標和篩選器設定的時間序列數量。百分位數選項 (例如「第 99 個百分位數」) 是根據符合指標和篩選器設定的時間序列得出的統計值。
如要合併具有相同標籤值的時間序列,請展開第二個選單,然後選取一或多個標籤。
圖表會重新整理,並顯示每個不重複標籤值組合的時間序列。舉例來說,如要顯示每個區域的時間序列,請將第二個選單設為「zone」。
如要設定資料點之間的間距,請按一下 add「新增查詢元素」,選取「最小間隔」,然後輸入值。
舉例來說,如果您將函式設為「總和」,並選取標籤 user_labels.version,則標籤 user_labels.version 的每個值都會有一個時間序列。每個時間序列中的資料點,都是根據特定版本個別時間序列的所有值總和計算而來:
選取多個標籤時,系統會合併所選標籤具有相同值的時間序列。產生的圖表會顯示每個標籤值組合的時間序列。指定標籤的順序不拘。以下螢幕截圖顯示的圖表,是依據 user_labels.version 和 system_labels.machine_image 標籤合併時間序列的結果:
如圖所示,圖表會為每對標籤值顯示一個時間序列。按照每個標籤組合取得時間序列,表示這項技術建立的資料可能超出單一圖表可顯示的範圍。
顯示所有時間序列
如要顯示所有時間序列,請在「Aggregation」(匯總) 元素上,將第一個選單設為「Unaggregated」(未匯總),第二個選單設為「None」(無)。
對齊資料
校正程序是將 Monitoring 收到的時間序列資料,轉換為資料點間隔固定的新時間序列。校正程序包含收集在固定時間長度內收到的所有資料點、套用函式來結合這些資料點,以及為結果指派時間戳記。該函式可能會計算所有樣本的平均值,也可能會擷取所有樣本的最大值。
設定對齊間隔
如要指定合併點的固定時間長度,請按一下查詢窗格中的 add「新增查詢元素」,選取「最小間隔」,然後完成對話方塊。
舉例來說,假設某項指標的取樣週期為一分鐘,如果圖表設定為顯示 1 小時的資料,則圖表可以顯示所有 60 個資料點。如果「Min Interval」(最小間隔) 欄位設為 10 minutes
,圖表會顯示 6 個資料點。不過,如果您現在將圖表設定為顯示一週的資料,圖表中就會有太多點要顯示,因此系統會自動修改合併點的間隔。在這個範例中,修改後的間隔為一小時。
下圖顯示特定 Google Cloud 專案中 Compute Engine VM 執行個體的 CPU 使用率。在這張圖片中,「最短間隔」欄位設為 1 minute
:
為進行比較,以下螢幕截圖說明將間隔從 1 minute
變更為 5 minutes
的效果:
增加時間範圍後,產生的圖表點數會減少,從每個時間序列 60 個點減少到每個時間序列 10 個點。增加「最小間隔」欄位的值,可合併更多點,對繪製的資料產生平滑效果。
設定校正函式
選取匯總函式時,Cloud Monitoring 會為您選取對齊函式。Cloud Monitoring 會根據您選取的指標類型和匯總函式,決定最佳的對齊函式。不過,您可以指定對齊函式,並覆寫 Cloud Monitoring 所做的選擇。
如要指定對齊函式,請執行下列步驟:
- 在「Aggregation」(匯總) 元素中,展開第一個選單並選取「Configure aligner」(設定對齊器)。新增「對齊」函式和「分組」元素。
- 展開「對齊功能」元素並進行選取。
雖然大多數支援的對齊函式都會執行常見的數學函式,但有些函式會執行較複雜的動作:
下一個較舊:如要只保留對齊期間內最新的樣本,請選取「下一個較舊」。這項函式通常用於正常運作時間檢查,如果您只關心最近的值,這是個不錯的選擇。
這項函式僅適用於計量表指標。
百分位數:如要在折線圖、堆疊面積圖或堆疊長條圖的繪圖類型中顯示分配指標,您必須選取要顯示的分配百分位數。如要指定這個百分位數,可以選取百分位數函式。您可以選取第 5、50、95 和 99 個百分位數。系統會使用校正週期內的所有資料點,計算指定的百分位數,藉此決定校正後的資料點。
這項函式僅適用於具有分配資料類型的計量和差異指標。
delta:如要將累計指標或 delta 指標轉換為 delta 指標,且每個對齊週期有一個樣本,請使用這個函式。使用這項函式時,可能會發生資料插補情形。 如需範例,請參閱「種類、型別和轉換」。
這項函式僅適用於累計和差異指標。
rate:如要將累計或差異指標轉換為計量表指標,請使用這個函式。如果選擇這個函式,您可以將時間序列視為經過轉換,就像使用 delta 函式一樣,然後除以對齊週期。舉例來說,如果原始時間序列的單位是 MiB,對齊週期的單位是秒,則圖表的單位是 MiB/秒。詳情請參閱種類、型別和轉換。
這項函式僅適用於累計和差異指標。
如要進一步瞭解可用的對齊函式,請參閱 API 參考資料中的 Aligner
。
次要匯總項目
如果您有多個已經代表匯總的時間序列,可以選擇「Secondary Aggregator」(次要匯總函式),將圖表上的所有時間序列縮減為單一時間序列。舉例來說,如果依區域分組資料,圖表會顯示每個區域的時間序列。如要建立含有單一時間序列的圖表,請使用次要匯總欄位。
部分指標類型可選擇轉換資料。如果這個選項可用,且您將「轉換」欄位設為「無」以外的值,則所有其他欄位都是次要匯總設定。
如果可設定次要匯總欄位,請按照下列步驟存取這些欄位:
- 按一下「新增查詢元素」add,然後選取「次要匯總」。
- 設定「次要匯總」元素。