MCP Tools Reference: monitoring.googleapis.com

Tool: list_alerts

Verwenden Sie dieses Tool als primäres Tool, um die Benachrichtigungen in einem Google Cloud-Projekt aufzulisten. Eine Benachrichtigung ist die Darstellung eines Verstoßes gegen eine Benachrichtigungsrichtlinie. So können Sie aktuelle und vergangene Verstöße gegen eine Benachrichtigungsrichtlinie nachvollziehen.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_alerts aufrufen.

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

Eingabeschema

Die ListAlerts-Anfrage.

ListAlertsRequest

JSON-Darstellung 
{
  "parent": string,
  "filter": string,
  "orderBy": string,
  "pageSize": integer,
  "pageToken": string
}
Felder
parent

string

Erforderlich. Der Name des Projekts, für das Benachrichtigungen aufgelistet werden sollen.
filter

string

Optional. Eine Benachrichtigung wird zurückgegeben, wenn es eine Übereinstimmung in einem der Felder gibt, die zur Benachrichtigung oder zu ihren Unterfeldern gehören.
orderBy

string

Optional. Eine durch Kommas getrennte Liste von Feldern in Alert, die zum Sortieren verwendet werden sollen. Die Standardsortierrichtung ist aufsteigend. Wenn Sie ein Feld absteigend sortieren möchten, fügen Sie den Modifikator desc hinzu. Die folgenden Felder werden unterstützt:

  • open_time
  • close_time

Wenn Sie beispielsweise close_time desc, open_time angeben, werden die zuletzt geschlossenen Benachrichtigungen zurückgegeben. Bei Gleichstand werden ältere Benachrichtigungen zuerst aufgeführt.

Wenn das Feld nicht festgelegt ist, werden die Ergebnisse nach open_time desc sortiert.
pageSize

integer

Optional. Die maximale Anzahl von Ergebnissen, die in einer einzelnen Antwort zurückgegeben werden sollen. Wenn nicht auf eine positive Zahl festgelegt, werden maximal 50 Benachrichtigungen zurückgegeben. Der Höchstwert liegt bei 1.000. Alle Werte darüber werden implizit in 1.000 umgewandelt.
pageToken

string

Optional. Wenn page_token nicht leer ist, muss es einen Wert enthalten, der in einer vorherigen Antwort als next_page_token zurückgegeben wurde, um den nächsten Satz von Ergebnissen anzufordern.

Ausgabeschema

Die ListAlerts-Antwort.

ListAlertsResponse

JSON-Darstellung 
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Felder
alerts[]

object (Alert)

Die Liste der Benachrichtigungen.
nextPageToken

string

Wenn der Wert nicht leer ist, gibt er an, dass es möglicherweise weitere Ergebnisse gibt, die der Anfrage entsprechen. Verwenden Sie den Wert im Feld page_token in einer nachfolgenden Anfrage, um die nächste Gruppe von Ergebnissen abzurufen. Das Token ist verschlüsselt und gibt nur innerhalb von 72 Stunden nach seiner Erstellung garantiert korrekte Ergebnisse zurück. Wenn leer, wurden alle Ergebnisse zurückgegeben.
totalSize

integer

Die geschätzte Gesamtzahl der übereinstimmenden Ergebnisse für diese Anfrage.

Benachrichtigung

JSON-Darstellung 
{
  "name": string,
  "state": enum (State),
  "openTime": string,
  "closeTime": string,
  "resource": {
    object (MonitoredResource)
  },
  "metadata": {
    object (MonitoredResourceMetadata)
  },
  "metric": {
    object (Metric)
  },
  "log": {
    object (LogMetadata)
  },
  "policy": {
    object (PolicySnapshot)
  }
}
Felder
name

string

ID. Der Name der Benachrichtigung.

Das Format dafür ist:

projects/[PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID]

[ALERT_ID] ist eine vom System zugewiesene eindeutige Kennung für die Benachrichtigung.
state

enum (State)

Nur Ausgabe. Der aktuelle Status der Benachrichtigung.
openTime

string (Timestamp format)

Die Uhrzeit, zu der die Benachrichtigung geöffnet wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
closeTime

string (Timestamp format)

Datum und Uhrzeit, zu der die Benachrichtigung geschlossen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
resource

object (MonitoredResource)

Der Typ der überwachten Ressource und alle Labels der überwachten Ressource, die aus der Bedingung zum Generieren des Vorfalls beibehalten wurden.
metadata

object (MonitoredResourceMetadata)

Die Metadaten der überwachten Ressource.
metric

object (Metric)

Der Messwerttyp und alle Messwertlabels, die aus der Bedingung beibehalten wurden, die das Ereignis ausgelöst hat.
log

object (LogMetadata)

Die mit der Benachrichtigung verknüpften Protokollinformationen. Dieses Feld wird nur für logbasierte Benachrichtigungen ausgefüllt.
policy

object (PolicySnapshot)

Der Snapshot der Benachrichtigungsrichtlinie, durch die diese Benachrichtigung generiert wurde.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

