# 日志系统说明

## 日志配置

项目已配置统一的文件日志系统，所有日志文件存储在 `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. 在代码中使用日志

```python
from logging_config import get_logger

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

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

### 2. 查看日志

```bash
# 查看最新日志
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. **检查日志目录权限**
   ```bash
   ls -la logs/
   ```

2. **查看最新错误**
   ```bash
   grep "ERROR" logs/*.log
   ```

3. **实时监控日志**
   ```bash
   tail -f logs/call_api_task.log
   ```

## 注意事项

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