Files

T

Your Name c9a99f4fb3 fix: 全项目文档对齐 + 代码清理

代码修复:
- web/agent/agent.py: datetime.utcnow() → datetime.now(timezone.utc)
- requirements.txt: 移除 paramiko==3.5.0 (已无活跃引用)
- 删除 server/infrastructure/ssh/pool.py (DEPRECATED, 无引用)

连接池三层对齐 (config.py/.env.example/session.py):
- DB_POOL_SIZE 100→160, DB_MAX_OVERFLOW 100→120
- 基于 MySQL max_connections=400, install.php 公式

文档修复 (21项):
- P0: 硬编码域名/IP替换为配置变量占位符
- P1: 10个过时设计文档加归档标注 (引用旧文件结构)
- P2: step-3-webssh报告 paramiko引用修正
- 6份审查报告连接池参数勘误 100/100→160/120
- ECC安全报告 EC5 datetime.utcnow 标记已修复
- docs/README.md 文档索引重写
- docs/memory/mem_nexus_overview.md 移除硬编码凭证
- docs/project/tech-stack-inventory.md paramiko标记已移除

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-22 08:19:56 +08:00

2.3 KiB

Raw Blame History

Redis + 实时数据架构

更新: 2026-05-22 — 修正 Redis key 命名和刷新间隔

架构

Agent(60s心跳) → Redis heartbeat:{id} (HSET, TTL=600s) → API 即时返回
                        ↑
            heartbeat_flush(10min) → MySQL (历史快照)

数据分布

数据	Redis Key	类型	TTL	用途
心跳数据	`heartbeat:{server_id}`	HSET	600s	is_online, system_info, agent_version, last_heartbeat
告警标记	`alerts:{server_id}`	SET	3600s	服务器处于告警状态
告警广播	`nexus:alerts`	Pub/Sub	—	WebSocket 跨 worker 告警推送
推送进度	`sync:progress:{op}:{ts}`	STRING	—	批量推送进度
名称/IP/密码/配置	— (MySQL)	—	永久	写少读多，不需要缓存

实现点

连接池: redis.asyncio.BlockingConnectionPool (ADR-008)，启动强校验 (ADR-009)
心跳写入: Agent POST /api/agent/heartbeat → HSET heartbeat:{id} + TTL 续期
批量刷新: heartbeat_flush 每 10min → SCAN heartbeat:* → MySQL UPDATE servers
API /servers: MySQL 查基础信息 + Redis HGETALL heartbeat:{id} 合并实时状态
API /stats: MySQL COUNT + Redis EXISTS alerts:{id} 统计告警数
健康检测: Redis HGETALL heartbeat:{id} 不存在或 is_online=False → 离线
告警推送: WebSocket broadcast (内存 + Redis Pub/Sub 两层, ADR-010) + Telegram
告警冷却: Redis SETNX alerts:{id} TTL=3600s 防重复告警
Dashboard: WebSocket 实时更新，收到 alert/recovery/system 事件时刷新统计

Redis Key 完整规范

Key 模式	类型	TTL	写入者	读取者
`heartbeat:{server_id}`	HSET	600s	agent.py	servers.py, heartbeat_flush.py
`alerts:{server_id}`	SET	3600s	agent.py	servers.py (stats)
`nexus:alerts`	Pub/Sub	—	websocket.py	websocket.py (跨 worker)

heartbeat:{server_id} HSET 字段

字段	类型	说明
is_online	string ("True"/"False")	在线状态
system_info	string (JSON)	系统信息 (CPU/内存/磁盘/OS)
agent_version	string	Agent 版本号
last_heartbeat	string (ISO8601)	最后心跳时间

2.3 KiB Raw Blame History

Redis + 实时数据架构

架构

数据分布

实现点

Redis Key 完整规范

heartbeat:{server_id} HSET 字段

2.3 KiB

Raw Blame History