From 9d9f5dc9205a8e430529c5b981007ab0cb2bc691 Mon Sep 17 00:00:00 2001 From: xuxueli <931591021@qq.com> Date: Sun, 21 Jun 2026 16:32:42 +0800 Subject: [PATCH] update doc --- doc/XXL-JOB官方文档.md | 75 ++++++++++--------- .../openapi/impl/AdminJobBizImpl.java | 2 +- 2 files changed, 41 insertions(+), 36 deletions(-) diff --git a/doc/XXL-JOB官方文档.md b/doc/XXL-JOB官方文档.md index 01ad67f0..f61ad33d 100644 --- a/doc/XXL-JOB官方文档.md +++ b/doc/XXL-JOB官方文档.md @@ -3102,9 +3102,10 @@ alter table xxl_job_log （注意：任务管理OpenAPI及操作代码示例，详见官方文档） - 5、【重构】数据模型标准化，通用字段命名统一，建表SQL规范性完善； - 6、【重构】I18N资源精简，通过配置组合替换重复资源，避免资源配置无序增长； -- 7、【TODO】配置线上化：发送邮箱配置线上管理、线程池配置调整； -- 8、【TODO】任务告警：拆分“告警类型、告警配置”属性，支持Webhook、邮箱多种方式； -- 9、【TODO】任务说明：拆分“任务名称、任务备注”属性，前者用于任务检索，后者用于补充任务描述。 +- 7、【TODO】任务日志设置：支持任务级别设置日志保留时间；执行期支持设置执行日志类型，包括Rolling Log 和 普通日志，普通日志不存储本地文件； +- 8、【TODO】任务告警增强：拆分“告警类型、告警配置”属性，支持Webhook、邮箱多种方式； +- 9、【TODO】配置线上化：发送邮箱配置线上管理、线程池配置调整； + **备注：** 数据库升级脚本： @@ -3114,10 +3115,9 @@ ALTER TABLE `xxl_job_group` ADD COLUMN `access_token` varchar(255) DEFAULT NULL COMMENT '执行器AccessToken' AFTER `address_list`; -- 2. 创建 app_name 的唯一索引 -ALTER TABLE `xxl_job_group` -ADD UNIQUE KEY `i_app_name` (`app_name`) USING BTREE; +ALTER TABLE `xxl_job_group` ADD UNIQUE KEY `i_app_name` (`app_name`) USING BTREE; --- 3. 将指定 AppName 的 access_token 更新为目标值；默认值为 'default_token'，可自行修改; +-- 3. 将指定 AppName 的 access_token 更新为目标值；（ 默认值为 'default_token'，可自行修改） UPDATE `xxl_job_group` SET `access_token` = '<新Token值>' WHERE `app_name` = '<目标AppName>'; -- 4. 执行器与任务表 name 字段标准化调整； @@ -3127,45 +3127,50 @@ ALTER TABLE `xxl_job_info` CHANGE `job_desc` `name` VARCHAR(255) NOT NULL COMMEN ### TODO LIST -- 1、调度隔离：调度中心针对不同执行器，各自维护不同的调度和远程触发组件。 -- 2、任务优先级：调度与执行阶段按照优先级分配资源。 -- 3、多数据库支持，DAO层通过JPA实现，不限制数据库类型。 -- 4、OpenApi： - - 执行器Log文件清理：支持调度中心远程删除执行器中指定任务的Log文件； -- 5、性能优化：任务、执行器数据全量本地缓存；新增消息表广播通知； -- 6、DAG流程任务 +- 1、DAG流程任务 - 子任务：废弃 - DAG任务创建、管理，DAG任务日志查看、操作； - 支持参数传递，共享数据； - 分片任务：全部完成后才会出发后置节点； - 配置并列的"a-b、b-c"路径列表，构成串行、并行、dag任务流程，"dagre-d3"绘图；任务依赖，流程图，子任务+会签任务，各节点日志；支持根据成功、失败选择分支； -- 7、任务标签：方便搜索； -- 8、GLUE 模式 Web Ide 版本对比功能； -- 9、自定义失败重试时间间隔； -- 10、任务导入导出工具，灵活支持版本升级、迁移等场景。 -- 11、任务日志重构：一次调度只记录一条主任务，维护起止时间和状态。 +- 2、分片任务：全部完成后才会出发后置节点； +- 3、任务日志重构：一次调度只记录一条主任务，维护起止时间和状态。 - 普通任务：只记录一条主任务； - 广播任务：记录一条主任务，每个分片任务记录一条次任务，关联在主任务上； - 重试任务：失败时，新增主任务。所有调度记录，包括入口调度和重试调度，均挂载主任务上。 -- 12、分片任务：全部完成后才会出发后置节点； -- 13、日期过滤：支持多个时间段排除； -- 15、脚本任务，支持数据参数，新版本仅支持单参数不支持需要兼容； -- 17、批量调度：调度请求入queue，调度线程批量获取调度请求并发起远程调度；提高线程效率； -- 18、执行器端口复用，复用容器端口提供通讯服务； -- 19、安全功能增强，通讯加密参数改用加密数据避免AccessToken明文， 降低token泄漏风险； -- 20、告警增强： +- 4、多数据库支持：支持 PG、H2 等多数据支持； +- 5、任务属性重构：支持 日志设置 + 告警增强； + - 基础配置：归属执行器、任务名称、负责人、任务备注【】 + - 调度配置：调度类型、Cron + - 任务配置： + - 已有：任务模式、JobHandler、任务参数 + - 新增-日志配置：日志归档时间【】、执行日志类型（rolling、普通）【】 + - 高级配置：调整为3列； + - 已有：路由策略、子任务、调度过期策略、阻塞处理策略、超时时间、失败重试次数； + - 新增-告警配置：告警类型（webhook、邮件）【】、告警配置【】 +- 6、日志设置： + - 调度日志策略：默认 DB 存储； + - 执行日志策略：rolling、普通； + - 日志持久化时间：任务维度自定义，保留3天、7天、1个月、3个月、一年、永久； + - 日志清理：调度日志，定期清理DB；执行日志，通过OpenAPI触发执行期端日志清理。持久化时间复用。 +- 7、告警增强： - 邮件告警：支持自定义标题、模板格式； - webhook告警：支持自定义告警URL、请求体格式； -- 21、公共告警策略：执行器维度设置多告警策略，任务勾选启用；待评估任务或执行器维度； -- 20、日志策略： - - 调度日志：全局配置：废弃； 新增“调度日志策略”：任务维度自定义，保留3天、7天、1个月、3个月、一年、永久； - - 执行日志：新增“执行RollingLog开关”：任务维度自定义，支持：RollingLog、普通日志（slf4j输出）、关闭（不输出）； -- 23、调度中心启动参数线上配置：告警发送邮箱、Token，支持线上配置生效，修改不需重启机器； -- 24、执行器内嵌server切换tomcat，精简依赖； -- 25、日志策略新增： - - 调度日志策略：任务级设置，最少保留1天。 - - 执行日志策略：可选 RollingLog、slf4jLog； - - 清理逻辑，性能重构。 +- 8、执行器端口： + - 执行器端口复用，复用容器端口提供通讯服务； + - 内嵌server切换tomcat，精简依赖； +- 9、Token安全增强，改用加密数据避免AccessToken明文泄漏； +- 10、调度触发时间： + - 日期过滤：支持多个时间段排除； +- 11、调度逻辑： + - 调度隔离：调度中心针对不同执行器，各自维护不同的调度和远程触发组件。 + - 任务优先级：调度与执行阶段按照优先级分配资源。 +- 12、任务导入导出工具，灵活支持版本升级、迁移等场景。 +- 13、脚本任务，支持数据参数，新版本仅支持单参数不支持需要兼容； +- 14、任务标签：方便搜索； +- 15、GLUE 模式 Web Ide 版本对比功能； +- 16、自定义失败重试时间间隔； +- 17、调度中心启动参数线上配置：告警发送邮箱、Token，支持线上配置生效，修改不需重启机器； ## 八、其他 diff --git a/xxl-job-admin/src/main/java/com/xxl/job/admin/business/scheduler/openapi/impl/AdminJobBizImpl.java b/xxl-job-admin/src/main/java/com/xxl/job/admin/business/scheduler/openapi/impl/AdminJobBizImpl.java index 051d43bd..0a262dfd 100644 --- a/xxl-job-admin/src/main/java/com/xxl/job/admin/business/scheduler/openapi/impl/AdminJobBizImpl.java +++ b/xxl-job-admin/src/main/java/com/xxl/job/admin/business/scheduler/openapi/impl/AdminJobBizImpl.java @@ -43,7 +43,7 @@ public class AdminJobBizImpl implements AdminJobBiz { /** * token bucket, for rate limiting */ - private final TokenBucket tokenBucket = TokenBucket.create(3, Duration.ofSeconds(30)); + private final TokenBucket tokenBucket = TokenBucket.create(100, Duration.ofSeconds(30)); @Override public Response addJob(JobAddRequest request) {