日誌與串流
Zeabur 為每個服務提供即時日誌串流，讓你能直接從儀表板即時掌握應用程式的運作狀況。
查看日誌
查看服務日誌的步驟：
- 在 Zeabur 儀表板中開啟你的專案。
- 選取你要檢視的服務。
- 點擊 Logs 分頁。
日誌檢視器會即時顯示應用程式的 stdout 和 stderr 輸出。新的日誌項目會在產生時自動出現，不需要手動重新整理。
建置日誌與執行階段日誌
Zeabur 將日誌分為兩類：
- 建置日誌 — 在建置階段產生的輸出（例如安裝相依套件、編譯等）。可以在每個部署的 Deployments 分頁中查看。
- 執行階段日誌 — 服務執行期間產生的輸出。顯示在 Logs 分頁中，並以即時串流方式呈現。
搜尋與篩選
日誌檢視器支援關鍵字搜尋，幫助你定位特定的項目。在日誌檢視器頂端的篩選列中輸入搜尋字詞，即可高亮顯示並篩選符合的行。
這在以下情況特別有用：
- 尋找錯誤訊息或堆疊追蹤
- 追蹤特定的請求 ID
- 依日誌等級篩選（例如
ERROR、WARN）
日誌保留
執行階段日誌在服務運行期間可供查閱。當服務重新啟動或重新部署時，先前實例的日誌將無法在儀表板中存取。
💡
Zeabur 不提供長期日誌儲存。如果你需要在目前服務生命週期之外保留日誌，請整合外部日誌服務，例如 Logflare、Better Stack 或 Datadog。你可以透過設定應用程式直接將輸出傳送至這些服務來轉發日誌。
最佳實踐
- 使用結構化日誌。 以 JSON 格式輸出日誌，使其更易於搜尋和解析，尤其是在轉發至外部服務時。
- 包含時間戳記。 雖然 Zeabur 會為日誌項目加上時間戳記，但在應用程式輸出中也加入時間戳記可確保跨環境的一致性。
- 使用適當的日誌等級。 使用
INFO記錄例行事件，WARN記錄可恢復的問題，ERROR記錄需要關注的故障。避免在正式環境中輸出過多的DEBUG資訊。 - 避免記錄敏感資料。 絕不要記錄密碼、API 金鑰或個人身份識別資訊。