文档

任务管理

更新时间:

本文介绍如何在任务管理页面创建并管理XXLJOB。

创建调度任务

  1. 登录微服务引擎MSE,选择任务调度 > XXL-JOB版,进入指定XXLJOB实例。

    image

  2. 在左侧菜单栏的任务管理,单击创建任务。在基本配置向导页,配置调度任务的相关信息,然后单击下一步

    image

    基本配置参数说明如下:

    配置项分类

    配置项

    描述

    默认值

    基本配置

    任务名称

    任务的名称,同一个应用下需保持唯一。

    任务描述

    任务的描述。

    关联应用

    该应用属于哪个应用。

    jobHandler

    对应执行器端被@Xxljob注解声明的jobHandler。

    路由策略

    轮询、随机、第一个、最后一个、最不经常使用、最近最久未使用、一致性哈希、分片广播。

    轮询

    优先级

    低、中、高、非常高。

    任务参数

    任务的参数,最大2000字节。

    高级配置

    任务失败重试次数

    任务失败自动重试的最大次数。

    0

    任务失败重试间隔

    任务每次失败重试的间隔。

    30秒

    任务并发数

    同一个任务同一时间允许运行的最大实例个数,1表示不允许重复执行。如果超过并发数,会跳过当前调度。

    1

  3. 定时配置向导页,设置定时参数和高级配置参数,然后单击下一步

    image

    定时参数说明如下:

    配置项

    描述

    默认值

    时间类型

    none、cron、api、fixed_rate、one_time。

    cron

    时间表达式

    不同的时间类型有不同的表达式

    • none:无表达式。

    • cronquartz cron表达式,可以精确到秒。

    • fixed_rate:固定执行频率,单位秒,即每隔N秒调度一次。

    • api:通过openapi调度。

    • one_time:一次性任务,跑完任务自动销毁,格式"yyyy-MM-dd HH:mm:ss",比如"2024-10-10 12:12:20"。

    时区

    可以按照固定时区调度,主要适用于cron表达式。

    当前地域时区

    日历

    可以导入自定义日历,按照日历调度,比如只想在工作日执行。

    每天调度

    生效时间

    指定任务开始生效时间。

    立即生效

  4. 通知配置配置向导页,设置报警参数及联系人,然后单击完成

    image

    配置项

    描述

    默认值

    超时报警开关

    任务执行超时是否发送告警。

    开启

    超时时间

    任务执行超时的时间,按照业务自行设定。

    7200秒

    超时终止开关

    任务执行超过指定时间是否自动停止,防止把下一次调度卡住。

    关闭

    成功通知开关

    任务执行成功是否通知给联系人,一般天级别比较重要的任务设置。

    关闭

    失败报警开关

    任务执行失败是否告警。

    开启

    连续失败次数

    任务连续失败指定次数才告警。

    1

    无可用机器报警开关

    任务调度的时候没有可用执行器是否告警。

    开启

    通知方式

    短信、webhook、邮件、电话。

    通知对象

    集成云监控联系人,需要去云监控配置联系人并激活联系方式。

    如果选用webhook告警(钉钉/企业微信/飞书),需要通过公网外发,所以需要您的VPC网络绑定公网NAT网关,如下图:

    image