Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Einführung in die Cloud Monitoring API

Auf dieser Seite werden einige Funktionen der Cloud Monitoring API v3 beschrieben.

Die API-Referenzdokumentation finden Sie auf einer der folgenden Seiten:

Projektnamen in der Monitoring API

Alle Methoden in der Monitoring API haben den erforderlichen Parameter name. Dieser Parameter enthält in der Regel eine Beschreibung wie die folgende:

Erforderlich. Das Projekt, in dem die Anfrage ausgeführt werden soll. Das Format dafür ist:
projects/[PROJECT_ID_OR_NUMBER]

In der Monitoring API wird beim Wert von PROJECT_ID_OR_NUMBER Folgendes angegeben:

  • Ein Google Cloud-Projekt
  • Ein Google Cloud-Projekt, das gleichzeitig ein Anwendungsbereich eines Messwertbereichs (oder des Hostprojekts des Arbeitsbereichs) ist

Für einige Methoden in der Monitoring API muss das Projekt ein Hostprojekt eines Messwertbereichs (oder des Hostprojekts des Arbeitsbereichs) sein. andere Methoden von Google. Bei einer geringen Anzahl von Methoden können je nach Projekttyp unterschiedliche Ergebnisse zurückgegeben werden.

Zum Beschreiben dieser Klassen von Methoden wird in der Diskussion der Begriff Messwerte-API verwendet, um auf die folgenden Ressourcen in der Monitoring API zu verweisen:

Umfang des Projektbereichs eines Messwertbereichs (oder des Hostprojekts des Arbeitsbereichs) erforderlich

Alle Monitoring API-Methoden, die nicht Teil der Metrics API sind, müssen den Parameter name auf ein Bereichsprojekt eines Messwertbereichs oder auch auf das Hostprojekt des Arbeitsbereichs verweisen.

Umfang eines Projektbereichs eines Messwertbereichs (oder des Hostprojekts des Arbeitsbereichs) nicht erforderlich

Keine der Methoden in der Metrics API erfordert, dass der Parameter name auf ein Bereichsprojekt eines Messwertbereichs (oder des Hostprojekts des Arbeitsbereichs) verweist. Einige Methoden verhalten sich jedoch anders:

  • Die folgenden Methoden in der Metrics API arbeiten mit dem benannten Cloud-Projekt. Diese Methoden wirken sich nur auf die Daten im benannten Projekt aus, unabhängig davon, ob es sich bei dem Projekt auch um das Hostprojekt eines Messwertbereichs oder das Hostprojekt des Arbeitsbereichs handelt.

    • timeSeries.create
    • metricDescriptors.create
    • metricDescriptors.delete
    • metricDescriptors.get
    • monitoredResourceDescriptors.get

  • Die restlichen Methoden in der Metrics API verhalten sich wie folgt:

    • Ist das benannte Projekt kein Umfangbereich eines Messwertbereichs oder des Hostprojekts des Arbeitsbereichs, werden mit den Methoden nur Daten aus dem benannten Projekt abgerufen.
    • Wenn das benannte Projekt auch ein Geltungsbereichprojekt eines Messwertbereichs oder des Hostprojekts des Arbeitsbereichs ist, rufen die Methoden Daten aus dem benannten Projekt und aus allen überwachten Projekten ab.

    Die Methoden in dieser Gruppe sind:

    • timeSeries.list
    • timeSeries.query
    • metricDescriptors.list
    • monitoredResourceDescriptors.list

Weitere Informationen zum Einrichten eines Cloud-Projekts als Extraktionsprojekt eines Messwertbereichs oder des Hostprojekts des Arbeitsbereichs finden Sie unter Projekt für Monitoring konfigurieren.

API-Ressourcen

Messwerte

Über die Monitoring API erhalten Sie Zugriff auf mehr als 1500 Cloud Monitoring-Messwerte von Google Cloud und Amazon Web Services. Sie können eigene benutzerdefinierte Messwerte erstellen und Ihre Cloudressourcen mithilfe von Gruppen organisieren.

Eine Einführung in Messwertkonzepte und die zugehörigen Datenstrukturen finden Sie unter Messwerte, Zeitachsen und Ressourcen.

Informationen zum Verwalten Ihrer benutzerdefinierten Messwerte und der integrierten Messwerte finden Sie unter Benutzerdefinierte Messwerte verwenden.

