Webanfragelogs Ihrer Website mit Cloud Logging ansehen, filtern und durchsuchen

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

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

  • Website besser verstehen : Sie können beispielsweise sehen, woher und wann Besucher auf Ihre Website kommen, die Antwortstatus Ihrer Website und die Latenz von Endnutzeranfragen.

  • Logs mit Abfragen filtern : Sie können automatisch erfasste Daten verwenden, um Daten zu filtern und darzustellen, die mit jeder Anfrage oder Ihrer Website verknüpft sind.

  • Logbasierte Messwerte verwenden : Sie können Cloud Monitoring-Diagramme und Benachrichtigungsrichtlinien aus vordefinierten Systemmesswerten oder benutzerdefinierten Messwerten erstellen.

  • Logs in andere Google Cloud exportieren : Sie können Logdaten in anderen Tools wie BigQuery und Data Studio verwenden, um umfassendere Analysen durchzuführen und Korrelationen zu ermitteln.

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

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

    Zum Verknüpfen oder Aufheben der Verknüpfung mit Cloud Logging benötigen Sie die Berechtigungen, die in einer der folgenden Rollen enthalten sind: Projektinhaber oder Bearbeiter oder Firebase-Entwickleradministrator.

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

    Wenn Sie bereits eine oder mehrere aktive Hosting Websites haben, wird im Verknüpfung workflow eine Schätzung der Datennutzung für Logs von jeder Ihrer Hosting Websites angezeigt. Dieser Wert wird anhand der letzten 30 Tage geschätzt.

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

Sie können die Verknüpfung von Firebase Hosting mit Cloud Loggingauch aufheben. Dadurch werden keine Webanfragelogs mehr nach Cloud Loggingexportiert.

Datennutzung für Logs prüfen

Nach der Verknüpfung mit Cloud Logging können Sie die Datennutzung für Logs von Ihren Hosting Websites so aufrufen:

Website besser verstehen

Die Logs Viewer Benutzeroberfläche in der Google Cloud Console bietet Tools, mit denen Sie Ihre spezifischen Logs und Daten mithilfe von Abfragen sowie integrierten Filtern und Datenfeldern aufrufen können. Weitere Informationen zum Filtern von Logs mit Abfragen finden Sie im nächsten Abschnitt.

  • Woher kommt der Traffic Ihrer Website auf detaillierter Ebene?
    Sie können Informationen zu jeder Anfrage aufrufen, einschließlich Quell-IP, Referrer, Stadt und Status.

  • Wann besuchen Nutzer Ihre Website?
    Im Histogramm können Sie die Verteilung nach bestimmten Zeiträumen sehen. So erhalten Sie Einblicke in die normalen Spitzen und Tiefs der Nutzung Ihrer App und können unerwartete Trafficspitzen erkennen.

  • Wie ist die Statusverteilung für Endnutzeranfragen?
    Sie können den Status für jede Anfrage aufrufen und sogar Anfragen diagnostizieren, bei denen Fehler auftreten. Sie können Ihre Logs nach Critical, Error oder Warning filtern.

  • Wie lange dauert es, bis Ihre Website auf eine Anfrage antwortet?
    Sie können die Latenz Ihrer Website für jede Anfrage anhand des Werts latency sehen, der in jedem Log erfasst wird.

  • Nutzt Ihre Website das Content-Caching?
    Jeder Log enthält ein Feld cacheHit, das angibt, ob die Ressource Ihrer Website schnell aus dem CDN-Cache von Hosting bereitgestellt wurde oder ob sie den gesamten Weg zum Hosting Back-End zurücklegen musste. So können Sie die Leistung Ihrer Website verbessern, indem Sie das globale CDN von Firebase optimal nutzen. Sie können die Daten beispielsweise verwenden, um die Caching-Gewohnheiten 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 Ihr Traffic verteilt ist. 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 folgenden Tabelle 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 Websitedomain)
  • Logname (logName) – webrequests (Firebase Hosting)

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

Feld Beschreibung
Firebase Hosting speichert die folgenden Felder im httpRequest Objekt des Log eintrags.
Diese Felder sind in der HTTP-Spezifikation definiert.
cacheHit Gibt an, ob das Hosting CDN die Ressource der Antwort im Cache hatte
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, websocket)
referer Die Adresse der vorherigen Webseite, von der aus ein Link zur aktuell angeforderten Seite aufgerufen wurde (falls vorhanden)
remoteIp Die ursprüngliche Client-IP-Adresse für die Anfrage
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 Inhaltscodierung, in der Regel ein Komprimierungsalgorithmus, der Client unterstützt (z. B. gzip oder compress)
billable Gibt an, ob Ihrem Projekt die Anfrage in Rechnung gestellt wurde
customDomain Gibt an, ob die Anfrage an eine benutzerdefinierte Domain gerichtet wurde
hostname Der Hostname, an den die Anfrage gerichtet wurde
remoteIpCountry Das Ursprungsland der Anfrage
remoteIpCity Die Ursprungsstadt der Anfrage

Logbasierte Messwerte verwenden

Sie können logbasierte Messwerte aufrufen 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.

  • Erstellen Sie benutzerdefinierte Messwerte für Ihr Projekt. Sie können die Anzahl der Logeinträge zählen, die einer bestimmten Abfrage entsprechen, oder bestimmte Werte mit den entsprechenden Logeinträgen verfolgen. Sie können mit regulären Ausdrücken filtern.

  • Verwenden Sie Cloud Monitoring zum Aufzeichnen der Anzahl der Logeinträge mit bestimmten Nachrichten oder zum Extrahieren von Latenzinformationen, die in Logeinträgen gemeldet werden. Sie können diese Messwerte dann in Diagrammen und Benachrichtigungsrichtlinien verwenden.

Firebase Hosting generiert auch die folgenden Hosting-spezifischen Logging Messwerte. Diese Messwerte beziehen sich nicht auf einen bestimmten Logeintrag, sondern auf die jeweilige Hosting Website als Ganzes.

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

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

    Dieser Messwert enthält das Feld des HTTP-Status, sodass Sie HTTP-Antworten beispielsweise nach Status darstellen können.

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:

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

  • Mit BigQuery haben Sie folgende Möglichkeiten:

    • Mit Data Studio können Sie Dashboards Ihrer Hosting Daten erstellen.
    • Sie können Abfragen ausführen, um mehr Einblicke in Ihre Anfragen zu erhalten (durchschnittliche Antwortgröße, Cache-Treffer im Vergleich zu Cache-Fehlern usw.).
    • Sie können nachvollziehen, welche URLs Ihre Nutzer tatsächlich anfordern.
    • Sie können Ihre Hosting Daten mit anderen Firebase-Daten kombinieren, die Sie nach BigQuery exportiert haben, und sie auf neue Weise abfragen.