架構
Excubius 以一小組容器的形式運行在你控制的一部 Linux 伺服器上。唯讀的採集器及你已擁有的監控工具,會把數據送入同一條處理流程,由它轉換成資源、狀態及警報,儲存在一個數據庫中,再提供給網頁應用程式、Slack、Jira 及公開狀態頁使用。本文說明每個組件、一次量測如何變成警報、伺服器如何配置,以及各項數據存放在哪裡。
組件及其連接方式
| 組件 | 作用 |
|---|---|
| 採集器 | 對你的系統執行檢查目錄中的檢查:對 SQL Server 使用 T-SQL,對端點、證書及域名使用 HTTP 和 DNS,另外還有 Azure 及 Microsoft Graph API,以及 Wazuh 搜尋。透過 WinRM 監控 Windows 及透過 SSH 監控 Linux 屬於實驗性功能。採集器也會輪詢你已擁有的工具。它使用沒有寫入權限的憑證連線,並在伺服器繁忙或重新啟動時,把結果保存在緩衝區中 |
| 數據源 | New Relic、NinjaOne 及 Azure Monitor,每個都可以透過輪詢、Webhook 或兩者並用來讀取。它們回報的內容與採集器的結果進入同一條處理流程,因此它們的警報會抵達同一個收件匣及同樣的通知頻道 |
| 正規化器 | 把每項輸入轉換成同樣的三種形式:資源、檢查結果或警報。系統會依據 Azure 資源 ID、主機名稱及 FQDN 等識別資訊,在不同數據源之間比對資源,因此三個工具看到的同一部伺服器只算一個資源 |
| 警報引擎 | 把每個結果與其有效閾值比較,開啟、升級及解決警報,去除重複警報,把警報歸入根本原因,在靜音及維護時段內暫緩通知,並計算每個資源的狀態 |
| 數據庫 | 使用 TimescaleDB 的 PostgreSQL 16 保存所有內容:設定、資源、指標、帶有時間線的警報、發現及稽核記錄 |
| API 及網頁應用程式 | API 為網頁應用程式提供服務,並根據你在相關實體上的角色檢查每個請求。網頁應用程式可在任何現行瀏覽器中運行,也可以安裝到手機或平板電腦上。公開狀態頁只會使用管理員選擇發佈的內容 |
| 通知 | Slack 訊息會在結果儲存後立即發出,後台每 15 秒掃描一次,發送需要等待的訊息。Slack 緩慢或無法使用,都不會延誤監控。Jira 問題按需建立,並會持續追蹤至完成 |
一次量測如何變成警報
- 採集器在檢查到期時執行檢查,並透過伺服器的內部網絡把結果發送到 API。數據源則改為透過輪詢或 Webhook 回報。
- 系統先儲存結果,因此即使後續步驟失敗也不會遺失任何內容。結果中的數值會寫入指標歷史記錄。
- 警報引擎把數值與該資源上該檢查的有效閾值比較。當條件在整個
for持續時間內持續成立,引擎會開啟警報,或更新同一條件已經開啟的警報。 - 系統重新計算資源的狀態,網頁應用程式在下次重新整理時顯示新狀態。
- 通知步驟判斷這項變更是否值得發送訊息,透過實體樹找出通知頻道,並把每則訊息記錄在警報的時間線上。
警報及通知詳細說明第 3 至 5 步,閾值及基線則說明有效閾值的來源。
一部伺服器,六個容器
所有組件都運行在一部伺服器上,作業系統為 Rocky Linux 9 或 10,或其他 Red Hat Enterprise Linux 系列系統,處理器架構為 x86_64。最低要求是 2 個 vCPU、4 GiB 記憶體及 20 GiB 可用磁碟空間。容器由 Podman 以無 root 模式在服務帳戶下運行,預設帳戶為 excubius,並隨伺服器啟動。伺服器上沒有原始碼:一個發行版本由一組容器映像檔及一個部署套件組成,由安裝程式負責安裝及升級。
| 容器 | 用途 |
|---|---|
proxy | 唯一開放連接埠 80 及 443 的容器。它負責終止 TLS,把請求轉送到網頁應用程式或 API,並限制 Webhook 的請求頻率 |
frontend | 提供網頁應用程式 |
backend | API、正規化器、警報引擎、通知、Jira 及公開狀態頁 |
collector | 採集器及數據源輪詢。它不開放任何連接埠,只接收自己的令牌及設定,永遠不會取得數據庫密碼或用於加密已儲存機密的密鑰 |
certs | 簽發及續期 TLS 證書:Let's Encrypt、自簽證書或你自己的證書 |
db | 使用 TimescaleDB 的 PostgreSQL 16 |
採集器只透過伺服器的內部網絡與 API 通訊:proxy 會拒絕來自外部對採集器路由的請求。對外方面,伺服器需要以 HTTPS 連線到 Slack、Jira 及你的數據源的 API。更新模組也會讀取公開的組建及公告資訊來源,當伺服器無法連線時,會改用發行版本內附的副本。在 Azure 中,請為伺服器的受控識別授予唯讀角色,例如 Reader 及 Monitoring Reader,讓採集器無需儲存機密即可讀取 Azure。
將外部的在線狀態監察工具指向 https://<your host>/heartbeat。伺服器運行期間,它會回應 ok,因此當 Excubius 本身停機時,你會收到通知。
數據存放在哪裡
| 數據 | 存放位置 | 保留時間 |
|---|---|---|
| 實體、資源、檢查、閾值、用戶及角色 | 數據庫 | 直至你變更為止 |
| 指標 | 數據庫,存放在 TimescaleDB hypertable 中 | 90 天 |
| 警報、發現、其時間線、查看記錄及指派 | 數據庫 | 作為歷史記錄保留 |
| 來自數據源的 Webhook 內容 | 數據庫 | 30 天 |
| 安全分數歷史記錄 | 數據庫 | 14 天內每小時一份快照,之後每天一份,保留 400 天 |
| 稽核記錄 | 數據庫 | 保留 |
| 憑證及數據源機密 | 數據庫,使用只保存在伺服器設定檔內的密鑰加密 | 直至你取代或移除為止 |
| 伺服器設定:數據庫密碼、工作階段簽署機密、加密密鑰、採集器令牌 | 安裝目錄中的 .env 檔案,預設安裝目錄為 /opt/excubius | 由安裝程式一次性產生 |
| TLS 證書 | certs 容器的一個儲存卷 | 剩餘 30 天或以內時自動續期 |
| 數據庫備份 | 安裝目錄中的 backups 資料夾:每天伺服器時間 02:30 一份傾印檔 | 最近 14 份傾印檔 |
機密只能寫入:儲存後,沒有人能在網頁應用程式或透過 API 再次讀取。單憑一份數據庫傾印檔無法得知任何機密,因為密鑰不在數據庫內;基於同一原因,請把 .env 檔案的副本與備份一併保管,否則還原數據庫後,必須重新輸入已儲存的機密。請透過你一般的伺服器備份,把每日備份複製到伺服器以外;升級、備份及還原說明如何還原這些備份。
在設計上唯讀
Excubius 偵測、解釋及建議;它絕不會變更受監控的系統。
- 監控登入帳戶及 API 憑證在建立時不具備寫入或安裝權限。SQL Server 登入帳戶永遠不需要
sysadmin。 - 安全發現及更新公告附有建議措施,以文字形式提供,供人員在變更時段內跟進。系統不會執行任何操作,也不會安裝任何內容。
- 系統不會向 New Relic、NinjaOne、Azure、Microsoft Entra ID 或 Wazuh 寫入任何內容。
- 在 Excubius 中刪除資源,只會刪除該資源在 Excubius 內的檢查、指標及警報,不會影響受監控的系統。
發生故障時
| 故障情況 | Excubius 的處理方式 |
|---|---|
| 數據源的 API 停止運作 | 數據源會變成過時狀態並顯示錯誤。系統不會因為輪詢失敗而解決任何警報,也不會憑空產生警報 |
| 採集器無法連線到資源 | 連續三次連線、登入或逾時失敗後,資源變成 嚴重,並產生一條 Cannot reach 警報,資源的其他警報則排在它之後等待 |
| API 或數據庫暫時無法使用 | 採集器保留結果,稍後再發送。同一個結果發送兩次,只會儲存一次 |
| Slack 無法使用 | 監控繼續運作。失敗的訊息會記錄在警報上並重試,一共三次 |
| Excubius 伺服器停機 | 期間發送的 Webhook 會遺失。混合模式的數據源會在下次比對同步時補回 |