跳至內容

本機 Linux

此內容適用於 0.1。 切換至最新版本以取得最新文件。

Chronicle 發行版本的 live-capture 部署形式是本機 Linux 主機。發行版本二進位檔的 target 為 x86_64-unknown-linux-gnuaarch64-unknown-linux-gnu;0.1 保留的 runtime 驗證環境是 Ubuntu 24.04/Linux 6.8/aarch64。x86_64 與其他 Linux 6.1+ 環境需要相符的 privileged acceptance;二進位檔可建置不代表 runtime 支援。

Terminal window
chronicle doctor

live capture 需要:

  • 發行版本 target 為 x86_64-unknown-linux-gnu 與 aarch64-unknown-linux-gnu;
  • runtime 驗證環境:Ubuntu 24.04/Linux 6.8/aarch64;
  • 其他 Linux 6.1+ 核心與 x86_64 需要相符的 privileged acceptance;
  • 啟用 cgroup v2、/sys/kernel/btf/vmlinux 提供 BTF,並具備必要 capability;
  • 錄製程序需要 CAP_BPFCAP_NET_ADMIN
  • 二進位檔包含內嵌 eBPF 程式;
  • 工作負載產生有明確上限的明文 HTTP/1.1。

自動化層需要穩定的 probe data 時,請透過全域選項使用 doctor --format json

Terminal window
chronicle --format json doctor

Recording、WAL segment、manifest、checkpoint 與 canonical payload 都會留在解析後的本機 data directory。recording 會持續到結束或明確停止為止,且不能超過 4 GiB 的實體 WAL 容量上限。規劃磁碟與檔案權限時,應以擷取資料而不是二進位檔大小為準。

Chronicle 目前沒有提供 Docker 或 Kubernetes 封裝、常駐的分散式 capture plane、PostgreSQL/S3 persistence 或遠端 artifact publication。這些是未來的議題,不是 0.1.x 的部署指示。

對受監督的命令,請使用:

Terminal window
chronicle record --name checkout -- ./my-app

對既有程序或 cgroup,請使用 --pid PID--cgroup PATH;Chronicle 不會終止這些工作負載。Replay 仍然只允許 loopback,且必須明確授權。