MCP Tools Reference: monitoring.googleapis.com

Herramienta: list_alerts

Usa esta herramienta como la principal para enumerar las alertas en un proyecto de Google Cloud. Una alerta es la representación de un incumplimiento de una política de alertas. Esto es útil para comprender los incumplimientos actuales y pasados de una política de alertas.

En la siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta de MCP list_alerts.

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

Esquema de entrada

Es la solicitud de ListAlerts.

ListAlertsRequest

Representación JSON
{
  "parent": string,
  "filter": string,
  "orderBy": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
parent

string

Obligatorio. Es el nombre del proyecto para el que se enumerarán las alertas.

filter

string

Es opcional. Se devuelve una alerta si hay una coincidencia en cualquiera de los campos que pertenecen a la alerta o sus subcampos.

orderBy

string

Es opcional. Es una lista separada por comas de los campos de Alert que se usarán para la ordenación. La dirección de orden predeterminada es ascendente. Para especificar el orden descendente de un campo, agrega un modificador desc. Se admiten los siguientes campos:

  • open_time
  • close_time

Por ejemplo, close_time desc, open_time devolverá las alertas cerradas más recientemente, y los empates se resolverán en el orden de las alertas más antiguas que se enumeran primero.

Si no se establece el campo, los resultados se ordenan por open_time desc.

pageSize

integer

Es opcional. Es la cantidad máxima de resultados que se devolverán en una sola respuesta. Si no se establece en un número positivo, se devolverán, como máximo, 50 alertas. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.

pageToken

string

Es opcional. Si no está vacío, page_token debe contener un valor que se haya devuelto como next_page_token en una respuesta anterior para solicitar el siguiente conjunto de resultados.

Esquema de salida

Es la respuesta de ListAlerts.

ListAlertsResponse

Representación JSON
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campos
alerts[]

object (Alert)

Es la lista de alertas.

nextPageToken

string

Si no está vacío, indica que puede haber más resultados que coincidan con la solicitud. Usa el valor del campo page_token en una solicitud posterior para recuperar el siguiente conjunto de resultados. El token está encriptado y solo se garantiza que devuelva resultados correctos durante 72 horas después de su creación. Si está vacío, se devolvieron todos los resultados.

totalSize

integer

Es la cantidad total estimada de resultados coincidentes para esta búsqueda.

Alerta

Representación 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)
  }
}
Campos
name

string

Es el identificador. Es el nombre de la alerta.

El formato es el siguiente:

projects/[PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID]

[ALERT_ID] es un identificador único asignado por el sistema para la alerta.

state

enum (State)

Solo salida. Es el estado actual de la alerta.

openTime

string (Timestamp format)

Fecha y hora en que se abrió la alerta.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

closeTime

string (Timestamp format)

Es la fecha y hora en que se cerró la alerta.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

resource

object (MonitoredResource)

El tipo de recurso supervisado y las etiquetas de recursos supervisados que se conservaron de la condición que generó el incidente.

metadata

object (MonitoredResourceMetadata)

Son los metadatos del recurso supervisado.

metric

object (Metric)

El tipo de métrica y las etiquetas de métrica conservadas de la condición que generó el incidente.

log

object (LogMetadata)

Es la información de registro asociada con la alerta. Este campo solo se completa para las alertas basadas en registros.

policy

object (PolicySnapshot)

Es la instantánea de la política de alertas que generó esta alerta.

Marca de tiempo

Representación JSON
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).

nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

MonitoredResource

Representación JSON
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
Campos
type

string

Obligatorio. Es el tipo de recurso supervisado. Este campo debe coincidir con el campo type de un objeto MonitoredResourceDescriptor. Por ejemplo, el tipo de una instancia de VM de Compute Engine es gce_instance. Para obtener una lista de los tipos, consulta Tipos de recursos de Monitoring y Tipos de recursos de Logging.

labels

map (key: string, value: string)

Obligatorio. Valores para todas las etiquetas que se enumeran en el descriptor de recurso supervisado asociado. Por ejemplo, las instancias de VM de Compute Engine usan las etiquetas "project_id", "instance_id" y "zone".

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

LabelsEntry

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

