Create an Ultra Task
-
A Snaplex with one or more FeedMaster nodes.
-
Write permissions for the Project Space.
-
A valid pipeline.
-
From Designer or Manager, open the Create Task dialog:
-
In Designer, with the pipeline open, in the toolbar, click More Tools.
Click Create Task and select Ultra Task
-
In Manager, from the left navigation, select the Project containing the pipeline.
In the toolbar, click Create Task > Ultra Task
-
In Designer, with the pipeline open, in the toolbar, click More Tools.
-
Edit the required fields:
-
Enter a name. This name is used in the URL when the pipeline has
unconnected inputs/outputs. The names of assets, projects, or project
spaces are limited to UTF-8 alphanumeric characters and these special
characters:
!" $% &'()*+-.:;<=>@[]^_`{|}~
-
If not already selected, click the drop-down menu and select the pipeline to be triggered by the Ultra Task.
If you choose a pipeline that contains parameters, the parameters display in the Create Task dialog, where you can modify them. In the following example, the parameter keys path, full, and table name are displayed, with their entries as the corresponding values. In the full field, the values contain nested JSON.
- From the dropdown menu, select a Snaplex that has a FeedMaster.
-
Modify the applicable optional fields as described in the table
below.
Field Description Notifications Enables email notifications based on the status of the Scheduled Task. If your Org supports Slack notifications, you can add Slack channels or recipients. To use notifications: - In Notifications, enter each recipient's email address, separated by commas.
- If Slack notifications are configured for your
Org, the following fields display. You can select
from the dropdown list or start typing a name to
find it in the list:
- Direct Message(s): Select individuals to receive notifications.
- Channels: Select channels to receive notifications.
- Select the status that triggers notifications
from the When Task has selector:
- Started: The Task is activated.
- Completed: The Task is completed.
- Failed: The associated pipeline didn't execute.
- Stopped: The associated pipeline has stopped abruptly and the Task is no longer running.
Number of Instances Select from the dropdown to scale the running instances for the Ultra Tasks. Remember: Review the information in Ultra Tasks in Production before you use the following settings.- Manual
per Snaplex: Specifies the number of instances
per Snaplex equal to or greater than 1.
- Default: 1
- Minimum: 1
- Maximum: 1000
- Manual per
Node: Specifies the number of instances per
node, which must be in the range of 1-99
inclusively. The total number of instances is
based on available nodes. Note: The input value does not guarantee the number of instances, but rather the pipelines will eventually converge on the number of instances running, so it's possible for there to be periods of time when it goes over that number.
- Autoscale based on
Feedmaster queue: Specifies the minimum and
the maximum numbers of instances per Snaplex,
which must be in the range of 1-99 inclusively. By
default, the instance values are set to 1. You can
also view details of the Auto-scaling events in
the Activity log under the Snaplex tab with
information on the previous and current
configurations. Note: This option applies only to low latency Ultra Tasks because it requires a FeedMaster node.
Alias Use an alias to run an Ultra Task in multiple regions for high availability and disaster recovery. Use the same alias in multiple Ultra Tasks that run the same pipeline. When an Ultra Task in one region fails, a Snaplex in another region can run the pipeline by invoking the Ultra Task that shares the same alias. The Ultra Task that shares the alias must be in the same project folder as the primary Ultra Task, but be deployed to different Snaplex instances. Bearer Token An automatically generated token for the HTTP Authorization header. If you clear this field, authentication is not required. You can also set the value yourself Note: To authenticate the application successfully, ensure to remove the special characters from the token when adding or updating the values.Maximum Failures Specifies an optional threshold when the pipeline fails to start. If the number of failures reaches the threshold, the Snaplex disables the Ultra Task. The default value is 10. The maximum value is 1000.
Set the value to 0 to remove the limitation on pipeline failures.
During development, the pipeline can be in an invalid state and fail to start multiple times. Therefore, in this scenario, it is recommended that you set the value to 0 until the pipeline is ready for production.
Max In-Flight Specifies a threshold for documents to be processed on a single pipeline instance. Once the execution reaches the threshold, the Snaplex distributes to other instances of the Ultra Pipeline. This enables you to prevent an excessive number of documents from being queued on a single, slow execution.
Set the Max In-Flight value to the maximum number of documents that can be processed by one instance at a time.
- Default: 200
- Minimum: 1
- Maximum: 1000
-
Click Save. (Optional) To create an API in API Manager, click Save and create API .
Attention: If you change an Ultra Task URL into a Triggered Task URL and invoke it, the pipeline is executed as an Ultra Task and completed successfully instead of returning an error or failing.
-
Enter a name. This name is used in the URL when the pipeline has
unconnected inputs/outputs. The names of assets, projects, or project
spaces are limited to UTF-8 alphanumeric characters and these special
characters: