採集器的運作方式
採集器是 Excubius 中負責連線到你的系統的部分。它透過唯讀連線執行目錄中的檢查,讀取你新增的數據源,並把原始結果傳送給 API;API 會評估結果、發出警報並發送通知。本文說明它的運作方式、使用的傳輸方式、各模組的需求、需要開放的網絡路徑,以及它絕不會做的事。
檢查如何執行
- 採集器每 30 秒會詢問 API 要執行什麼:目錄中的檢查定義、它們針對的資源,以及它們使用的憑證。沒有變更時,回應是空的,幾乎不佔用資源。
- 它按每項檢查的間隔,透過目錄指定的傳輸方式執行,例如對 SQL Server 實例使用 T-SQL,對網頁端點使用 HTTP。
- 它把原始結果分批傳送給 API。API 把結果與有效閾值比較、開啟及解決警報,並通知相應的頻道。
- 它每 10 秒會領取一次性工作,例如 Test connection、Discover,以及數據源的 Test 和 Sync now。它每 60 秒回報一次檢測信號,並顯示在 Overview 的 Sources 區域。
採集器在 Excubius 伺服器內部運行,與 API 相鄰。它只會收到自己的權杖和設定;它永遠看不到數據庫密碼,也看不到加密已儲存機密的金鑰。憑證透過內部網絡傳送給它,只保存在記憶體中,絕不記錄到日誌。
傳輸方式
傳輸方式是採集器與某一類系統溝通的方式。每一種都只讀取。
| 傳輸方式 | 連線對象 | 連接埠 | 憑證類型 | 狀態 |
|---|---|---|---|---|
| T-SQL (Microsoft ODBC Driver 18) | SQL Server 實例、可用性群組、連結伺服器、Reporting Services 執行記錄 | 1433 或實例的連接埠;沒有固定連接埠的具名實例使用 UDP 1434 | SQL 登入 | 支援 |
| HTTP(S) | 網頁端點、Reporting Services 入口網站、TLS 證書、域名到期(RDAP) | 443、80 | 無、Windows 帳戶(NTLM)、HTTP 用戶及密碼、Bearer 權杖 | 支援 |
| DNS | 端點和可用性群組接聽程式的名稱解析,使用伺服器的解析器 | 53 | 無 | 支援 |
| Azure Resource Graph | 雲端態勢檢查、Defender for Cloud 評估、Azure Update Manager、Service Health | 443 | 伺服器的受控識別,或 Azure 服務主體 | 支援 |
| Microsoft Graph | Entra ID 身分識別檢查 | 443 | 伺服器的受控識別,或 Azure 服務主體 | 支援 |
| Wazuh | Wazuh 索引器,以及選用的管理器 API | 你設定的 URL | HTTP 用戶及密碼 | Wazuh 開啟時支援 |
| WinRM | Windows 主機檢查、Active Directory 檢查 | 5986(HTTPS) | Windows 帳戶 | 實驗性 |
| SSH | Linux 主機檢查 | 22,或主機的 ssh_port | SSH 金鑰、SSH 密碼 | 實驗性 |
| PostgreSQL | PostgreSQL 模組檢查 | 5432 | SQL 登入 | 尚未提供:檢查會新增,但保持 未知 |
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 登入 |
| Windows | WinRM(實驗性),或 New Relic 和 NinjaOne | 屬於三個本機讀取群組的 Windows 帳戶,或數據源 |
| Linux | SSH(實驗性),或 New Relic 和 NinjaOne | 使用金鑰的非 root 用戶,或數據源 |
| PostgreSQL | 尚未提供原生採集;Azure 彈性伺服器透過 Azure Monitor 採集 | 具備 pg_monitor 的角色,為日後提供採集預先準備 |
| Azure、Azure Data Factory | Azure Monitor 數據源 | Reader 和 Monitoring Reader,另加唯讀的 Data Factory 角色 |
| 綜合檢查 | HTTP、DNS、T-SQL | 只有受保護的端點和報表伺服器才需要憑證 |
| 到期 | Azure Monitor、HTTP(RDAP)、T-SQL、WinRM | Key Vault 和 Microsoft Graph 的讀取權限 |
| 更新 | 由 API 讀取的廠商數據饋送,加上清單檢查 | 從伺服器到這些數據饋送的出站 HTTPS |
| 身分安全 | Microsoft Graph、WinRM | 唯讀的 Graph 應用程式權限 |
| 雲端安全 | Resource Graph、Defender for Cloud、Wazuh | Reader 和 Security Reader;唯讀的 Wazuh 用戶 |
| New Relic、NinjaOne | 它們的數據源 | 唯讀金鑰或 API 用戶端 |
所有權限集中在這裏:權限。
網絡路徑
每個連線都由 Excubius 伺服器發起。不會有任何連線連入採集器。
| 目的地 | 連接埠 | 用途 |
|---|---|---|
| 每個 SQL Server 實例、複本、接聽程式名稱及接聽程式 IP | SQL 連接埠,預設為 1433 | SQL Server 模組、可用性群組、綜合 SQL 往返測試 |
| 沒有固定連接埠的具名實例 | UDP 1434 | SQL Server Browser |
| 網頁端點和 Reporting Services 入口網站 | 443、80 | 綜合檢查、TLS 證書 |
| 伺服器的 DNS 解析器 | 53 | 名稱解析檢查 |
data.iana.org 和各註冊管理機構的 RDAP 伺服器 | 443 | 域名到期 |
| Windows 主機 | 5986 | WinRM(實驗性) |
| Linux 主機 | 22 | SSH(實驗性) |
management.azure.com、graph.microsoft.com、你的金鑰保存庫(*.vault.azure.net),以及使用服務主體時的 login.microsoftonline.com | 443 | Azure Monitor 數據源、Azure 態勢和身分識別檢查 |
api.newrelic.com 或 api.eu.newrelic.com | 443 | New Relic 數據源 |
app.ninjarmm.com,或 eu.、oc. 或 ca.ninjarmm.com | 443 | NinjaOne 數據源 |
| 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 或你的設定管理工具。