MonitoredResource

JSON-Darstellung 
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
Felder
type

string

Erforderlich. Der Typ der überwachten Ressource. Dieses Feld muss mit dem Feld type eines MonitoredResourceDescriptor-Objekts übereinstimmen. Der Typ einer Compute Engine-VM-Instanz ist beispielsweise gce_instance. Eine Liste der Typen finden Sie unter Monitoring-Ressourcentypen und Logging-Ressourcentypen.
labels

map (key: string, value: string)

Erforderlich. Werte für alle Labels, die im zugehörigen Deskriptor der überwachten Ressource aufgeführt sind. Für Compute Engine-VM-Instanzen werden beispielsweise die Labels "project_id", "instance_id" und "zone" verwendet.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

LabelsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

MonitoredResourceMetadata

JSON-Darstellung 
{
  "systemLabels": {
    object
  },
  "userLabels": {
    string: string,
    ...
  }
}
Felder
systemLabels

object (Struct format)

Nur Ausgabe Werte für vordefinierte Labels für Systemmetadaten. Systemlabels sind eine Art von Metadaten, die von Google extrahiert werden. Dazu gehören "machine_image", "vpc", "subnet_id", "security_group", "name" usw. Die Systemlabelwerte können nur Strings, boolesche Werte oder eine Liste von Strings sein. Beispiel:

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

map (key: string, value: string)

Nur Ausgabe Eine Zuordnung mit benutzerdefinierten Metadatenlabels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Struct

JSON-Darstellung 
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

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

Ungeordnete Zuordnung von dynamisch typisierten Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung 
{
  "key": string,
  "value": value
}
Felder
key

string
value

value (Value format)

Wert

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt ein JSON-null dar.
numberValue

number

Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Auch große Int64-Werte können nicht dargestellt werden, da das JSON-Format sie in seinem Zahlentyp generell nicht unterstützt.
stringValue

string

Stellt einen JSON-String dar.
boolValue

boolean

Stellt einen booleschen JSON-Wert dar (true- oder false-Literal in JSON).
structValue

object (Struct format)

Stellt ein JSON-Objekt dar.
listValue

array (ListValue format)

Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung 
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederkehrendes Feld mit dynamisch typisierten Werten.

UserLabelsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

Messwert

JSON-Darstellung 
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
Felder
type

string

Ein vorhandener Messwerttyp (siehe google.api.MetricDescriptor). Beispiel: custom.googleapis.com/invoice/paid/amount
labels

map (key: string, value: string)

Die Menge der Labelwerte, die diesen Messwert eindeutig identifizieren. Allen in MetricDescriptor aufgeführten Labels müssen Werte zugewiesen werden.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

LabelsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

LogMetadata

JSON-Darstellung 
{
  "extractedLabels": {
    string: string,
    ...
  }
}
Felder
extractedLabels

map (key: string, value: string)

Die aus dem Log extrahierten Labels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ExtractedLabelsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

PolicySnapshot

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "severity": enum (Severity),
  "userLabels": {
    string: string,
    ...
  }
}
Felder
name

string

Der Name der Benachrichtigungsrichtlinienressource. Im Format „projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]“.
displayName

string

Der Anzeigename der Benachrichtigungsrichtlinie.
severity

enum (Severity)

Der Schweregrad der Benachrichtigungsrichtlinie.
userLabels

map (key: string, value: string)

Die Nutzerlabels für die Benachrichtigungsrichtlinie.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

UserLabelsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

Bundesland

Die Aufzählung der möglichen Status für eine Benachrichtigung.

Enums
STATE_UNSPECIFIED Der Benachrichtigungsstatus ist nicht angegeben.
OPEN Die Benachrichtigung ist offen.
CLOSED Die Benachrichtigung wurde geschlossen.

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der einen Enum mit nur einem Wert verwendet, um den Nullwert für die Typunion Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 gilt als ungültig. Die meisten ProtoJSON-Serialisierungsprogramme geben ein Value mit einem als JSON-null festgelegten null_value aus, unabhängig vom Ganzzahlwert. Daher wird ein Roundtrip zu einem 0-Wert durchgeführt.

Enums
NULL_VALUE Nullwert.

Schweregrad

Eine Aufzählung der möglichen Schweregrade für eine Benachrichtigungsrichtlinie.

Enums
SEVERITY_UNSPECIFIED Es wurde kein Schweregrad angegeben. Dies ist der Standardwert.
CRITICAL Dies ist die höchste Schweregradstufe. Verwenden Sie diese Option, wenn das Problem zu erheblichen Schäden oder Ausfallzeiten führen könnte.
ERROR Dies ist der mittlere Schweregrad. Verwenden Sie diese Option, wenn das Problem zu geringfügigen Schäden oder Ausfallzeiten führen könnte.
WARNING Dies ist der niedrigste Schweregrad. Verwenden Sie diese Option, wenn das Problem keine Schäden oder Ausfallzeiten verursacht, aber in Zukunft zu einem Problem führen könnte.

Tool-Annotationen

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