Fogsight当前版本不内置告警模块，需通过外部机制实现实时响应：一、监控服务健康状态触发系统级告警；二、捕获API调用失败日志触发告警；三、校验credentials.json文件完整性防范配置异常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用雾象Fogsight生成动画时需要对异常状态或系统事件进行实时响应，则需通过外部告警机制实现，因为Fogsight当前版本不内置告警模块，其核心功能聚焦于AI驱动的动画生成与LUI交互。以下是结合其运行架构实现告警能力的可行配置路径：
一、基于服务进程健康状态的系统级告警
该方法通过监控Fogsight后端服务（Python Flask/FastAPI）的存活与响应状态，触发操作系统或运维平台告警。适用于部署在Linux服务器或容器环境的场景。
1、确认Fogsight后端服务监听端口为8000，且无防火墙拦截。
2、使用systemd或supervisord部署服务时，在服务单元文件中添加ExecStartPost指令调用curl检测http://127.0.0.1:8000/health端点。
3、当curl返回非200状态码时，执行脚本向企业微信机器人或钉钉群发送告警消息，内容包含服务宕机时间、主机IP、进程PID。
4、将该脚本设为定时任务，每30秒执行一次检测。
二、基于API调用失败的日志触发告警
该方法利用Fogsight前端发起生成请求后，后端若因API密钥无效、模型超时或OpenRouter网关拒绝等导致HTTP 4xx/5xx响应，可在Nginx或反向代理层捕获错误日志并转发至告警系统。
1、在Nginx配置中启用error_log，并设置log_format包含$request、$status、$upstream_response_time字段。
2、使用rsyslog或filebeat采集包含“401”“429”“504”关键词的错误行。
3、配置logstash或自定义Python脚本过滤连续5分钟内出现超过10次504错误的记录。
4、匹配成功后，调用Webhook推送告警，其中关键字段为失败请求URL、错误码、最近三次失败时间戳。
三、基于credentials.json文件变更的配置异常告警
该方法防范因人为误操作导致API_KEY被清空、BASE_URL填写错误等引发的静默失败，通过文件完整性校验触发预警。
1、在Fogsight项目根目录下执行sha256sum credentials.json > cred.sha256，生成初始哈希快照。
2、编写shell脚本定期（如每5分钟）重新计算credentials.json哈希值并与cred.sha256比对。
3、若哈希不一致，检查credentials.json中"API_KEY"字段长度是否小于32字符或"BASE_URL"是否包含"http://"以外的非法协议头。
4、确认异常后，向管理员邮箱发送告警邮件，正文中高亮显示credentials.json最后修改时间、当前API_KEY前4位与后4位。
