Django Q Documentation Release 1.3.6

语言	格式	评分
英语	.pdf	3
摘要
文档详细介绍了Django Q的功能和配置方法，包括安装、配置、任务调度、错误处理、信号机制等。Django Q支持多种队列系统，如Redis、Disque、IronMQ、SQS、MongoDB和ORM。文档还提到了Django Q的架构、任务分组、链式任务、监控功能以及与Django admin的集成。配置选项包括任务限制、队列限制、守护进程周期、超时设置等。错误处理部分介绍了可插拔的错误报告系统，支持Rollbar和Sentry。信号机制允许在任务生命周期中触发自定义操作。
AI总结
### Django Q 1.3.6 文档总结 #### 1. 特性 - 异步任务：支持异步任务处理。 - 调度任务：支持定时、重复和计划任务。 - 任务分组与链：支持任务分组和链式任务。 - 结果存储：成功和失败结果可存储在数据库或缓存中。 - 监控与管理：提供Django admin界面和多集群监控。 - 兼容性：支持多种消息队列（Redis、Disque、IronMQ、SQS、MongoDB、ORM）及错误报告工具（Rollbar、Sentry）。 - 平台支持：兼容Python 3.7、3.8，Django 2.2.x、3.1.x。 --- #### 2. 安装 - 使用pip安装：`$ pip install Django-q` - 将`Django_q`添加到`INSTALLED_APPS`。 --- #### 3. 配置 - Q_CLUSTER：核心配置字典，包含以下选项： - `workers`：设置 worker 数量，默认为CPU核数。 - `daemonize`：设置worker为守护进程，默认为`True`。 - `recycle`：worker处理任务数达到阈值后重启，默认为500。 - `save_limit`：成功任务存储限制，默认为250。 - `timeout`：任务超时时间，默认为`None`。 - `redis`：Redis连接配置（默认连接本地Redis）。 - broker：支持多种消息队列，用于任务分发。 --- #### 4. 任务 - 异步任务：通过`async_task`或`AsyncTask`类异步执行函数。 - 任务结果：成功和失败结果可通过Django admin查看和管理。 - 任务选项：支持自定义任务参数（如`hook`、`group`、`timeout`）。 --- #### 5. 管理页面 - 成功任务：展示所有成功任务，支持按名称、函数名或组过滤。 - 失败任务：展示失败任务，支持重新提交失败任务。 - 排队任务：仅在使用Django ORM Broker时显示，展示当前排队中的任务。 --- #### 6. 错误处理 - 基于插件的错误报告系统，支持Rollbar和Sentry。 - 错误报告插件需实现`report`方法，并通过`Q_CLUSTER`配置。 --- #### 7. 信号 - 在任务生命周期中发送信号： - `pre_enqueue`：任务入队前触发。 --- #### 8. 调度 - 支持计划任务、重复任务和一次性任务。 - 可设置任务的开始时间、重复间隔和执行次数。 --- #### 9. 集群 - 支持多集群管理，每个集群可独立配置。 - 集群状态：通过`Stat`类获取集群状态信息。 --- #### 10. 监控 - 提供任务执行状态和集群性能监控。 - 支持查看任务队列、执行结果及资源使用情况。 --- #### 11. 示例与架构 - 示例展示了如何使用Django Q进行异步任务、链式任务和调度任务。 - 架构基于可插拔组件设计，支持多种消息队列和扩展插件。 --- #### 12. 兼容性与语言 - 当前支持英语、德语和法语。 --- 总结：Django Q 1.3.6 是一个功能强大的任务队列工具，支持异步任务、调度任务、多集群监控及多种消息队列和错误报告插件，适用于需要高效任务管理的Django项目。