以指標為準的快訊政策的快訊

當時間序列資料符合指標型警告政策的條件時,Cloud Monitoring 警告可讓您追蹤及調查問題。針對每則快訊,Monitoring 會傳送通知,並建立「Alert details」(快訊詳細資料) 頁面,協助您排解失敗問題及管理快訊生命週期。

在「Alert details」(快訊詳細資料) 頁面中,您可以查看快訊時間軸、受監控指標資料的圖表,以及相關快訊和記錄項目的連結。如果政策包含多項條件,則政策會指定是否只要符合單一條件,就會觸發警告。如果政策已延後或停用,或者警告政策或警告數量超過警告限制,Monitoring 就不會建立警告。

這項功能僅支援 Google Cloud 專案。如要設定 App Hub,請選取 App Hub 主專案或管理專案。

事前準備

如要取得查看及管理警告所需的權限,請要求管理員在專案中授予您下列 IAM 角色:

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

如要進一步瞭解 Cloud Monitoring 角色,請參閱「使用 Identity and Access Management 控管存取權」。

查看快訊

如要查看專案中的警告,請使用 Google Cloud 控制台、gcloud CLI 或 Monitoring API。

Google Cloud 控制台

如要列出 Google Cloud 專案中的警告,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的 「Alerting」(警告) 頁面:

    前往「Alerting」(警告)

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

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

    「Alerting」(警告) 頁面會顯示警告政策、延後和警告的相關資訊:

    • 「摘要」窗格會列出待處理警告的數量。
    • 「Alerts」(警告) 表格會顯示最近開啟的警告。如要在表格中列出最近的快訊 (包括已關閉的快訊),請按一下「Show closed alerts」(顯示已關閉的快訊)。
  3. 如要查看特定快訊的詳細資料,請在清單中選取該快訊。

    「快訊詳細資料」頁面隨即開啟。如要進一步瞭解「Alert details」(快訊詳細資料) 頁面,請參閱本文的「調查快訊」一節。

查看舊快訊

「Alerting」(警告) 頁面的「Alerts」(警告) 表格會顯示最近開啟的警告。如要查看較舊的快訊,請執行下列任一操作:

  • 如要翻閱「Alerts」(警告) 表格中的項目,請按一下 「Newer」(較新) 或 「Older」(較舊)。

  • 如要開啟可列出及篩選快訊的頁面,請按一下「See all alerts」(查看所有快訊)。「Alerts」(快訊) 頁面隨即開啟。在該頁面中執行下列操作:

    • 顯示所有警告,包括已關閉的警告。如要顯示所有警告,請按一下「Show closed alerts」(顯示已關閉的警告)。
    • 篩選警告。如要瞭解如何新增篩選器,請參閱「篩選快訊」。
    • 確認或關閉警告,或延後警告政策。如要存取這些選項,請按一下快訊列中的「更多選項」圖示 ,然後從選單中選取所需選項。詳情請參閱「管理快訊」。

篩選警告

如要限制表格顯示的快訊,請新增篩選器。如果新增多個篩選器,表格只會顯示符合所有篩選條件的快訊。

如要篩選警告表格,請按照下列步驟操作:

  1. 在「Alerts」(快訊) 頁面上,按一下 「Filter table」(篩選表格),然後選取篩選器屬性。篩選器屬性包括:

    • 警告狀態
    • 警告政策名稱
    • 開啟或關閉快訊的時間
    • 指標類型
    • 資源類型
  2. 從次要選單中選取值,或在篩選列中輸入值。

    舉例來說,如果您選取「Metric type」(指標類型) 並輸入 usage_time,則次要選單中可能只會顯示下列選項:

    agent.googleapis.com/cpu/usage_time
    compute.googleapis.com/guest/container/cpu/usage_time
    container.googleapis.com/container/cpu/usage_time
    

    「快訊」表格隨即會列出篩選條件。

gcloud

您可以使用 gcloud 取得快訊和列出快訊。

接收快訊

