Telegram机器人日志轮转配置与监控报警：从入门到实践

一、为什么你的Telegram机器人需要日志轮转和监控报警？

当Telegram机器人长期运行后，日志文件会持续增长，占用磁盘空间甚至导致系统崩溃。另一方面，如果机器人出现API调用失败、用户反馈异常，没有日志监控很难快速定位问题。日志轮转和监控报警是生产环境机器人的必备配置，能有效降低运维成本，提升服务可用性。

二、日志轮转的基本概念

日志轮转（Log Rotation）指定期将当前日志文件重命名并生成新文件，旧文件可以压缩或删除，从而控制日志总量。主流方案有两种：

应用内轮转：在代码中使用Python的logging.handlers.RotatingFileHandler或TimedRotatingFileHandler。
系统级轮转：使用Linux自带的logrotate工具，定期处理指定日志文件。

三、使用Python内置Handler实现日志轮转

如果你的机器人基于Python开发，最简单的方式就是修改日志配置。下面是一个完整的代码示例：

import logging
from logging.handlers import RotatingFileHandler

# 按文件大小轮转：单个文件最大5MB，保留3个备份
handler = RotatingFileHandler(
    'bot.log',
    maxBytes=5 * 1024 * 1024,
    backupCount=3,
    encoding='utf-8'
)

# 也可以按时间轮转：每天轮转，保留7天
# from logging.handlers import TimedRotatingFileHandler
# handler = TimedRotatingFileHandler('bot.log', when='midnight', backupCount=7)

logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s - %(message)s',
    handlers=[handler]
)

logger = logging.getLogger(__name__)

这个配置会在日志达到5MB时自动重命名，并保留最近3个历史文件。适合单机部署的机器人。

四、使用系统logrotate统一管理日志

如果机器人由systemd、Docker或Nginx等工具共同部署，建议使用系统logrotate集中管理。例如在/etc/logrotate.d/telegram-bot中创建配置：

/var/log/telegram-bot/bot.log {
    daily
    rotate 7
    compress
    delaycompress
    missingok
    notifempty
    copytruncate
    create 644 telegram telegram
}

daily：每天轮转一次
rotate 7：保留7份历史日志
compress：压缩旧日志为.gz
copytruncate：先复制再清空，适合一直持有文件句柄的应用

配置完成后，可以通过logrotate -d /etc/logrotate.d/telegram-bot预览执行过程。

五、日志级别与结构化建议

监控报警依赖精准的日志信息。建议在开发时采用以下规范：

使用DEBUG记录详细调用参数，INFO记录关键事件，WARNING和ERROR记录异常。
输出结构化日志（如JSON格式），方便后续对接日志分析系统。
避免记录敏感信息（如用户密码、token），防止信息泄露。

示例：将日志格式改为JSON：

import json
import logging

class JsonFormatter(logging.Formatter):
    def format(self, record):
        log_data = {
            'time': self.formatTime(record),
            'level': record.levelname,
            'message': record.getMessage(),
            'module': record.module
        }
        return json.dumps(log_data, ensure_ascii=False)

六、监控报警方案全解析

日志轮转解决了空间问题，但机器人出现API错误、进程崩溃时仍需实时感知。以下是几种实用的监控报警方式：

1. 核心功能健康检查

定期向机器人发送一个测试命令，如果无响应则触发报警。可以使用定时任务：

*/5 * * * * curl -s -m 10 https://api.telegram.org/bot<TOKEN>/getMe > /dev/null || echo "Telegram API不可达"

但这种方法只能验证API连通性。更可靠的是让机器人主动上报心跳，例如每小时用另一个Bot发送一条心跳消息到指定频道。

2. 日志异常检测

对日志文件中的ERROR级别进行实时扫描，使用`tail -F`配合`grep`实现简单报警：

tail -F bot.log | grep --line-buffered 'ERROR' | while read line; do
    curl -s -X POST "https://api.telegram.org/bot/sendMessage" \
        -d chat_id= \
        -d text="机器人异常：$line"
done

这是最轻量的方案，但不够健壮。生产环境建议使用ELK、Loki等日志收集平台，并配置告警规则。

3. 接入专业监控服务

使用Sentry或Prometheus可以自动捕获异常、统计性能指标。以Sentry为例，只需在代码中集成SDK：

import sentry_sdk
sentry_sdk.init("https://your-dsn@sentry.io/project")

# 在except位置使用：sentry_sdk.capture_exception()

当机器人抛出异常时，Sentry会通过邮件或Webhook通知你。对接Telegram可以使用“Telegram Alert”Webhook插件。

七、实践：基于Docker部署时的日志策略

在Docker环境中，建议将应用日志输出到stdout/stderr，然后用Docker的json-file日志驱动配合logrotate插件。也可以在容器内同时配置应用内轮转，但要注意持久化挂载健康。

docker run -v /var/log/telegram-bot:/var/log telegram-bot:latest

然后在宿主机上设置logrotate处理`/var/lib/docker/containers/*/*.log`，但推荐使用`docker run --log-opt max-size=10m --log-opt max-file=3`实现容器日志限制。

八、常见问题与排查建议

轮转后文件权限不对：确保logrotate配置中的create权限正确，或应用启动用户可写。
日志轮转不生效：检查logrotate的cron任务是否执行，或使用`logrotate -f`强制运行。
监控报警漏报：确认告警脚本运行在独立进程，避免与被监控机器人共用同一环境。

九、总结

日志轮转和监控报警是Telegram机器人线上运维的坚实基础。通过应用内日志轮转或系统logrotate控制磁盘用量，再结合健康检查、日志异常检测或Sentry等工具，开发者能快速发现并处理异常。建议从小处做起，逐步完善你的运维体系，让机器人更加稳定可靠。