狀態資料庫
routerd 將狀態與事件持久化至 SQLite。每個常駐程式除此之外還各自擁有自身的租約或狀態檔案與事件日誌。
主要路徑
| 種類 | 路徑 |
|---|---|
| routerd 狀態 DB | /var/lib/routerd/routerd.db |
| DHCPv6-PD 租約 | /var/lib/routerd/dhcpv6-client/<name>/lease.json |
| DHCPv4 租約 | /var/lib/routerd/dhcpv4-client/<name>/lease.json |
| PPPoE 狀態 | /var/lib/routerd/pppoe-client/<name>/state.json |
| HealthCheck 狀態 | /var/lib/routerd/healthcheck/<name>/state.json |
| 常駐程式別事件 | /var/lib/routerd/<daemon>/<name>/events.jsonl |
events 資料表
事件匯流排會將事件持久化至 SQLite。EventRule 與 DerivedEvent 以此串流作為輸入。
日常運維請使用 routerctl get events，而非直接操作 sqlite3：
routerctl get events --limit 20
routerctl get events --topic routerd.resource.status.changed
routerctl get events --resource DNSResolver/lan-resolver -o json
Mobility holder transitions
CloudEdge SAM failover 會發出 routerd.mobility.holder.transition 事件，
其中包含 transitionKind、address、timestamp、issuedAt、
fromNode、toNode、mobilityPathSig、assignmentGeneration 等機器可讀屬性。
在 provider-secondary-IP capture 流程中，seize-complete 表示 active /32
bgpCaptureAssignment 對應的 provider capture assign action 已在 action journal
中記錄為 succeeded。issuedAt 使用 journal 的 ExecutedAt，因此
timestamp - issuedAt 表示從 provider 接受寫入到事件記錄之間的延遲。
T_seize 是 provider 接受寫入的時間。
capture-confirmed 仍然基於 discovery 觀測。T_confirm 是本機程序觀測到
provider capture 生效的時間。兩者共同度量從接受到生效的區間。
節點重啟或 rejoin 後的重新確認事件可能會重用原始 journal 接受時間作為
issuedAt。此時，timestamp - issuedAt 會包含節點停止或缺席的時間。
請將這類差值視為重新確認經過時間，不要解釋為收斂延遲。
對於 static-owned、static-handover、local-home 等非 capture 流程，
seize-complete 仍來自 active-holder 加 self-identity 的 BGP 觀測。目前 lab
實證僅覆蓋 capture 流程；static/handover completion event 尚未在真實環境中實證。
備份思維
狀態 DB 保存的是已觀測到的狀態，無法取代設定。 意圖的正本是 YAML 設定檔，請以 git 管理。 重建主機時，比起還原 SQLite，套用設定檔並讓 routerd 進行調和（reconcile）更為可靠。
若出於鑑識目的需要保留操作事件歷史，請定期為 events.db、dns-queries.db、traffic-flows.db、firewall-logs.db 建立快照。這些檔案為僅附加模式，不需要像 routerd.db 那樣進行特定時間點的備份。