排解圖表問題

如要解決 Cloud Monitoring 中圖表和資訊主頁小工具的錯誤訊息或非預期結果，您可以調整查詢、對齊週期和權限，確保遙測資料準確呈現。本文有助於診斷 Metrics Explorer 和自訂資訊主頁的常見問題，包括資料缺口、時間序列顯示限制、Y 軸單位不符，以及小工具設定錯誤。

圖表錯誤

本節說明設定圖表時可能出現的錯誤。您可以使用 Metrics Explorer 設定圖表，或將圖表新增至資訊主頁。

圖表資料缺漏

圖表有時會出現資料缺漏。舉例來說，以下螢幕截圖說明指標 loadbalancing.googleapis.com/https/total_latencies 的這項行為：

範例：圖表中的值有間隙。

如果資料寫入頻率極低，就可能出現資料缺口。Cloud Monitoring 會透過取樣收集指標，如果資料非常稀疏，收集樣本時可能不會有任何可用資料。舉例來說，如果每秒查詢次數 (QPS) 為 0.05 或更低，負載平衡器指標可能會出現缺口。當查詢率提高時，間隔就會消失。

您可以增加對齊間隔，移除視覺上的落差。當系統產生新的時間序列，且資料點間隔規律時，會使用對齊間隔來判斷要合併原始資料點的時間範圍。詳情請參閱「對齊：序列內正規化」。

如要設定最小對齊時間間隔，請編輯圖表的查詢。舉例來說，使用 Metrics Explorer 時，請前往查詢窗格，然後選取「 Add query element」(新增查詢元素)。在選單中選取「Min Interval」(最小間隔)，然後選取時間間隔。

修改日期範圍時，對齊週期會變更

您在資訊主頁中新增圖表。變更資訊主頁或圖表的日期範圍時，有時對齊週期也會隨之變更。舉例來說，如果您將時間範圍從一小時變更為兩小時，對齊週期會列為 1 minute interval。不過，如果將日期範圍從一小時改為一天，對齊週期就會顯示為 5 minute interval。

這是正常現象。

圖表可顯示的資料點數量有限。因此，如果所選日期範圍的資料點數量超過顯示上限，監控服務會自動修改對齊設定，減少顯示的資料點數量。

圖表未顯示所有時間序列

您設定了圖表，但圖表未顯示所有時間序列。

基於效能考量，圖表最多只會顯示 50 個時間序列。

設定圖表時，如果可用的時間序列超過 50 個，圖表會限制顯示的時間序列數量，並在工具列中加入一個帶有紅點的圖示。圖示的工具提示會顯示下列訊息：

To improve performance, we've limited the time series displayed in this chart.

如要顯示所有時間序列，請展開工具提示，然後選取標示為「Show All Time Series」(顯示所有時間序列) 的按鈕。

圖表未顯示任何資料

設定圖表後，圖表顯示錯誤訊息，而非資料：

  • 如果圖表指定的日期範圍沒有可用資料，系統會顯示下列訊息：

    No data is available for the selected time frame.

    如要解決這個問題，請嘗試下列方法：

    • 擴大圖表的日期範圍。部分指標類型 (例如回報配額用量的指標) 每天只會提供一筆樣本。

    • 變更圖表選取的指標類型。圖表指定的指標類型可能未啟用。如果指標類型沒有任何時間序列，就會處於非使用中狀態。

  • 如果系統無法辨識查詢指定的指標類型或資源類型，就會顯示下列訊息：

    An error occurred requested data. One or more resources could not be found.

    如要解決這個問題，請嘗試下列做法：

    • 確認查詢中指定的指標類型和資源類型已定義。您可以使用圖表的選單導向介面，搜尋指標類型。

    • 檢查查詢中的指標類型和資源類型拼寫是否正確。

圖表顯示機密中繼資料警告

您開啟自訂資訊主頁，預期所有小工具都會顯示資料。不過，如果一或多個含有 SQL 查詢的小工具顯示類似下列訊息：

