Monitoring API aktivieren

Bevor Sie die Monitoring API verwenden können, müssen Sie sie aktivieren und Nutzer für den Zugriff darauf autorisieren.

Auf dieser Seite wird beschrieben, wie Sie die Monitoring API v3 aktivieren und autorisieren.

API aktivieren

Die Monitoring API muss aktiviert werden, bevor sie verwendet werden kann. Sie können den Status überprüfen und die API bei Bedarf mit dem gcloud-Befehlszeilentool des Cloud SDK oder der Cloud Console aktivieren.

Cloud SDK

  1. Wenn Sie das Cloud SDK noch nicht auf Ihrer Workstation installiert haben, finden Sie entsprechende Informationen in der Google Cloud SDK-Dokumentation.

  2. Führen Sie den folgenden Befehl auf Ihrer Workstation aus, um festzustellen, ob die Monitoring API aktiviert ist:

    gcloud services list
    

    Wenn monitoring.googleapis.com in der Ausgabe angezeigt wird, ist die API aktiviert.

  3. Wenn die API nicht aktiviert ist, führen Sie den folgenden Befehl aus, um sie zu aktivieren.

    gcloud services enable monitoring
    

Weitere Informationen finden Sie unter gcloud services.

Cloud Console

Zu APIs und Dienste

  1. Wählen Sie das Projekt aus, mit dem Sie auf die API zugreifen.
  2. Klicken Sie auf die Schaltfläche APIs und Dienste aktivieren.
  3. Suchen Sie nach "Stackdriver".
  4. Klicken Sie in den Suchergebnissen auf "Cloud Monitoring API".
  5. Wenn "API aktiviert" angezeigt wird, ist die API bereits aktiviert. Falls nicht, klicken Sie auf die Schaltfläche Aktivieren.

Verwendung der API autorisieren

Der Zugriff auf die API wird durch Rollen und Berechtigungen von Identity and Access Management (IAM) gesteuert. Jeder Methode ist eine Berechtigung zugeordnet. Berechtigungen für zugehörige Methoden werden in Rollen zusammengefasst, die dann den Nutzern gewährt werden können. Weitere Informationen finden Sie unter Zugriffssteuerung.

Sobald der Zugriff auf die API autorisiert ist, kann die API von überall aus verwendet werden. Sie können beispielsweise die Methode timeSeries.list von Ihrer lokalen Workstation aus verwenden. Sie können die API auch verwenden, um Messwerte für jede Entität zu senden, die als überwachte Ressource dargestellt werden kann. Eine Liste der verfügbaren Typen finden Sie unter Typ einer überwachten Ressource auswählen. Der Cloud Monitoring-Agent wurde jedoch für die Ausführung auf einer Cloud-VM entwickelt und funktioniert nicht auf einer lokalen Workstation.

Wenn Sie eine Anwendung schreiben, die die Monitoring API verwendet, autorisieren Sie die empfohlenen Clientbibliotheken Ihre Anwendung mit Standardanmeldedaten für Anwendungen. Dadurch werden die Autorisierungsdetails im Anwendungscode ausgeblendet.

In einigen Situationen können Sie möglicherweise auch API-Schlüssel verwenden. Dienstkonten werden jedoch im Allgemeinen empfohlen. API-Schlüssel sind in Clients wie Browsern und mobilen Anwendungen ohne Back-End-Server nützlich. Weitere Informationen finden Sie unter API-Schlüssel verwenden.

Weitere Informationen zur Authentifizierung und Autorisierung für Cloud APIs finden Sie in unserem Authentifizierungsleitfaden.

Clientbibliotheken verwenden

Nachdem Sie die Verwendung der API aktiviert und autorisiert haben, können Sie mit dem Schreiben von Code beginnen. Weitere Informationen zur Verwendung der Monitoring-Clientbibliotheken finden Sie unter Clientbibliotheken.