使用下列任何指令資料前,請先替換以下項目:

  • ALERT_NAME:快訊的資源名稱。例如:projects/my-project/alerts/my-alert-id。

執行 gcloud alpha monitoring alerts describe 指令:

Linux、macOS 或 Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

gcloud alpha monitoring alerts describe ALERT_NAME
指令會傳回包含警告詳細資料的回應,例如警告狀態、附加標籤和來源警告政策。回應大致如下:
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

列出警告

您可以使用 gcloud CLI 列出專案中的警告,並篩選結果。

使用下列任何指令資料前,請先替換以下項目:

  • PROJECT_ID:專案 ID。

執行 gcloud alpha monitoring alerts list 指令:

Linux、macOS 或 Cloud Shell

gcloud alpha monitoring alerts list

Windows (PowerShell)

gcloud alpha monitoring alerts list

Windows (cmd.exe)

gcloud alpha monitoring alerts list
指令會傳回包含警告詳細資料的回應,例如警告狀態、附加標籤和來源警告政策。回應大致如下:
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
您也可以使用下列選用旗標,篩選、排序或修改輸出內容:
  • --filter::提供篩選運算式,依時間或標籤篩選快訊。例如,使用 --filter='close_time>="2025-09-10T00:00:00Z"' 依時間篩選,或使用 --filter='resource.labels.key="value"' 依標籤篩選。

  • --sort-by:以逗號分隔的清單,用於排序輸出內容。例如 --sort-by=open_time。

  • --uri:指令會輸出資源 URI 清單,而非預設輸出內容。

  • --limit:將這個旗標設為 2 以上,即可限制傳回的警示數量。請勿將這個旗標與 --filter 旗標搭配使用。

Monitoring API

您可以使用 Monitoring API 取得及列出警告。

接收快訊

如要透過 Monitoring API 取得單一快訊的詳細資料,請使用 alerts.get 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • PROJECT_ID:專案 ID。
  • ALERT_ID:快訊 ID。

HTTP 方法和網址:

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

請展開以下其中一個選項,以傳送要求:

指令會傳回包含警告詳細資料的回應,例如警告狀態、附加標籤和來源警告政策。回應大致如下:
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

列出警告

如要列出專案中的快訊,並使用 Monitoring API 篩選結果,請使用 alerts.list 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • PROJECT_ID:專案 ID。

HTTP 方法和網址:

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

請展開以下其中一個選項,以傳送要求:

指令會傳回包含警告詳細資料的回應,例如警告狀態、附加標籤和來源警告政策。回應大致如下:
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
Curl 使用者可以新增 --data-urlencode 旗標,後接篩選運算式,依時間或標籤篩選警告。請參閱以下範例:

列出過去一小時內開啟的快訊:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

列出並篩選過去一天內開啟的快訊:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

列出並篩選在兩個時間點之間開啟的警示:

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

依使用者標籤列出及篩選快訊。在這個範例中,依名稱為 app 且值為 my-gke-app 的使用者標籤進行篩選:

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"
Powershell 使用者可以參考以下範例,在要求網址中加入時間篩選條件:
$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

調查警告

「快訊詳細資料」頁面包含的資訊,可能有助於您找出快訊原因。

探索指標資料

如要分析快訊發生前後的指標狀態,請使用「Alert Metrics」(快訊指標) 圖表。這張圖表顯示時間軸,以及導致警告政策條件符合的時間序列。

您可以調整時間軸範圍,查看指標資料與警告相關的趨勢和模式:

  • 如要切換顯示模式,只顯示符合條件的時間序列,或顯示條件評估的所有時間序列,請按一下 「Show all timeseries」(顯示所有時間序列)。

  • 如要變更圖表顯示的時間範圍,可以使用工具列中的時間範圍選取器,或用指標醒目顯示圖表上的時間範圍。

您也可以在 Metrics Explorer 中查看指標資料,進一步分析。方法是前往「Alert Metrics」(快訊指標) 圖表,然後按一下「Explore Data」(探索資料) 。根據預設,Metrics Explorer 會匯總及篩選指標資料,讓指標圖表與「Alert Metrics」(警告指標) 時間軸上顯示的時間序列一致。

