MCP Tools Reference: monitoring.googleapis.com

工具: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

string

這是必要旗標,要列出快訊的專案名稱。

filter

string

選用。如果警示或其子欄位的任何欄位相符,系統就會傳回警示。

orderBy

string

選用。以半形逗號分隔的 Alert 欄位清單,用於排序。預設排序方向為遞增。如要針對欄位指定遞減順序,請加上 desc 修飾符。系統支援下列欄位:

  • open_time
  • close_time

舉例來說,close_time desc, open_time 會傳回最近關閉的快訊,如果關閉時間相同,則會先列出較舊的快訊。

如未設定這個欄位,結果會依 open_time desc 排序。

pageSize

integer

選用。單一回應中傳回的結果數量上限。如未設為正數,最多將傳回 50 則快訊。許可的最大值為 1000;超出的數值將一律指定為 1000。

pageToken

string

選用。如果 page_token 不是空白,就必須包含先前回應中傳回的 next_page_token 值,才能要求下一組結果。

輸出內容的結構定義

ListAlerts 的回覆。

ListAlertsResponse

JSON 表示法
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
欄位
alerts[]

object (Alert)

快訊清單。

nextPageToken

string

如果不是空白,表示可能還有更多符合要求的結果。在後續要求中使用 page_token 欄位中的值,即可擷取下一組結果。權杖會經過加密,且僅保證在建立後的 72 小時內傳回正確結果。如果留空,表示已傳回所有結果。

totalSize

integer

這項查詢的預估相符結果總數。

快訊

JSON 表示法
{
  "name": string,
  "state": enum (State),
  "openTime": string,
  "closeTime": string,
  "resource": {
    object (MonitoredResource)
  },
  "metadata": {
    object (MonitoredResourceMetadata)
  },
  "metric": {
    object (Metric)
  },
  "log": {
    object (LogMetadata)
  },
  "policy": {
    object (PolicySnapshot)
  }
}
欄位
name

string

ID。快訊名稱。

格式為:

projects/[PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID]

[ALERT_ID] 是系統指派的快訊專屬 ID。

state

enum (State)

僅供輸出。快訊的目前狀態。

openTime

string (Timestamp format)

開啟快訊的時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

closeTime

string (Timestamp format)

警告關閉的時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

resource

object (MonitoredResource)

受監控資源類型,以及從事件產生條件保留的任何受監控資源標籤。

metadata

object (MonitoredResourceMetadata)

受監控資源的中繼資料。

metric

object (Metric)

指標類型,以及從事件產生條件保留的任何指標標籤。

log

object (LogMetadata)

與快訊相關的記錄資訊。這個欄位只會填入以記錄為準的快訊。

policy

object (PolicySnapshot)

產生這則快訊的快訊政策快照。

時間戳記

JSON 表示法
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含),對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。

nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分,並非秒數的替代值。如果秒數值為負數,且包含小數,奈秒值仍須為非負數,且會往前計算時間。必須介於 0 至 999,999,999 之間 (含)。

MonitoredResource

JSON 表示法
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
欄位
type

string

這是必要旗標,受監控的資源類型。這個欄位必須與 MonitoredResourceDescriptor 物件的 type 欄位相符。舉例來說,Compute Engine VM 執行個體的類型為 gce_instance。如需類型清單,請參閱「監控資源類型」和「記錄資源類型」。

labels

map (key: string, value: string)

這是必要旗標,相關聯的受監控資源描述元中列出的所有標籤的值。舉例來說,Compute Engine VM 執行個體會使用 "project_id"、"instance_id" 和 "zone" 標籤。

包含 "key": value 組合清單的物件,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

LabelsEntry

JSON 表示法
{
  "key": string,
  "value": string
}
欄位
key

string

value

string

MonitoredResourceMetadata

JSON 表示法
{
  "systemLabels": {
    object
  },
  "userLabels": {
    string: string,
    ...
  }
}
欄位
systemLabels

object (Struct format)

僅限輸出。預先定義系統中繼資料標籤的值。系統標籤是一種由 Google 擷取的中繼資料,其中包括「machine_image」、「vpc」、「subnet_id」、「security_group」、「name」等。系統標籤值只能為字串、布林值或字串清單。例如:

{ "name": "my-test-instance",
  "security_group": ["a", "b", "c"],
  "spot_instance": false }
userLabels

map (key: string, value: string)

僅限輸出。使用者定義中繼資料標籤的對應區。

包含 "key": value 組合清單的物件,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

結構

JSON 表示法
{
  "fields": {
    string: value,
    ...
  }
}
欄位
fields

map (key: string, value: value (Value format))

動態型別值的無序對應。

包含 "key": value 組合清單的物件,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

FieldsEntry

JSON 表示法
{
  "key": string,
  "value": value
}
欄位
key

string

value

value (Value format)

值

JSON 表示法
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
欄位
聯集欄位 kind。值的類型。kind 只能是下列其中一個設定:
nullValue

null

代表 JSON null。

numberValue

number

代表 JSON 數字。不得為 NaN、Infinity 或 -Infinity,因為 JSON 不支援這些字元。此外,由於 JSON 格式一般不支援數字類型中的大型 Int64 值,因此也無法表示這類值。

stringValue

string

代表 JSON 字串。

boolValue

boolean

代表 JSON 布林值 (JSON 中的 true 或 false 常值)。

structValue

object (Struct format)

代表 JSON 物件。

listValue

array (ListValue format)

代表 JSON 陣列。

ListValue

JSON 表示法
{
  "values": [
    value
  ]
}
欄位
values[]

value (Value format)

動態型別值的重複欄位。

UserLabelsEntry

JSON 表示法
{
  "key": string,
  "value": string
}
欄位
key

string

value

string

指標

JSON 表示法
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
欄位
type

string

現有指標類型,請參閱 google.api.MetricDescriptor。例如:custom.googleapis.com/invoice/paid/amount。

labels

map (key: string, value: string)

可唯一識別這個指標的標籤值組合。必須為 MetricDescriptor 中列出的所有標籤指派值。

包含 "key": value 組合清單的物件,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

LabelsEntry

JSON 表示法
{
  "key": string,
  "value": string
}
欄位
key

string

value

string

LogMetadata

JSON 表示法
{
  "extractedLabels": {
    string: string,
    ...
  }
}
欄位
extractedLabels

map (key: string, value: string)

從記錄中擷取的標籤。

包含 "key": value 組合清單的物件,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

ExtractedLabelsEntry

JSON 表示法
{
  "key": string,
  "value": string
}
欄位
key

string

value

string

PolicySnapshot

JSON 表示法
{
  "name": string,
  "displayName": string,
  "severity": enum (Severity),
  "userLabels": {
    string: string,
    ...
  }
}
欄位
name

string

快訊政策資源的名稱。格式為「projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]」。

displayName

string

警告政策的顯示名稱。

severity

enum (Severity)

警告政策的嚴重程度。

userLabels

map (key: string, value: string)

警告政策的使用者標籤。

包含 "key": value 組合清單的物件,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

UserLabelsEntry

JSON 表示法
{
  "key": string,
  "value": string
}
欄位
key

string

value

string

狀態

列舉快訊的可能狀態。

列舉
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 這是最低的嚴重性等級。如果問題不會造成任何損壞或停機,但日後可能導致問題,請使用這項功能。

工具註解

破壞性提示:❌ | 等冪提示:✅ | 唯讀提示:✅ | 開放世界提示:❌