完成 APP 建立流程和使用分析、增加主機備機的備援機制、管理者後臺增加資料庫監控
This commit is contained in:
275
README-DATABASE-FAILOVER.md
Normal file
275
README-DATABASE-FAILOVER.md
Normal file
@@ -0,0 +1,275 @@
|
||||
# 資料庫備援系統說明
|
||||
|
||||
## 概述
|
||||
|
||||
本系統實現了主機和備機資料庫的自動備援機制，當主機資料庫出現問題時，系統會自動切換到備機資料庫，確保服務的連續性和穩定性。
|
||||
|
||||
## 功能特點
|
||||
|
||||
- ✅ 自動故障檢測和切換
|
||||
- ✅ 健康檢查機制
|
||||
- ✅ 手動切換功能
|
||||
- ✅ 資料同步功能
|
||||
- ✅ 監控面板
|
||||
- ✅ 連接池管理
|
||||
- ✅ 重試機制
|
||||
|
||||
## 環境變數配置
|
||||
|
||||
在 `.env` 文件中添加以下配置：
|
||||
|
||||
```env
|
||||
# ===== 主機資料庫配置 =====
|
||||
DB_HOST=mysql.theaken.com
|
||||
DB_PORT=33306
|
||||
DB_NAME=db_AI_Platform
|
||||
DB_USER=AI_Platform
|
||||
DB_PASSWORD=Aa123456
|
||||
|
||||
# ===== 備機資料庫配置 =====
|
||||
SLAVE_DB_HOST=122.100.99.161
|
||||
SLAVE_DB_PORT=43306
|
||||
SLAVE_DB_NAME=db_nighttime_care_record
|
||||
SLAVE_DB_USER=A999
|
||||
SLAVE_DB_PASSWORD=1023
|
||||
|
||||
# ===== 資料庫備援配置 =====
|
||||
DB_FAILOVER_ENABLED=true
|
||||
DB_HEALTH_CHECK_INTERVAL=30000
|
||||
DB_CONNECTION_TIMEOUT=5000
|
||||
DB_RETRY_ATTEMPTS=3
|
||||
DB_RETRY_DELAY=2000
|
||||
```
|
||||
|
||||
## 初始化步驟
|
||||
|
||||
### 1. 初始化備機資料庫
|
||||
|
||||
首先在備機上創建資料庫結構：
|
||||
|
||||
```bash
|
||||
# 初始化備機資料庫結構
|
||||
pnpm run db:init-slave
|
||||
```
|
||||
|
||||
### 2. 同步資料
|
||||
|
||||
將主機的資料同步到備機：
|
||||
|
||||
```bash
|
||||
# 同步所有資料
|
||||
pnpm run db:sync
|
||||
```
|
||||
|
||||
### 3. 檢查健康狀態
|
||||
|
||||
檢查主機和備機的連接狀態：
|
||||
|
||||
```bash
|
||||
# 檢查資料庫健康狀態
|
||||
pnpm run db:health
|
||||
```
|
||||
|
||||
## 使用方法
|
||||
|
||||
### 程式碼中使用
|
||||
|
||||
系統會自動使用備援功能，無需修改現有程式碼：
|
||||
|
||||
```typescript
|
||||
import { db } from '@/lib/database';
|
||||
|
||||
// 查詢資料
|
||||
const users = await db.query('SELECT * FROM users');
|
||||
|
||||
// 插入資料
|
||||
await db.insert('INSERT INTO users (name, email) VALUES (?, ?)', ['John', 'john@example.com']);
|
||||
|
||||
// 獲取備援狀態
|
||||
const status = db.getFailoverStatus();
|
||||
console.log('當前使用資料庫:', status?.currentDatabase);
|
||||
|
||||
// 手動切換資料庫
|
||||
await db.switchDatabase('slave'); // 切換到備機
|
||||
await db.switchDatabase('master'); // 切換到主機
|
||||
```
|
||||
|
||||
### 監控面板
|
||||
|
||||
訪問管理後台查看資料庫狀態：
|
||||
|
||||
```typescript
|
||||
import { DatabaseMonitor } from '@/components/admin/database-monitor';
|
||||
|
||||
// 在管理頁面中使用
|
||||
<DatabaseMonitor />
|
||||
```
|
||||
|
||||
### API 端點
|
||||
|
||||
#### 獲取資料庫狀態
|
||||
|
||||
```http
|
||||
GET /api/admin/database-status
|
||||
```
|
||||
|
||||
回應：
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"isEnabled": true,
|
||||
"currentDatabase": "master",
|
||||
"masterHealthy": true,
|
||||
"slaveHealthy": true,
|
||||
"lastHealthCheck": "2024-01-01T12:00:00.000Z",
|
||||
"consecutiveFailures": 0,
|
||||
"uptime": 3600,
|
||||
"timestamp": "2024-01-01T12:00:00.000Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 切換資料庫
|
||||
|
||||
```http
|
||||
POST /api/admin/database-status
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"action": "switch",
|
||||
"database": "slave"
|
||||
}
|
||||
```
|
||||
|
||||
## 腳本命令
|
||||
|
||||
| 命令 | 說明 |
|
||||
|------|------|
|
||||
| `pnpm run db:init-slave` | 初始化備機資料庫結構 |
|
||||
| `pnpm run db:sync` | 同步主機資料到備機 |
|
||||
| `pnpm run db:health` | 檢查資料庫健康狀態 |
|
||||
| `pnpm run db:monitor` | 執行健康檢查並顯示結果 |
|
||||
|
||||
## 故障處理
|
||||
|
||||
### 自動切換
|
||||
|
||||
當主機資料庫出現以下問題時，系統會自動切換到備機：
|
||||
|
||||
- 連接超時
|
||||
- 連接重置
|
||||
- 協議錯誤
|
||||
- 其他連接相關錯誤
|
||||
|
||||
### 手動切換
|
||||
|
||||
如果需要手動切換資料庫：
|
||||
|
||||
1. 通過監控面板切換
|
||||
2. 通過 API 切換
|
||||
3. 通過程式碼切換
|
||||
|
||||
### 故障恢復
|
||||
|
||||
當主機資料庫恢復後：
|
||||
|
||||
1. 系統會自動檢測到主機恢復
|
||||
2. 可以手動切換回主機
|
||||
3. 建議重新同步資料
|
||||
|
||||
## 監控和日誌
|
||||
|
||||
### 健康檢查
|
||||
|
||||
- 每 30 秒自動檢查一次
|
||||
- 檢查連接狀態和響應時間
|
||||
- 記錄連續失敗次數
|
||||
|
||||
### 日誌記錄
|
||||
|
||||
系統會記錄以下事件：
|
||||
|
||||
- 資料庫切換事件
|
||||
- 連接失敗事件
|
||||
- 健康檢查結果
|
||||
- 同步操作結果
|
||||
|
||||
### 監控指標
|
||||
|
||||
- 當前使用的資料庫
|
||||
- 主機和備機的健康狀態
|
||||
- 最後檢查時間
|
||||
- 連續失敗次數
|
||||
- 系統運行時間
|
||||
|
||||
## 注意事項
|
||||
|
||||
1. **資料一致性**：備機資料可能不是實時同步的，建議定期同步
|
||||
2. **性能影響**：備援機制會增加少量性能開銷
|
||||
3. **網路依賴**：需要確保主機和備機之間的網路連接穩定
|
||||
4. **權限配置**：確保備機資料庫有足夠的權限進行操作
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 常見問題
|
||||
|
||||
1. **備機連接失敗**
|
||||
- 檢查網路連接
|
||||
- 驗證資料庫配置
|
||||
- 確認用戶權限
|
||||
|
||||
2. **同步失敗**
|
||||
- 檢查表結構是否一致
|
||||
- 確認資料庫權限
|
||||
- 查看錯誤日誌
|
||||
|
||||
3. **自動切換不工作**
|
||||
- 確認 `DB_FAILOVER_ENABLED=true`
|
||||
- 檢查健康檢查間隔設定
|
||||
- 查看系統日誌
|
||||
|
||||
### 日誌位置
|
||||
|
||||
- 應用程式日誌：控制台輸出
|
||||
- 資料庫日誌：MySQL 錯誤日誌
|
||||
- 系統日誌：系統日誌文件
|
||||
|
||||
## 最佳實踐
|
||||
|
||||
1. **定期備份**：即使有備援機制，仍建議定期備份資料
|
||||
2. **監控告警**：設定監控告警，及時發現問題
|
||||
3. **測試切換**：定期測試備援切換功能
|
||||
4. **性能監控**：監控資料庫性能指標
|
||||
5. **文檔更新**：保持配置文檔的更新
|
||||
|
||||
## 技術架構
|
||||
|
||||
```
|
||||
┌─────────────────┐ ┌─────────────────┐
|
||||
│ 應用程式 │ │ 應用程式 │
|
||||
└─────────┬───────┘ └─────────┬───────┘
|
||||
│ │
|
||||
▼ ▼
|
||||
┌─────────────────┐ ┌─────────────────┐
|
||||
│ 資料庫服務 │ │ 備援服務 │
|
||||
│ (主機) │ │ (備機) │
|
||||
└─────────────────┘ └─────────────────┘
|
||||
│ │
|
||||
▼ ▼
|
||||
┌─────────────────┐ ┌─────────────────┐
|
||||
│ MySQL 主機 │ │ MySQL 備機 │
|
||||
│ mysql.theaken │ │ 122.100.99.161│
|
||||
│ .com:33306 │ │ :43306 │
|
||||
└─────────────────┘ └─────────────────┘
|
||||
```
|
||||
|
||||
## 支援
|
||||
|
||||
如有問題，請檢查：
|
||||
|
||||
1. 環境變數配置
|
||||
2. 網路連接狀態
|
||||
3. 資料庫服務狀態
|
||||
4. 系統日誌
|
||||
5. 監控面板狀態
|
||||
Reference in New Issue
Block a user