This SQL query is configured to run on the BigQuery engine using [PROJECT_ID],
and references resources from [RESOURCE, ...]. Sensitive metadata,
including table contents, may be written to [PROJECT_ID].

警告訊息會指出查詢跨越擁有權界線，並讓您有機會在執行前驗證查詢。擁有權界線取決於多項因素，其中一項是查詢所用資源的階層。

每次開啟資訊主頁時，系統都會執行邊界檢查。您無法避免或關閉這些警告。

如果小工具顯示警告訊息，您可以執行下列任一操作：

  • 如果您確定查詢可安全執行，且想查看查詢結果，請點選「確認並執行」。

  • 忽略錯誤訊息。這個小工具不會顯示目前工作階段的資料。

  • 分析查詢，並視需要停用。舉例來說，您可以執行下列操作：

    1. 檢查查詢，並評估查詢的資料。
    2. 查看資訊主頁的記錄，判斷是誰在何時新增小工具。
    3. 如果有人傳送資訊主頁連結給您，請確認寄件者是否為可信任的來源。
    4. 如要儲存分析結果供日後參考，請在資訊主頁中新增「Text」(文字) 小工具。

Google Cloud 提供一些功能，可協助防止資料透過網路釣魚、內部攻擊或外部實體外洩。詳情請參閱「Observability Analytics 的資料安全性」。

含有多個指標的圖表顯示錯誤訊息

您正在設定圖表來顯示多項指標，但圖表顯示下列錯誤訊息：

    The units for queries using the same Y-axis must be the same for the chart
    to render correctly.

圖表可以顯示多種指標類型，您可以將指標類型對應至左側 Y 軸或右側 Y 軸。對應至左側 Y 軸的所有指標類型單位必須相同，否則會顯示上述錯誤訊息。同樣地，對應至右 Y 軸的所有指標類型單位必須相同，否則系統會顯示先前的錯誤訊息。

如要解決這項錯誤，請按照下列步驟操作：

  1. 如果圖表中的指標有兩種以上的單位類型，請移除指標，直到只剩兩種單位類型。

  2. 將所有具有一種單位類型的指標指派給左側 Y 軸，並將所有具有另一種單位類型的指標指派給右側 Y 軸。

含有多項指標的圖表顯示非預期資料

圖表已設定為顯示多項指標，且已新增篩選器，只顯示特定時間序列。不過，圖表會顯示不符合篩選條件的時間序列。

如要解決這個問題，請務必為圖表中的每個指標套用篩選器。

舉例來說，下列螢幕截圖顯示 Metrics Explorer 的設定窗格，其中圖表顯示虛擬機器 (VM) 執行個體讀取和寫入的位元組數：

Metrics Explorer 範例，其中包含兩種指標類型。

在螢幕截圖中，圖表顯示的每個指標類型都有一個標題。

舉例來說，如果希望圖表只顯示 us-central1-a 區域中 VM 的時間序列，請在每項查詢中新增 zone = us-central1-a 篩選器。

無法為 PromQL 定義的圖表選取篩選器值

您可以在自訂資訊主頁上建立圖表，並使用 PromQL 設定這些圖表。接著建立永久資訊主頁篩選器。 查看資訊主頁時，您嘗試變更篩選器的預設值，但標籤值選單未顯示或不正確：

未載入資訊主頁層級篩選器的值。

如要解決這個問題，請輸入篩選器值，然後選取「套用」。舉例來說，如果篩選器鍵是 zone，則可輸入 us-central1-a。

資訊主頁錯誤

本節說明建立或編輯資訊主頁時可能出現的錯誤。

無法建立資訊主頁

您可以使用資訊主頁的 JSON 或 YAML 說明建立資訊主頁，而該說明包含 name 欄位。你變更顯示名稱並嘗試建立第二個資訊主頁，但系統顯示錯誤訊息。舉例來說，如果您使用 Google Cloud CLI，會收到下列錯誤：

ERROR: (gcloud.alpha.monitoring.dashboards.create) Resource in projects [xxxxxxx] is the subject of a conflict: Requested entity already exists.

