Jobs
Manage Discovery (Inbox scans), Remote connection, and File import jobs on the Jobs page. It displays the latest 250 entries.
The Jobs page updates periodically to display the latest information.
Customize the Jobs page
Sort the job list
Every column on the Jobs page can be sorted.
Sort a column by clicking on the column header. An arrow marks the sorted column. Click on it to switch between descending or ascending.
Filter the job list
Every column on the Jobs page can be filtered.
Filter a column by clicking on the filter icon in the column header. Select an appropriate filter criteria and, if applicable, a value. The list is filtered by the selected criteria and the filter icon in the column header indicates that a filter on the column is set.
Get details of a job
Click the context menu in the left corner of an entry and select View Details to open the details pane of the selected job. Details are organized in blinds, depending on the selected type of job and its parameters.
Discovery jobs
Discovery job details show the Asset Link and its ID the job was started with. A Discovery job returns assets during its scan process. The Metrics blind displays the current resulting asset count of this job.
| Metric | Description |
|---|---|
| Total | Total number of assets detected. |
| Created | The number of assets identified for the first time. |
| Updated | The number of assets already present and updated by a scan. |
| Duplicate | The number of assets identified as duplicates with a different Asset Link. |
| Rejected | The number of assets rejected by the inventory and not captured at all. |
| Failed | The number of assets that failed to update due to an internal error in inventory service. |
If filters or options were defined when starting the Discovery job, they are also displayed in separate blinds.
Remote connection jobs
Remote connection job details show the Asset name, the Port, and the Connection type the remote connection was initiated with in a separate blind.
File import jobs
File import job details show the Filename that was imported and the Message produced by the import process in a separate blind. A File import job returns metrics during the processing. These are displayed in a separate blind.
| Metric | Description |
|---|---|
| Total | Total number of assets processed. |
| Added | The number of assets added to the inventory. |
| Updated | The number of assets already present and updated by the file import. |
| Duplicate | The number of assets identified as duplicates with a different Asset Link. |
| Rejected | The number of assets rejected by the inventory and not captured at all. |
| Failed | The number of assets that failed to update due to an internal error in inventory service. |
| Skipped | The number of skipped assets due to missing required properties. |
The metrics details show detailed information about each processed row of the imported file.
Job states
Every job transitions through a series of states during its lifecycle. The Status column on the Jobs page displays the current state.
Common states
These states apply to all job types. Discovery and Remote connection jobs are executed by the Asset Gateway. File import jobs are processed by the cloud-side File Import Service.
| Status | Description |
|---|---|
| Created | The job has been created and is waiting to be picked up for execution. |
| Started | The job has been picked up and is being executed. |
| Done | The job completed successfully. |
| Failed | The job completed with an error. |
| Cancel | A stop has been requested but not yet confirmed. The job is still considered in progress. |
| Canceled | The stop has been confirmed and the job is finished. |
Automatic job cancellation
Discovery jobs are automatically canceled when the associated Asset Gateway goes offline and the job has stopped making progress. The system periodically checks for stuck jobs. If the Asset Gateway is offline and the job has not progressed since the last check, the job transitions to the Canceled state.
This typically occurs within 10 to 20 minutes of the Asset Gateway going offline.
Note
Automatic cancellation applies only to Discovery jobs executed by an Asset Gateway. File import jobs processed by the cloud-side File Import Service are not affected.
Additional remote connection states
Remote connection jobs use additional states for the connection lifecycle.
| Status | Description |
|---|---|
| Connected | The remote connection is established and active. |
| Disconnect | A disconnect has been requested but not yet completed. |
| Disconnect failed | The disconnect attempt failed and is being retried. |
| Closed | The remote connection has been terminated. |
Perform actions on jobs
Action 'Stop'
Stop a currently running job by selecting it and clicking Stop. Jobs are considered running depending on their current status. The jobs list supports multi-selection, so the Stop dialog may display jobs in several states. Only jobs considered in progress are stoppable. All other jobs appear in the Stop dialog in separate blinds but are not affected by this action. After confirming the Stop dialog, the selected jobs are requested to stop. One or more messages appear after the stop requests are processed.