Jobs Queue

The Jobs queue (in the Jobs window) enables you to monitor all scheduled and active jobs and view historical jobs in your Code Insight system. The queue is in a navigable grid, enabling you locate and view details for jobs more easily. The following table describes the queue columns that provide details for each job. It also describes the fields that help you navigate the queue or control the queue view.

For complete information on how to access and search the Jobs queue, see Monitoring the Code Insight Jobs Queue.

Note:The “the specified project” in the following descriptions refers to the project identified in the Project Name column for the job.

Jobs Queue

Field/Column

Description

Show jobs for

The filter that configures the Jobs queue to show only those jobs that were added to the queue in the last number of days specified, enabling you to monitor a manageable number of jobs. You can also select to view all jobs.

Select one of these values:

15 days—Show only jobs queued in the last 15 days. (Default)
30 days—Show only jobs queued in the last 30 days.
All—Show all jobs.

Scan server name

The filter in the Active Jobs tab that configures the Jobs queue to display only those active and scheduled scan jobs that is performed by the specified scan server. Enabling you to select only one scan server at a time from the field drop-down.

The following columns in the Jobs queue describe each job.

Job ID

The internally generated ID for the job. By default, the Jobs queue is sorted in descending order by this column. However, you change the sort to ascending order or choose to sort by another column. For more information, see Sorting the Jobs Queue.

Job Type

The type of event that triggered the job:

Project Branching—The branching of the specified project to another project.
Project Copy—The copying of the specified project to another project.
Project Scan—A Code Insight scan of the specified project.
Project Re-Scan—A rescan of the specified project.
PDL Update—An Electronic Update of the local Code Insight Data Library.
Library Refresh—A daily Code Insight Data Library refresh of new vulnerability alerts generated since the previous day.
Project Deletion—The deletion of the specified project.
Export to SBOM Insights—The export of a project’s inventory data to SBOM Insights.
Update Notices—The automatic update of the Notices content across all inventory in a project.
Project Import—The import of exported project data into a project.
Project Export—The export of project data to a JSON file so that it can be imported into another project.
Remote Scan—The processing of the scan results sent to Code Insight by a Code Insight scan-agent plugin residing on a remote server.

Currently, the Jobs queue supports the processing of scan results from the generic or Docker Images scan-agent plugin only. For all other scan-agent plugins, the results-processing phase begins as soon as Code Insight receives the results; no job is added to the Jobs queue to run in the background. For more information, see Support for Processing Remote Scan Results in the Background. Report-Audit Report—The generation of an Audit report for the specified project.

Report-Notices Report—The generation of a Notices report for the specified project.
Report-Project Report—The generation of a Project report for the specified project.

(Continued)

Report-<customReportName>—The generation of a custom report for the specified project.Apply Policy - Global
Apply Policy - Project—The application of current criteria in a review policy profile to inventory in a specified project associated with the profile.
Apply Policy - Global—The application of current criteria in a given review policy profile to inventory across all projects associated with the profile.

You can use this column to filter the Jobs queue to one of the job types. For more information, see Filtering the Jobs Queue by Column.

Project Name

The name of the project associated with the job. If you click the hyperlinked name, the project is opened to its Summary tab. (If the project is private, only administrators and those users assigned roles on the project can open it. All other users receive the message “Unable to access the project”.) Note the following:

If the project has been deleted, this column shows Deleted Project (with no hyperlink). However, in most cases, the name of the deleted project is still referenced in the Details column.
For a Project Copy job, this column shows the name of the source project from which data is copied. The target project to which the data is copied is identified in the Details column.
For a PDL Update, Library Refresh, or Apply Policy - Global job, this column shows N/A since the job is a system event (and not related to one specific project).

You can use this column to filter the Jobs queue to a specified project name string. For more information, see Filtering the Jobs Queue by Column.

Status

The current status of the job:

New—The job has just been added to the queue, and its current status is pending.
Active—The job is now executing.
Canceled—A user manually canceled the job while it was in a Scheduled state.
Completed—The job has successfully finished.
Failed—The job encountered an error. Usually a description of the error is provided in the Errors column for the job.
Scheduled—The job is waiting for a scan or rescan to complete for one or more projects other than the one specified for the job.
Terminated—A system timeout or loss of connection caused the job to end prematurely. This status is also used if the job was canceled while in an Active state.
Waiting on update—The job is waiting for an Electronic Update to complete on your Code Insight instance.
Waiting on library refresh—The job is waiting on a Library Refresh to complete on your Code Insight instance.

You can use this column to filter the Jobs queue to a single status. For more information, see Filtering the Jobs Queue by Column.

Scan Server

The alias of the Scan Server that performed the scan (even if the Scan Server has since been disabled). For jobs related to the Code Insight Core Server, the value is N/A.

You can use this column to filter the Jobs queue to one or more Scan Server aliases. You cannot filter using the N/A (Core Server) value. For more information, see Filtering the Jobs Queue by Column.

Triggered By

The login name of the user who initiated the event that triggered the job. Clicking the hyperlinked name lets you can send an email to the user.

You can use this column to filter the Jobs queue to a specified user-name string. For more information, see Filtering the Jobs Queue by Column.

Queued On

The date and time at which the job was added to the queue. You can sort the Jobs queue by this column. For more information, see Sorting the Jobs Queue.

Note:A Remote Scan job is added to the queue when the scan results from a scan-agent plugin residing on a remote server are successfully sent to Code Insight for processing. Currently, the Jobs queue supports the processing of scan results from the generic or Docker Images scan-agent plugin only. For all other scan-agent plugins, the results-processing phase begins as soon as Code Insight receives the results; no job is added to the Jobs queue to run in the background.

Actions

Icons that you can click to perform certain actions on the scan jobs listed on the Active Jobs tab in the Jobs window. This column enables you to reordering or managing all the active and scheduled scan jobs in the Jobs queue via the following icons:

Move up—Click the Move up icon to move the selected scan job up in the Jobs queue.
Move down—Click the Move down icon to move the selected job down in the Jobs queue.
Move to top—Click the Move to top icon to move the selected job to the top in the Jobs queue.
Move to bottom—Click the Move to bottom icon to move the selected job to the bottom in the Jobs queue.
Stop Scan—Click the Stop Scan icon to remove the selected job from the Jobs queue.

Activated On

The date and time at which the job began to execute.

Completed On

The date and time at which the job ended. (Check the Status column to determine the final status of the job when it ended.) You can sort the Jobs queue by this column. For more information, see Sorting the Jobs Queue.

Details

In general, a description of the job and, if applicable, the name of the project on which it was run. However, for the following jobs, the column provides different information:

Project Copy job—Details include both source project from which data was copied and the target project to which data was copied. (The source project is also listed under Project Name.)
Apply Policy - Global and Apply Policy - Project jobs—The description provides the name of the review policy profile applied to inventory.

Errors

Details of the error(s) that caused a job to end with a “Failed” status. If no errors were generated for the job, this value is empty.

These buttons at the bottom of each page in the Jobs queue enable you to navigate easily between pages. A page holds a maximum of 25 jobs.

 

Navigate to the first or last page in the queue.

 

Navigate to the previous or next page in the queue.

Navigate to the specified page in the queue.

These buttons refresh the Jobs queue or close the Jobs window.

Refreshes the Jobs queue with the latest job information. All search mechanisms currently applied to the queue are retained.

Close

Closes the Jobs window. When you reopen the window, the Jobs queue is displayed in its default view. (Search mechanisms applied previously to the queue are not retained.)