Mit Cloud Logging können Sie die Webanfrageprotokolle Ihrer Website anzeigen, durchsuchen und filtern

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

Hier sind einige Dinge, die Sie mit Cloud Logging-Protokollen tun können. Besuchen Sie jeden Abschnitt dieser Seite, um Einzelheiten zu erfahren.

Wenn Ihr Projekt mehrere Hosting-Sites umfasst, können Sie auswählen, welche Ihrer Hosting-Sites Protokolle exportieren sollen. Anschließend können Sie Ihre Protokolldaten nach Hosting-Site und sogar nach Domäne filtern und anzeigen. Durch die Auswahl bestimmter Hosting-Sites zum Exportieren von Protokollen können Sie auch die Menge der für Ihr Projekt verarbeiteten Daten steuern.

  1. Klicken Sie in der Cloud Logging- Integrationskarte der Firebase-Konsole auf „Link“ .

    Um Cloud Logging zu verknüpfen oder die Verknüpfung aufzuheben, benötigen Sie die Berechtigungen, die in einer der folgenden Rollen gebündelt sind: Projektbesitzer oder -editor oder Firebase-Entwicklungsadministrator .

  2. Befolgen Sie die Anweisungen auf dem Bildschirm, um auszuwählen, welche Ihrer Hosting-Sites Protokolle nach Cloud Logging exportieren sollen.

    Wenn Sie bereits über eine oder mehrere aktive Hosting-Sites verfügen, zeigt der Verknüpfungsworkflow einen geschätzten Datennutzungsgrad für Protokolle von jeder Ihrer Hosting-Sites an. Dieser Wert wird aus den letzten 30 Tagen geschätzt.

Nach der Verknüpfung mit Cloud Logging werden Protokolle für alle neuen Anfragen an Ihre Hosting-Sites normalerweise innerhalb von 30 Minuten nach der Anfrage angezeigt.

Sie können auch die Verknüpfung von Firebase Hosting mit Cloud Logging aufheben, wodurch der Export von Webanfrageprotokollen in Cloud Logging gestoppt wird.

Überwachen Sie Ihre Datennutzung für Protokolle

Nach der Verknüpfung mit Cloud Logging können Sie den Datennutzungsgrad für Protokolle Ihrer Hosting-Sites anzeigen:

Verstehen Sie Ihre Website besser

Die Logs Viewer-Oberfläche in der Google Cloud Console bietet Tools zum Anzeigen Ihrer spezifischen Protokolle und Daten mithilfe von Abfragen sowie integrierten Filtern und Datenfeldern. Weitere Informationen zum Filtern Ihrer Protokolle mit Abfragen finden Sie im nächsten Abschnitt unten.

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

  • Wann besuchen Benutzer Ihre Website?
    Sie können das Histogramm-Bedienfeld verwenden, um die Verteilung nach bestimmten Zeitbereichen anzuzeigen. Dies kann Ihnen Einblick in die normalen Spitzen und Einbrüche der Nutzung Ihrer App geben und unerwartete Spitzen im Datenverkehr aufdecken.

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

  • Wie lange dauert es, bis Ihre Website auf eine Anfrage antwortet?
    Sie können die Latenz Ihrer Site für jede Anfrage anhand des in jedem Protokoll erfassten latency anzeigen.

  • Nutzt Ihre Website Content-Caching?
    Jedes Protokoll enthält ein Feld cacheHit , das Ihnen mitteilt, ob die Ressource Ihrer Site schnell aus dem CDN-Cache von Hosting bereitgestellt wurde oder ob sie den gesamten Weg zum Hosting-Backend zurücklegen musste. Dies kann Ihnen helfen, die Leistung Ihrer Website zu verbessern, indem Sie das globale CDN von Firebase optimal nutzen. Beispielsweise können Sie die Daten verwenden, um die Caching-Gewohnheiten Ihrer statischen Assets und dynamischen Inhalte zu optimieren.

  • Wie verteilt sich der Traffic auf Ihre verschiedenen Domains?
    Wenn Sie über mehrere Domänen oder Hosting-Sites verfügen, können Sie Ihre Protokolle nach Domäne oder Site filtern. Dadurch können Sie sehen, wie sich Ihr Traffic verteilt. Wenn Sie nach Domain filtern, können Sie verfolgen, welche Domain am häufigsten besucht wird.

Filtern Sie Ihre Protokolle mit Abfragen

Um zu erfahren, wie Sie Ihre Protokolle mit Abfragen filtern, besuchen Sie Beispielabfragen mit Logs Viewer und Protokollabfragen erstellen . In der folgenden Tabelle werden die für diese Abfragen verfügbaren Felder beschrieben.