MonitoredResourceMetadata

Representación JSON
{
  "systemLabels": {
    object
  },
  "userLabels": {
    string: string,
    ...
  }
}
Campos
systemLabels

object (Struct format)

Solo salida. Son los valores de las etiquetas de metadatos del sistema predefinidas. Las etiquetas del sistema son un tipo de metadatos que extrae Google, como "machine_image", "vpc", "subnet_id", "security_group", "name", etcétera. Los valores de las etiquetas del sistema solo pueden ser cadenas, valores booleanos o una lista de cadenas. Por ejemplo:

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

map (key: string, value: string)

Solo salida. Es un mapa de etiquetas de metadatos definidas por el usuario.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Struct

Representación JSON
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Es un mapa no ordenado de valores escritos de forma dinámica.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representación JSON
{
  "key": string,
  "value": value
}
Campos
key

string

value

value (Value format)

Valor

Representación 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.
}
Campos
Campo de unión kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes:
nullValue

null

Representa un null de JSON.

numberValue

number

Representa un número JSON. No debe ser NaN, Infinity ni -Infinity, ya que no se admiten en JSON. Tampoco puede representar valores Int64 grandes, ya que el formato JSON generalmente no los admite en su tipo de número.

stringValue

string

Representa una cadena JSON.

boolValue

boolean

Representa un valor booleano de JSON (literal true o false en JSON).

structValue

object (Struct format)

Representa un objeto JSON.

listValue

array (ListValue format)

Representa un array JSON.

ListValue

Representación JSON
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Es un campo repetido de valores escritos de forma dinámica.

UserLabelsEntry

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

Métrica

Representación JSON
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
Campos
type

string

Es un tipo de métrica existente. Consulta google.api.MetricDescriptor. Por ejemplo, custom.googleapis.com/invoice/paid/amount

labels

map (key: string, value: string)

Es el conjunto de valores de etiqueta que identifican de forma única esta métrica. Se deben asignar valores a todas las etiquetas que se enumeran en MetricDescriptor.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

LabelsEntry

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

LogMetadata

Representación JSON
{
  "extractedLabels": {
    string: string,
    ...
  }
}
Campos
extractedLabels

map (key: string, value: string)

Son las etiquetas extraídas del registro.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ExtractedLabelsEntry

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

PolicySnapshot

Representación JSON
{
  "name": string,
  "displayName": string,
  "severity": enum (Severity),
  "userLabels": {
    string: string,
    ...
  }
}
Campos
name

string

Es el nombre del recurso de la política de alertas. Tiene el formato "projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]".

displayName

string

Es el nombre visible de la política de alertas.

severity

enum (Severity)

Es la gravedad de la política de alertas.

userLabels

map (key: string, value: string)

Son las etiquetas de usuario de la política de alertas.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

UserLabelsEntry

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

Estado

Es la enumeración de los posibles estados de una alerta.

Enums
STATE_UNSPECIFIED El estado de la alerta no está especificado.
OPEN La alerta está abierta.
CLOSED Se cerró la alerta.

NullValue

Representa un null de JSON.

NullValue es un centinela que usa un enum con solo un valor para representar el valor nulo de la unión de tipos Value.

Un campo de tipo NullValue con cualquier valor que no sea 0 se considera no válido. La mayoría de los serializadores de ProtoJSON emitirán un Value con un null_value establecido como un null de JSON, independientemente del valor entero, por lo que se realizará un viaje de ida y vuelta a un valor de 0.

Enums
NULL_VALUE Valor nulo.

Gravedad

Es una enumeración del nivel de gravedad posible para una política de alertas.

Enums
SEVERITY_UNSPECIFIED No se especificó la gravedad. Este es el valor predeterminado.
CRITICAL Este es el nivel de gravedad más alto. Usa esta opción si el problema podría causar daños o tiempo de inactividad significativos.
ERROR Este es el nivel de gravedad medio. Usa esta opción si el problema podría causar daños menores o tiempo de inactividad.
WARNING Este es el nivel de gravedad más bajo. Usa esta opción si el problema no causa daños ni tiempo de inactividad, pero podría generar un problema en el futuro.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