探索記錄項目

「Alert details」(警告詳細資料) 頁面的「Logs」(記錄) 窗格會顯示與警告相關的記錄項目。除了監控記錄指標的警告政策外,這個窗格會顯示與觸發警告的時間序列資源類型和標籤相符的記錄項目。不過,如果警告政策監控的是在同一專案中定義的記錄指標,這個窗格就會顯示符合指標篩選器查詢的記錄項目。這項查詢不含條件篩選器或匯總標籤,例如分組標籤 (groupByFields)。

您可以分析這些記錄項目,找出有助於排解警告問題的其他資訊。

  • 如要在記錄檔探索工具中查看記錄項目,請按一下「View in Logs Explorer」(在記錄檔探索工具中查看),然後選取範圍專案。Logs Explorer 提供其他工具來分析記錄項目資料,例如相關記錄項目的建立時間軸。
  • 如要查看及編輯用於篩選 Metrics Explorer 中記錄項目的查詢,請按一下 「Explore Data」(探索資料)。

查看應用程式資訊

如要查看與 App Hub 應用程式相關聯的警告政策,請前往「Associated with application」(與應用程式相關聯) 專區。這個部分中的一個項目會列出應用程式 ID,以及顯示應用程式相關資訊的資訊主頁連結。第二個項目會列出工作負載或服務,並連結至資訊主頁。

查看補充資訊

「Labels」(標籤) 區段會顯示受監控資源的標籤和值、引發警告的時間序列指標,以及警告政策中定義的使用者標籤。這項資訊有助於找出引發警告的特定受監控資源。詳情請參閱「使用標籤為快訊加上註解」。

「Documentation」(說明文件) 專區會顯示您在建立警告政策時,為通知提供的說明文件範本。這項資訊可能包括警告政策監控內容的說明,以及緩解措施提示。詳情請參閱「使用使用者定義的文件為通知加上註解」。

如果您未設定警告政策的說明文件,則「Documentation」(說明文件) 窗格會顯示「No documentation is configured」(未設定任何說明文件)。

如要找出應用程式中的潛在問題,可以查看與其他警告政策條件相關的警告。

「Related alerts」(相關快訊) 專區會列出符合下列任一條件的快訊:

  • 當同一警告政策的條件符合時,系統就會建立警告。
  • 快訊的標籤與「Alert details」(快訊詳細資料) 頁面顯示的快訊相同。

管理快訊

快訊會處於下列其中一種狀態:

  •  未解決: 警告政策的一組條件已符合,或沒有資料指出條件已不符合。 如果警告政策包含多個條件,系統會根據這些條件的組合方式開啟警告。詳情請參閱「具有多個條件的政策」。

  •  已確認:警告處於開啟狀態,且已手動標示為「已確認」。這個狀態通常表示快訊正在調查中。

  •  已關閉: 系統觀察到條件不再符合、 您關閉了快訊, 或 7 天內未觀察到 條件持續符合。

設定警告政策時,請確保穩定狀態會在一切正常時提供信號。這是為了確保能識別無錯誤狀態,並在警告開啟時關閉警告。如果沒有信號指出錯誤狀況已停止,警告開啟後,會在警告政策觸發後保持開啟 7 天。

舉例來說,如果您建立警告政策,在錯誤數量大於 0 時通知您,請確保在沒有任何錯誤時,該政策產生的錯誤數量為 0。如果警告政策在無錯誤狀態下傳回空值或空白,就沒有信號指出錯誤何時停止。如有需要,PromQL 可讓您指定預設值,以便在沒有測量值時使用。

確認警告

建議您在開始調查快訊原因時,將快訊標示為已確認。

如要將警告標示為已確認,請按照下列步驟操作:

  1. 在「Alerting」(快訊) 頁面的「Alerts」(快訊) 表格中,按一下「See all alerts」(查看所有快訊)。
  2. 在「Alerts」(警告) 頁面中,找出要確認的警告,然後執行下列任一操作:

    • 按一下 「More options」(更多選項),然後選取「Acknowledge」(確認)。
    • 開啟快訊的詳細資料頁面,然後按一下「Acknowledge alert」(確認快訊)。

