MQ Monitor 是一個用於監控 IBM MQ 佇列管理器、佇列和通道狀態的 Web 應用程式。它提供了直觀的儀表板和 RESTful API，讓使用者能夠即時監控 MQ 資源的運行狀況。系統具備自動和手動重新連線功能，確保在 MQ 連線斷開時能夠快速恢復連線。
- 佇列管理器監控：顯示佇列管理器的連接狀態、啟動時間等資訊
- 佇列監控：顯示所有佇列的深度、使用率、連接數等資訊
- 通道監控：顯示所有通道的狀態和活動情況
- 自動重新整理：支援可配置的自動重新整理間隔
- 自動重新連線：當 MQ 連線斷開時，系統會自動嘗試重新連線
- 手動重新連線：提供 Web 界面和 API 端點，允許手動觸發重新連線
- RESTful API：提供完整的 API 介面，方便與其他系統整合
- 響應式設計：適應不同螢幕尺寸的裝置
-
後端：
- Java 21
- Spring Boot 3.4.5
- IBM MQ Java Client 9.3.4.0
- PCF (Programmable Command Format) API
- Spring Scheduling (用於自動重新連線)
- Lombok
- Apache Commons Lang3
-
前端：
- FreeMarker 模板引擎
- Bootstrap 5
- JavaScript
- Java 21 或更高版本
- Maven 3.6 或更高版本
- IBM MQ 伺服器 (本地或遠端)
git clone https://github.com/yourusername/mq-monitor.git
cd mq-monitor編輯 src/main/resources/application.yml 檔案，設定您的 IBM MQ 連接資訊：
# IBM MQ 配置
mq-info:
queueManager: YOUR_QUEUE_MANAGER_NAME
channel: YOUR_CHANNEL_NAME
connName: YOUR_HOST(YOUR_PORT)
user: YOUR_USERNAME
password: YOUR_PASSWORD # 可選，如果需要密碼認證./mvnw clean packagejava -jar target/mq-monitor-0.0.1-SNAPSHOT.jar或使用 Maven 直接執行：
./mvnw spring-boot:run應用程式將在 http://localhost:8080 啟動。
- 開啟瀏覽器，訪問 http://localhost:8080
- 儀表板將顯示佇列管理器、佇列和通道的狀態
- 可以設定自動重新整理間隔或手動重新整理
- 點擊「重新連接 MQ」按鈕可手動觸發重新連線
MQ Monitor 提供以下 REST API 端點：
- GET /api/mq/queuemanager - 獲取佇列管理器狀態
- GET /api/mq/queues - 獲取所有佇列狀態
- GET /api/mq/channels - 獲取所有通道狀態
- GET /api/mq/status - 獲取所有 MQ 資源的狀態
- POST /api/mq/reconnect - 手動觸發重新連接到 MQ
範例請求：
# 獲取所有 MQ 資源狀態
curl http://localhost:8080/api/mq/status
# 手動觸發重新連接到 MQ
curl -X POST http://localhost:8080/api/mq/reconnect請求：
GET /api/mq/queuemanager
回應：
{
"name": "MQJ006D",
"status": "正常運行",
"connected": true,
"startDate": "2023-05-15",
"startTime": "08:30:45"
}請求：
GET /api/mq/queues
回應：
[
{
"name": "DEV.QUEUE.1",
"depth": 10,
"maxDepth": 5000,
"openInputCount": 1,
"openOutputCount": 2,
"status": "正常"
},
...
]請求：
GET /api/mq/channels
回應：
[
{
"name": "DEV.APP.SVRCONN",
"status": "運行中",
"active": true
},
...
]請求：
POST /api/mq/reconnect
回應：
{
"success": true,
"message": "已成功重新連接到 MQ"
}或
{
"success": false,
"message": "重新連接到 MQ 失敗"
}mq-monitor/
├── .mvn/ # Maven 包裝器目錄
├── .vscode/ # VS Code 配置
├── src/
│ ├── main/
│ │ ├── java/com/example/mqmonitor/
│ │ │ ├── config/ # 配置類
│ │ │ ├── controller/ # 控制器
│ │ │ │ ├── api/ # API 控制器
│ │ │ │ └── web/ # Web 控制器
│ │ │ ├── model/ # 資料模型
│ │ │ ├── scheduler/ # 排程器
│ │ │ ├── service/ # 服務層
│ │ │ └── MqMonitorApplication.java
│ │ └── resources/
│ │ ├── META-INF/ # 額外配置元數據
│ │ ├── templates/ # FreeMarker 模板
│ │ ├── application.yml # 應用程式配置
│ │ └── logback.xml # 日誌配置
│ └── test/ # 測試類
├── pom.xml # Maven 配置
├── spec.md # 規格文件
├── todolist.md # 任務清單
└── README.md # 本文件
MQConfig.java- MQ 連接配置，負責創建和管理 MQ 連接MQInfo.java- MQ 連接屬性，從配置文件中讀取 MQ 連接參數
- API 控制器
MqApiController.java- 提供 RESTful API 端點，用於獲取 MQ 狀態和觸發重新連線
- Web 控制器
HomeController.java- 處理主頁請求，顯示 MQ 監控儀表板ReportController.java- 處理報表生成和預覽請求
MQStatus.java- MQ 狀態模型，包含佇列管理器、佇列和通道的狀態資訊
MQConnectionService.java- MQ 連接服務，負責管理與 MQ 的連接MQPCFService.java- MQ PCF 命令服務，使用 PCF 命令獲取 MQ 資源狀態PdfReportService.java- PDF 報表生成服務，生成 MQ 狀態報表
MQConnectionScheduler.java- MQ 連接檢查排程器，定期檢查 MQ 連接狀態並自動重新連線
application.yml- 應用程式配置文件，包含 MQ 連接和 FreeMarker 配置logback.xml- 日誌配置文件index.ftl- 主頁 FreeMarker 模板pdf-viewer.ftl- PDF 預覽頁面 FreeMarker 模板
README.md- 專案說明文件spec.md- 系統規格文件report.md- 開發報告todolist.md- 任務清單
- 確保您已安裝 Java 21 和 Maven
- 克隆專案並導入到您的 IDE (Eclipse, IntelliJ IDEA 等)
- 執行
MqMonitorApplication.java啟動應用程式
- Fork 專案
- 創建您的功能分支 (
git checkout -b feature/amazing-feature) - 提交您的更改 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 開啟一個 Pull Request
本專案採用 Apache License 2.0。
如有任何問題或建議，請聯絡：
- GitHub Issues：提交問題