查看記錄檔和指標

記錄和指標是偵錯及監控程式碼的重要工具。App Hosting 可讓您快速查看為網頁應用程式提供支援的 Google Cloud 服務記錄和指標:Cloud Run、Cloud Build 和 Cloud CDN。

您可以使用標準記錄語法 (例如 Node.js 的 console.log),將記錄項目寫入 Cloud Logging。

在控制台中查看用量

每個後端都有「Overview」(總覽) 分頁,其中包含應用程式過去七天的流量 (要求數量) 和錯誤率摘要。

後端的「Logs」(記錄) 分頁可讓您查看及篩選「Build logs」(建構記錄) (來自 Cloud Build) 和「Runtime logs」(執行階段記錄) (來自 Cloud Run 和 Cloud CDN)。

每個後端也都有「Usage」(用量) 分頁,其中包含多個用量圖表,顯示應用程式的活動和用量。呈現的資料包括 CDN 頻寬和要求、Cloud Run CPU 和記憶體使用率等。

您可以在 Google Cloud 控制台查看 Cloud Run 的其他使用率指標,例如 CPU 使用率和記憶體使用率。

在控制台中查看記錄

在推出作業的 Firebase 控制台內容選單 (右上角的三點選單) 中,您可以快速查看 Cloud Run 修訂版本詳細資料和錯誤,以及建構記錄。

這些記錄含有實用資訊,可協助您對 App Hosting 部署作業進行偵錯。例如,如果找不到 package.json,Cloud Run 記錄會記下這項資訊。

建構記錄會顯示建構輸出內容,方便您判斷錯誤是發生在架構設定,還是 App Hosting 設定。此外,這個頁面也會顯示基本的 runConfig 設定,並指出設定遺漏或 apphosting.yaml 不存在的情況:

> next build

   ▲ Next.js 14.1.4
   -   Environments: .env

   ...

Route (app)                              Size     First Load JS
┌ λ /                                    4.79 kB         214 kB
├ λ /_not-found                          882 B          85.3 kB
└ λ /restaurant/[id]                     5.28 kB         207 kB
+   First Load JS shared by all            84.4 kB
  ├ chunks/69-6678c81190a8fe82.js        29 kB
  ├ chunks/fd9d1056-51920e345d2966e8.js  53.4 kB
  └ other shared chunks (total)          1.98 kB

將記錄寫入 Cloud Logging

如要記錄自訂事件,可以從 Cloud Run 寫入 Cloud Logging,也就是伺服器轉譯程式碼執行的位置。請使用標準 JavaScript 記錄呼叫,例如 console.log 和 console.error。舉例來說,如要透過 Next.js 路由處理常式的程式碼寫入自訂項目,可以執行下列操作:

export async function GET(request) {
  console.log("Handling GET request");
  return Response.json({ message: "Hello, world!" });
}
  • console.log() 指令的記錄層級為 INFO。
  • console.info() 指令的記錄層級為 INFO。
  • console.warn() 指令具有 ERROR 記錄層級。
  • console.error() 指令具有 ERROR 記錄層級。
  • 內部系統訊息具有 DEBUG 記錄層級。

請注意,console.log 會在應用程式的伺服器轉譯程式碼中傳送至 Cloud Logging。與靜態轉譯相關的事件會傳送至 Cloud Build 記錄,而伺服器轉譯則會傳送至 Cloud Run 記錄。

查看伺服器錯誤

Cloud Error Reporting 會彙整 App Hosting Cloud Run 執行個體的錯誤。您也可以設定 Cloud Error Reporting,在發生新錯誤時通知您。