Tasks
Tasks are a flexible job type that can be used to clean up old logs or run any REST call.
Task subtypes
The "task" job type has the following subtypes:
-
Log cleanup jobs are run against your system logs collection to delete log messages that were created prior to the number of days specified in the
Delete logs older than "n" days
field.
To create a log cleanup job, sign in to Fusion and click Collections > Jobs. Then click Add+ and in the Custom and Other Jobs section, select Log Cleanup. You can enter parameters to configure the job. If the field has a default value, it is populated when you click to add the job.
Parameters
-
ID. The unique ID for this job in the API. This is the
id
field in the configuration file. Required field. -
Logs Collection. The collection that contains the documents that are deleted when the job is run. The allowed value is system_logs. This is the
collection
field in the configuration file. Required field. -
Delete logs older than "n" days. The number of days to retain system log messages. When this job is run, it deletes all system log messages older than the number of days entered in this field. This is the
days
field in the configuration file. Optional field. -
Query to match docs to delete. The query syntax to identify the documents to be deleted. The default value of
-logger_class_s:"com.lucidworks.cloud.gateway.audit"
excludes audit log entries to preserve audit information such as login and logout events. This is thequery
field in the configuration file. Optional field. -
A versatile job type that runs an arbitrary REST/HTTP/Solr command.
REST jobs can call external systems using:
-
any HTTP or HTTPS request:
<http-protocol>://<path>
; requires JWT header. -
a Solr request:
solr://COLLECTION_NAME/…
; authentication is handled. -
a Fusion service request:
extservice://SERVICE_NAME/<path>
; authentication is handled.
To create a REST Call job, sign in to Fusion and click Collections > Jobs. Then click Add+ and in the Custom and Other Jobs section, select REST Call. You can enter parameters to configure the job. If the field has a default value, it is populated when you click to add the job.
The parameters for this job are:
-
ID. The user-defined name for this job. This is the
id
field in the configuration file. Required field. -
Endpoint URI. The name or location of the data this job searches. This is the
uri
field in the configuration file. Required field. -
Call method. The operation submitted in the request. Values are GET, POST, PUT, or DELETE. This is the
method
field in the configuration file. Required field. -
Query parameters. This section lets you enter
property name:property value
options submitted in the query. This is thequeryParams
field in the configuration file. Optional field. -
Request protocol headers. This section lets you enter
property name:property value
protocol headers submitted in the query. This is theheaders
field in the configuration file. Optional field. -
Request entity. The request string to submit for the query. This is the
entity
field in the configuration file. Optional field.
Task configuration
Tasks can be created and modified using the Fusion UI. They can be scheduled using the Fusion UI or the Jobs API.
See also Jobs Configuration Reference.