Tool: list_metric_descriptors
Verwenden Sie dieses Tool als primäres Tool, um die Arten von Messwerten zu ermitteln, die in einem Google Cloud-Projekt verfügbar sind. Das ist ein guter erster Schritt, um zu verstehen, welche Daten für das Monitoring und zum Erstellen von Dashboards oder Benachrichtigungen verfügbar sind.
Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_metric_descriptors 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_metric_descriptors", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Eingabeschema
Die ListMetricDescriptors-Anfrage.
ListMetricDescriptorsRequest
| JSON-Darstellung |
|---|
{ "name": string, "filter": string, "pageSize": integer, "pageToken": string, "activeOnly": boolean } |
| Felder | |
|---|---|
name |
Erforderlich. Das Projekt, in dem die Anfrage ausgeführt werden soll. Das Format dafür ist: |
filter |
Optional. Wenn dieses Feld leer ist, werden alle benutzerdefinierten und systemdefinierten Messwertdeskriptoren zurückgegeben. Andernfalls wird mit dem filter angegeben, welche Messwertdeskriptoren zurückgegeben werden sollen. Der folgende Filter stimmt beispielsweise mit allen benutzerdefinierten Messwerten überein: |
pageSize |
Optional. Eine positive Zahl, die die maximale Anzahl der zurückzugebenden Ergebnisse angibt. Der Standard- und der Höchstwert sind 10.000. Wenn ein page_size-Wert <= 0 oder > 10.000 übergeben wird, werden stattdessen maximal 10.000 Ergebnisse zurückgegeben. |
pageToken |
Optional. Wenn dieses Feld nicht leer ist, muss es den |
activeOnly |
Optional. Wenn „true“, werden in die Antwort nur Messwerte und überwachte Ressourcentypen mit aktuellen Daten (innerhalb von etwa 25 Stunden) aufgenommen. – Wenn in einem Messwertdeskriptor überwachte Ressourcentypen aufgeführt sind, werden nur die überwachten Ressourcentypen, für die der Messwerttyp aktuelle Daten enthält, in den zurückgegebenen Messwertdeskriptor aufgenommen. Wenn für keinen der überwachten Ressourcentypen aktuelle Daten vorhanden sind, wird der Messwertdeskriptor nicht zurückgegeben. – Wenn in einem Messwertdeskriptor die kompatiblen überwachten Ressourcentypen nicht aufgeführt sind, wird er nur zurückgegeben, wenn der Messwerttyp aktuelle Daten für einen überwachten Ressourcentyp enthält. Der zurückgegebene Deskriptor listet keine Typen von überwachten Ressourcen auf. |
Ausgabeschema
Die ListMetricDescriptors-Antwort.
ListMetricDescriptorsResponse
| JSON-Darstellung |
|---|
{
"metricDescriptors": [
{
object ( |
| Felder | |
|---|---|
metricDescriptors[] |
Die Messwertdeskriptoren, die für das Projekt verfügbar sind und mit dem Wert von |
nextPageToken |
Wenn mehr Ergebnisse vorhanden sind, als zurückgegeben wurden, wird dieses Feld auf einen nicht leeren Wert gesetzt. Um die zusätzlichen Ergebnisse zu sehen, verwenden Sie diesen Wert als |
MetricDescriptor
| JSON-Darstellung |
|---|
{ "name": string, "type": string, "labels": [ { object ( |
| Felder | |
|---|---|
name |
Der Ressourcenname des Messwertdeskriptors. |
type |
Der Messwerttyp, einschließlich des Präfixes des DNS-Namens. Der Typ ist nicht URL-codiert. Alle benutzerdefinierten Messwerttypen haben den DNS-Namen |
labels[] |
Die Menge der Labels, die zum Beschreiben einer bestimmten Instanz dieses Messwerttyps verwendet werden können. Der Messwerttyp |
metricKind |
Gibt an, ob für den Messwert Momentanwerte oder Änderungen an einem Wert erfasst werden. Einige Kombinationen von |
valueType |
Gibt an, ob es sich bei der Messung um eine Ganzzahl, eine Gleitkommazahl usw. handelt. Einige Kombinationen aus |
unit |
Die Einheiten, in denen der Messwert gemeldet wird. Dies gilt nur, wenn In verschiedenen Systemen werden die Werte möglicherweise skaliert, um die Darstellung zu vereinfachen. So kann ein Wert von Wenn Sie mit einem benutzerdefinierten Messwert die genaue Anzahl der von einem Job verwendeten CPU-Sekunden erfassen möchten, können Sie einen Wenn Sie möchten, dass ein benutzerdefinierter Messwert Daten auf granularere Weise erfasst, können Sie alternativ einen Die unterstützten Einheiten sind eine Teilmenge des Standards Unified Code for Units of Measure: Grundeinheiten (UNIT)
Präfixe (PREFIX)
Grammatik Die Grammatik umfasst auch diese Konnektoren:
Die Grammatik für eine Einheit lautet so: Hinweise:
|
description |
Eine detaillierte Beschreibung des Messwerts, die in der Dokumentation verwendet werden kann. |
displayName |
Ein prägnanter Name für den Messwert, der in Benutzeroberflächen angezeigt werden kann. Verwenden Sie die normale Groß- und Kleinschreibung ohne Schlusspunkt, z. B. „Anzahl der Anfragen“. Dieses Feld ist optional, sollte aber für alle Messwerte festgelegt werden, die mit für Nutzer sichtbaren Konzepten wie dem Kontingent verknüpft sind. |
metadata |
Optional. Metadaten, die zur Orientierung bei der Verwendung des Messwerts dienen können. |
launchStage |
Optional. Die Einführungsphase der Messwertdefinition. |
monitoredResourceTypes[] |
Nur Lesezugriff. Falls vorhanden, kann ein |
LabelDescriptor
| JSON-Darstellung |
|---|
{
"key": string,
"valueType": enum ( |
| Felder | |
|---|---|
key |
Der Schlüssel für dieses Label. Der Schlüssel muss die folgenden Kriterien erfüllen:
|
valueType |
Der Datentyp, der dem Label zugewiesen werden kann. |
description |
Eine für Menschen lesbare Beschreibung des Labels. |
MetricDescriptorMetadata
| JSON-Darstellung |
|---|
{ "launchStage": enum ( |
| Felder | |
|---|---|
launchStage |
Verworfen Stattdessen muss |
samplePeriod |
Der Stichprobenzeitraum von Messwertdatenpunkten. Bei Messwerten, die regelmäßig geschrieben werden, werden aufeinanderfolgende Datenpunkte in diesem Zeitintervall gespeichert, wobei Datenverlust aufgrund von Fehlern nicht einberechnet wird. Messwerte mit einer höheren Granularität haben einen kürzeren Sampling-Zeitraum. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
ingestDelay |
Die Verzögerung von Datenpunkten aufgrund der Aufnahme. Datenpunkte, die älter als dieser Wert sind, werden garantiert aufgenommen und stehen zum Lesen bereit, wobei Datenverlust aufgrund von Fehlern nicht einberechnet wird. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
timeSeriesResourceHierarchyLevel[] |
Der Umfang der Zeitachsendaten des Messwerts. |
Dauer
| JSON-Darstellung |
|---|
{ "seconds": string, "nanos": integer } |
| Felder | |
|---|---|
seconds |
Vorzeichenbehaftete Sekunden des Zeitraums. Muss zwischen -315.576.000.000 und +315.576.000.000 (einschließlich) liegen. Hinweis: Diese Grenzwerte werden so berechnet: 60 Sek./Min. × 60 Min./Std. × 24 Std./Tag × 365,25 Tage/Jahr × 10.000 Jahre |
nanos |
Signierte Sekundenbruchteile mit Nanosekunden-Auflösung des Zeitraums. Dauern von weniger als einer Sekunde werden mit dem Feld |
ValueType
Werttypen, die als Labelwerte verwendet werden können.
| Enums | |
|---|---|
STRING |
Ein String mit variabler Länge, der 1.024 Zeichen nicht überschreiten darf. Dies ist der Standardwerttyp. |
BOOL |
Boolesch; „true“ oder „false“. |
INT64 |
Eine vorzeichenbehaftete 64-Bit-Ganzzahl. |
MetricKind
Die Art der Messung. Sie beschreibt, wie die Daten gemeldet werden. Informationen zum Festlegen der Start- und Endzeit basierend auf „MetricKind“ finden Sie unter TimeInterval.
| Enums | |
|---|---|
METRIC_KIND_UNSPECIFIED |
Diesen Standardwert nicht verwenden. |
GAUGE |
Die Momentmessung eines Werts. |
DELTA |
Die Änderung eines Werts während eines Zeitintervalls. |
CUMULATIVE |
Ein über ein Zeitintervall hinweg kumulierter Wert. Kumulative Messungen in einer Zeitreihe sollten dieselbe Startzeit und ansteigende Endzeiten haben, bis ein Ereignis den kumulativen Wert auf null zurücksetzt und für die nachfolgenden Punkte eine neue Startzeit festlegt. |
ValueType
Der Werttyp eines Messwerts.
| Enums | |
|---|---|
VALUE_TYPE_UNSPECIFIED |
Diesen Standardwert nicht verwenden. |
BOOL |
Der Wert ist ein boolescher Wert. Dieser Werttyp kann nur verwendet werden, wenn die Messwertart GAUGE ist. |
INT64 |
Der Wert ist eine vorzeichenbehaftete 64-Bit-Ganzzahl. |
DOUBLE |
Der Wert ist eine Gleitkommazahl mit doppelter Genauigkeit. |
STRING |
Der Wert ist ein Textstring. Dieser Werttyp kann nur verwendet werden, wenn die Messwertart GAUGE ist. |
DISTRIBUTION |
Der Wert ist ein . |
MONEY |
Der Wert ist ein Geldwert. |
LaunchStage
Die Einführungsphase, wie in den Einführungsphasen der Google Cloud Platform definiert.
| Enums | |
|---|---|
LAUNCH_STAGE_UNSPECIFIED |
Diesen Standardwert nicht verwenden. |
UNIMPLEMENTED |
Die Funktion ist noch nicht implementiert. Nutzer können sie nicht verwenden. |
PRELAUNCH |
Funktionen vor der Markteinführung sind für Nutzer ausgeblendet und nur intern sichtbar. |
EARLY_ACCESS |
Early-Access-Features sind auf eine ausgewählte Gruppe von Testern beschränkt. Wenn Sie diese Funktionen nutzen möchten, müssen Sie sich im Voraus registrieren und eine Trusted Tester-Vereinbarung unterzeichnen, die Vertraulichkeitsbestimmungen enthält. Die Funktionen können instabil sein und nicht abwärtskompatible Änderungen enthalten. Außerdem ist nicht gewährleistet, dass sie freigegeben werden. |
ALPHA |
Alpha ist eine Testphase mit begrenzter Verfügbarkeit, bevor Versionen zur allgemeinen Verwendung freigegeben werden. Bis zur Alpha-Phase sind alle wichtigen Designprobleme behoben und wir überprüfen die Funktionalität. Alphakunden müssen den Zugriff beantragen, den anwendbaren Nutzungsbedingungen zustimmen und ihre Projekte auf die Zulassungsliste setzen lassen. Alphaversionen müssen nicht vollständig sein und sind weder mit SLAs noch mit technischen Supportverpflichtungen verbunden. Sie sind jedoch so weit entwickelt, dass Kunden sie in Testumgebungen oder für Tests mit eingeschränkter Nutzung verwenden können – genau wie in normalen Produktionsumgebungen. |
BETA |
Beta ist der Punkt, an dem wir ein Release für die Kunden freigeben. Sie sind weder mit SLAs, noch mit technischen Supportverpflichtungen verbunden. Die Produkte enthalten alle vorgesehenen Funktionen, können jedoch noch offene Probleme aufweisen. Betareleases eignen sich nur eingeschränkt für Produktionsumgebungen. |
GA |
GA-Funktionen stehen allen Entwicklern zur Verfügung und gelten als stabil und voll qualifiziert für den Einsatz in der Produktion. |
DEPRECATED |
Verworfene Features werden an einem bestimmten Termin eingestellt oder entfernt. Weitere Informationen finden Sie in unseren Nutzungsbedingungen im Abschnitt „Richtlinie zur Einstellung von Produkten und Diensten“ und in der Dokumentation Google Cloud Platform-Dienste, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen. |
TimeSeriesResourceHierarchyLevel
Die Ebene der Ressourcenhierarchie der Zeitreihendaten einer Messgröße.
| Enums | |
|---|---|
TIME_SERIES_RESOURCE_HIERARCHY_LEVEL_UNSPECIFIED |
Diesen Standardwert nicht verwenden. |
PROJECT |
Weist einem Projekt einen Messwert zu. |
ORGANIZATION |
Schränkt einen Messwert auf eine Organisation ein. |
FOLDER |
Weist einem Messwert einen Ordner zu. |
Tool-Annotationen
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