In diesem Dokument wird beschrieben, wie Sie Logeinträge in Echtzeit durch Streaming von
und Live-Tailing.
Mit dem Streaming von Logs können Sie Logeinträge in Echtzeit ansehen. Diese Funktion ist in der
Log-Explorer:
Beim Live-Tailing können Sie Logeinträge in Echtzeit ansehen.
gcloud CLI
Befehl gcloud alpha logging tail
und als Cloud Logging API-Methode
entries.tail
Wenn Sie Ihre Logs mit dem Log-Explorer, gcloud logging read
oder der API-Methode entries.list
aufrufen und analysieren, sehen Sie Folgendes: Logeinträge, die von Cloud Logging gespeichert wurden. Beim Streamen
oder Live-Tail-Log-Einträge anzeigen,
Anwendungen schreiben sie in die Cloud Logging API.
Logs im Log-Explorer streamen
Im Log-Explorer können Sie Ihre Logdaten in Echtzeit mithilfe von Logs streamen aufrufen. Wenn Sie Logs streamen verwenden, können Sie eine Abfrage um nur die Logs zu streamen, die der Abfrage entsprechen. So streamen Sie Logs:
-
Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Geben Sie im Textfeld Abfrage eine Abfrage ein und klicken Sie dann auf Logs streamen.
Während Logging die Logdaten schreibt, werden im Bereich Abfrageergebnisse nur Logs angezeigt, die mit der Abfrage übereinstimmen. Wenn keine Abfrage festgelegt ist, werden in Logging die kürzlich gespeicherten Logeinträge angegeben. Die Protokolle werden weiter gestreamt, bis Sie die Bildlaufleiste im Bereich „Protokolle“ auswählen. Wenn das Streaming beendet wurde, wird die Schaltfläche Streaming neu starten angezeigt.
Weitere Informationen zu Abfragen finden Sie unter Abfragen erstellen in der Log-Explorer
Live-Tailing in der Google Cloud CLI verwenden
Beim Live-Tailing können Sie Ihre Logeinträge in Echtzeit als Cloud Logging ansehen schreibt sie entweder mit der Google Cloud CLI oder der Cloud Logging API.
Live-Tailing wird für Log-Buckets mit Zugriffssteuerung auf Feldebene, kann Logs streamen für für diese Buckets im Log-Explorer.
Informationen zur API-Methode für die Live-Verfolgung finden Sie unter der Methode entries.tail.
gcloud alpha logging tail
installieren
Zur Verwendung von gcloud alpha logging tail
müssen Python 3 und das Python-Paket grpcio
installiert sein.
Eine Anleitung zum Installieren von Python finden Sie auf der Python-Seite.
Eine Anleitung zum Installieren des Python-Paketmanagers pip
, der zur Installation des Pakets grpcio
erforderlich ist, finden Sie auf der Seite zum Python-Paketinstallationsprogramm.
Führen Sie die folgenden Schritte aus, um gcloud alpha logging tail
zu installieren:
Prüfen Sie, ob die Google Cloud CLI installiert ist. Eine Anleitung dazu, wie Sie Informationen zum Installieren der Google Cloud CLI finden Sie unter Google Cloud CLI installieren
Stellen Sie sicher, dass Sie die Version 302.0.0 oder höher der gcloud CLI verwenden können.
gcloud version
Eine Anleitung zum Aktualisieren der gcloud CLI finden Sie unter
gcloud components update
Installieren Sie die Alphakomponenten der gcloud CLI:
gcloud components install alpha
Führen Sie für MacOS-, Linux- und Cloud Shell-Nutzer Folgendes aus:
Installieren Sie gRPC-Clientbibliotheken:
sudo pip3 install grpcio
Legen Sie die Umgebungsvariable
CLOUDSDK_PYTHON_SITEPACKAGES
auf einen beliebigen Wert fest:export CLOUDSDK_PYTHON_SITEPACKAGES=1
Verwenden Sie die folgenden Befehle, um Ihre Google Cloud-Projekt-ID festzulegen und Authentifizieren:
gcloud config set project PROJECT_ID gcloud auth login
Informationen zum Abrufen der Projekt-ID finden Sie unter Erstellen und Verwalten Projekten.
Prüfen Sie mit dem folgenden Befehl, ob
gcloud alpha logging tail
installiert ist:gcloud alpha logging tail
Der Befehl gibt die folgende Meldung aus:
Initializing tail session.
Sie sehen die Logeinträge für Ihr Google Cloud-Projekt jetzt als Logging schreibt.
Weitere Informationen zur Verwendung der Live-Verfolgung finden Sie im gcloud alpha logging tail
-Referenzhandbuch.
Zwischenspeichern und sortieren
Da Logging Logeinträge in chronologischer Reihenfolge empfangen kann, bietet die Live-Verfolgung eine Zwischenspeicherfenstereinstellung, sodass Sie den richtigen Kompromiss zwischen dem Aufrufen der Logeinträge beim Schreiben und dem Anzeigen in aufsteigender Reihenfolge finden können. Sie können für das Zwischenspeicherfenster einen Wert zwischen 0
und 60
Sekunden festlegen.
Beachten Sie die folgenden Eigenschaften des Zwischenspeicherfensters:
Das Zwischenspeicherfenster beträgt standardmäßig zwei Sekunden.
Logging verzögert das Schreiben der Logeinträge in Log-Buckets für den Dauer des Pufferfensters.
Wenn ein Logeintrag außerhalb des Zwischenspeicherfensters geschrieben wird, gibt Logging die Logeinträge so zurück, wie sie empfangen werden.
Beim Konfigurieren des Pufferfensters Sie können die Protokolle beim Schreiben und die Einträge in der falschen Reihenfolge anzeigen.
Zwischenspeicherfenster | Kompromiss |
---|---|
0 Sekunden |
Die neuesten zurückgegebenen Logeinträge, allerdings mit einer höheren Wahrscheinlichkeit, dass sie in der falschen Reihenfolge vorliegen |
60 Sekunden |
Eine Verzögerung von 60 Sekunden, bevor die zurückgegebenen Einträge angezeigt werden, aber die meisten Logs werden in aufsteigender Reihenfolge zurückgegeben |
Limits und Kontingente
In der folgenden Tabelle sind die Limits und Kontingente für die Live-Verfolgung aufgeführt:
Limits und Kontingente | Wert |
---|---|
Zurückgegebene Einträge pro Minute | 60.000 Wenn mehr als 60.000 Einträge mit einem Filter übereinstimmen, Logging gibt die Anzahl der Einträge in der Antwort zurück. |
Live-Tailing-Sitzungen pro Google Cloud-Projekt öffnen | 10 |
Clienteinschränkungen
Bei einem Google Cloud-Projekt, das schnell viele Einträge schreibt, können sie möglicherweise nicht so schnell verarbeiten, wie sie geschrieben werden. In diesem Fall begrenzt Logging die Gesamtzahl der gesendeten Einträge, wobei die neuesten Einträge priorisiert werden. Am Ende der Verfolgungsitzung gibt Logging die Anzahl der Einträge zurück, die aufgrund der Limits des Clients nicht angezeigt wurden.
Live-Tailing mit Clientbibliotheken verwenden
Mit der Live-Verfolgung können Sie Ihre Logeinträge in Echtzeit anzeigen, während Cloud Logging sie schreibt. Informationen zur API-Methode für die Live-Verfolgung finden Sie unter der Methode entries.tail.
Live-Tailing wird für Log-Buckets mit Zugriffssteuerung auf Feldebene, kann Logs streamen für für diese Buckets im Log-Explorer.
Dieses Beispiel zeigt die Live-Verfolgung von Logeinträgen eines bestimmten Loggers.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Logging finden Sie unter Logging von Clientbibliotheken
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Logging zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Logging finden Sie unter Logging von Clientbibliotheken
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Logging zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Logging finden Sie unter Logging-Clientbibliotheken.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Logging zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.