Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

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

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

在「快訊詳細資料」頁面，您可以查看快訊時間軸、受監控指標資料的圖表，以及相關快訊和記錄項目的連結。如果政策包含多項條件，則政策會指定是否只要符合單一條件，就會開啟快訊。如果政策已暫緩或停用，或是警告政策或警告數量超過快訊限制，監控服務就不會建立警告。

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

事前準備

如要取得查看及管理快訊所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

使用 Google Cloud CLI 或 Cloud Monitoring API 查看快訊： Monitoring Alert Viewer (roles/monitoring.alertViewer)
使用 Google Cloud 控制台查看快訊：
- Monitoring Cloud 控制台事件檢視者 (roles/monitoring.cloudConsoleIncidentViewer)
- Stackdriver 帳戶檢視者 (roles/stackdriver.accounts.viewer)
使用 Google Cloud 控制台管理快訊：
- Monitoring Cloud 控制台事件編輯者 (roles/monitoring.cloudConsoleIncidentEditor)
- Stackdriver 帳戶檢視者 (roles/stackdriver.accounts.viewer)

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

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

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

查看快訊

如要在專案中查看快訊，請使用 Google Cloud 控制台、gcloud CLI 或 Monitoring API。

Google Cloud 控制台

如要列出 Google Cloud 專案中的快訊，請執行下列操作：

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

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
在 Google Cloud 控制台的工具列中，選取 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或管理專案。

「警告」頁面會顯示警告政策、暫緩和警告的相關資訊：
- 「摘要」窗格會列出未結警報的數量。
- 「快訊」表格會顯示最近開啟的快訊。如要在表格中列出最新快訊 (包括已關閉的快訊)，請按一下「顯示已關閉的警告」。
如要查看特定快訊的詳細資料，請在清單中選取該快訊。

「快訊詳細資料」頁面隨即開啟。如要進一步瞭解「警報詳細資料」頁面，請參閱本文的「調查警報」一節。

查看舊警報

「警告」頁面上的「警告」表格會顯示最近開啟的警告。如要查看較舊的快訊，請執行下列任一操作：

如要在「快訊」表格中逐頁瀏覽項目，請按一下「較新」或「較舊」。
如要開啟可列出及篩選快訊的頁面，請按一下「查看所有快訊」。「快訊」頁面隨即開啟。在該頁面中，執行下列操作：
- 顯示所有快訊，包括已關閉的快訊。如要顯示所有快訊，請按一下「顯示已關閉的警告」。
- 篩選快訊。如要瞭解如何新增篩選器，請參閱「篩選快訊」。
- 確認或關閉警告，或延後警告政策。如要存取這些選項，請按一下快訊列中的「更多選項」，然後從選單中選取所需選項。詳情請參閱「管理快訊」。

篩選警告

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

如要篩選快訊表格，請按照下列步驟操作：

在「快訊」頁面上，按一下「篩選表格」，然後選取篩選器屬性。篩選條件屬性包括：
- 快訊狀態
- 警告政策名稱
- 開啟或關閉快訊的時間
- 指標類型
- 資源類型
從次要選單選取值，或在篩選列中輸入值。

舉例來說，如果您選取「指標類型」並輸入 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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID"

PowerShell (Windows)

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID" | Select-Object -Expand Content

這項指令會傳回含有警告詳細資料的回應，例如警告狀態、附加標籤和來源警告政策。回應內容應如下所示：

