task-executer/LOGGING_README.md

日志系统说明

日志配置

项目已配置统一的文件日志系统，所有日志文件存储在 logs/ 目录下。

日志文件

1. 主要日志文件

• logs/call_api_task.log - 呼叫任务API执行日志
• logs/celery_app.log - Celery应用日志
• logs/app.log - 应用主日志

2. 日志格式

2025-12-09 17:34:49 - call_api_task - INFO - 开始遍历API配置文件执行调用任务 - 当前时间: 2025-12-09 17:34:49

格式说明：

• 时间戳
• 模块名
• 日志级别 (INFO/WARNING/ERROR)
• 日志消息

使用方法

1. 在代码中使用日志

from logging_config import get_logger

# 获取logger
logger = get_logger('your_module_name')

# 记录日志
logger.info("信息日志")
logger.warning("警告日志") 
logger.error("错误日志")

2. 查看日志

# 查看最新日志
tail -f logs/call_api_task.log

# 查看日志文件
ls -la logs/

日志级别

• INFO: 正常执行信息
• WARNING: 警告信息，但不影响执行
• ERROR: 错误信息，可能导致任务失败

日志管理

自动创建

• 日志目录 logs/ 会自动创建
• 日志文件会自动创建和追加

日志轮转

• 目前使用简单的追加模式
• 建议定期清理旧的日志文件

示例

任务执行日志示例

2025-12-09 17:34:49 - call_api_task - INFO - 开始遍历API配置文件执行调用任务
2025-12-09 17:34:49 - call_api_task - INFO - 开始处理API配置: main_api
2025-12-09 17:34:49 - call_api_task - INFO - 正在调用任务API: POST https://api.example.com
2025-12-09 17:34:52 - call_api_task - INFO - 任务API调用成功，响应数据: {...}
2025-12-09 17:34:52 - call_api_task - INFO - 遍历API配置文件完成 - 成功: 1/1

错误日志示例

2025-12-09 17:35:15 - call_api_task - WARNING - 任务API需要重试，当前重试次数: 1/3
2025-12-09 17:35:15 - call_api_task - ERROR - 任务API失败，状态码: 500

故障排查

1. 检查日志目录权限

   ls -la logs/
   

2. 查看最新错误

   grep "ERROR" logs/*.log
   

3. 实时监控日志

   tail -f logs/call_api_task.log
   

注意事项

• 日志文件会持续增长，建议定期备份和清理
• 敏感信息不应写入日志文件
• 日志文件使用UTF-8编码