10. Jobs

An overview table featuring all Jobs is available on the Jobs page, facilitating the management of pending and failed Jobs. In the list part of the page, you can find all jobs, complete with their status and overall progress. Upon selecting a specific job from the list, the corresponding job details are presented in the detail part of the page (see Fig. 10.1).

_images/jobs_list.png — Fig. 10.1 Jobs overview

10.1. Job Details

In the Detail part of the page the Job Details are displayed:

Job	Shows the name and the type of the Job.
State	Shows the state of a Job, the progress of its tasks and the Schedule. The different states are described in Section 10.3 and the Schedule Types in Section 10.2.
Job Tasks	Shows each Task, often associated with a specific device, the Tasks State, when it was last triggered, the current Step (if applicable) and the progress of its steps (if applicable). The different states are described in Section 10.4.
Steps	Certain tasks consist of multiple steps. Those steps indicate where a task might got stuck and how to manually fix an issue with the device. Steps have a Status and they have Started At, Skipped At and Completed At dates indicating their progress.

_images/job_details.png — Fig. 10.2 Job Details

10.2. Job schedules

10.2.1. Fire and forget

The Job will be executed immediately after it was created. If it fails, it will retry every 5 minutes until the Expires At date is reached. Fire and forget Jobs expire after 30min.

10.2.2. Scheduled

The Job will be executed during the specified date range under the consideration of the specified time window and weekdays. If the Job fails, it will retry every 5minutes during those windows until the end of the specified date range (Expires at).

_images/job_schedule.png — Fig. 10.3 Jobs Schedule

10.3. Job States

Indicates in which state a Job is, between creation and completion.

Job Status	Description
Scheduled	Pending for execution. Typically due to the start date has not been reached yet or the execution time window is currently closed (the current time is not between start and end time and/or the date of the week does not allow the execution).
Running	Job is being executed.
Paused	The paused state typically occurs when the schedule window has closed.
Succeeded	Successfully completed with all tasks processed as expected.
Failed	Due to an error or failure the job was not completed.
Partially Succeeded	Not all of the tasks belonging to a job were completed successfully processed.
Cancelled Manually	Manually cancelled before completion.
Replaced	A different Job has replaced the current Job.
Unknown	The state of the Job is not known or has not been set.

10.4. Task States

Represents the various states a Job Task can have during its lifecycle.

Status	Description
Scheduled	Scheduled to run at a specified time.
Running	The Job Task is currently in progress.
Rescheduled	Rescheduled to run at a different time.
Succeeded	Completed successfully.
Failed	An error was encountered during execution, therefore it not complete successfully.
Cancelled	It was cancelled before it could complete.

10.5. System Jobs

The system generates various Jobs that are automatically excluded from the Jobs List by default. These jobs are created to guarantee the proper functioning of the Connectivity Suite, such as updating Device Certificates or retrieving the most recent Device Information.