跳至主要内容
版本:0.4 · 現行版

採集器的運作方式

概念審閱日期:2026年10月11日
適用於:Excubius 0.4角色: 實體管理員, 安裝人員(Linux 管理員)
方案Free · Core · Pro · Enterprise部署自行託管

採集器是 Excubius 中負責連線到你的系統的部分。它透過唯讀連線執行目錄中的檢查,讀取你新增的數據源,並把原始結果傳送給 API;API 會評估結果、發出警報並發送通知。本文說明它的運作方式、使用的傳輸方式、各模組的需求、需要開放的網絡路徑,以及它絕不會做的事。

檢查如何執行​

  1. 採集器每 30 秒會詢問 API 要執行什麼:目錄中的檢查定義、它們針對的資源,以及它們使用的憑證。沒有變更時,回應是空的,幾乎不佔用資源。
  2. 它按每項檢查的間隔,透過目錄指定的傳輸方式執行,例如對 SQL Server 實例使用 T-SQL,對網頁端點使用 HTTP。
  3. 它把原始結果分批傳送給 API。API 把結果與有效閾值比較、開啟及解決警報,並通知相應的頻道。
  4. 它每 10 秒會領取一次性工作,例如 Test connection、Discover,以及數據源的 Test 和 Sync now。它每 60 秒回報一次檢測信號,並顯示在 Overview 的 Sources 區域。

採集器在 Excubius 伺服器內部運行,與 API 相鄰。它只會收到自己的權杖和設定;它永遠看不到數據庫密碼,也看不到加密已儲存機密的金鑰。憑證透過內部網絡傳送給它,只保存在記憶體中,絕不記錄到日誌。

傳輸方式​

傳輸方式是採集器與某一類系統溝通的方式。每一種都只讀取。

傳輸方式連線對象連接埠憑證類型狀態
T-SQL (Microsoft ODBC Driver 18)SQL Server 實例、可用性群組、連結伺服器、Reporting Services 執行記錄1433 或實例的連接埠;沒有固定連接埠的具名實例使用 UDP 1434SQL 登入支援
HTTP(S)網頁端點、Reporting Services 入口網站、TLS 證書、域名到期(RDAP)443、80無、Windows 帳戶(NTLM)、HTTP 用戶及密碼、Bearer 權杖支援
DNS端點和可用性群組接聽程式的名稱解析,使用伺服器的解析器53無支援
Azure Resource Graph雲端態勢檢查、Defender for Cloud 評估、Azure Update Manager、Service Health443伺服器的受控識別,或 Azure 服務主體支援
Microsoft GraphEntra ID 身分識別檢查443伺服器的受控識別,或 Azure 服務主體支援
WazuhWazuh 索引器,以及選用的管理器 API你設定的 URLHTTP 用戶及密碼Wazuh 開啟時支援
WinRMWindows 主機檢查、Active Directory 檢查5986(HTTPS)Windows 帳戶實驗性
SSHLinux 主機檢查22,或主機的 ssh_portSSH 金鑰、SSH 密碼實驗性
PostgreSQLPostgreSQL 模組檢查5432SQL 登入尚未提供:檢查會新增,但保持 未知
注意

WinRM 和 SSH 傳輸方式已經存在,它們的檢查也會新增到 Windows 和 Linux 主機,但尚未在真實主機上驗證。對於這些主機,請先使用 NinjaOne、New Relic 或 Azure Monitor 作為數據源,直到某個版本將它們標示為支援為止。

採集器也會透過 HTTPS(443)讀取數據源,每個數據源都有自己的配接器:New Relic 透過 NerdGraph,NinjaOne 透過其公開 API,Azure Monitor 透過 Azure Resource Manager、Resource Graph、Azure Monitor、Data Factory、Key Vault 和 Microsoft Graph。請參閱數據源。

預設情況下,採集器會提供其映像中所含程式庫對應的所有傳輸方式。EXCUBIUS_COLLECTOR_TRANSPORTS 可縮小這份清單;請參閱環境變數。

各模組的需求​

