webstatus/readme.md

服务状态监控系统

项目概述

这是一个基于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. 环境准备

# 克隆项目
cd c:\Users\xiaji\Documents\个人文件夹\夏骥\状态页面

# 安装依赖
pip install -r requirements.txt

2. 数据库迁移

python manage.py migrate

3. 启动开发服务器

python manage.py runserver

访问地址：http://localhost:8000

4. 生产环境部署

使用Gunicorn和Nginx

# 安装Gunicorn
pip install gunicorn

# 启动Gunicorn
python -m gunicorn --bind 0.0.0.0:8000 statuspage.wsgi:application

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