All Products
Search
Document Center

Microservices Engine:Application management

Last Updated:Sep 23, 2025

This topic describes how to create and manage applications for XXL-JOB task scheduling. It covers basic configuration, advanced settings, and connection methods.

Create an application

Before using XXL-JOB scheduled tasks, you must create an application.

Step 1: Basic task configuration

  1. Log on to the MSE XXL-JOB console, and select a region in the top navigation bar.

  2. In the left navigation bar, select Task Scheduling > XXL-JOB Edition.

  3. Click the target instance. In the navigation pane on the left, go to Application Management and click Create Application.

  4. In the Create Application pane, enter an AppName and a Name. Configure advanced settings as needed, and then click OK.

    Category

    Item

    Description

    Default Value

    Basic Application Information

    AppName

    The unique identifier that associates an executor with an application during registration. This identifier must be globally unique.

    None

    Name

    The name of the application. The name can be in Chinese or English.

    None

    AccessToken

    The authentication token for executor registration. You can specify a custom token or let the system generate one. For security, use a unique token for each application.

    None

    Application Type

    • Normal Application: Requires an executor connected using the XXL-JOB SDK for Java, Go, or Python.

    • HTTP Application: Does not require an SDK. Backend nodes are automatically discovered by configuring a domain name or a Kubernetes service. Scheduling is performed over the HTTP protocol. Requires engine version 2.3.0 or later.

    Normal Application

    Advanced Application Configuration

    Traffic Shaping

    Application-level traffic shaping. If you enable this feature, you can set the task concurrency to prevent the application from being overwhelmed. High-priority tasks are executed first.

    Off

    Task Execution Queue Size

    The maximum number of task instances that can run concurrently for an application. Task instances that exceed this limit are not discarded. They are placed in a queue to wait for execution.

    100

    Log Collection

    If you enable log collection, logs are pulled from the executor and saved in the cloud after each task execution. This helps with future troubleshooting. If tasks are scheduled frequently, do not enable this feature, because it may overload the executor.

    Off

    Tag-based Routing Policy

    • If a task has no tags, schedule all machines.

    • If a task has no tags, schedule only untagged machines.

    For more information about how to add tags to an executor, see How to perform a grayscale release for tasks using tag-based routing.

    If a task has no tags, schedule all machines

Step 2: Connection configuration

After creating the application, click Connection Configuration in the Actions column of the application to obtain the connection configuration for the executor.

  • Connection Method 1: Modify the Spring Boot configuration file.

    xxl.job.admin.addresses=http://xxljob-xxxx.schedulerx.mse.aliyuncs.com
    xxl.job.accessToken=xxxxxxx
    xxl.job.executor.appname=xxxxxxx
  • Connection Method 2: Restart the application with -D parameters (no changes to code or configuration files required). Rebuilding the image is not required.

    java -Dxxl.job.admin.addresses=http://xxljob-xxxx.schedulerx.mse.aliyuncs.com
    -Dxxl.job.accessToken=xxxxxxx
    -Dxxl.job.executor.appname=xxxxxxx
    app.jar

Edit an application

  1. Log on to the MSE XXL-JOB console, and select a region in the top navigation bar.

  2. In the left navigation bar, select Task Scheduling > XXL-JOB Edition.

  3. Click the target instance. In the navigation pane on the left, go to Application Management. In the Actions column of the target application, click Edit.

  4. In the Edit Application pane, modify the Name, AccessToken, Application Type, Traffic Shaping, and Log Collection settings. Then, click OK.

Delete an application

You can delete an application if you no longer use XXL-JOB scheduled tasks.

  1. Log on to the MSE XXL-JOB console, and select a region in the top navigation bar.

  2. In the left navigation bar, select Task Scheduling > XXL-JOB Edition.

  3. Click the target instance. In the navigation pane on the left, go to Application Management. In the Actions column of the target application, click Delete.

  4. In the Delete Application dialog box, enter the application name and then click OK.