java-template/docs/redis_cache_deployment_guide.md

Redis缓存告警系统部署指南

📋 部署概述

本指南用于部署基于Redis的告警规则缓存同步系统，实现ljwx-boot和ljwx-bigscreen之间的高效数据同步。

🏗️ 系统架构

ljwx-admin → ljwx-boot (Redis DB=1) → MySQL
                ↓ pub/sub
            Redis服务器
                ↓ 订阅监听
        ljwx-bigscreen (Redis DB=0) → generate_alerts

✅ 部署前检查

1. 系统要求

• Redis版本: 5.0+
• Python版本: 3.7+
• Java版本: JDK 8+
• 内存要求: 至少2GB可用内存

2. 现有组件确认

# 检查Redis服务状态
redis-cli ping

# 检查ljwx-boot Redis配置
grep -n "redis" ljwx-boot/ljwx-boot-admin/src/main/resources/application-local.yml

# 检查ljwx-bigscreen Redis配置
python3 ljwx-bigscreen/bigscreen/redis_config.py

3. 网络连通性测试

# 测试Redis连接
redis-cli -h 127.0.0.1 -p 6379 -a 123456 ping

# 测试跨DB通信
redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 0 ping
redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 1 ping

🚀 部署步骤

步骤1: 更新ljwx-boot缓存策略

1. 备份现有文件

cd ljwx-boot/ljwx-boot-modules/src/main/java/com/ljwx/modules/health/facade/impl/
cp TAlertRulesFacadeImpl.java TAlertRulesFacadeImpl.java.backup

2. 应用更新

• 文件已在实施过程中更新
• 新增版本控制和分布式锁机制
• TTL设置为24小时（86400秒）

3. 验证更新

# 重启ljwx-boot服务
cd ljwx-boot && ./run-local.sh restart

# 检查日志
tail -f ljwx-boot/logs/ljwx-boot-local.log | grep "告警规则缓存"

步骤2: 部署Python缓存管理器

1. 安装缓存管理器

# 文件已创建在以下位置
ls -la ljwx-bigscreen/bigscreen/alert_rules_cache_manager.py

2. 安装依赖

cd ljwx-bigscreen/bigscreen
pip3 install redis dataclasses typing

3. 权限设置

chmod +x alert_rules_cache_manager.py

步骤3: 部署优化版生成器

1. 安装生成器

# 文件已创建
ls -la utils/redis_cache_generate_alerts.py
chmod +x utils/redis_cache_generate_alerts.py

2. 测试基础功能

cd utils
python3 redis_cache_generate_alerts.py

步骤4: 部署监控和测试工具

1. 部署测试套件

ls -la utils/test_redis_cache_alerts.py
chmod +x utils/test_redis_cache_alerts.py

2. 部署监控工具

ls -la utils/monitor_alert_cache_performance.py
chmod +x utils/monitor_alert_cache_performance.py

🧪 部署验证

1. 运行完整测试

cd utils
python3 test_redis_cache_alerts.py

期望输出:

🧪 启动Redis缓存告警系统完整测试
✅ PASS - Redis连接测试
✅ PASS - 告警规则获取测试
✅ PASS - 告警生成测试
✅ PASS - 批量处理性能测试
✅ PASS - 缓存统计测试
✅ PASS - 边界情况测试

总计: 6 | 通过: 6 | 失败: 0 | 通过率: 100.0%
🎉 测试通过！Redis缓存告警系统运行正常

2. 性能基准测试

# 监控10分钟并生成报告
python3 monitor_alert_cache_performance.py -d 600 -r

🔧 配置优化

1. Redis配置优化

# 编辑Redis配置文件
sudo vim /etc/redis/redis.conf

# 关键配置项
maxmemory 2gb
maxmemory-policy allkeys-lru
notify-keyspace-events Ex
save 900 1
save 300 10
save 60 10000

2. ljwx-boot配置调优

# application-local.yml
spring:
  data:
    redis:
      url: redis://default:123456@localhost:6379/1
      connect-timeout: 10000ms
      timeout: 30000ms
      lettuce:
        pool:
          max-active: 20
          max-idle: 10
          min-idle: 5

3. ljwx-bigscreen配置调优

# redis_config.py
class RedisConfig:
    def __init__(self):
        self.host = '127.0.0.1'
        self.port = 6379
        self.db = 0
        self.password = '123456'
        self.socket_timeout = 30
        self.retry_on_timeout = True

📊 性能目标

目标指标

• 缓存命中率: >95%
• 告警规则TTL: 24小时
• 处理延迟: <5ms/record
• QPS: >1000 records/sec
• Redis连接稳定性: >99.9%

监控命令

# 实时性能监控
python3 monitor_alert_cache_performance.py -i 5

# 生成性能报告
python3 monitor_alert_cache_performance.py -d 3600 -r

🔒 安全配置

1. Redis安全

# 设置Redis密码
redis-cli CONFIG SET requirepass "your_secure_password"

# 禁用危险命令
redis-cli CONFIG SET rename-command FLUSHALL ""
redis-cli CONFIG SET rename-command EVAL ""

2. 网络安全

# 限制Redis访问IP
# 在redis.conf中配置
bind 127.0.0.1 192.168.1.0/24
protected-mode yes

🚨 故障排除

常见问题

1. Redis连接失败

# 检查Redis服务状态
systemctl status redis

# 检查端口占用
netstat -tulpn | grep 6379

# 查看Redis日志
tail -f /var/log/redis/redis-server.log

2. 缓存命中率低

# 检查缓存键
redis-cli -n 1 keys "alert_rules_*"

# 检查TTL
redis-cli -n 1 TTL "alert_rules_1"

# 检查订阅通道
redis-cli PUBSUB CHANNELS

3. 订阅者不工作

# 测试订阅者
python3 -c "
from ljwx_bigscreen.bigscreen.alert_rules_cache_manager import get_alert_rules_cache_manager
manager = get_alert_rules_cache_manager()
manager.start_subscriber()
import time; time.sleep(10)
print(manager.get_cache_stats())
"

诊断脚本

# 运行完整诊断
cat > diagnose_redis_cache.sh << 'EOF'
#!/bin/bash
echo "🔍 Redis缓存系统诊断"
echo "===================="

echo "1. Redis服务状态:"
systemctl status redis --no-pager

echo -e "\n2. Redis连接测试:"
redis-cli -h 127.0.0.1 -p 6379 -a 123456 ping

echo -e "\n3. DB分离测试:"
redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 0 ping
redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 1 ping

echo -e "\n4. 缓存键检查:"
redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 1 keys "alert_rules_*"

echo -e "\n5. 订阅通道检查:"
redis-cli -h 127.0.0.1 -p 6379 -a 123456 PUBSUB CHANNELS

echo -e "\n6. Python组件测试:"
python3 utils/test_redis_cache_alerts.py

echo "===================="
echo "✅ 诊断完成"
EOF

chmod +x diagnose_redis_cache.sh
./diagnose_redis_cache.sh

📈 监控和维护

日常监控

# 启动持续监控（后台运行）
nohup python3 monitor_alert_cache_performance.py -i 30 > monitor.log 2>&1 &

# 定期生成报告
crontab -e
# 添加以下行，每小时生成一次报告
0 * * * * cd /path/to/utils && python3 monitor_alert_cache_performance.py -d 3600 -r

维护任务

# 每日维护脚本
cat > daily_maintenance.sh << 'EOF'
#!/bin/bash
echo "📅 每日Redis缓存维护 - $(date)"

# 清理过期键
redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 0 --scan --pattern "*" | xargs -I {} redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 0 EXPIRE {} 86400

# 生成性能报告
cd /path/to/utils
python3 monitor_alert_cache_performance.py -d 600 -r

# 检查系统健康
python3 test_redis_cache_alerts.py > daily_test_$(date +%Y%m%d).log

echo "✅ 维护完成"
EOF

chmod +x daily_maintenance.sh

🔄 回滚方案

如果需要回滚到原始版本：

1. 恢复ljwx-boot

cd ljwx-boot/ljwx-boot-modules/src/main/java/com/ljwx/modules/health/facade/impl/
cp TAlertRulesFacadeImpl.java.backup TAlertRulesFacadeImpl.java
cd ljwx-boot && ./run-local.sh restart

2. 停用Python组件

# 停止监控
pkill -f monitor_alert_cache_performance.py

# 移除缓存管理器（可选）
mv ljwx-bigscreen/bigscreen/alert_rules_cache_manager.py ljwx-bigscreen/bigscreen/alert_rules_cache_manager.py.disabled

3. 清理Redis缓存

redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 1 keys "alert_rules_*" | xargs redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 1 DEL
redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 1 keys "alert_rules_version_*" | xargs redis-cli -h 127.0.0.1 -p 6379 -a 123456 -n 1 DEL

📚 相关文档

• 告警规则缓存同步方案
• generate_alerts性能分析
• Redis配置最佳实践

---

部署负责人: 系统架构团队
最后更新: 2025-09-09
版本: v1.0