運用 Cloud Logging 查看、搜尋及篩選網站要求記錄檔

您可以將 Firebase 專案連結至「Cloud Logging」,以查看、搜尋及 篩選個別 Hosting 個網站的網站要求記錄。這些記錄檔 由 Firebase 自動提供的 CDN 發出 網站和相關請求資料都會記錄下來。

以下是您如何使用 Cloud Logging 記錄進行的操作。請參閱本頁的各個部分,瞭解詳細資訊。

如果您的專案中有多個 Hosting 網站,則可以選取 你的 Hosting 網站將匯出記錄。您可以篩選及查看記錄檔 按 Hosting 個網站甚至按網域劃分資料。選取特定Hosting 匯出記錄的其他網站時,您也可以控制系統為 專案。

  1. 按一下 Cloud Logging 中的「連結」。 整合資訊卡 Firebase 控制台。

    如要連結或取消連結「Cloud Logging」,您必須具備相關權限 下列任一角色:專案擁有者或編輯者Firebase 開發管理員

  2. 按照畫面上的指示選取您的 Hosting 個網站 應將記錄匯出至 Cloud Logging

    如果你已有一或多個有效的 Hosting 網站,請提供連結 工作流程會針對各個 Hosting 個網站。這個值是根據過去 30 天的資料估算而得。

連結至 Cloud Logging 後,系統通常會在您提出要求後的 30 分鐘內,顯示您對 Hosting 網站提出的所有要求記錄。

你也可以 取消連結「Firebase HostingCloud Logging 停止將網路要求記錄匯出至 Cloud Logging

監控資料用量記錄

連結至 Cloud Logging 後,即可查看記錄的數據用量等級 來自你的 Hosting 個網站:

進一步瞭解您的網站

Logs Viewer 介面 Google Cloud 控制台提供多項工具,方便您查看特定記錄檔和資料 查看這些資料進一步瞭解篩選功能 並在下一節使用查詢。

  • 網站流量來自哪些精細層級的來源?
    您可以查看每項要求的相關資訊,包括來源 IP、參照網址、城市和狀態。

  • 使用者會在哪些情況下造訪您的網站?
    您可以使用「直方圖」面板查看特定時間範圍的分布情形。這可讓您深入瞭解 藉此瞭解應用程式使用率的正常高點和低點,同時指出 並在流量中突然暴增

  • 使用者要求的狀態分佈情形為何?
    您可以查看每項要求的狀態,甚至可以診斷 接收錯誤。你可以依 CriticalErrorWarning 篩選記錄。

  • 網站需要多久時間才會回應要求?
    您可以使用各個記錄中擷取的 latency 值,查看網站對每項要求的延遲時間。

  • 網站是否使用內容快取功能?
    每筆記錄都包含 cacheHit 欄位,說明網站的資源是否為 會從 Hosting 的 CDN 快取中快速提供資料,或者必須完全擷取 就會前往 Hosting 後端這有助於提高網站的 充分發揮 Firebase 全球 CDN 的效益。舉例來說, 微調的快取習慣 靜態素材資源動態內容

  • 各個網域的流量分佈情形為何?
    如果您擁有多個網域或 Hosting 網站,可以篩選記錄 依網域或網站劃分方便您查看流量分配情形。依網域篩選時 最常瀏覽的資料

使用查詢篩選記錄檔

如要瞭解如何使用查詢篩選記錄檔,請參閱: 使用記錄檢視器的查詢範例建立記錄查詢。 下表說明這些查詢的可用欄位。

以下是 Hosting 的一些查詢初始篩選器:

  • 資源 (resource.type) - firebase_domain (Firebase Hosting 網站網域)
  • 記錄名稱 (logName) - webrequests (Firebase Hosting)

每個記錄項目都有預先定義的結構和可查詢的欄位 (請參閱 LogEntry)。 對 Hosting 來說,部分欄位是 HTTP 要求的標準欄位,但 其他欄位值,產生自 Hosting 在每個欄位執行的處理程序 請求。

欄位 說明
Firebase Hosting 會將下列欄位儲存在 記錄的 httpRequest 物件 項目。
這些欄位已在 HTTP 規格中定義。
cacheHit Hosting CDN 是否在快取內容中擁有回應資源
latency 要求時間長度,以秒為單位加上 s 後置字串 (適用於 例如:1.256s)
protocol 要求使用的通訊協定 (例如 HTTP/1.1HTTP/2websocket)
referer 前一個網頁的網址,其中包含目前要求的網頁連結 (如果有的話)
remoteIp 要求的來源用戶端 IP
requestMethod 要求方法 (GETPOSTPUT 等)
requestSize 要求的大小 (以位元組為單位)
requestUrl 要求的完整網址 (例如
https://foo.web.app/barhttps://custom.domain.com?query=param)
responseSize HTTP 回應的大小 (以位元組為單位)
serverIp 未填入任何值
status HTTP 回應狀態 (例如:200404)
userAgent 要求的使用者代理程式標頭
Firebase Hosting 會在 jsonPayload 物件 記錄項目。
acceptEncoding (來自 HTTP 要求) 哪些內容編碼通常是 壓縮演算法,則用戶端支援 (例如 gzipcompress)
billable 是否為專案收取要求費用
customDomain 要求是否針對自訂網域提出
hostname 提出要求時使用的主機名稱
remoteIpCountry 要求的來源國家/地區
remoteIpCity 要求的來源城市

使用記錄指標

您可以查看及建構 記錄指標、 然後使用 Cloud Monitoring 中的這些指標建立圖表和快訊 再檢查有關聯的允許政策

  • 利用自動記錄的預先定義系統指標,例如在特定時間範圍內發生的記錄事件數量。

  • 創作 使用者定義指標 。您可以計算符合指定查詢的記錄項目數,或追蹤相符記錄項目中的特定值。個人中心 可以透過規則運算式進行篩選。

  • 使用 Cloud Monitoring: 記錄含有特定訊息或擷取文字的記錄項目數量 記錄項目中回報的延遲資訊。接著,你就能在 圖表和快訊政策

Firebase Hosting 也會產生下列 Hosting 專屬記錄 指標。這些指標不限於記錄項目 一般特定 Hosting 網站

  • log_bytes:每個網站的資料總用量 (位元組)

  • response_count:網站的回應總數

    這項指標包含 HTTP 狀態的欄位,因此您可以繪製 HTTP 回應的圖形 按狀態篩選 (例如)。

將記錄檔匯出至其他 Google Cloud 工具

您也可以將網站記錄匯出至其他 Google Cloud 工具,例如 Cloud Monitoring 或 BigQuery,例如:

  • 使用 Cloud Monitoring, 您可以建立記錄指標,這些資訊可用於圖表與快訊 再檢查有關聯的允許政策

  • 透過 BigQuery,您可以執行以下任一作業: 包括:

    • 使用數據分析產生 Hosting 資料的資訊主頁。
    • 執行查詢即可深入瞭解要求 (平均回應大小、 在快取中找到了所需資料、在快取中找不到所需資料等項目)。
    • 瞭解您的使用者實際要求哪些網址。
    • 結合您的 Hosting 資料與您匯出到的其他 Firebase 資料 BigQuery 並以新的方式查詢。