105 lines
2.3 KiB
Markdown
105 lines
2.3 KiB
Markdown
# 日志系统说明
|
||
|
||
## 日志配置
|
||
|
||
项目已配置统一的文件日志系统，所有日志文件存储在 `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编码 |