模組採集方式你需要提供
SQL Server、可用性群組、SQL Server 安全T-SQL每個實例和複本上的唯讀 SQL 登入
WindowsWinRM(實驗性),或 New Relic 和 NinjaOne屬於三個本機讀取群組的 Windows 帳戶,或數據源
LinuxSSH(實驗性),或 New Relic 和 NinjaOne使用金鑰的非 root 用戶,或數據源
PostgreSQL尚未提供原生採集;Azure 彈性伺服器透過 Azure Monitor 採集具備 pg_monitor 的角色,為日後提供採集預先準備
Azure、Azure Data FactoryAzure Monitor 數據源Reader 和 Monitoring Reader,另加唯讀的 Data Factory 角色
綜合檢查HTTP、DNS、T-SQL只有受保護的端點和報表伺服器才需要憑證
到期Azure Monitor、HTTP(RDAP)、T-SQL、WinRMKey Vault 和 Microsoft Graph 的讀取權限
更新由 API 讀取的廠商數據饋送,加上清單檢查從伺服器到這些數據饋送的出站 HTTPS
身分安全Microsoft Graph、WinRM唯讀的 Graph 應用程式權限
雲端安全Resource Graph、Defender for Cloud、WazuhReader 和 Security Reader;唯讀的 Wazuh 用戶
New Relic、NinjaOne它們的數據源唯讀金鑰或 API 用戶端

所有權限集中在這裏:權限。

網絡路徑​

每個連線都由 Excubius 伺服器發起。不會有任何連線連入採集器。

目的地連接埠用途
每個 SQL Server 實例、複本、接聽程式名稱及接聽程式 IPSQL 連接埠,預設為 1433SQL Server 模組、可用性群組、綜合 SQL 往返測試
沒有固定連接埠的具名實例UDP 1434SQL Server Browser
網頁端點和 Reporting Services 入口網站443、80綜合檢查、TLS 證書
伺服器的 DNS 解析器53名稱解析檢查
data.iana.org 和各註冊管理機構的 RDAP 伺服器443域名到期
Windows 主機5986WinRM(實驗性)
Linux 主機22SSH(實驗性)
management.azure.com、graph.microsoft.com、你的金鑰保存庫(*.vault.azure.net),以及使用服務主體時的 login.microsoftonline.com443Azure Monitor 數據源、Azure 態勢和身分識別檢查
api.newrelic.com 或 api.eu.newrelic.com443New Relic 數據源
app.ninjarmm.com,或 eu.、oc. 或 ca.ninjarmm.com443NinjaOne 數據源
Wazuh 索引器和管理器它們的連接埠Wazuh

擷取更新數據饋送以及與 Slack 和 Jira 溝通的是 API,而不是採集器;請參閱環境變數。來自數據源的 Webhook 會送達伺服器公開位址的 443 連接埠,並交給 API,絕不會交給採集器。

限制及逾時​

限制值
同時執行的檢查合共 32 項;按傳輸方式:T-SQL 8、HTTP 和 DNS 16、SSH 8、WinRM 4、Resource Graph 4、Defender、Microsoft Graph 和 Wazuh 各 2
SQL Server 登入逾時 · 查詢逾時10 s · 30 s(目錄參數 timeout_seconds、query_timeout_seconds)
每次查詢讀取的行數1,000
單項檢查的最長執行時間120 s
API 無法連線時保留的結果10,000;最舊的會先被丟棄

SQL Server 工作階段帶有應用程式名稱 monitoring-collector,因此數據庫管理員可以在 sys.dm_exec_sessions 中辨認它們。

採集器絕不會做的事​

採集器在佈建上和程式碼上都是唯讀的。它從不安裝、更新、重新啟動或停止任何東西,從不寫入數據、登錄檔或設定,從不終止工作階段,也從不執行補救措施。需要寫入的檢查,在審核加入目錄時就會被拒絕。

它會送出的內容:

  • SQL Server:對動態管理檢視、目錄檢視、msdb 備份和作業表,以及報表伺服器的 ExecutionLog3 執行 SELECT;把 sys.sp_readerrorlog 的結果放入資料表變數;對連結伺服器執行 sp_testlinkedserver。
  • HTTP:只有 GET 和 HEAD。
  • Azure 和 Wazuh:讀取,加上少數屬於查詢的 POST 請求,例如 Resource Graph 查詢、Data Factory 執行查詢或 Wazuh _search。其他任何請求在程式碼中都會被拒絕。
  • WinRM 和 SSH:目錄中寫明的 PowerShell 和 shell 命令,這些命令只讀取。

每項檢查的確切查詢都在目錄中,也可以透過 API 的 GET /api/v1/catalog/checks/{id} 取得。

選用數據源的代理程式​

Excubius 不會在它所監控的系統上安裝任何東西。選用數據源(例如 Wazuh)的代理程式,由你自己的工具部署,例如 NinjaOne 或你的設定管理工具。

後續步驟​