失敗原因是資訊主頁 ID (在 name 欄位的值中識別這個資訊主頁) 已存在。因此無法建立資訊主頁。

如果您在建立資訊主頁時指定 name 欄位，則指定的值必須在全域範圍內不重複。name 欄位的語法如下：

"name": "projects/PROJECT_ID_OR_NUMBER/dashboards/DASHBOARD_ID"

顯示名稱可以重複。

資訊主頁未顯示所有事件

您設定資訊主頁來顯示事件，但只會顯示近期事件。系統不會顯示較早的活動。

如要解決這個問題，請採取下列任一做法：

  • 使用較短的日期範圍。例如，顯示最近一小時 (而非最近一天) 的資料，或選取自訂時間範圍。

  • 新增篩選器。

基於效能考量，資訊主頁可顯示的事件數量有限。達到這些上限後，資訊主頁只會顯示最近的事件。

Terraform 建立的資訊主頁已重新調整

您使用 Terraform 建立資訊主頁，然後使用 Google Cloud 控制台編輯資訊主頁。您預期除了編輯內容外，資訊主頁不會有其他變更。而是會重新調整資訊主頁大小。舉例來說，資訊主頁原本有 12 個資料欄，現在有 48 個資料欄。

請勿使用 Google Cloud 控制台編輯透過 Terraform 建立的資訊主頁。編輯資訊主頁時，大小會放大四倍。

警告政策小工具未顯示任何資料

資訊主頁包含警告政策的圖表，但圖表未顯示任何資料。

如要解決這個問題，請嘗試下列做法：

  • 查看圖表設定，並確認已選取警告政策。如果沒有顯示任何警告政策，請將圖表與警告政策建立關聯，或從資訊主頁中刪除圖表。

    如果刪除警告政策，資訊主頁上顯示該政策資料的圖表就會停止顯示資料。刪除警告政策時，不會刪除參照該政策的圖表。

  • 查看警告政策的詳細資料，確認政策只包含單一條件。

    如果警告政策經過修改，包含多個條件，則資訊主頁上顯示警告政策資料的圖表會停止顯示資料。如要解決這個問題，請將圖表與單一條件的警告政策建立關聯，或從資訊主頁中刪除圖表。

  • 擴大日期範圍。日期範圍選取器必須設為大於資料取樣週期的值。雖然大部分指標每 60 秒取樣一次，但有些指標的取樣頻率較低。舉例來說，serviceruntime.googleapis.com/quota/limit 指標每 86,400 秒 (1 天) 取樣一次。

記錄面板回報查詢無效

您會看到「Error: Invalid query」(錯誤：查詢無效) 錯誤訊息，且記錄面板不會顯示任何記錄項目。

如要解決這個問題，請減少記錄面板設定顯示記錄的專案數量。

如要進一步瞭解這項失敗條件，請參閱「查詢傳回錯誤」。

「記錄」面板回報找不到任何項目

記錄面板中顯示「找不到任何與目前篩選條件相符的項目」錯誤訊息。您看到這則訊息的原因可能有很多。 請確認下列事項：

  • 如要查看專案的記錄項目，請確認符合下列任一條件：

    • 您具備記錄檢視器 (roles/logging.viewer) 角色。

    • 自訂角色具備下列權限：

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list

  • 請確認查詢編輯器中的子句與記錄面板中顯示的設定沒有衝突。

    舉例來說，如果「Query Editor」(查詢編輯器) 欄位包含 severity=NOTICE，記錄面板會擷取嚴重性等級剛好為 NOTICE 的所有記錄。如果記錄面板的「Severity」(嚴重性) 選單設為「Warning」(警告)，記錄面板會顯示「No entries found matching current filter」(找不到符合目前篩選條件的項目)。系統顯示這則訊息，是因為擷取的記錄項目中，沒有任何項目的嚴重性等級至少為「警告」。

    相反地，如果「Query Editor」(查詢編輯器) 欄位包含 severity=WARNING，且記錄面板的「Severity」(嚴重性) 選單設為「Notice」(通知)，您可能會看到記錄項目。採用這項設定後，記錄面板會擷取嚴重性等級為 WARNING 的記錄。接著，系統會篩選該記錄清單，只顯示嚴重性至少為「Notice」的記錄，而所有擷取的記錄都至少達到該嚴重性等級。

