91 lines
3.0 KiB
Markdown
91 lines
3.0 KiB
Markdown
# 队列管理配置说明
|
||
|
||
本文档说明了视频生成API服务中队列管理相关的配置参数。
|
||
|
||
## 配置参数
|
||
|
||
### 基础队列配置
|
||
|
||
| 参数名 | 环境变量 | 默认值 | 说明 |
|
||
|--------|----------|--------|------|
|
||
| 最大运行任务数 | `QUEUE_MAX_RUNNING_TASKS` | 5 | 同时运行的最大任务数量 |
|
||
| 状态更新间隔 | `QUEUE_UPDATE_INTERVAL` | 5 | 任务状态检查更新间隔（秒） |
|
||
| 持久化文件 | `QUEUE_PERSISTENCE_FILE` | task_queue_persistence.json | 队列数据持久化文件路径 |
|
||
|
||
### 缓存管理配置
|
||
|
||
| 参数名 | 环境变量 | 默认值 | 说明 |
|
||
|--------|----------|--------|------|
|
||
| 已完成任务缓存大小 | `QUEUE_MAX_COMPLETED_CACHE_SIZE` | 100 | 最多保留的已完成任务数量 |
|
||
| 缓存保留时间 | `QUEUE_COMPLETED_CACHE_TTL_HOURS` | 24 | 已完成任务在缓存中保留的小时数 |
|
||
|
||
## 环境配置建议
|
||
|
||
### 开发环境 (.env.dev)
|
||
```bash
|
||
# 队列管理配置
|
||
QUEUE_MAX_RUNNING_TASKS=5
|
||
QUEUE_UPDATE_INTERVAL=5
|
||
QUEUE_PERSISTENCE_FILE=task_queue_persistence.json
|
||
QUEUE_MAX_COMPLETED_CACHE_SIZE=100
|
||
QUEUE_COMPLETED_CACHE_TTL_HOURS=24
|
||
```
|
||
|
||
### 测试环境 (.env.dev-server)
|
||
```bash
|
||
# 队列管理配置
|
||
QUEUE_MAX_RUNNING_TASKS=8
|
||
QUEUE_UPDATE_INTERVAL=3
|
||
QUEUE_PERSISTENCE_FILE=task_queue_persistence.json
|
||
QUEUE_MAX_COMPLETED_CACHE_SIZE=200
|
||
QUEUE_COMPLETED_CACHE_TTL_HOURS=24
|
||
```
|
||
|
||
### 生产环境 (.env.pro)
|
||
```bash
|
||
# 队列管理配置
|
||
QUEUE_MAX_RUNNING_TASKS=10
|
||
QUEUE_UPDATE_INTERVAL=3
|
||
QUEUE_PERSISTENCE_FILE=task_queue_persistence.json
|
||
QUEUE_MAX_COMPLETED_CACHE_SIZE=500
|
||
QUEUE_COMPLETED_CACHE_TTL_HOURS=48
|
||
```
|
||
|
||
## 配置调优建议
|
||
|
||
### QUEUE_MAX_RUNNING_TASKS（最大运行任务数）
|
||
- **开发环境**: 5个任务，适合本地开发测试
|
||
- **测试环境**: 8个任务，模拟中等负载
|
||
- **生产环境**: 10个任务，根据服务器性能和API限制调整
|
||
|
||
### QUEUE_UPDATE_INTERVAL（状态更新间隔）
|
||
- **开发环境**: 5秒，便于调试观察
|
||
- **测试/生产环境**: 3秒，提高响应速度
|
||
- **注意**: 间隔太短会增加API调用频率，太长会影响用户体验
|
||
|
||
### QUEUE_MAX_COMPLETED_CACHE_SIZE（缓存大小）
|
||
- **开发环境**: 100个任务，满足基本需求
|
||
- **测试环境**: 200个任务，支持更多测试场景
|
||
- **生产环境**: 500个任务，支持高并发场景
|
||
|
||
### QUEUE_COMPLETED_CACHE_TTL_HOURS（缓存保留时间）
|
||
- **开发/测试环境**: 24小时，便于调试和测试
|
||
- **生产环境**: 48小时，给用户更长的查询窗口
|
||
|
||
## 性能影响
|
||
|
||
1. **QUEUE_MAX_RUNNING_TASKS**: 影响并发处理能力和资源消耗
|
||
2. **QUEUE_UPDATE_INTERVAL**: 影响状态更新及时性和API调用频率
|
||
3. **QUEUE_MAX_COMPLETED_CACHE_SIZE**: 影响内存使用和查询性能
|
||
4. **QUEUE_COMPLETED_CACHE_TTL_HOURS**: 影响存储空间和数据一致性
|
||
|
||
## 监控建议
|
||
|
||
建议监控以下指标：
|
||
- 运行中任务数量
|
||
- 等待队列长度
|
||
- 任务完成率
|
||
- 平均处理时间
|
||
- 缓存命中率
|
||
|
||
通过这些指标可以判断当前配置是否合适，并进行相应调整。 |