當 Cloud Logging 中的個別記錄項目符合記錄指標警告政策的條件時，您可以使用 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)
- Monitoring Cloud 控制台事件檢視者 (
-
使用 Google Cloud 控制台管理快訊：
- Monitoring Cloud 控制台事件編輯者 (
roles/monitoring.cloudConsoleIncidentEditor) - Stackdriver 帳戶檢視者 (
roles/stackdriver.accounts.viewer)
- Monitoring Cloud 控制台事件編輯者 (
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。
如要進一步瞭解 Cloud Monitoring 角色，請參閱「使用 Identity and Access Management 控制存取權」。
查看快訊
如要在專案中查看快訊，請使用 Google Cloud 控制台、gcloud CLI 或 Monitoring API。
Google Cloud 控制台
如要列出 Google Cloud 專案中的快訊，請執行下列操作：
-
前往 Google Cloud 控制台的 notifications「Alerting」(警告) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
在 Google Cloud 控制台的工具列中，選取 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或管理專案。
「警告」頁面會顯示警告政策、暫緩和警告的相關資訊：
- 「摘要」窗格會列出未結警報的數量。
- 「快訊」表格會顯示最近開啟的快訊。如要在表格中列出最新快訊 (包括已關閉的快訊)，請按一下「顯示已關閉的警告」。
如要查看特定快訊的詳細資料，請在清單中選取該快訊。
「快訊詳細資料」頁面隨即開啟。如要進一步瞭解「警報詳細資料」頁面，請參閱本文的「調查警報」一節。
查看舊警報
「警告」頁面上的「警告」表格會顯示最近開啟的警告。如要查看較舊的快訊，請執行下列任一操作：
如要在「快訊」表格中逐頁瀏覽項目，請按一下「較新」arrow_back_ios或「較舊」arrow_forward_ios。
如要開啟可列出及篩選快訊的頁面，請按一下「查看所有快訊」。「快訊」頁面隨即開啟。在該頁面中，執行下列操作：
篩選警告
如要限制表格顯示的快訊，請新增篩選器。如果新增多個篩選器，表格只會顯示符合所有篩選條件的快訊。
如要篩選快訊表格，請按照下列步驟操作：
在「快訊」頁面上，按一下「篩選表格」filter_list，然後選取篩選器屬性。篩選條件屬性包括：
- 快訊狀態
- 警告政策名稱
- 開啟或關閉快訊的時間
從次要選單選取值，或在篩選列中輸入值。
「快訊」表格隨即會列出篩選條件。
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-id",
"state": "OPEN",
"open_time": "2025-06-11T09:53:46Z",
"resource": {
"type": "k8s_cluster",
"labels": {
"location": "us-central1",
"cluster_name": "example_cluster",
"project_id": "my-project"
}
},
"log": {
"extracted_labels": {
"title": "my title"
}
},
"policy": {
"name": "projects/my-project/alertPolicies/POLICY_1",
"displayName": "test-policy"
},
"summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}
列出快訊
您可以使用 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-id",
"state": "OPEN",
"open_time": "2025-06-11T09:53:46Z",
"resource": {
"type": "k8s_cluster",
"labels": {
"location": "us-central1",
"cluster_name": "example_cluster",
"project_id": "my-project"
}
},
"log": {
"extracted_labels": {
"title": "my title"
}
},
"policy": {
"name": "projects/my-project/alertPolicies/POLICY_1",
"displayName": "test-policy"
},
"summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}
]
}
--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-id",
"state": "OPEN",
"open_time": "2025-06-11T09:53:46Z",
"resource": {
"type": "k8s_cluster",
"labels": {
"location": "us-central1",
"cluster_name": "example_cluster",
"project_id": "my-project"
}
},
"log": {
"extracted_labels": {
"title": "my title"
}
},
"policy": {
"name": "projects/my-project/alertPolicies/POLICY_1",
"displayName": "test-policy"
},
"summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}
列出快訊
如要在專案中列出快訊，並使用 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-id",
"state": "OPEN",
"open_time": "2025-06-11T09:53:46Z",
"resource": {
"type": "k8s_cluster",
"labels": {
"location": "us-central1",
"cluster_name": "example_cluster",
"project_id": "my-project"
}
},
"log": {
"extracted_labels": {
"title": "my title"
}
},
"policy": {
"name": "projects/my-project/alertPolicies/POLICY_1",
"displayName": "test-policy"
},
"summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}
]
}
--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\")"
$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
調查快訊
「快訊詳細資料」頁面包含的資訊有助於您找出快訊原因。
查看記錄項目
探索記錄項目，找出與調查相關的模式和重複發生的問題。「Logs」(記錄) 窗格會顯示符合記錄式警告政策查詢的記錄項目。
- 如要在 Logs Explorer 中查看記錄項目，請按一下「View in Logs Explorer」，然後選取範圍界定專案。
- 如要在 Metrics Explorer 中查看「記錄」面板，請按一下「探索資料」圖示 query_stats。
查看補充資訊
「標籤」部分會顯示導致快訊的記錄項目中，所含受監控資源的標籤和值。這項資訊有助於找出導致快訊的特定受監控資源。詳情請參閱「使用標籤為快訊加上註解」。
「文件」部分會顯示您建立警告政策時提供的通知文件範本。這類資訊可能包括警報政策監控內容的說明，以及緩解問題的訣竅。詳情請參閱「使用使用者定義的說明文件為通知加上註解」。
如果未設定警告政策的說明文件，則「說明文件」窗格會顯示「未設定任何說明文件」。
查看相關快訊
如要找出應用程式的根本問題，您可以探索與其他警告政策條件相關的快訊。
「相關快訊」部分會列出符合下列任一條件的快訊：- 當符合相同警告政策的條件時，系統就會建立警告。
- 快訊與「快訊詳細資料」頁面顯示的快訊共用標籤。
管理快訊
快訊會處於下列其中一種狀態：
error 開啟： 記錄型警告政策的條件已符合，且警告仍處於開啟狀態。如果再次符合相同條件，且已開啟警報，系統就不會開啟新警報。
warning 已確認： 警報已開啟，且已手動標示為已確認。 這個狀態通常表示系統正在調查快訊。
check_circle 已關閉： 您已手動關閉快訊，或快訊在自動關閉時間到期後自動關閉。
確認快訊
建議您在開始調查快訊原因時，將快訊標示為已確認。
如要將快訊標示為已確認，請按照下列步驟操作：
- 在「快訊」表格的「快訊」頁面中，按一下「查看所有快訊」。
在「快訊」頁面中，找出要確認的快訊，然後執行下列任一操作：
- 按一下「更多選項」圖示 more_vert，然後選取「確認」。
- 開啟快訊的詳細資料頁面，然後按一下「確認快訊」。
暫緩執行警告政策
如要避免 Monitoring 在特定時間範圍內建立警告及傳送通知，請延後相關警告政策。延後警告政策後，與該政策相關的警告仍會保持開啟狀態，但不會再發出通知。系統會根據警告政策的自動關閉期限關閉警告。
如要為正在查看的快訊建立暫緩通知，請按照下列步驟操作：
在「快訊詳細資料」頁面中，按一下「暫緩政策」。
選取暫緩通知的時間長度。選取延後時間後，延後設定就會立即生效。
您也可以在「快訊」頁面中，找出要延後的快訊，然後依序點選「更多選項」more_vert和「延後」，延後警告政策。您可以在服務中斷期間延後警告政策，避免在疑難排解程序中收到更多通知。
關閉快訊
你可以讓監控服務為你關閉快訊，也可以自行關閉快訊。
當警告政策的自動關閉時間到期時，監控系統會自動關閉警告。根據預設，自動關閉時間為 7 天。自動關閉期限最短為 30 分鐘。
自動關閉時間長度是指警告關閉前，必須經過一段時間，且警告原因不會重複發生。因此，如果警告開啟後再次發生原因，警告可能會在自動關閉時間過後仍保持開啟狀態。
如要關閉快訊，請按照下列步驟操作：
- 在「Alerting」(快訊) 頁面的「Alerts」(快訊) 表格中，按一下「See all alerts」(查看所有快訊)。
在「快訊」頁面中，找出要關閉的快訊，然後執行下列任一操作：
- 依序點選「查看更多」more_vert和「關閉快訊」。
- 開啟該快訊的「快訊詳細資料」頁面，然後按一下「關閉快訊」。
如果看到 Unable to close alert 訊息，請稍候幾分鐘再試。您無法立即關閉新的 Google 快訊，因為快訊系統仍將導致快訊的條件視為有效。
資料保留與限制
如要瞭解快訊的限制和保留期限，請參閱「快訊限制」。
後續步驟
- 如要使用 Monitoring API 或從指令列建立及管理警告政策，請參閱「使用 API 管理警告政策」。