系统信息收集功能优化方案：Django命令式实现

系统信息收集功能优化方案：Django命令式实现

一、实现方案概述

为提升系统健康检查端点性能，将原BeaconHealthCheckView中的实时系统信息收集功能迁移至独立Django命令，通过预生成配置文件实现信息读取与健康检查解耦。该方案通过定时任务维护系统信息时效性，同时降低健康检查接口响应延迟。

二、核心模块变更

1. Django管理命令实现

文件路径：apps/audit_logs/management/commands/write_system_info.py

功能：独立收集系统信息并写入INI格式配置文件，支持手动触发与自动调度。

关键实现：

• 信息采集项：

o 基础环境：OS类型/版本、系统架构、处理器型号、Python版本

o 框架版本：Django、DRF版本号

o 运行指标：主机名、系统运行时间（通过psutil计算）

• 文件输出：

o 路径：项目根目录system.ini

o 格式：标准INI结构，包含[System]section

o 示例内容：[System]

os = Linux

os_release = 5.15.0-86-generic

python_version = 3.10.12

django_version = 4.2.5

uptime = 15h 30m 45s

2. 健康检查视图改造

文件路径：apps/audit_logs/beacon/views.py

核心变更：将get_system_info方法改造为从文件读取信息，移除实时采集逻辑。

关键实现：

• 文件读取机制：

SYSTEM_INFO_FILE = os.path.join(settings.BASE_DIR, 'system.ini')

def get_system_info(self):

if not os.path.exists(self.SYSTEM_INFO_FILE):

return self.default_system_info()

config = configparser.ConfigParser()

config.read(self.SYSTEM_INFO_FILE)

return dict(config['System']) if config.has_section('System') else self.default_system_info()

• 降级策略：

o 文件不存在或格式错误时返回默认信息（含错误标记）

o 错误日志记录与监控告警集成

3. 自动运行配置

文件路径：apps/audit_logs/apps.py

功能：实现应用启动时自动生成配置文件及定时更新机制。

关键实现：

• 启动时初始化：

def ready(self):

if os.environ.get('RUN_MAIN') == 'true': # 避免开发服务器重复执行

system_info_file = os.path.join(settings.BASE_DIR, 'system.ini')

if not os.path.exists(system_info_file):

call_command('write_system_info')

• 定时更新：

o 使用django-apscheduler实现每日凌晨3点自动更新

o 支持任务调度持久化与失败重试

三、使用与部署说明

1. 手动操作

• 生成系统信息文件：

python manage.py write_system_info

• 文件位置：项目根目录system.ini，支持直接编辑（用于临时调试）
• 安装定时任务组件：

2. 自动运行依赖

pip install django-apscheduler

• 配置应用：

# settings.py

INSTALLED_APPS = [

# ...

'django_apscheduler',

]

四、方案优势分析

1. 性能优化

• 降低接口响应时间：健康检查接口从文件读取信息（O(1)操作），替代原实时采集（O(n)系统调用）
• 减少资源消耗：系统信息采集从"每次请求触发"改为"定时批量执行"，降低CPU/内存占用
• 故障隔离：系统信息采集失败不影响健康检查主流程（返回默认值）
• 数据缓存：INI文件作为中间缓存层，避免依赖外部库（如psutil）可用性
• 逻辑解耦：系统信息采集与健康检查功能分离，便于独立迭代
• 配置化管理：更新策略（频率/触发条件）可通过配置调整，无需修改核心代码
• 支持离线分析：系统信息文件可直接用于问题诊断，无需实时访问服务器
• 多环境适配：通过INI文件格式兼容不同部署环境（开发/测试/生产）配置差异

2. 可靠性增强

3. 可维护性提升

4. 扩展能力

该方案通过命令式采集、文件缓存与定时更新的组合策略，在保持系统监控完整性的同时，显著提升了健康检查接口的性能与稳定性，特别适合高并发企业级应用场景。