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