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 |
Obligatorio. Es el nombre del proyecto para el que se enumerarán las alertas. |
filter |
Es opcional. Se devuelve una alerta si hay una coincidencia en cualquiera de los campos que pertenecen a la alerta o sus subcampos. |
orderBy |
Es opcional. Es una lista separada por comas de los campos de
Por ejemplo, Si no se establece el campo, los resultados se ordenan por |
pageSize |
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 |
Es opcional. Si no está vacío, |
Esquema de salida
Es la respuesta de ListAlerts.
ListAlertsResponse
| Representación JSON |
|---|
{
"alerts": [
{
object ( |
| Campos | |
|---|---|
alerts[] |
Es la lista de alertas. |
nextPageToken |
Si no está vacío, indica que puede haber más resultados que coincidan con la solicitud. Usa el valor del campo |
totalSize |
Es la cantidad total estimada de resultados coincidentes para esta búsqueda. |
Alerta
| Representación JSON |
|---|
{ "name": string, "state": enum ( |
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre de la alerta. El formato es el siguiente:
|
state |
Solo salida. Es el estado actual de la alerta. |
openTime |
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: |
closeTime |
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: |
resource |
El tipo de recurso supervisado y las etiquetas de recursos supervisados que se conservaron de la condición que generó el incidente. |
metadata |
Son los metadatos del recurso supervisado. |
metric |
El tipo de métrica y las etiquetas de métrica conservadas de la condición que generó el incidente. |
log |
Es la información de registro asociada con la alerta. Este campo solo se completa para las alertas basadas en registros. |
policy |
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 |
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 |
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 |
Obligatorio. Es el tipo de recurso supervisado. Este campo debe coincidir con el campo |
labels |
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 Un objeto que contiene una lista de pares |
LabelsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
MonitoredResourceMetadata
| Representación JSON |
|---|
{ "systemLabels": { object }, "userLabels": { string: string, ... } } |
| Campos | |
|---|---|
systemLabels |
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: |
userLabels |
Solo salida. Es un mapa de etiquetas de metadatos definidas por el usuario. Un objeto que contiene una lista de pares |
Struct
| Representación JSON |
|---|
{ "fields": { string: value, ... } } |
| Campos | |
|---|---|
fields |
Es un mapa no ordenado de valores escritos de forma dinámica. Un objeto que contiene una lista de pares |
FieldsEntry
| Representación JSON |
|---|
{ "key": string, "value": value } |
| Campos | |
|---|---|
key |
|
value |
|
Valor
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes: |
|
nullValue |
Representa un |
numberValue |
Representa un número JSON. No debe ser |
stringValue |
Representa una cadena JSON. |
boolValue |
Representa un valor booleano de JSON (literal |
structValue |
Representa un objeto JSON. |
listValue |
Representa un array JSON. |
ListValue
| Representación JSON |
|---|
{ "values": [ value ] } |
| Campos | |
|---|---|
values[] |
Es un campo repetido de valores escritos de forma dinámica. |
UserLabelsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
Métrica
| Representación JSON |
|---|
{ "type": string, "labels": { string: string, ... } } |
| Campos | |
|---|---|
type |
Es un tipo de métrica existente. Consulta |
labels |
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 Un objeto que contiene una lista de pares |
LabelsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
LogMetadata
| Representación JSON |
|---|
{ "extractedLabels": { string: string, ... } } |
| Campos | |
|---|---|
extractedLabels |
Son las etiquetas extraídas del registro. Un objeto que contiene una lista de pares |
ExtractedLabelsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
PolicySnapshot
| Representación JSON |
|---|
{
"name": string,
"displayName": string,
"severity": enum ( |
| Campos | |
|---|---|
name |
Es el nombre del recurso de la política de alertas. Tiene el formato "projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]". |
displayName |
Es el nombre visible de la política de alertas. |
severity |
Es la gravedad de la política de alertas. |
userLabels |
Son las etiquetas de usuario de la política de alertas. Un objeto que contiene una lista de pares |
UserLabelsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
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: ❌