# Zabbix MCP Server

MCP (Monitoring Control Panel) Server là một hệ thống phân tích thông minh cho Zabbix, giúp tự động phân tích và xử lý các trigger từ Zabbix.

## Tính năng chính

### 1. Phân tích Trigger
- Phân tích nguyên nhân gốc rễ (RCA)
- Phân tích xu hướng và mẫu
- Phân tích tác động và ảnh hưởng
- Đề xuất giải pháp tự động

### 2. Phân tích Xu hướng
- Phân tích tần suất xuất hiện của trigger
- Phân tích mức độ nghiêm trọng theo thời gian
- Phân tích thời gian phục hồi
- Dự đoán xu hướng trong tương lai

### 3. Phân tích Tác động
- Phân tích tác động trực tiếp
- Phân tích tác động gián tiếp
- Phân tích tác động theo thời gian
- Ước tính chi phí kinh doanh

### 4. Bảo mật
- Xác thực API key
- Rate limiting (60 request/phút)
- Logging chi tiết
- Kiểm tra sức khỏe hệ thống

## Cài đặt

### Yêu cầu
- Python 3.8+
- MongoDB 4.4+
- Redis 6.0+
- Zabbix 5.0+

### Cài đặt dependencies
```bash
pip install -r requirements.txt
```

### Cấu hình
1. Tạo file `.env` với các biến môi trường:
```env
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=zabbix_mcp
REDIS_HOST=localhost
REDIS_PORT=6379
ZABBIX_API_URL=http://your-zabbix-server/api_jsonrpc.php
ZABBIX_USER=Admin
ZABBIX_PASSWORD=zabbix
ZABBIX_WEBHOOK_API_KEY=your-secret-key
OPENAI_API_KEY=your-openai-key
USE_OLLAMA=false
OLLAMA_API_URL=http://localhost:11434
OLLAMA_MODEL=llama2
```

2. Cấu hình Zabbix webhook:
```bash
python scripts/setup_zabbix.py
```

### Chạy với Docker
```bash
docker-compose up -d
```

## API Endpoints

### Webhook
```
POST /api/v1/webhook/zabbix
```
Nhận trigger từ Zabbix và phân tích.

Headers:
- `X-API-Key`: API key để xác thực

Body:
```json
{
    "event": {
        "event_id": "string",
        "host": "string",
        "item": "string",
        "trigger": "string",
        "severity": "integer",
        "status": "string",
        "timestamp": "datetime",
        "value": "string",
        "description": "string",
        "tags": []
    },
    "action": "string"
}
```

### Health Check
```
GET /api/v1/health
```
Kiểm tra trạng thái của các service.

## Cấu trúc dự án

```
zabbixmcp/
├── app/
│   ├── api/
│   │   ├── webhook.py
│   │   └── health.py
│   ├── models/
│   │   └── event.py
│   ├── services/
│   │   ├── analysis.py
│   │   ├── database.py
│   │   ├── trend_analysis.py
│   │   ├── impact_analysis.py
│   │   ├── deep_research.py
│   │   ├── rag_service.py
│   │   └── ollama_service.py
│   └── core/
│       └── logging.py
├── config/
├── scripts/
│   └── setup_zabbix.py
├── tests/
├── docker-compose.yml
├── Dockerfile
├── requirements.txt
└── README.md
```

## Phân tích

### Phân tích Xu hướng
- Tần suất xuất hiện của trigger
- Mức độ nghiêm trọng theo thời gian
- Thời gian phục hồi trung bình
- Dự đoán xu hướng

### Phân tích Tác động
- Tác động trực tiếp
  - Mức độ nghiêm trọng
  - Host bị ảnh hưởng
  - Item bị ảnh hưởng
  - Hành động cần thiết
- Tác động gián tiếp
  - Service bị ảnh hưởng
  - User bị ảnh hưởng
  - Hiệu ứng dây chuyền
  - Tác động kinh doanh
- Tác động theo thời gian
  - Thời điểm xảy ra
  - Thời gian phục hồi
  - Mẫu lịch sử

## Bảo mật

### Xác thực
- API key bắt buộc cho webhook
- Kiểm tra IP nguồn
- Rate limiting

### Logging
- Log tất cả request
- Log kết quả phân tích
- Log lỗi và cảnh báo

## Monitoring

### Health Check
- Kiểm tra MongoDB
- Kiểm tra Redis
- Kiểm tra Zabbix API
- Kiểm tra AI service

### Metrics
- Số lượng trigger
- Thời gian phân tích
- Độ chính xác của phân tích
- Tỷ lệ phục hồi

## Contributing

Xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết thêm chi tiết.

## License

MIT License