快速入門:新增可用性群組
在本快速入門中,你會把桃花島物流的雙複本可用性群組新增到 Excubius,並在 Overview 上查看它。監控登入建立好之後,大約需要 15 分鐘。
開始之前
- 每個複本上都已以相同的 SID 建立監控登入。請參閱先決條件。
- 你是將存放該群組的實體上的 Entity admin,例如桃花島物流 › Production。
- Excubius 伺服器可以透過 SQL 連接埠連到接聽程式及兩個複本。
在範例中,複本為 sql-ventas-01.ciguapa.example 及 sql-ventas-02.ciguapa.example,群組為 ag-ventas。
1. 儲存登入一次
儲存在桃花島物流上的憑證,可供其下的所有資源使用。
- 控制台
- API
- 開啟 Settings › Credentials,並在實體選擇器中選擇桃花島物流。
- 選取 Add credential,類型選擇 SQL login。
- 輸入名稱
sql-monitoring、用戶usr_monitoring及密碼。 - 選取 Save。密碼會經過加密,之後不會再顯示。
CRED=$(curl -s "${H[@]}" -X POST "$BASE/credentials" -d "{
\"entity_id\": \"$CIGUAPA\", \"name\": \"sql-monitoring\", \"kind\": \"sql_login\",
\"username\": \"usr_monitoring\", \"secret\": \"<password>\"
}" | jq -r .id)
$BASE 是 https://<your server>/api/v1,H 存放你的承載權杖;請參閱 API 參考。
2. 把每個複本新增為實例
- 控制台
- API
- 開啟 Resources › Add resource。
- Type:SQL Server instance。
- Place and name:桃花島物流 › Production,名稱為
sql-ventas-01。 - Connection:主機
sql-ventas-01.ciguapa.example,連接埠1433。 - Tags:
env:prod、role:sql、client:ciguapa;重要程度為4。 - Credential:
sql-monitoring。 - 選擇 Review,然後選擇 Create resource。
對 sql-ventas-02 重複相同步驟。
for n in 01 02; do
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"sqlserver_instance\", \"name\": \"sql-ventas-$n\",
\"attributes\": {\"host\": \"sql-ventas-$n.ciguapa.example\", \"port\": 1433},
\"tags\": {\"env\": \"prod\", \"role\": \"sql\", \"client\": \"ciguapa\"}, \"criticality\": 4,
\"credential_id\": \"$CRED\"
}" | jq '{id, name, checks_provisioned}'
done
SQL Server 實例的預設檢查會立即設定好;第一批數值會在一兩分鐘內到達。
3. 測試連線
在第一個複本上,選取 Test connection。測試成功時,會顯示伺服器名稱、版本、版本類型及延遲,並列出任何缺少的權限。
| 結果 | 含義 | 解決方法 |
|---|---|---|
auth | 登入失敗,或已停用 SQL 登入 | 檢查密碼,並確認實例接受 SQL 登入(混合模式) |
unreachable | 名稱、防火牆或連接埠問題 | 從 Excubius 伺服器檢查 DNS 及防火牆 |
timeout | 未在時限內回應 | 檢查網絡路徑及 SQL 連接埠 |
Warning: login is sysadmin | 可以運作,但不是最低權限 | 依照先決條件重新建立登入 |
4. 探索可用性群組
只在其中一個複本上選取 Discover。探索會讀取伺服器、其可用性群組(包括複本、角色及接聽程式)、數據庫及連結伺服器,並把它們新增為子資源,各自附有檢查。每當拓撲變更時,請再次執行;消失的子資源會標示為遺失,而不會被刪除。
5. 在 Overview 上查看
開啟桃花島物流的 Overview。ag-ventas 卡片會顯示接聽程式、主要複本、兩個複本的同步健康狀態,以及數據庫。兩個複本都應顯示為 正常。
清理
若要移除你新增的項目,請從 Resources 刪除這兩個實例;探索到的子資源、檢查、指標及警報會一併刪除。最後才刪除憑證,確保沒有任何項目再使用它。