骡子快跑提供四种日志轮转方案：一、启用内置云端自动轮转，支持按天或10MB轮转，保留7/30/90天；二、Agent中用RotatingFileHandler本地控制，5MB单文件、保留10份；三、快捷重启Bot触发日志截断与归档；四、配置HTTP转发至Loki/ELK集群，支持认证与分级推送。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您使用骡子快跑处理高频任务，日志文件可能持续增长导致存储压力增大，则需启用稳定可靠的日志轮转机制。以下是针对骡子快跑大容量日志处理的多种可行方法：
一、启用内置云端日志自动轮转
骡子快跑为每位用户分配独立的7×24小时云端虚拟机，其日志系统已预置基于时间与大小双重策略的自动轮转能力，无需额外部署或修改代码。该机制在后台持续运行，确保日志不堆积、不丢失、不阻塞主流程。
1、登录骡子快跑控制台，进入「设置」→「日志管理」页面。
2、开启「自动轮转」开关，并选择轮转模式：可选「按天轮转」或「按10MB大小轮转」。
3、设定保留周期，支持配置保留最近7天、30天或90天的历史日志压缩包。
4、点击「保存并重启日志服务」，系统将在30秒内完成生效，旧日志自动归档至/private/logs/rotated/目录下。
二、通过Agent工具调用自定义RotatingFileHandler
对于需要精细控制日志行为的高级用户，骡子快跑支持在Python Agent脚本中直接集成logging.handlers.RotatingFileHandler模块，实现本地化、可编程的日志切分逻辑。该方式适用于需对接企业内部日志分析平台的场景。
1、在Agent编辑器中新建Python任务，导入标准日志模块：from logging.handlers import RotatingFileHandler。
2、初始化处理器，设置单文件上限为5MB，最多保留10个历史备份：handler = RotatingFileHandler('task.log', maxBytes=5242880, backupCount=10)。
3、将handler绑定至logger实例，并设置日志级别为INFO及以上。
4、运行任务后，日志将自动触发轮转，所有操作均在用户专属虚拟机隔离环境中执行，不涉及主机文件系统权限问题。
三、使用快捷重启Bot按钮配合日志清理策略
当突发性高负载导致日志瞬时膨胀时，可通过控制台提供的「快捷重启Bot」功能强制刷新运行上下文，同步触发内置的日志截断与归档流程。该操作不会中断长期运行的Agent服务，仅重置当前会话级日志缓冲区。
1、在控制台首页找到目标Bot卡片，点击右上角三个点图标展开操作菜单。
2、选择「快捷重启Bot」，系统弹出确认框提示：“本次操作将清空当前会话日志缓存，并归档已有日志至冷存储”。
3、确认后，界面显示倒计时15秒，期间所有新日志暂存于内存缓冲区。
4、重启完成后，原日志文件被自动重命名为app_20260317_232100.log.gz格式并迁移至归档路径，主日志文件恢复为空白状态。
四、配置外部日志转发至Loki或ELK集群
骡子快跑支持通过HTTP POST方式将结构化日志实时推送至外部可观测性平台，从而卸载本地存储压力并实现集中式检索分析。此方案适用于已部署Loki、ELK或类似日志基础设施的企业用户。
1、进入「设置」→「日志转发」，填写目标接收端地址，例如：https://loki.example.com/loki/api/v1/push。
2、配置认证Token，支持Bearer Token或Basic Auth两种方式，系统会对Token字段进行前端掩码+传输加密处理。
3、选择转发级别，可限定仅推送ERROR及以上级别日志，或全量转发。
4、启用后，每条日志将以Logfmt格式封装，并携带bot_id、task_id、timestamp、log_level等元数据字段。
