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

新增資源

操作指南審閱日期:2026年10月11日
適用於:Excubius 0.4角色: 實體管理員
方案Free · Core · Pro · Enterprise部署自行託管

資源是 Excubius 監控的一個項目:SQL Server 實例、網頁端點、報表伺服器或主機。新增資源時,Excubius 會立即為其類型設定預設檢查。本指南說明如何使用 Add resource 精靈新增資源、測試其連線、探索其上運行的內容,以及編輯或刪除資源。

開始之前​

  • 你需要在將容納該資源的實體上擁有 Entity admin(實體管理員)角色。
  • 資源所需的憑證已儲存,或者你準備好在精靈中建立。請參閱為採集器儲存憑證。
  • Excubius 伺服器可以透過正確的連接埠連線到該系統。請參閱網絡路徑。

數據源回報的資源,例如來自 Azure Monitor 的 Azure 資源或來自 NinjaOne 的裝置,會自動出現。你只需新增原生採集器可連線到的項目。數據庫和連結伺服器同樣不需要手動新增:請從其實例探索它們。

新增資源​

  1. 開啟 Resources 並選取 Add resource。
  2. Type:選擇資源是什麼。每個類型會顯示它預設取得多少項檢查,以及它所需的詳細資料。
  3. Place and name:選擇 Entity,它決定資源繼承什麼(閾值、頻道、憑證),並輸入各處顯示的 Name,例如 sql-ventas-01。
  4. Connection:輸入該類型的詳細資料,必填項目在前。繼續之前會先檢查這些資料。
  5. Tags:新增 key:value 配對,至少包括 env、role 和 client,並設定 Criticality(關鍵程度),從 1(低)到 5(關鍵)。
  6. Credential:選擇一個可用的合適憑證,選擇 None 以使用父資源的憑證,或選擇 New credential 在此建立。
  7. Review 你輸入的內容,然後選取 Create resource。

預設檢查會立即設定,第一批值會在一兩分鐘內到達。最後一個畫面提供 Test connection、適用於 SQL Server 實例的 Discover、Open the resource 和 Add another。

各類型的詳細資料​

類型必填其他詳細資料
SQL Server 實例hostport(預設為 1433);instance 用於沒有固定連接埠的具名實例,透過 UDP 1434 上的 SQL Server Browser 連線
Always On 可用性群組ag_name通常由探索建立,連同它的接聽程式、複本和數據庫
SQL Server Reporting Servicesportal_urltest_report_path 用於轉譯一份報表;host、port、instance 和 report_server_db(預設為 ReportServer)用於執行記錄檢查
網頁端點/入口網站urlexpect_status、expect_text;domain(可註冊的域名)用於域名到期
Windows 主機—ip;沒有它時,採集器會連線到資源名稱
Linux 主機—ip 和 ssh_port(預設為 22);沒有 ip 時,採集器會連線到資源名稱
PostgreSQL 伺服器—host、port
Entra ID 租用戶/網域服務—tenant_id、domain;承載身分識別檢查
監控平台本身—heartbeat_url;承載涵蓋整個平台的檢查,例如更新數據饋送和雲端態勢
Azure 資源—resource_id;通常由 Azure Monitor 數據源新增

測試連線​

在資源頁面上,選取 Test connection。採集器會在大約 10 秒內領取測試,並使用資源的憑證連線。

類型測試成功時顯示
SQL Server 實例、可用性群組伺服器名稱、版本、Edition 和延遲,登入的權限(並列出缺少的權限),以及登入屬於 sysadmin 時的警告
報表伺服器、網頁端點位址、HTTP 狀態和版本,以及延遲

測試失敗時,會顯示錯誤類型和提示:

錯誤類型檢查項目
auth登入名稱和密碼,以及實例是否接受 SQL 登入
unreachable主機名稱、連接埠,以及 Excubius 伺服器與該系統之間的防火牆
timeout網絡路徑;系統沒有及時回應
query登入缺少某項權限
config需要在 Excubius 中修正的內容:主機、憑證或已儲存的機密

如果測試一直停在 waiting for the collector,最後顯示 No collector picked it up,表示採集器沒有運行、沒有權杖,或沒有提供該傳輸方式。請參閱採集器錯誤。

探索實例上運行的內容​

在 SQL Server 實例上,選取 Discover。探索會讀取伺服器、其可用性群組(連同複本、角色和接聽程式)、其數據庫、其連結伺服器,以及 SQL Agent 摘要。它會把這些項目新增或更新為子資源,並附帶各自的檢查,然後回報建立、更新和不再找到的數目。

  • 每當拓撲變更時,請再次執行探索。
  • 不再找到的子項目會標示為 missing,並連同歷史記錄一併保留。探索永遠不會刪除它;當它永久消失時,請自行刪除。
  • 對於可用性群組,請把每個複本新增為實例,並在其中一個上執行探索。請參閱快速入門:新增可用性群組。

編輯或刪除資源​

  • Edit 可變更名稱、關鍵程度、標記和憑證。連線詳細資料和實體需透過 API 變更:使用 PATCH /api/v1/resources/{id} 並附帶 attributes 或 entity_id。
  • Delete 會移除資源,連同其探索到的子項目、檢查、指標和警報。受監控的系統本身絕不會受到影響。

編輯者可在單一資源的 Checks 索引標籤上開啟或關閉檢查,並變更其間隔和閾值;請參閱資源與資源頁面。