「記錄」面板顯示部分資料

記錄面板會顯示警告指標和「Showing partial results」(顯示部分結果) 訊息。

如果您沒有權限查看已選取顯示記錄的 Google Cloud 專案記錄，就會看到這個指標。如要移除警告指標，請執行下列任一操作：

  • 請與系統管理員聯絡，並要求對方為您要查看記錄的每個專案執行下列任一動作： Google Cloud

    • 授予您記錄檢視者角色 (roles/logging.viewer)。

    • 如果是自訂角色，請授予下列權限：

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list

  • 變更記錄面板的設定，只顯示您有權查看記錄項目的Google Cloud 專案記錄。

「記錄」面板顯示權限遭拒訊息

資訊主頁上的記錄面板小工具會顯示下列權限遭拒訊息：

Error: Permission 'logging.views.access' denied on resource (or it may not exist).

如要解決這個問題，請按照下列步驟操作：

  1. 編輯記錄面板小工具。

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

    • 將「Scope by」(範圍依據) 選單設為「Project」(專案)，然後使用「Projects」(專案) 選單選取「Current project」(目前專案)。

    • 從「儲存空間檢視」選單中，移除您沒有權限查看的記錄檢視。如要瞭解存取記錄檢視畫面所需的 IAM 角色，請參閱「授予記錄檢視畫面存取權」。

      記錄檔面板小工具搜尋記錄檔檢視時，您必須具備權限，才能讀取列出的所有記錄檔檢視中的記錄項目。否則會顯示錯誤訊息。

  3. 按一下「套用」。

表格未顯示所有時間序列

您設定了表格，但表格未顯示所有時間序列。

基於效能考量，表格最多只會顯示 300 列。

API 呼叫無法建立含有記錄面板的資訊主頁

建立含有記錄面板的資訊主頁時，可能會看到錯誤訊息，原因如下：

  • 如果記錄面板未達到最低高度或寬度要求，系統會顯示下列錯誤：

    Unable to save dashboard: Field mosaicLayout.tiles[0] has an invalid value: LogsPanel must have a minimum width of 3 and height of 3.

    如要解決這個問題，請在資訊主頁 JSON 表示法中，確保記錄面板小工具的 height 和 width 欄位符合最低需求。

  • 如果 logsPanel.filter 欄位超過 2,000 個字元，系統會顯示下列錯誤：

    Unable to save dashboard: filter cannot be greater than 2000 characters.

    如要解決這個問題，請縮短篩選器。

  • 如果缺少 resourceNames 欄位，系統會顯示下列錯誤訊息：

    Unable to save dashboard: Dashboard is missing required field mosaicLayout.tiles[0].widget.logsPanel.resourceNames.

    如要解決這個問題，請在資訊主頁 JSON 中新增 resourceNames 欄位。

  • 如果 resourceNames 欄位的語法不正確，您會看到類似下列的錯誤：

    Unable to save dashboard: Field mosaicLayout.tiles[0].widget.logsPanelWidget.resourceNames has an invalid value of "a-project": resource name must have the format `projects/{project}`.

    如要解決這個問題，請在資訊主頁 JSON 中將 a-project 替換為 projects/a-project。

  • 如要瞭解如何解決 filter 欄位中的語法錯誤，請參閱「疑難排解：語法問題」。

如需格式正確的 JSON 檔案範例，請參閱「含有 LogsPanel 小工具的資訊主頁」。

匯入 Grafana 資訊主頁

如要瞭解如何使用資訊主頁匯入工具及排解相關問題，請參閱「將 Grafana 資訊主頁匯入 Cloud Monitoring」。

如要瞭解資訊主頁內容轉換問題，請參閱匯入工具的 README 檔案。