{
  "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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts"

PowerShell (Windows)

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts" | Select-Object -Expand Content

這項指令會傳回含有警告詳細資料的回應，例如警告狀態、附加標籤和來源警告政策。回應內容應如下所示：

{
  "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

調查快訊

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

探索指標資料

如要分析警報觸發前後的指標狀態，請使用「警報指標」圖表。這張圖表會顯示時間軸，以及導致警告政策條件成立的時間序列。

您可以調整時間軸的範圍，找出與快訊相關的指標資料趨勢和模式：

如要切換顯示符合條件的時間序列，以及條件評估的所有時間序列，請按一下「顯示所有時間序列」。
如要變更圖表顯示的日期範圍，可以使用工具列中的日期範圍選取器，或使用指標在圖表上醒目顯示日期範圍。

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

查看記錄項目

「Alert details」(快訊詳細資料) 頁面的「Logs」(記錄) 窗格會顯示與指標受監控資源的資源類型和標籤相符的記錄項目。您可以分析這些記錄項目，找出可能有助於排解快訊問題的其他資訊。

如要在 Logs Explorer 中查看記錄項目，請按一下「在記錄檔探索工具中查看」，然後選取範圍界定專案。Logs Explorer提供額外工具，可分析記錄項目資料，例如相關記錄項目的建立時間軸。
如要查看及編輯用於篩選 Metrics Explorer 中記錄項目的查詢，請按一下「探索資料」。

查看應用程式資訊

如要查看與 App Hub 應用程式相關聯的警告政策，請前往「與應用程式相關聯」部分。這個部分會列出應用程式 ID，並提供連結，方便您前往顯示應用程式資訊的資訊主頁。第二個項目會列出工作負載或服務，並連結至資訊主頁。

查看補充資訊

「標籤」部分會顯示導致快訊的時間序列所監控資源和指標的標籤和值，以及在快訊政策中定義的使用者標籤。這項資訊有助於找出導致快訊的特定受監控資源。詳情請參閱「使用標籤為快訊加上註解」。

「文件」部分會顯示您建立警告政策時提供的通知文件範本。這類資訊可能包括警報政策監控內容的說明，以及緩解問題的訣竅。詳情請參閱「使用使用者定義的說明文件為通知加上註解」。

如果未設定警告政策的說明文件，則「說明文件」窗格會顯示「未設定任何說明文件」。

如要找出應用程式的根本問題，您可以探索與其他警告政策條件相關的快訊。

「相關快訊」部分會列出符合下列任一條件的快訊：

當符合相同警告政策的條件時，系統就會建立警告。
快訊與「快訊詳細資料」頁面顯示的快訊共用標籤。

管理快訊

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

開啟：警告政策的一組條件符合，或沒有資料指出條件不再符合。如果警告政策包含多個條件，系統會根據這些條件的組合方式開啟警告。詳情請參閱「具有多項條件的政策」。
已確認：警報已開啟，且已手動標示為已確認。這個狀態通常表示系統正在調查快訊。
已結案：系統發現條件不再符合、你關閉了快訊，或 7 天內未觀察到條件持續符合。

設定警告政策時，請確保穩定狀態會在一切正常時提供信號。這項作業是必要的，可確保系統能識別無錯誤狀態，並在警告開啟時關閉警告。如果沒有信號指出錯誤情況已停止，系統會在觸發警告政策後開啟警告，並保留 7 天。

舉例來說，如果您建立的警告政策會在錯誤數超過 0 時通知您，請確保政策在沒有任何錯誤時，會產生 0 個錯誤的計數。如果警告政策在無錯誤狀態下傳回空值或空白，表示沒有信號指出錯誤何時停止。如有需要，您可以使用 PromQL 指定預設值，在沒有測量值時使用。

確認快訊

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

如要將快訊標示為已確認，請按照下列步驟操作：

在「快訊」表格的「快訊」頁面中，按一下「查看所有快訊」。
在「快訊」頁面中，找出要確認的快訊，然後執行下列任一操作：
- 按一下「更多選項」圖示，然後選取「確認」。
- 開啟快訊的詳細資料頁面，然後按一下「確認快訊」。

如果警告政策設定為重複傳送通知，確認警告後通知不會停止。如要停止播放，請執行下列任一操作：

為警告政策建立暫緩通知。
停用警告政策。

暫緩執行警告政策

如要避免 Monitoring 在特定時間範圍內建立警告及傳送通知，請延後相關警告政策。暫緩警告政策時，Monitoring 也會關閉與該政策相關的所有警告。

如要為正在查看的快訊建立暫緩通知，請按照下列步驟操作：

在「快訊詳細資料」頁面中，按一下「暫緩政策」。
選取暫緩通知的時間長度。選取延後時間後，延後設定就會立即生效。

您也可以在「快訊」頁面中，找出要延後的快訊，然後依序點選「更多選項」和「延後」，延後警告政策。您可以在服務中斷期間延後警告政策，避免在疑難排解程序中收到更多通知。

關閉快訊

您可以讓 Monitoring 為您關閉快訊，也可以在觀察結果停止傳送後關閉快訊。如果關閉快訊後，系統收到資料顯示條件已符合，就會建立新的快訊。關閉快訊時，系統不會關閉相同條件的其他未解決快訊。如果延後警告政策，系統會在延後開始時關閉未解決的警告。

發生下列任一情況時，監控功能會自動關閉快訊：

指標門檻條件：
- 觀察結果指出未違反門檻。
- 沒有收到任何觀察結果，且條件已設定為在停止收到觀察結果時關閉快訊，而基礎資源的狀態為不明或未停用。
  
  注意： 如果系統已知資源已停用，即使資料停止傳送，警報也不會關閉。不過，你可以手動關閉警報。如果資源含有 metadata.system_labels.state 標籤，且警告政策不是以監控查詢語言編寫，監控服務就能判斷資源狀態。詳情請參閱「資料停止傳送時，快訊不會關閉」。
- 在警告政策的自動關閉時間內，系統未收到任何觀察結果，且條件未設定為在停止收到觀察結果時自動關閉警告。如要設定自動關閉時間長度，可以使用 Google Cloud 控制台或 Monitoring API。系統預設的自動關閉時間為七天。自動關閉期限最短為 30 分鐘。
指標缺席條件：
- 發生觀察事件。
- 警報政策的自動關閉時間到期後，24 小時內不會收到任何觀察結果。如要設定自動關閉時間長度，可以使用 Google Cloud 控制台或 Monitoring API。系統預設的自動關閉時間為七天。
預測條件：
- 系統會產生預測結果，並預測時間序列在預測期間內不會違反門檻。
- 10 分鐘內未收到任何觀測資料，且條件已設定為在觀測資料停止傳送時關閉快訊，而基礎資源的狀態為不明或未停用。
  
  注意： 如果系統已知資源已停用，即使資料停止傳送，警報也不會關閉。不過，你可以手動關閉警報。如果資源含有 metadata.system_labels.state 標籤，且警告政策不是以監控查詢語言編寫，監控服務就能判斷資源狀態。詳情請參閱「資料停止傳送時，快訊不會關閉」。
- 在警告政策的自動關閉時間內，系統未收到任何觀察結果，且條件未設定為在停止收到觀察結果時自動關閉警告。

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

如要關閉快訊，請按照下列步驟操作：

在「Alerting」(快訊) 頁面的「Alerts」(快訊) 表格中，按一下「See all alerts」(查看所有快訊)。
在「快訊」頁面中，找出要關閉的快訊，然後執行下列任一操作：
- 依序點選「查看更多」和「關閉快訊」。
- 開啟該快訊的「快訊詳細資料」頁面，然後按一下「關閉快訊」。

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

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

資料保留與限制

如要瞭解快訊的限制和保留期限，請參閱「快訊限制」。

後續步驟

如要使用 Monitoring API 或從指令列建立及管理警告政策，請參閱「使用 API 管理警告政策」。

如要深入瞭解警告政策的概念，請參閱「以指標為基準的警告政策行為」。

以指標為準的快訊政策的快訊 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

查看快訊

Google Cloud 控制台

查看舊警報

篩選警告

gcloud

接收快訊

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

列出快訊

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Monitoring API

接收快訊

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

列出快訊

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

調查快訊

探索指標資料

查看記錄項目

查看應用程式資訊

查看補充資訊

查看相關快訊

管理快訊

確認快訊

暫緩執行警告政策

關閉快訊

資料保留與限制

後續步驟

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