blocklet server logs 指令是一個用於故障排除和監控的重要工具。它不會直接顯示日誌內容,而是提供與 Blocklet Server 守護進程及任何已安裝的 Blocklet 相關的所有日誌的確切檔案路徑。這讓您可以使用標準的命令列工具,如 cat、tail 或 less,輕鬆地定位和檢查日誌。
用法
要在您的 Blocklet Server 專案目錄中顯示日誌檔案路徑,只需執行以下指令:
blocklet server logs
blocklet server logs輸出說明
該指令的輸出分為兩個主要部分:伺服器層級的日誌和特定於 Blocklet 的日誌。
伺服器日誌
此部分提供核心 Blocklet Server 守護進程日誌的路徑。它將始終顯示守護進程日誌的主目錄,並指向最新的業務日誌檔案。
伺服器會維護多種類型的日誌,這些日誌會每日輪替:
| 檔名模式 | 說明 |
|---|---|
access-<date>.log | 標準存取日誌,用於追蹤傳入的 HTTP 請求。 |
daemon-<date>.log | 主要的業務日誌,包含伺服器的運營資訊。 |
daemon-error-<date>.log | 錯誤日誌,捕獲伺服器拋出的任何異常或嚴重錯誤。 |
service.log | 與底層 Blocklet Server 服務管理器 (abtnode) 相關的日誌。 |
stderr.log | 來自伺服器進程的原始標準錯誤輸出。 |
stdout.log | 來自伺服器進程的原始標準輸出。 |
Blocklet 日誌
如果您的 Blocklet Server 正在執行且已安裝 Blocklet,該指令也會列出每個 Blocklet 的日誌檔案。這對於獨立調試單個 Blocklet 非常有幫助。
對於每個已安裝的 Blocklet,您將看到兩個日誌檔案路徑:
- 輸出:指向
output.log的路徑,其中包含來自 Blocklet 進程的標準輸出 (stdout)。 - 錯誤:指向
error.log的路徑,其中包含來自 Blocklet 進程的標準錯誤 (stderr)。
輸出範例
以下是在安裝了兩個 Blocklet 的伺服器上執行該指令時可能看到的範例:
輸出範例
$ blocklet server logs
Blocklet Server Logs
- Latest logs: /path/to/your/data/daemon/logs/daemon-2023-10-27.log
- Daemon Logs Directory: /path/to/your/data/daemon/logs
Daemon Logs
- access-<date>.log: access logs rotated by day
- daemon-<date>.log: business logs rotated by day
- daemon-error-<date>.log: error logs rotated by day
- service.log: abtnode service logs
- stderr.log: stderr logs
- stdout.log: stdout logs
my-first-blocklet@1.2.0
- Output: /path/to/your/data/logs/my-first-blocklet/output.log
- Error: /path/to/your/data/logs/my-first-blocklet/error.log
another-blocklet@2.0.1
- Output: /path/to/your/data/logs/another-blocklet/output.log
- Error: /path/to/your/data/logs/another-blocklet/error.log常見情境
- 伺服器未執行:如果 Blocklet Server 未執行,該指令無法存取特定 Blocklet 的日誌,並會顯示警告:
Unable to get blocklet logs because Blocklet Server is not running。 - 未安裝 Blocklet:如果伺服器正在執行但尚未安裝任何 Blocklet,您將看到以下訊息:
No blocklets installed yet.