Webanfragelogs Ihrer Website mit Cloud Logging ansehen, filtern und durchsuchen

Sie können Ihr Firebase-Projekt mit Cloud Logging verknüpfen, um die Webanforderungsprotokolle für jede Ihrer Hosting-Websites aufzurufen, zu durchsuchen und zu filtern. Diese Logs stammen vom CDN, das automatisch von Firebase bereitgestellt wird. Daher wird jede Anfrage an Ihre Website und die zugehörigen Anfragedaten protokolliert.

Hier sind einige Beispiele für die Verwendung von Cloud Logging-Protokollen. Weitere Informationen finden Sie in den einzelnen Abschnitten auf dieser Seite.

  • Website besser verstehen: Sie können nachvollziehen, woher und wann Zugriffe auf Ihre Website erfolgen, welche Antwortstatus Ihre Website hat und wie hoch die Latenz von Endnutzeranfragen ist.

  • Logs mit Abfragen filtern: Nutzen Sie automatisch erhobene Daten, um Daten zu filtern und darzustellen, die mit den einzelnen Anfragen oder Ihrer Website verknüpft sind.

  • Logbasierte Messwerte verwenden: Erstellen Sie Cloud Monitoring-Diagramme und ‑Benachrichtigungsrichtlinien aus vordefinierten Systemmesswerten oder benutzerdefinierten Messwerten.

  • Logs in andere Google Cloud-Tools exportieren: Sie können Logdaten in anderen Tools wie BigQuery und Data Studio verwenden, um leistungsstärkere Analysen und Korrelationen zu erstellen.

Wenn Sie mehrere Hosting-Websites in Ihrem Projekt haben, können Sie auswählen, für welche Ihrer Hosting-Websites Protokolle exportiert werden sollen. Anschließend können Sie Ihre Logdaten nach Hosting-Website und sogar nach Domain filtern und ansehen. Wenn Sie bestimmte Hosting-Websites für den Export von Logs auswählen, können Sie auch die Menge der Daten steuern, die für Ihr Projekt verarbeitet werden.

  1. Klicken Sie in der Firebase-Konsole auf der Integrationskarte Cloud Logging auf Verknüpfen.

    Zum Verknüpfen oder Aufheben der Verknüpfung von Cloud Logging benötigen Sie die Berechtigungen, die in einer der folgenden Rollen enthalten sind: Projektinhaber oder ‑bearbeiter oder Firebase Develop-Administrator.

  2. Folgen Sie der Anleitung auf dem Bildschirm, um auszuwählen, für welche Ihrer Hosting-Websites Protokolle nach Cloud Logging exportiert werden sollen.

    Wenn Sie bereits eine oder mehrere aktive Hosting-Websites haben, wird im Verknüpfungsprozess eine geschätzte Datennutzung für Protokolle von jeder Ihrer Hosting-Websites angezeigt. Dieser Wert wird anhand der Daten der letzten 30 Tage geschätzt.

Nach der Verknüpfung mit Cloud Logging werden Protokolle für neue Anfragen an Ihre Hosting-Websites in der Regel innerhalb von 30 Minuten nach der Anfrage angezeigt.

Sie können auch die Verknüpfung von Firebase Hosting mit Cloud Logging aufhebenCloud Logging. In diesem Fall werden keine Webanfrage-Logs mehr nach Cloud Logging exportiert.

Datennutzung für Logs im Blick behalten

Nachdem Sie eine Verknüpfung mit Cloud Logging hergestellt haben, können Sie den Datenverbrauch für Logs von Ihren Hosting-Websites ansehen:

Website besser verstehen

Die Logs Viewer-Oberfläche in der Google Cloud-Konsole bietet Tools zum Aufrufen Ihrer spezifischen Logs und Daten mithilfe von Abfragen und integrierten Filtern und Datenfeldern. Im nächsten Abschnitt unten erfahren Sie mehr über das Filtern Ihrer Logs mit Abfragen.

  • Woher stammen die Zugriffe auf Ihre Website auf detaillierter Ebene?
    Sie können Informationen zu jeder Anfrage aufrufen, z. B. Quell-IP, Referrer, Stadt und Status.

  • Wann besuchen Nutzer Ihre Website?
    Im Histogramm-Feld können Sie die Verteilung nach bestimmten Zeiträumen aufrufen. So können Sie die normalen Spitzen und Tiefs bei der Nutzung Ihrer App nachvollziehen und unerwartete Traffic-Spitzen erkennen.

  • Wie sieht die Statusverteilung für Endnutzeranfragen aus?
    Sie können den Status jeder Anfrage einsehen und sogar Anfragen mit Fehlern analysieren. Sie können Ihre Logs nach Critical, Error oder Warning filtern.

  • Wie lange dauert es, bis Ihre Website auf eine Anfrage reagiert?
    Die Latenz Ihrer Website für jede Anfrage können Sie anhand des latency-Werts ablesen, der in jedem Protokoll erfasst wird.

  • Wird auf Ihrer Website Content-Caching genutzt?
    Jedes Log enthält das Feld cacheHit, in dem angegeben ist, ob die Ressource Ihrer Website schnell aus dem CDN-Cache von Hosting bereitgestellt wurde oder ob sie den gesamten Weg zum Hosting-Backend zurücklegen musste. So können Sie die Leistung Ihrer Website verbessern, indem Sie das globale CDN von Firebase optimal nutzen. So können Sie beispielsweise die Daten verwenden, um das Caching Ihrer statischen Assets und dynamischen Inhalte zu optimieren.

  • Wie ist der Traffic auf Ihre verschiedenen Domains verteilt?
    Wenn Sie mehrere Domains oder Hosting-Websites haben, können Sie Ihre Logs nach Domain oder Website filtern. So können Sie sehen, wie sich Ihr Traffic verteilt. Wenn Sie nach Domain filtern, können Sie nachvollziehen, welche Domain am häufigsten besucht wird.

