新增資源
資源是 Excubius 監控的一個項目:SQL Server 實例、網頁端點、報表伺服器或主機。新增資源時,Excubius 會立即為其類型設定預設檢查。本指南說明如何使用 Add resource 精靈新增資源、測試其連線、探索其上運行的內容,以及編輯或刪除資源。
開始之前
- 你需要在將容納該資源的實體上擁有 Entity admin(實體管理員)角色。
- 資源所需的憑證已儲存,或者你準備好在精靈中建立。請參閱為採集器儲存憑證。
- Excubius 伺服器可以透過正確的連接埠連線到該系統。請參閱網絡路徑。
數據源回報的資源,例如來自 Azure Monitor 的 Azure 資源或來自 NinjaOne 的裝置,會自動出現。你只需新增原生採集器可連線到的項目。數據庫和連結伺服器同樣不需要手動新增:請從其實例探索它們。
新增資源
- 控制台
- API
- 開啟 Resources 並選取 Add resource。
- Type:選擇資源是什麼。每個類型會顯示它預設取得多少項檢查,以及它所需的詳細資料。
- Place and name:選擇 Entity,它決定資源繼承什麼(閾值、頻道、憑證),並輸入各處顯示的 Name,例如
sql-ventas-01。 - Connection:輸入該類型的詳細資料,必填項目在前。繼續之前會先檢查這些資料。
- Tags:新增
key:value配對,至少包括env、role和client,並設定 Criticality(關鍵程度),從 1(低)到 5(關鍵)。 - Credential:選擇一個可用的合適憑證,選擇 None 以使用父資源的憑證,或選擇 New credential 在此建立。
- Review 你輸入的內容,然後選取 Create resource。
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"web_endpoint\", \"name\": \"portal-ventas\",
\"attributes\": {\"url\": \"https://ventas.ciguapa.example/\", \"domain\": \"ciguapa.example\"},
\"tags\": {\"env\": \"prod\", \"role\": \"web\", \"client\": \"ciguapa\"}, \"criticality\": 4
}" | jq '{id, name, checks_provisioned}'
$BASE 是 https://<your server>/api/v1,H 保存你的 Bearer 權杖;請參閱 API 參考。
預設檢查會立即設定,第一批值會在一兩分鐘內到達。最後一個畫面提供 Test connection、適用於 SQL Server 實例的 Discover、Open the resource 和 Add another。
各類型的詳細資料
| 類型 | 必填 | 其他詳細資料 |
|---|---|---|
| SQL Server 實例 | host | port(預設為 1433);instance 用於沒有固定連接埠的具名實例,透過 UDP 1434 上的 SQL Server Browser 連線 |
| Always On 可用性群組 | ag_name | 通常由探索建立,連同它的接聽程式、複本和數據庫 |
| SQL Server Reporting Services | portal_url | test_report_path 用於轉譯一份報表;host、port、instance 和 report_server_db(預設為 ReportServer)用於執行記錄檢查 |
| 網頁端點/入口網站 | url | expect_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 索引標籤上開啟或關閉檢查,並變更其間隔和閾值;請參閱資源與資源頁面。