172 lines
4.4 KiB
Markdown
172 lines
4.4 KiB
Markdown
# 服务状态监控系统
|
||
|
||
## 项目概述
|
||
|
||
这是一个基于Django框架开发的服务状态监控系统，用于实时监控各种服务的运行状态，支持多种检测方式，并提供Web界面和REST API接口。
|
||
|
||
## 主要功能
|
||
|
||
### 1. 服务管理
|
||
- 支持服务分组管理
|
||
- 可添加多种类型的服务监控：
|
||
- Ping检测：通过ICMP ping检查主机可达性
|
||
- TCP端口检测：检查指定主机的TCP端口是否开放
|
||
- HTTP请求：发送HTTP请求检查Web服务状态
|
||
- 自定义脚本：支持通过自定义脚本进行服务检测
|
||
- 支持服务启用/禁用功能
|
||
|
||
### 2. 状态监控
|
||
- 实时记录服务状态变化
|
||
- 保存服务检测历史记录
|
||
- 记录响应时间和错误信息
|
||
- 自动更新服务状态
|
||
|
||
### 3. Web界面
|
||
- 服务列表展示
|
||
- 服务详细信息查看
|
||
- 检测记录历史查询
|
||
- 直观的状态可视化
|
||
|
||
### 4. REST API
|
||
- 提供完整的API接口
|
||
- 支持服务信息查询
|
||
- 支持检测记录查询
|
||
- 支持API文档浏览
|
||
|
||
## 技术栈
|
||
|
||
- **后端框架**：Django 4.2
|
||
- **API框架**：Django REST Framework
|
||
- **数据库**：SQLite（默认），支持扩展到MySQL/PostgreSQL
|
||
- **语言**：Python 3.8+
|
||
- **前端**：Django模板系统
|
||
|
||
## 安装部署
|
||
|
||
### 1. 环境准备
|
||
|
||
```bash
|
||
# 克隆项目
|
||
cd c:\Users\xiaji\Documents\个人文件夹\夏骥\状态页面
|
||
|
||
# 安装依赖
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 2. 数据库迁移
|
||
|
||
```bash
|
||
python manage.py migrate
|
||
```
|
||
|
||
### 3. 启动开发服务器
|
||
|
||
```bash
|
||
python manage.py runserver
|
||
```
|
||
|
||
访问地址：http://localhost:8000
|
||
|
||
### 4. 生产环境部署
|
||
|
||
#### 使用Gunicorn和Nginx
|
||
|
||
```bash
|
||
# 安装Gunicorn
|
||
pip install gunicorn
|
||
|
||
# 启动Gunicorn
|
||
python -m gunicorn --bind 0.0.0.0:8000 statuspage.wsgi:application
|
||
```
|
||
|
||
Nginx配置示例：
|
||
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name your-domain.com;
|
||
|
||
location / {
|
||
proxy_pass http://127.0.0.1:8000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
|
||
location /static/ {
|
||
alias /path/to/your/project/static/;
|
||
}
|
||
|
||
location /media/ {
|
||
alias /path/to/your/project/media/;
|
||
}
|
||
}
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
.
|
||
├── status/ # 主应用目录
|
||
│ ├── migrations/ # 数据库迁移文件
|
||
│ ├── templates/ # HTML模板
|
||
│ │ └── status/ # 状态相关模板
|
||
│ ├── __init__.py
|
||
│ ├── admin.py # Django后台管理
|
||
│ ├── api_urls.py # API路由配置
|
||
│ ├── api_views.py # API视图
|
||
│ ├── apps.py # 应用配置
|
||
│ ├── models.py # 数据模型
|
||
│ ├── serializers.py # API序列化器
|
||
│ ├── tests.py # 测试文件
|
||
│ ├── urls.py # Web路由配置
|
||
│ ├── utils.py # 工具函数
|
||
│ └── views.py # Web视图
|
||
├── statuspage/ # 项目配置目录
|
||
│ ├── __init__.py
|
||
│ ├── asgi.py # ASGI配置
|
||
│ ├── urls.py # 根路由配置
|
||
│ ├── wsgi.py # WSGI配置
|
||
│ └── 生产系统settings.py # 生产环境配置
|
||
├── .gitignore
|
||
├── db.sqlite3 # SQLite数据库文件
|
||
├── manage.py # Django管理脚本
|
||
└── requirements.txt # 项目依赖
|
||
```
|
||
|
||
## 使用说明
|
||
|
||
### Web界面
|
||
|
||
1. **服务列表**：访问首页查看所有服务的状态
|
||
2. **服务详情**：点击服务名称查看详细信息和历史记录
|
||
3. **API文档**：访问 `/api/docs/` 查看API文档
|
||
|
||
### API接口
|
||
|
||
#### 主要API端点
|
||
|
||
- `GET /api/services/` - 获取所有服务列表
|
||
- `GET /api/services/<id>/` - 获取单个服务详情
|
||
- `GET /api/services/<id>/records/` - 获取服务检测记录
|
||
- `GET /api/groups/` - 获取服务分组列表
|
||
|
||
## 开发说明
|
||
|
||
### 日志记录
|
||
|
||
项目使用loguru库进行日志记录，在关键操作处添加了日志输出，便于调试和监控。
|
||
|
||
### 扩展建议
|
||
|
||
1. 添加定时检测任务（可使用Celery或Django Q）
|
||
2. 添加告警功能（邮件、短信、微信通知等）
|
||
3. 添加服务状态统计和图表展示
|
||
4. 实现更完善的权限管理
|
||
5. 添加服务依赖关系管理
|
||
|
||
## 许可证
|
||
|
||
MIT License
|