Logs mit Abfragen filtern

Informationen zum Filtern von Logs mit Abfragen finden Sie unter Beispielabfragen mit der Loganzeige und Logabfragen erstellen. In der Tabelle unten werden die Felder beschrieben, die für diese Abfragen verfügbar sind.

Hier sind einige erste Filter für eine Abfrage für Hosting:

  • Ressource (resource.type) – firebase_domain (Firebase Hosting Site Domain)
  • Logname (logName) – webrequests (Firebase Hosting)

Jeder Logeintrag hat eine vordefinierte Struktur und abfragbare Felder (siehe LogEntry). Bei Hosting sind einige Felder für eine HTTP-Anfrage Standard, andere Feldwerte stammen jedoch aus der Verarbeitung, die Hosting für jede Anfrage ausführt.

Feld Beschreibung
Firebase Hosting speichert die folgenden Felder im httpRequest-Objekt des Logeintrags.
Diese Felder sind in der HTTP-Spezifikation definiert.
cacheHit Gibt an, ob sich die Ressource der Antwort im Cache des Hosting-CDN befand.
latency Die Dauer der Anfrage in Sekunden mit dem Suffix s (z. B. 1.256s)
protocol Das für die Anfrage verwendete Protokoll, z. B. HTTP/1.1, HTTP/2 oder websocket
referer Die Adresse der vorherigen Webseite, von der aus ein Link zur aktuell angeforderten Seite aufgerufen wurde (falls vorhanden)
remoteIp Die IP-Adresse des Clients, von dem die Anfrage stammt
requestMethod Die Anfragemethode (GET, POST, PUT usw.)
requestSize Die Größe der Anfrage in Byte
requestUrl Die vollständige URL der Anfrage (z. B.
,https://foo.web.app/bar oder https://custom.domain.com?query=param)
responseSize Die Größe der HTTP-Antwort in Byte
serverIp nicht ausgefüllt
status Der HTTP-Antwortstatus (z. B. 200 oder 404)
userAgent Der User-Agent-Header der Anfrage
Firebase Hosting speichert zusätzliche Felder im jsonPayload-Objekt des Logeintrags.
acceptEncoding (aus der HTTP-Anfrage) Welche Inhaltsverschlüsselung, in der Regel ein Komprimierungsalgorithmus, der Client unterstützt (z. B. gzip oder compress)
billable Ob Ihr Projekt für die Anfrage abgerechnet wurde
customDomain Ob die Anfrage für eine benutzerdefinierte Domain gestellt wurde
hostname Der Hostname, für den die Anfrage gestellt wurde
remoteIpCountry Das Ursprungsland der Anfrage
remoteIpCity Die Stadt, aus der die Anfrage stammt

Logbasierte Messwerte verwenden

Sie können logbasierte Messwerte ansehen und erstellen und diese Messwerte dann in Cloud Monitoring verwenden, um Diagramme und Benachrichtigungsrichtlinien zu erstellen.

  • Nutzen Sie vordefinierte Systemmesswerte, die automatisch erfasst werden, z. B. die Anzahl der Logging-Ereignisse, die innerhalb eines bestimmten Zeitraums aufgetreten sind.

  • Benutzerdefinierte Messwerte für Ihr Projekt erstellen Sie können die Anzahl der Logeinträge zählen, die mit einer bestimmten Abfrage übereinstimmen, oder bestimmte Werte in den übereinstimmenden Logeinträgen erfassen. Sie können mit regulären Ausdrücken filtern.

  • Mit Cloud Monitoring können Sie die Anzahl der Logeinträge mit bestimmten Nachrichten aufzeichnen oder in Logeinträgen enthaltene Angaben zu Latenzen extrahieren. Sie können diese Messwerte dann in Diagrammen und Benachrichtigungsrichtlinien verwenden.

Firebase Hosting generiert auch die folgenden Hosting-spezifischen Messwerte für die Protokollierung. Diese Messwerte beziehen sich nicht auf einen bestimmten Logeintrag, sondern auf die Hosting-Website als Ganzes.

  • log_bytes: Gesamtzahl der Byte der Datennutzung für jede Website

  • response_count: Gesamtzahl der für die Website verfassten Antworten

    Dieser Messwert enthält das Feld für den HTTP-Status. Sie können HTTP-Antworten also beispielsweise nach Status darstellen.

Logs in andere Google Cloud-Tools exportieren

Sie können die Logs Ihrer Website auch in andere Google Cloud-Tools wie Cloud Monitoring oder BigQuery exportieren, z. B.:

  • Mit Cloud Monitoring können Sie logbasierte Messwerte erstellen, die Sie in Diagrammen und Benachrichtigungsrichtlinien verwenden können.

  • Mit BigQuery haben Sie folgende Möglichkeiten:

    • Mit Data Studio können Sie Dashboards mit Ihren Hosting-Daten erstellen.
    • Führen Sie Abfragen aus, um mehr Informationen zu Ihren Anfragen zu erhalten (durchschnittliche Antwortgröße, Cache-Treffer im Vergleich zu Cache-Fehlern usw.).
    • Sie erfahren, welche URLs Ihre Nutzer tatsächlich anfordern.
    • Kombinieren Sie Ihre Hosting-Daten mit anderen Firebase-Daten, die Sie nach BigQuery exportiert haben, und führen Sie neue Abfragen aus.