API-Monitoring

Auf dieser Seite wird beschrieben, wie Sie mithilfe der von API Gateway automatisch erfassten Logs und Messwerte den Zustand Ihrer API Gateway APIs beobachten können.

Wenn Sie eine API erstellen, wird in API Gateway automatisch ein entsprechender verwalteter Dienst erstellt. Den Namen des erstellten verwalteten Dienstes finden Sie in der Ausgabe des folgenden Befehls:

gcloud api-gateway apis describe API_ID

Der Name Ihres Dienstes ist der Wert des Felds managedService.

Wenn Nutzer Anfragen an Ihre API senden, protokolliert API Gateway Informationen über die Anfragen und Antworten. API Gateway erfasst auch drei der vier goldene Signale für die Überwachung: Latenz, Traffic und Fehler. Mit diesen Nutzungs- und Leistungsmesswerten können Sie Ihre API überwachen.

Hinweis

Wenn Sie Logs und Messwerte für die Ansicht generieren möchten, stellen Sie eine API bereit und senden Sie Anfragen an diese. Wenn Sie noch keine API erstellt und in einem Gateway bereitgestellt haben, versuchen Sie es mit dem Kurzanleitung zu API Gateway

API-Übersicht

Wenn Sie einen Fehler in Ihrem Dienst beheben oder einfach sicherstellen wollen, dass alles wie erwartet abläuft, rufen Sie die API-Übersicht auf.

  1. Rufen Sie in der Google Cloud Console das API-Gateway auf > APIs für Ihrem Projekt:

    Zur Seite „APIs“

  2. Wenn Sie mehr als eine API haben, klicken Sie auf die zu überwachende API.

  3. Achten Sie darauf, dass Sie sich auf dem Tab Übersicht befinden.

Grafiken

Auf der Übersichtsseite finden Sie eine Reihe von Grafiken für einige der Messwerte, sodass Sie Spitzen, Rückgänge oder unerwartete Aktivitäten sofort erkennen können. Mit den Filtern oben auf der Seite können Sie Folgendes tun:

  • Wählen Sie in der Drop-down-Liste Grafiken auswählen die für Sie interessanten Messwerte aus und entfernen Sie die Messwerte, die nicht angezeigt werden sollen.
  • Passen Sie den Umfang der Diagramme an, indem Sie aus den verschiedenen Zeiträumen auswählen. Dadurch wird der Zeitraum der angezeigten Werte und auch die Detaillierungsgrad des Punkts angepasst.

Methodentabelle

Wenn Sie die Daten weiter aufschlüsseln möchten, scrollen Sie zur Tabelle unter den Grafiken. Sie enthält Messwerte für einzelne Methoden der API. Sie haben folgende Möglichkeiten:

  • Klicken Sie links oben in der Tabelle auf das Symbol Tabelle filtern, um eine detailliertere Filterabfrage auszuwählen. aus der Drop-down-Tabelle auswählen. Fügen Sie zwischen den Filterabfragen ein OR ein, um nach mehreren Begriffen zu suchen.
  • Klicken Sie rechts oben in der Tabelle auf das Symbol Spaltenanzeigeoptionen, um eine Drop-down-Liste aufzurufen. Setzen Sie ein Häkchen bei den Messwerten, die Sie sehen möchten, und entfernen Sie das Häkchen bei den Messwerten, die nicht angezeigt werden sollen.
  • Wählen Sie in der rechten oberen Ecke der Übersicht mit dem entsprechenden Auswahlelement eine Zeitspanne für die Messwerte in der Tabelle aus. Die ausgewählte Zeitspanne gilt sowohl für die Grafiken als auch für die Tabelle.

Logs

Wenn Sie ein Problem bei den Messwerten feststellen, können Sie die Seite Log-Explorer in der Google Cloud Console, um Logs der Anfragen und Antworten für Ihre API aufzurufen.

  • Sie können Logs für einzelne Methoden der API aufrufen. Dafür klicken Sie in der Tabelle auf Logs ansehen.

  • Sie können Logs für alle Methoden der API aufrufen. Klicken Sie dafür in der unteren rechten Ecke auf Alle Logs ansehen.

  • So finden Sie API Gateway-Logs direkt auf der Seite „Log-Explorer“:

    1. Rufen Sie in der Google Cloud Console die Seite Logs-Explorer auf.

      Zur Seite „Log-Explorer“

    2. Wählen Sie Produzierte API, SERVICE_NAME, aus, wobei SERVICE_NAME der Name des verwalteten Dienstes ist.

Details zur Struktur der Logs im Log-Explorer finden Sie in der Referenz zu API Gateway-Logs.

Weitere Verwendungsmöglichkeiten für Logs:

  • Machen Sie sich zuerst mit der Log-Explorer vertraut.

    Geben Sie im Abfragebereich die Logeinträge an, die Sie ansehen möchten. z. B. alle Anfragen mit einer Latenz von mehr als 300 Millisekunden.

  • Senken konfigurieren und verwalten Sie können Logs an BigQuery streamen und dort weitere Analysen vornehmen, die unbearbeiteten Logs in Cloud Storage speichern oder die Logs an Messaging-Themen in Pub/Sub senden.

Nach einem bestimmten Nutzerprojekt filtern

So filtern Sie Messwerte für ein bestimmtes Nutzerprojekt:

  1. Holen Sie sich Projektnummer des API-Nutzerprojekts. Wenn Sie keine Berechtigung für den Zugriff auf das API-Nutzerprojekt haben, bitten Sie eine berechtigte Person, die Projektnummer für Sie zu ermitteln.

  2. Rufen Sie in der Google Cloud Console das API-Gateway auf > Seite APIs für Ihr Projekt.

    Zur Seite „APIs“

  3. Geben Sie in der linken oberen Ecke der Seite Übersicht die Projektnummer in das Bearbeitungsfeld Nach Projektnummer filtern ein.

  4. Klicken Sie auf Filtern.

Die Messwerte auf der Seite werden aktualisiert, sodass nur der Traffic für das angegebene Projekt angezeigt wird.

Nächste Schritte