Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

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 }'

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 个提醒。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
`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` 相应查询的匹配结果总数估计值。

alerts[]

object (Alert)

提醒列表。

nextPageToken

string

如果不为空，则表示可能还有更多结果与请求匹配。请在后续请求中使用 page_token 字段中的值来获取下一组结果。该令牌已加密，仅保证在创建后 72 小时内返回正确的结果。如果为空，则表示已返回所有结果。

totalSize

integer

相应查询的匹配结果总数估计值。

提醒

JSON 表示法

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,
  "state": enum (State),
  "openTime": string,
  "closeTime": string,
  "resource": {
    object (MonitoredResource)
  },
  "metadata": {
    object (MonitoredResourceMetadata)
  },
  "metric": {
    object (Metric)
  },
  "log": {
    object (LogMetadata)
  },
  "policy": {
    object (PolicySnapshot)
  }
}

字段
`name`	`string` 标识符。提醒的名称。格式为： `projects/[PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID]` `[ALERT_ID]` 是系统为相应提醒分配的唯一标识符。
`state`	`enum (State)` 仅限输出。提醒的当前状态。
`openTime`	`string (Timestamp format)` 打开提醒的时间。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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)` 表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
`nanos`	`integer` 秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 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 虚拟机实例的类型为 `gce_instance`。如需查看类型列表，请参阅监控资源类型和日志记录资源类型。
`labels`	`map (key: string, value: string)` 必需。关联的受监控资源描述符中列出的所有标签的值。例如，Compute Engine 虚拟机实例使用标签 `"project_id"`、`"instance_id"` 和 `"zone"`。包含一系列 `"key": value` 对的对象。示例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。

type

string

必需。受监控的资源类型。此字段必须与 MonitoredResourceDescriptor 对象的 type 字段匹配。例如，Compute Engine 虚拟机实例的类型为 gce_instance。如需查看类型列表，请参阅监控资源类型和日志记录资源类型。

labels

map (key: string, value: string)

必需。关联的受监控资源描述符中列出的所有标签的值。例如，Compute Engine 虚拟机实例使用标签 "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" }`。

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" }`。

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 表示法

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`. }

{

  // 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 不支持这些值。此类型也无法表示较大的 Int64 值，因为 JSON 格式通常不支持在其数字类型中使用这些值。
`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)` 动态类型值的重复字段。

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" }`。

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" }`。

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 类型联合的 null 值。

如果类型为 NullValue 的字段的值不是 0，则视为无效。大多数 ProtoJSON 序列化程序都会发出一个 Value，并将 null_value 设置为 JSON null，无论整数值是多少，因此都会往返于 0 值。

枚举
`NULL_VALUE`	Null 值。

严重级别

一个枚举，包含提醒政策的可能严重程度级别。

枚举
`SEVERITY_UNSPECIFIED`	未指定严重程度。这是默认值。
`CRITICAL`	这是最高严重程度级别。如果问题可能导致严重损坏或停机，请使用此选项。
`ERROR`	这是中等严重程度级别。如果问题可能会造成轻微损坏或停机，请使用此级别。
`WARNING`	这是最低严重级别。如果问题不会造成任何损坏或停机，但未来可能会导致问题，请使用此严重程度。

工具注释

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：✅ | 开放世界提示：❌

MCP Tools Reference: monitoring.googleapis.com 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

工具：list_alerts

输入架构

ListAlertsRequest

输出架构

ListAlertsResponse

提醒

时间戳

MonitoredResource

LabelsEntry

MonitoredResourceMetadata

结构体

FieldsEntry

值

ListValue

UserLabelsEntry

指标

LabelsEntry

LogMetadata

ExtractedLabelsEntry

PolicySnapshot

UserLabelsEntry

州

NullValue

严重级别

工具注释

MCP Tools Reference: monitoring.googleapis.com

工具：`list_alerts`