MCP Tools Reference: monitoring.googleapis.com

工具：get_alert

這是取得特定快訊資訊的主要工具。警示代表違反警示政策。這有助於瞭解特定快訊的詳細資料。

下列程式碼範例說明如何使用 curl 呼叫 get_alert 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": "get_alert",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

GetAlert 要求。

GetAlertRequest

JSON 表示法 
{
  "name": string
}
欄位
name

string

這是必要旗標，快訊名稱。

格式為：

projects/[PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID]

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

輸出內容的結構定義

警示代表違反警示政策。這是唯讀資源，無法透過隨附的 API 修改。

快訊

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

工具註解

工具註解會傳送至 MCP 用戶端，說明特定工具的基本風險。大多數用戶端會將這些提示視為不受信任，但可用於決定何時向使用者傳送確認提示。

除了標題字串外，以下布林提示的定義如下：

  • readOnlyHint：如果為 true，工具不會修改環境。預設值：false。
  • destructiveHint：如果為 true，工具可以執行破壞性動作。如果為 false，工具只能執行加法動作。預設值：true。
  • idempotentHint：如果為 true，以相同引數重複呼叫工具，對環境不會有額外影響。預設值：false。
  • openWorldHint：設為 true 時，工具可以與外部實體的「開放世界」互動。如果為 false，工具只能與內部實體互動。舉例來說，網頁搜尋工具屬於開放世界，記憶體工具則不屬於開放世界。

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