如果警告政策設為傳送重複通知,確認警告並不會停止通知。只要警告仍處於開啟狀態,系統就會在每個設定的時間間隔繼續傳送重複通知。如要停止,請執行下列任一操作:

  • 為警告政策建立延後。
  • 停用警告政策。

延後警告政策

如要防止 Monitoring 在特定時間範圍內建立快訊及傳送通知,請延後相關警告政策。延後警告政策時,Monitoring 也會關閉與該政策相關的所有警告。

如要為正在查看的警告建立延後通知,請按照下列步驟操作:

  1. 在「Alert details」(快訊詳細資料) 頁面中,按一下「Snooze Policy」(延後政策)。

  2. 選取延後時間長度。選取延後時間長度後,延後設定會立即生效。

您也可以在「Alerts」(警告) 頁面中延後警告政策,方法是找出要延後的警告,按一下 「More options」(更多選項),然後選取「Snooze」(延後)。您可以在服務中斷期間延後警告政策,避免在疑難排解過程中收到更多通知。

關閉警告

您可以讓 Monitoring 關閉警告,也可以在觀測資料停止傳入後關閉警告。如果您關閉警告,但隨後收到的資料顯示符合條件,系統就會建立新的警告。關閉警告時,系統不會關閉因相同條件而觸發的其他警告。如果延後警告政策,未解決的警告會在延後開始時關閉。

發生下列任一情況時,Monitoring 會自動關閉警告:

  • 指標門檻條件:

    • 收到觀察結果,指出未違反門檻。
    • 沒有觀測資料,條件設為在觀測資料停止時關閉警告,且基礎資源的狀態不明或未停用。

    • 在警告政策的自動關閉時間長度內,沒有任何觀測結果,且條件未設為在觀測結果停止時自動關閉警告。如要設定自動關閉時間長度,可以使用 Google Cloud 控制台或 Monitoring API。預設的自動關閉時間長度為七天。自動關閉時間長度下限為 30 分鐘。

  • 指標缺失條件:

    • 觀察。
    • 警告政策的自動關閉時間到期後,24 小時內未收到任何觀測結果。如要設定自動關閉時間長度,可以使用 Google Cloud 控制台或 Monitoring API。預設的自動關閉時間長度為七天。
  • 預測條件:

    • 系統會產生預測,並預測時間序列不會在預測時間範圍內違反門檻。
    • 10 分鐘內沒有觀測結果,條件設定為在觀測結果停止時關閉警告,且基礎資源的狀態為不明或未停用。

    • 在警告政策的自動關閉時間長度內,沒有任何觀測項目,且條件未設為在觀測項目停止時自動關閉警告。

舉例來說,如果 HTTP 回應延遲時間連續 10 分鐘超過 2 秒,警告政策就會產生警告。如果下次測量的 HTTP 回應延遲時間小於或等於兩秒,系統就會關閉警告。同樣地,如果連續七天未收到任何資料,快訊就會關閉。

如要關閉警告,請按照下列步驟操作:

  1. 在「Alerting」(快訊) 頁面的「Alerts」(快訊) 表格中,按一下「See all alerts」(查看所有快訊)。
  2. 在「Alerts」(快訊) 頁面中,找出要關閉的快訊,然後執行下列任一操作:

    • 按一下「 查看更多」,然後選取「關閉快訊」
    • 開啟該警告的「Alert details」(警告詳細資料) 頁面,然後按一下「Close alert」(關閉警告)。

如果看到「Unable to close alert with active conditions」訊息,表示系統在最近的警告期間內收到資料,因此無法關閉警告。

如果看到 Unable to close alert. Please try again in a few minutes. 訊息,表示發生內部錯誤,因此無法關閉快訊。

資料保留和限制

如要瞭解警告限制和保留期限,請參閱「警告限制」。

後續步驟