工具:list_alerts
這是列出 Google Cloud 雲端專案中警告的主要工具。警示代表違反警示政策。這項資訊有助於瞭解目前和過去的警告政策違規情形。
下列程式碼範例說明如何使用 curl 呼叫 list_alerts MCP 工具。
| Curl 要求 |
|---|
curl --location 'https://monitoring.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_alerts", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
輸入內容的結構定義
ListAlerts 要求。
ListAlertsRequest
| JSON 表示法 |
|---|
{ "parent": string, "filter": string, "orderBy": string, "pageSize": integer, "pageToken": string } |
| 欄位 | |
|---|---|
parent |
這是必要旗標,要列出快訊的專案名稱。 |
filter |
選用。如果警示或其子欄位的任何欄位相符,系統就會傳回警示。 |
orderBy |
選用。以半形逗號分隔的
舉例來說, 如未設定這個欄位,結果會依 |
pageSize |
選用。單一回應中傳回的結果數量上限。如未設為正數,最多將傳回 50 則快訊。許可的最大值為 1000;超出的數值將一律指定為 1000。 |
pageToken |
選用。如果 |
輸出內容的結構定義
ListAlerts 的回覆。
ListAlertsResponse
| JSON 表示法 |
|---|
{
"alerts": [
{
object ( |
| 欄位 | |
|---|---|
alerts[] |
快訊清單。 |
nextPageToken |
如果不是空白,表示可能還有更多符合要求的結果。在後續要求中使用 |
totalSize |
這項查詢的預估相符結果總數。 |
快訊
| JSON 表示法 |
|---|
{ "name": string, "state": enum ( |
| 欄位 | |
|---|---|
name |
ID。快訊名稱。 格式為:
|
state |
僅供輸出。快訊的目前狀態。 |
openTime |
開啟快訊的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
closeTime |
警告關閉的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
resource |
受監控資源類型,以及從事件產生條件保留的任何受監控資源標籤。 |
metadata |
受監控資源的中繼資料。 |
metric |
指標類型,以及從事件產生條件保留的任何指標標籤。 |
log |
與快訊相關的記錄資訊。這個欄位只會填入以記錄為準的快訊。 |
policy |
產生這則快訊的快訊政策快照。 |
時間戳記
| JSON 表示法 |
|---|
{ "seconds": string, "nanos": integer } |
| 欄位 | |
|---|---|
seconds |
代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含),對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。 |
nanos |
以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分,並非秒數的替代值。如果秒數值為負數,且包含小數,奈秒值仍須為非負數,且會往前計算時間。必須介於 0 至 999,999,999 之間 (含)。 |
MonitoredResource
| JSON 表示法 |
|---|
{ "type": string, "labels": { string: string, ... } } |
| 欄位 | |
|---|---|
type |
這是必要旗標,受監控的資源類型。這個欄位必須與 |
labels |
這是必要旗標,相關聯的受監控資源描述元中列出的所有標籤的值。舉例來說,Compute Engine VM 執行個體會使用 包含 |
LabelsEntry
| JSON 表示法 |
|---|
{ "key": string, "value": string } |
| 欄位 | |
|---|---|
key |
|
value |
|
MonitoredResourceMetadata
| JSON 表示法 |
|---|
{ "systemLabels": { object }, "userLabels": { string: string, ... } } |
| 欄位 | |
|---|---|
systemLabels |
僅限輸出。預先定義系統中繼資料標籤的值。系統標籤是一種由 Google 擷取的中繼資料,其中包括「machine_image」、「vpc」、「subnet_id」、「security_group」、「name」等。系統標籤值只能為字串、布林值或字串清單。例如: |
userLabels |
僅限輸出。使用者定義中繼資料標籤的對應區。 包含 |
結構
| JSON 表示法 |
|---|
{ "fields": { string: value, ... } } |
| 欄位 | |
|---|---|
fields |
動態型別值的無序對應。 包含 |
FieldsEntry
| JSON 表示法 |
|---|
{ "key": string, "value": value } |
| 欄位 | |
|---|---|
key |
|
value |
|
值
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位 kind。值的類型。kind 只能是下列其中一個設定: |
|
nullValue |
代表 JSON |
numberValue |
代表 JSON 數字。不得為 |
stringValue |
代表 JSON 字串。 |
boolValue |
代表 JSON 布林值 (JSON 中的 |
structValue |
代表 JSON 物件。 |
listValue |
代表 JSON 陣列。 |
ListValue
| JSON 表示法 |
|---|
{ "values": [ value ] } |
| 欄位 | |
|---|---|
values[] |
動態型別值的重複欄位。 |
UserLabelsEntry
| JSON 表示法 |
|---|
{ "key": string, "value": string } |
| 欄位 | |
|---|---|
key |
|
value |
|
指標
| JSON 表示法 |
|---|
{ "type": string, "labels": { string: string, ... } } |
| 欄位 | |
|---|---|
type |
現有指標類型,請參閱 |
labels |
可唯一識別這個指標的標籤值組合。必須為 包含 |
LabelsEntry
| JSON 表示法 |
|---|
{ "key": string, "value": string } |
| 欄位 | |
|---|---|
key |
|
value |
|
LogMetadata
| JSON 表示法 |
|---|
{ "extractedLabels": { string: string, ... } } |
| 欄位 | |
|---|---|
extractedLabels |
從記錄中擷取的標籤。 包含 |
ExtractedLabelsEntry
| JSON 表示法 |
|---|
{ "key": string, "value": string } |
| 欄位 | |
|---|---|
key |
|
value |
|
PolicySnapshot
| JSON 表示法 |
|---|
{
"name": string,
"displayName": string,
"severity": enum ( |
| 欄位 | |
|---|---|
name |
快訊政策資源的名稱。格式為「projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]」。 |
displayName |
警告政策的顯示名稱。 |
severity |
警告政策的嚴重程度。 |
userLabels |
警告政策的使用者標籤。 包含 |
UserLabelsEntry
| JSON 表示法 |
|---|
{ "key": string, "value": string } |
| 欄位 | |
|---|---|
key |
|
value |
|
狀態
列舉快訊的可能狀態。
| 列舉 | |
|---|---|
STATE_UNSPECIFIED |
未指定快訊狀態。 |
OPEN |
警示已開啟。 |
CLOSED |
警告已關閉。 |
NullValue
代表 JSON null。
NullValue 是哨兵,使用只有一個值的列舉,代表 Value 型別聯集的空值。
如果 NullValue 類型的欄位值不是 0,系統就會視為無效。大多數 ProtoJSON 序列化程式都會發出 Value,並將 null_value 設為 JSON null (不論整數值為何),因此會來回傳輸至 0 值。
| 列舉 | |
|---|---|
NULL_VALUE |
空值。 |
嚴重性
警告政策可能嚴重性等級的列舉。
| 列舉 | |
|---|---|
SEVERITY_UNSPECIFIED |
未指定嚴重程度。這是預設值。 |
CRITICAL |
這是最高嚴重程度。如果問題可能導致重大損害或停機,請使用這個選項。 |
ERROR |
這是中等嚴重程度。如果問題可能導致輕微損壞或停機,請使用這個選項。 |
WARNING |
這是最低的嚴重性等級。如果問題不會造成任何損壞或停機,但日後可能導致問題,請使用這項功能。 |
工具註解
破壞性提示:❌ | 等冪提示:✅ | 唯讀提示:✅ | 開放世界提示:❌