Für das Hosting sind hier einige erste Filter für eine Abfrage:

  • Ressource ( resource.type ) – firebase_domain (Domäne der Firebase-Hosting-Site)
  • Protokollname ( logName ) – webrequests (Firebase Hosting)

Jeder Protokolleintrag verfügt über eine vordefinierte Struktur und abfragbare Felder (siehe LogEntry ). Bei Hosting sind einige Felder Standard für eine HTTP-Anfrage, es gibt jedoch andere Feldwerte, die aus der Verarbeitung stammen, die Hosting bei jeder Anfrage durchführt.

Feld Beschreibung
Firebase Hosting speichert die folgenden Felder im httpRequest Objekt des Protokolleintrags.
Diese Felder sind in der HTTP-Spezifikation definiert.
cacheHit Ob das Hosting-CDN die Ressource der Antwort im Cache hatte oder nicht
latency Die Anforderungsdauer in Sekunden mit dem Postfix 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 aufgerufenen Seite verfolgt wurde (falls vorhanden)
remoteIp Die ursprüngliche Client-IP für die Anfrage
requestMethod Die Anforderungsmethode ( GET , POST , PUT usw.)
requestSize Die Größe der Anfrage in Bytes
requestUrl Die vollständige URL der Anfrage (z. B.
https://foo.web.app/bar oder https://custom.domain.com?query=param )
responseSize Die HTTP-Antwortgröße in Bytes
serverIp nicht besiedelt
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 Protokolleintrags.
acceptEncoding (aus der HTTP-Anfrage) Welche Inhaltskodierung, normalerweise ein Komprimierungsalgorithmus, der Client unterstützt (z. B. gzip oder compress )
billable Ob Ihrem Projekt die Anfrage in Rechnung gestellt wurde oder nicht
customDomain Ob die Anfrage für eine benutzerdefinierte Domäne gestellt wurde oder nicht
hostname Der Hostname, für den die Anfrage gestellt wurde
remoteIpCountry Das Ursprungsland der Anfrage
remoteIpCity Der Ursprungsort der Anfrage

Verwenden Sie protokollbasierte Metriken

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

  • Nutzen Sie vordefinierte Systemmetriken , die automatisch aufgezeichnet werden, z. B. die Anzahl der Protokollierungsereignisse, die innerhalb eines bestimmten Zeitraums aufgetreten sind.

  • Erstellen Sie benutzerdefinierte Metriken für Ihr Projekt. Sie können die Anzahl der Protokolleinträge zählen, die einer bestimmten Abfrage entsprechen, oder bestimmte Werte mit den übereinstimmenden Protokolleinträgen verfolgen. Sie können mithilfe regulärer Ausdrücke filtern.

  • Verwenden Sie Cloud Monitoring , um die Anzahl der Protokolleinträge aufzuzeichnen, die bestimmte Nachrichten enthalten, oder um in Protokolleinträgen gemeldete Latenzinformationen zu extrahieren. Anschließend können Sie diese Metriken in Diagrammen und Benachrichtigungsrichtlinien verwenden.

Firebase Hosting generiert außerdem die folgenden Hosting-spezifischen Protokollierungsmetriken. Diese Metriken beziehen sich nicht speziell auf einen Protokolleintrag, sondern auf die spezifische Hosting-Site als Ganzes.

  • log_bytes : Gesamtbytes der Datennutzung für jede Site

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

    Diese Metrik umfasst das Feld HTTP-Status, sodass Sie HTTP-Antworten nach Status darstellen können (als Beispiel).

Exportieren Sie Protokolle in andere Google Cloud-Tools

Sie können die Protokolle Ihrer Website auch in andere Google Cloud-Tools wie Cloud Monitoring oder BigQuery exportieren, zum Beispiel:

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

  • Mit BigQuery können Sie Folgendes tun:

    • Verwenden Sie Data Studio, um Dashboards Ihrer Hosting-Daten zu erstellen.
    • Führen Sie Abfragen aus, um mehr Einblick in Ihre Anfragen zu erhalten (durchschnittliche Antwortgröße, Cache-Treffer vs. Fehlschläge usw.).
    • Erfahren Sie, welche URLs Ihre Nutzer tatsächlich anfordern.
    • Kombinieren Sie Ihre Hosting-Daten mit anderen Firebase-Daten, die Sie nach BigQuery exportiert haben, und fragen Sie sie auf neue Weise ab.