Eine vollständige Liste der verfügbaren Messwerte finden Sie unter Messwertliste.

Überwachte Ressourcen

Bei einer überwachten Ressource werden Messwerte erfasst. Beispielsweise könnten Sie an der Aktivität einer VM-Instanz oder einer Hardware interessiert sein.

Eine Liste der verfügbaren überwachten Ressourcen finden Sie in der Liste der überwachten Ressourcen.

Überwachte Ressourcengruppen

Eine Gruppe ist eine dynamische Sammlung von überwachten Ressourcen. Sie können Gruppen immer manuell in der Monitoring-Konsole erstellen und mit der Cloud Monitoring API Code schreiben, der Gruppen erstellt und verwendet.

Weitere Informationen finden Sie in der API-Referenz für Group.

Benachrichtigungsrichtlinien

Eine Benachrichtigungsrichtlinie ist eine Konfigurationsressource, die die Kriterien zum Generieren von Vorfällen beschreibt und wie Sie benachrichtigt werden, wenn diese Vorfälle erstellt werden. Unter Benachrichtigungskonzepte werden die grundlegenden Konzepte von Benachrichtigungsrichtlinien erläutert. Weitere Informationen finden Sie in der API-Referenz für AlertPolicy.

Mit der API können Sie auch Benachrichtigungsrichtlinien basierend auf einem Verhältnis von zwei Messwerten erstellen. Derzeit können Verhältnisse nicht mithilfe von Monitoring in der Google Cloud Console erstellt werden. Weitere Informationen finden Sie unter MetricThreshold in der AlertPolicy-Referenz.

Benachrichtigungskanäle

Ein Benachrichtigungskanal ist eine Konfigurationsressource, die beschreibt, wie Sie bei Vorfällen benachrichtigt werden. Benachrichtigungskanäle können auf eine Vielzahl verschiedener Arten von Kommunikationsdiensten und -endpunkten verweisen. Diese werden in Deskriptoren angegeben. Die Deskriptoren bestimmen die Konfigurationsparameter, die in einem Channel-Objekt enthalten sind.

Weitere Informationen finden Sie in der NotificationChannel-Referenz und der NotificationChannelDescriptor-Referenz.

Dienstmonitoring

Die Ressourcen zur Dienstüberwachung werden zum Einrichten von Zielen auf Dienstebene verwendet, mit denen die Integrität Ihrer Dienste überwacht werden kann.

Service Monitoring fügt der Monitoring API die folgenden Ressourcen hinzu:

Weitere Informationen zu diesen Dienst-Monitoring-Konzepten und zur Verwendung der API finden Sie unter SLO-Monitoring.

Dashboards

Mit dem Endpunkt Dashboards können Sie sowohl Dashboards als auch Diagramme programmatisch erstellen und bearbeiten. Informationen zur Verwendung dieses Endpunkts zum Verwalten von Dashboards und Diagrammen finden Sie unter Dashboards nach API verwalten.

Monitoring-Abfragesprache

Monitoring Query Language (MQL) bietet eine textbasierte Schnittstelle zum Abfragen von Zeitachsendaten aus Cloud Monitoring. MQL verwendet ein Pipeline-Abfragemodell und ist aussagekräftiger als Monitoring-Filter. Sie können MQL-Abfragen über die Monitoring API oder den Abfrageeditor verwenden.

Allgemeine Informationen zu MQL finden Sie unter Monitoring-Abfragesprache verwenden.

Informationen zum Verwenden von MQL zum Abrufen von Zeitachsendaten mithilfe der Monitoring API finden Sie in der API-Referenz für die Methode timeSeries.query.

Weitere Informationen über das Erstellen von Dashboards mit MQL-basierten Diagrammen und der Monitoring API finden Sie in der API-Referenz für das Objekt TimeSeriesQuery. Dieses Objekt liefert den Mechanismus zum Abrufen des Datasets für ein Diagramm oder eine Kurzübersicht.

Filter

Die Monitoring API verwendet Filter, um Messwerte auszuwählen, Zeitachsendaten abzurufen und überwachte Ressourcen in Gruppen zu erfassen. Weitere Informationen finden Sie unter Filter überwachen.

Die Monitoring API verwendet auch Filter, um die Ergebnismenge bestimmter list-Vorgänge einzuschränken. Siehe Sortieren und filtern um Details zur Verwaltung der ErgebnissealertPolicies.list notificationChannels.list aufrufen.

Tipp