日誌

日誌 是雲端面板中,用來查看建置輸出、執行階段活動與專案錯誤訊息的區域。

何時該使用日誌

當應用程式行為與預期不符,而你需要技術證據而非靠肉眼猜測時,開啟 日誌。

適用於以下問題:

  • 部署或建置未如預期完成
  • 某個頁面或功能在預覽中正常,但在執行階段卻失敗
  • API、登入或付款流程回傳錯誤
  • 在專案發佈後除錯即時問題

你能在日誌中做什麼

在 日誌 面板中,你可以:

  • 在執行階段日誌與建置日誌間切換
  • 使用搜尋篩選日誌行
  • 即時觀看新的執行階段日誌行出現
  • 在閱讀時開啟或關閉自動捲動
  • 清除目前的日誌檢視畫面

這使 日誌 成為檢查應用程式在介面背後實際運作情況的主要地方。

執行階段日誌與建置日誌

依問題類型選擇正確的日誌類別:

  • 執行階段 日誌適合應用程式已在運作,但實際使用時某個功能失敗的情況
  • 建置 日誌適合程式碼生成、部署或設定在應用程式能正常運作前就出現異常的情況

簡單的判斷原則:

  • 如果應用程式能載入但某功能異常,先查看執行階段日誌
  • 如果應用程式在能被使用之前就失敗,先查看建置日誌

如何快速閱讀日誌

不要一開始就逐行閱讀。

通常最快的方法是:

  1. 重現問題一次。
  2. 開啟 日誌。
  3. 切換到最相關的分頁。
  4. 搜尋明顯的關鍵字,例如 error、auth、payment、端點名稱或時間戳記。
  5. 尋找第一個真正解釋失敗原因的行,而不是後續重複的內容。

如果執行階段日誌更新太快,請關閉自動捲動,以便專注檢查某一部分內容。

日誌比預覽更有用的時機

預覽 顯示應用程式看起來的樣子。

日誌 顯示應用程式實際在做什麼。

在以下情況使用 日誌:

  • 請求失敗
  • 伺服器端或執行階段錯誤
  • 遺失的密鑰
  • 整合失敗
  • 建置或部署問題

在問題主要與視覺或版面有關時,使用 預覽。

相關指南