Mit Cloud Logging die Webanfrage-Logs 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 aus dem 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-Logs tun können. Besuchen Sie jeden Abschnitt dieser Seite, um Details zu erfahren.

Wenn Ihr Projekt über mehrere Hosting-Sites verfügt, können Sie auswählen, welche Ihrer Hosting-Sites Protokolle exportieren soll. Sie können dann Ihre Protokolldaten nach Hosting-Site und sogar nach Domain filtern und anzeigen. Durch die Auswahl bestimmter Hosting-Sites zum Exportieren von Protokollen können Sie auch die für Ihr Projekt verarbeitete Datenmenge steuern.

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

    Um einen Link oder unlink Cloud Logging, müssen Sie die Berechtigungen gebündelt in eine der folgenden Rollen: Projekteigentümer oder Editor oder Firebase Admin entwickeln .

  2. Befolgen Sie die Anweisungen auf dem Bildschirm, um auszuwählen, welche Ihrer Hosting-Sites Logs in Cloud Logging exportieren soll.

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

Nach der Verknüpfung zu Cloud Logging, Protokolle für alle neue Anforderungen an Ihre Hosting - Site werden in der Regel innerhalb von 30 Minuten von der Anfrage angezeigt gemacht.

Sie können auch unlink Firebase Hosting von Cloud Logging, die Exporte von Web - Anfrage Protokolle Cloud Logging stoppt.

Überwachen Sie Ihre Datennutzung für Protokolle

Nachdem Sie eine Verknüpfung zu Cloud Logging hergestellt haben, können Sie die Datennutzungsebene für Protokolle von Ihren Hosting-Sites anzeigen:

Verstehen Sie Ihre Website besser

Die Logs Viewer - Schnittstelle in den Google Cloud Console bieten Tools , um Ihr spezifisches Protokoll und Datenabfragen mit anzeigen und integrierten Filtern und Datenplatten. Weitere Informationen zum Filtern Ihrer Logs mit Abfragen finden Sie im nächsten Abschnitt weiter 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 die Verwendung Histogrammbedienfeld die Verteilung durch bestimmte Zeitbereiche zu sehen. Dies kann Ihnen einen Einblick in die normalen Spitzen und Einbrüche der Nutzung Ihrer App geben sowie unerwartete Verkehrsspitzen aufdecken.

  • Wie ist die Statusverteilung für Endbenutzeranfragen?
    Sie können den Status für jede Anfrage anzeigen und sogar Anfragen diagnostizieren, die Fehler erhalten. Sie können Ihre Protokolle durch Filter Critical , Error oder Warning .

  • Wie lange braucht Ihre Website, um auf eine Anfrage zu antworten?
    Sie können Ihre Website-Latenz für jede Anforderung mit der Ansicht latency in jedem Protokoll erfasst.

  • Nutzt Ihre Website Content-Caching?
    Jedes Protokoll enthält ein cacheHit Feld , das Ihnen sagt , wenn Ihre Website - Ressource serviert wurde schnell von CDN - Cache des Hosting, oder wenn es die volle Reise in den Hosting - Backend machen hat. Auf diese Weise können Sie die Leistung Ihrer Website verbessern, indem Sie das globale CDN von Firebase optimal nutzen. Zum Beispiel können Sie die Daten zur Feinabstimmung der Caching - Gewohnheiten Ihrer verwenden statische Vermögenswerte und dynamische Inhalte .

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

Filtern Sie Ihre Logs mit Abfragen

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

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

  • Ressource ( resource.type ) - firebase_domain (Firebase Hosting - Website Domain)
  • Protokollname ( logName ) - webrequests (Firebase - Hosting)

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

Feld Beschreibung
Hosting Firebase speichert die folgenden Felder in der httpRequest Aufgabe 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 s Postfix (beispielsweise 1.256s )
protocol Das Protokoll für die Anfrage verwendet (beispielsweise HTTP/1.1 , HTTP/2 , websocket )
referer Die Adresse der vorherigen Webseite, von der aus auf die aktuell aufgerufene Seite verwiesen wurde (falls vorhanden)
remoteIp Die ursprüngliche Client-IP für die Anfrage
requestMethod Die Anforderungsmethode ( GET , POST , PUT , etc.)
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 HTTP-Antwortgröße in Byte
serverIp nicht besiedelt
status Der HTTP - Antwort - Status (beispielsweise 200 oder 404 )
userAgent Der User-Agent-Header der Anfrage
Hosting speichert Firebase zusätzliche Felder im jsonPayload Aufgabe des Protokolleintrags.
acceptEncoding (von der HTTP - Anforderung) Welcher Inhaltskodierung, in der Regel eines Kompressionsalgorithmus, der Client unterstützt (beispielsweise gzip oder compress )
billable Ob Ihrem Projekt die Anfrage in Rechnung gestellt wurde oder nicht not
customDomain Ob die Anfrage für eine benutzerdefinierte Domain gestellt wurde oder nicht not
hostname Der Hostname, für den die Anfrage gestellt wurde
remoteIpCountry Das Ursprungsland der Anfrage
remoteIpCity Die Ursprungsstadt der Anfrage

Logbasierte Messwerte verwenden

Sie können anzeigen und Build - Logs basierte Metriken , dann diese Messwerte im Bereich Cloud verwenden Überwachung Diagramme und Alarmierungsrichtlinien zu erstellen.

  • Leverage Systemmetriken vorgegeben , die automatisch aufgezeichnet werden, wie zB die Anzahl der Protokollierung Ereignisse , die innerhalb eines bestimmten Zeitraums aufgetreten.

  • 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 mit regulären Ausdrücken filtern.

  • Verwenden Überwachung Wolke die Anzahl der Log - Einträge enthält bestimmte Nachrichten oder Extrakt Latenzinformationen berichtet in den Protokolleinträgen aufzeichnen. Sie können diese Metriken dann in Diagrammen und Benachrichtigungsrichtlinien verwenden.

Firebase Hosting generiert auch die folgenden Hosting-spezifischen Protokollierungsmesswerte. Diese Metriken beziehen sich nicht auf einen Protokolleintrag, sondern auf die jeweilige Hosting-Site als Ganzes.

  • log_bytes : Gesamtbytes der Datennutzung für jeden Standort

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

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

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, zum Beispiel:

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

  • Mit BigQuery können Sie eine der folgenden Bedingungen tun:

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