AI智能体在长时间运行后，日志文件疯狂增长是一个高频问题。不少团队遇到过这种情况：Agent跑了一两周，服务器C盘突然告警，排查后发现日志目录膨胀到了几十GB，严重时甚至拖垮整个系统的写入性能。日志本身是排查问题的重要依据，完全关掉不现实，但放任不管又会占满磁盘。这篇文章就来系统地讲讲如何定位、清理和预防Agent日志文件过大的问题。
一、快速定位占用磁盘的大日志文件
处理磁盘空间不足，第一步永远是找到“元凶”。在Windows系统上，推荐用PowerShell来排查，比图形界面一个个翻文件夹效率高得多。假设Agent的日志默认输出在C:\Logs目录下，可以执行下面的命令列出该目录下所有超过100MB的文件，并按大小降序排列：
Get-ChildItem -Path "C:\Logs" -Recurse -File |
Where-Object { $_.Length -gt 100MB } |
Sort-Object Length -Descending |
Select-Object FullName, @{Name="SizeGB";Expression={[math]::Round($_.Length/1GB,2)}} |
Format-Table -AutoSize执行后会得到一份清晰的清单，通常能直接看到某个类似agent-runtime.log的文件占了大头。除了日志本身，还要注意一些容易被忽略的地方：比如Agent框架产生的滚动备份（agent.log.1、agent.log.2这类文件）、崩溃时生成的dump文件（C:\Logs\dumps目录下），以及Windows事件日志。这些文件加起来往往比主日志还要大。
如果不确定日志写到了哪里，可以打开资源监视器（resmon），切换到“磁盘”选项卡，按写入字节数排序进程，正在疯狂写日志的Agent进程会立刻现形，再顺着它打开的文件句柄就能找到具体路径。另外也可以检查Agent的配置文件，常见位置如C:\ProgramData\MyAgent\config.yaml，里面一般会明确指定日志输出目录和级别。
二、立即释放磁盘空间的三种手段
找到大文件之后，接下来就是清理。这里要分三种情况处理，不能一股脑全删。
第一种是纯临时日志，确认近期没有排查中的问题后可以直接删除或清空。注意如果Agent进程正在运行，直接删除文件可能失败（文件被占用），此时可以用清空代替删除：
# 清空而不是删除，避免文件句柄被占用导致报错
Clear-Content -Path "C:\Logs\agent-runtime.log" -Force
# 删除7天以前的滚动备份日志
Get-ChildItem -Path "C:\Logs" -Filter "*.log.*" |
Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-7) } |
Remove-Item -Force第二种是仍有价值的日志，比如近期出过故障需要留证据。建议先压缩归档再删除原文件，文本型日志的压缩率非常高，几十GB的日志压缩后往往只剩几GB。可以手动压缩，也可以写个定时任务自动处理：
$logDir = "C:\Logs"
$cutoff = (Get-Date).AddDays(-3)
Get-ChildItem -Path $logDir -Filter "*.log" |
Where-Object { $_.LastWriteTime -lt $cutoff } |
ForEach-Object {
Compress-Archive -Path $_.FullName -DestinationPath ($_.FullName + ".zip") -CompressionLevel Optimal
if (Test-Path ($_.FullName + ".zip")) {
Remove-Item $_.FullName -Force
}
}第三种是紧急止血：磁盘已经满到Agent无法写日志、甚至系统开始异常的程度。这时优先删除dump文件和旧的归档包，必要时可以先停掉Agent服务，清空主日志后立即重启。同时检查回收站是否堆积了大量被“删除”但没真正释放空间的文件，清空回收站往往能立刻找回几个GB。
三、从根源上配置日志滚动，防止再次爆盘
临时清理只是治标，真正解决问题要靠合理的日志配置。核心思路是给日志设置“滚动策略”，让单个文件到达一定大小或时间后自动切割，并限制保留的文件数量和总大小。
以Python技术栈的Agent为例，标准库logging提供了RotatingFileHandler和TimedRotatingFileHandler两个现成的处理器，配置非常简单：
import logging
from logging.handlers import RotatingFileHandler
logger = logging.getLogger("agent")
logger.setLevel(logging.INFO)
# 单个文件最大100MB，最多保留5个备份，总计不超过600MB
handler = RotatingFileHandler(
"C:\\Logs\\agent.log",
maxBytes=100 * 1024 * 1024,
backupCount=5,
encoding="utf-8"
)
handler.setFormatter(logging.Formatter(
"%(asctime)s [%(levelname)s] %(name)s: %(message)s"
))
logger.addHandler(handler)如果希望按天切割日志，方便按日期排查问题，可以换成TimedRotatingFileHandler，设置when="midnight"表示每天零点滚动，backupCount=14表示保留两周。
除了滚动策略，还有两个有效的控制手段。一是降低日志级别：调试结束后把DEBUG级别改回INFO或WARNING，DEBUG级别的日志量可能是INFO的十倍以上，很多爆盘事故就是因为上线时忘了改回来。二是控制日志内容本身：Agent的对话上下文、完整的工具调用参数这类大块数据，默认不要全量打印，可以只记录摘要或截断到固定长度，需要时再通过请求ID回溯。
最后建议把日志目录规划到数据盘而不是系统盘，例如D:\AgentLogs，避免C盘被日志挤爆影响操作系统。再配合Windows任务计划程序，每天凌晨自动执行一次压缩清理脚本，形成“滚动切割 + 定期归档 + 自动清理”的三层防线，基本可以保证日志永远不会再次占满磁盘。
四、日常监控与告警建议
解决问题之后，还应该加上监控，避免下次爆盘了才发现。最简单的做法是用任务计划程序定时执行一个检查脚本，当磁盘剩余空间低于阈值或日志目录超过设定大小时，自动清理旧归档并发送告警：
$drive = Get-PSDrive -Name C
$freeGB = [math]::Round($drive.Free / 1GB, 2)
if ($freeGB -lt 10) {
# 删除30天以前的日志归档包
Get-ChildItem -Path "C:\Logs" -Filter "*.zip" |
Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-30) } |
Remove-Item -Force
# 这里可以接入邮件或钉钉、企业微信机器人通知
}
# 记录日志目录当前总大小，便于观察增长趋势
$sizeGB = [math]::Round((Get-ChildItem "C:\Logs" -Recurse -File |
Measure-Object Length -Sum).Sum / 1GB, 2)
Add-Content -Path "C:\Logs\size_history.txt" -Value "$(Get-Date) : $sizeGB GB"把脚本注册到任务计划程序，每天执行一次，就能持续掌握日志的增长速度。如果发现日志量异常增长，往往意味着Agent行为异常（比如陷入重试循环），这时候问题就不只是磁盘了，值得深入排查一下Agent本身的运行逻辑。磁盘空间管理看起来是小事，但稳定的日志体系是AI智能体可运维的基础，值得一开始就配置好。