View Job and Error History

Home > selected Project > Status drop-down > Job and Error History...

Requires System-level Job and Error History - View permissions to view the Job and Error History information.

System Users in a role with the appropriate System-level permissions can view history and error information for the Jobs and Errors in the system. By default, a System Administrator and System Manager have these permissions to view the Job and Error History, but not a System Member. For information about System-level permissions, see View and Manage System Role-Based Permissions.

The View Job and Error History page opens in a new browser tab. When you are done viewing the information, you can either close the tab or use it to view other Status menu items, such as Active User Sessions.

Main Toolbar Options

The main toolbar of the Job History contains the following options:

Jobs | Errors

By default, the Job and Error History shows you information for Jobs. This default display does not include errors. If you want to see operations that failed due to errors, or view system-related errors, click the Errors tab instead.

Include Syntax Errors

By default, the Job History does not show you search syntax errors, and the toggle is shown in the disabled state . If you want to include search syntax errors when you are either on the Jobs tab or the general Errors tab, use the toggle to enable the option instead (and the toggle will show as enabled ). Your setting is maintained when you switch tabs.

Note: A failed Adding Documents from <dataset/viewname> to Project Data task will also appear as a type of syntax error when it has an INVALID_ARGUMENT error code. This will be the case if you try to add documents that are not at the required representation level for Project Data (Analytic Index or Content Index level).

Job Status

  • All... –By default, you see Job history information for all Job statuses supported by the system. If you want to control which Job statuses you see, click the ellipsis, which enables you to Deselect All and use the toggle to enable or disable individual Job statuses. The toggle for each status is initially shown enabled . A toggle is provided for each of the following state:

    • Blocked –A Job is currently blocked because another Job in the same Project is causing changes to the underlying data, and those changes must be done in an exclusive manner. For example, if a tagging Job is requested and a request to add more documents to Project Data is made, the Job to add more documents may become blocked if the tagging Job is in a phase where the underlying data is being changed. A Job that is in the Blocked state cannot be deleted, but it can be canceled and then deleted.
    • Cancelled – The operation has been aborted successfully. If you cancel a PAUSED ON FAILURE task, you cannot resume it.
    • Complete with Warnings/Errors – You may see the Warning icon for tasks that completed with exceptions, such as an Export production, Copy to Document Storage, Reprocessing, Validating Bulk Search Query, External Image Import , or Export Project task. For example, for a Copy to Document Storage task, the Warning status applies to any file that was excluded or failed to copy. For tasks with a Complete with Warnings/Errors status, hovering over the icon changes it to a download icon, which you can then click to download a file with the exceptions, the WARNING_DETAILS_REPORT.csv file. (See How to Perform a Copy to Document Storage for more information about the exclusions or errors that apply to the copy operation.) If a download is not available for a task with this status, a popup will provide details about the warning.
    • Failure – Indicates that the operation could not be completed. For many failures, you can retry the operation. Hovering over the icon changes it to the information icon, which you can then click to get details about the failure.
    • Paused – The task/job has been suspended temporarily.
    • Paused on Failure – The system suspended the Job in response to a failure (for example, a lack of disk space). Hovering over the icon changes it to the information icon, which you can then click to get details about the failure. Once the failure has been resolved, you can resume the Job where it left off, instead of having to restart the entire Job. You cannot delete an operation that is paused, but you can cancel it (even if it is in a critical state of processing) and then delete it. Note that under certain circumstances, when a Job is paused on failure, locking may prevent subsequent Jobs such as export or tagging from being scheduled until the Job completes with success or failure (that is, subsequent Jobs will appear as queued).
    • Pausing – An operation is in the process of being paused. The system is suspending all activity associated with the Job. Depending on the state of the Job and the number of resources associated with it, pausing a Job can take some time.
    • Pending Cancellation – An operation has been canceled but the system has not yet completed the cancel operation. The system is working to cleanly cancel the Job and release any resources used by the Job. Depending on the state of the Job and the number of resources associated with it, canceling a Job can take some time.
    • Queued – The Job is in a queue, waiting for system resources to become available to accommodate it. You may see tasks queued up behind a long-running task, waiting for the server to allocate processing time. You cannot delete an operation that is queued but you can cancel it and then delete it.
    • Running – The Job is running. You can monitor the progress using the Task % column on the Job Management screen.
    • Success – The Job has completed and you can act upon the result.
    • Unknown – The Job is in a transitory state and cannot be determined at this time.

Job and Error History Columns

The following columns are shown by default and display information about the various Jobs and Errors:

  • Operation Type — The type of Job, as classified by the software (for example, DOCUMENT_ADD_FROM_FILE_LIST, GET_DOCUMENT_LIST, VECTOR_SET_SEARCH, or TAG_APPLY). This column supports a Custom Combination filter. Operation Type is generally populated for Jobs generating Work Basket tasks. Therefore, for Errors not associated with Work Basket tasks, this column will not be populated.

  • Operation Status / Description — The current status (status icon) of the Job and the job description (for example, (quota) in Project Data). When you filter this column, the filtering is based on the text in the description (not the icon).

  • Error Code — The associated error code (for example, CAE_ERROR or DATA_ERROR_UNAVAILABLE). This column supports a Custom Combination filter.
  • Error Messages — The associated error description (for example, for one type of CAE_Error, The connector is not operational).
  • Request Identifier — The Service Request Identifier (SRI) or SRIs associated with the Job (for example, SRI 99456).
  • Username — The user who initiated the Job.
  • Organization — The Organization associated with the User who triggered the Job. This column supports a Custom Combination filter.
  • Project — The name of the Project associated with the Job, if applicable, or Unknown if the Project is not applicable or known for a given operation. For example, for a Connector Activation, you will not see a Project identified, as it is not applicable for a specific Project (Connectors are at the Organization level). If this is a Project to which you have membership, the Project name will appear in blue and serve as a link to the Project. If you click the link, the Project opens in another window and this becomes the active Project (the one reported in the Active User Sessions screen for your session).
  • Start Time — The start date and time in the format YYYY-MM-DD HH:mm:ss, as selected using the Calendar Date/Time picker. Some Errors will not have a Start Time (because no task ever started) or End Time, but will have an Error Time.
  • Error Time — When viewing errors on the Errors tab, the time the error occurred in the format YYYY-MM-DD HH:mm:ss, as selected using the Calendar Date/Time picker.
  • End Time — The end date and time in the format YYYY-MM-DD HH:mm:ss, as selected using the Calendar Date/Time picker. Some Errors will not have an End Time or Start Time (because no task ever started), but will have an Error Time.
  • Duration — The length of time that the Job has been in process in the format dd hh:mm:ss, depending on the available information. If the day value is zero, then it is not shown. This column is updated continuously. Sample task duration: 2:55.

Custom Combination Box Filtering, Standard Filtering, and Date/Time Filtering

Except for Duration, the columns in the Job and Error History support one of three types of inline filtering:

  • Custom Combination Drop-down Filtering
  • Standard Inline Filtering
  • Special Date/Time Filtering

You can work with only one column filter at a time. For example, if you open a Date/Time picker for one time-related column, opening another Date/Time picker for another time-related column will automatically close the first picker. The same is true if you open a Custom drop-down filter for a column and then open a Date/Time picker for a time-related column; the Custom drop-down filter will automatically close.

Note: In addition to inline filtering, you can right-click a column and select which columns you want to see. If you have filtered column information, you can also right-click a column and select Reset All Filters to clear/reset all filtering.

Custom Combination Drop-down Filtering

The Operation Type, Error Code, and Organization columns support a Custom Combination Filter box with a drop-down option. The icon indicates that this type of filtering is available. This Custom box enables you to either filter for information that contains the characters you type in the Filter box and then optionally make a selection, or you can click in the box or click the filter icon to use the drop-down to scan and then select from a list of possible values for the column. For example, if you type bulk in the box for the Operation Type column, you will filter by all operations that contain BULK. If you want to then select a specific type of BULK entry, like BULK_SEARCH, you can then select just that type from the list.

For any applied filter or selection, you can then clear the filter or selection by removing the text from the box or by clicking the that appears at the far right of the Filter box. Clearing a filter or selection restores the list to its original state.

Standard Inline Filtering

Many columns on this screen (Operation Status/Description, Error Message, Request Identifier, Users, and Project) support the standard filter row text box, shown for these columns by default:

  • Filter row text box — You can use the Filter row text box under the appropriate column. (The icon indicates that filtering is available.) Using the Filter box enables you to pinpoint the items you want to work with based on a Filter term item containing one or more characters you enter. You can explicitly apply a filter by typing one or more characters in the text box and clicking Enter (the return key). If you type one or more characters in the text box, the software will automatically apply the filter for you, and the text box changes to a yellow background color. For any applied filter, you can then clear the filter by removing the text in the box and clicking Enter, by removing the text from the box, or by clicking the that appears at the far right of the Filter box. Clearing a filter restores the list to its original state.

Special Date/Time Filtering

The Start Time, Error Time, and End Time columns support a special date/time Filter box using an enhanced Calendar Date/Time picker. The icon in these columns also indicates that this special date/time filtering is available. You do not enter values directly into Filter row box for one of these columns Instead, you click anywhere in the Filter row, including the filter icon itself, and you will see a separate picker in which you can select and/or specify a date/time range.

The initial state of the date/time picker enables you to specify a date/time range with additional options and apply the information as a filter, as follows:

On/after date...— Limits the list to jobs/errors that start on or after the date you specify in the left-side date box or select using the left-side Calendar. This start date is in the format YYYY-MM-DD. The Calendar enables you to select a Year, Month, and Day.

Time (24hr).. — Further limits the list to jobs/errors that start at the time you specify in the left-side time box. This start time is in the 24-hour format HH:mm:ss. Once populated, you can click the that appears at the far right of the box to clear the information.

~~ — Specifies the syntax needed for a range.

On/before date... — Limits the list to tasks that start on or before the date you specify in the right-side date box or select using the right-side Calendar. This end date is in the format YYYY-MM-DD. The Calendar enables you to select a Year, Month, and Day.

Time (24hr).. — Further limits the list to jobs/errors that end at the time you specify in the right-side time box. This end time is in the 24-hour format HH:mm:ss. Once populated, you can click the that appears at the far right of the box to clear the information.

Note: Clicking the Calendar icon itself will load the current date and select it in the appropriate Calendar. Clicking the icon itself will load the current time in the appropriate time box.

Select: Today | Yesterday ... — Enables you to select common dates. Making a selection will update the picker accordingly.

  • Today — Selects today's date as both the start and end date, using 00:00:00 as the start time and 23:59:59 as the end time.
  • Yesterday — Selects yesterday's date as both the start and end date, using 00:00:00 as the start time and 23:59:59 as the end time.
  • Last 24 hours — Selects yesterday's date as the start date and today's date as the end date, using the current time as the start time and end time.
  • Last 7 days — Selects the date 7 days ago as the start date and today's date as the end date, using the current time as the start time and end time.
  • Last 30 days — Selects the date 30 days ago as the start date and today's date as the end date, using the current time as the start time and end time.

Note: When using the Calendars, you can use the middle arrow buttons to quickly copy a date and time to the other-side Calendar and its appropriate date and time boxes. For example, if you have July 1 2021 at 11:00:00 selected in the left-side (On/after) Calendar, clicking the right arrow button will copy July 1 2021 at 11:00:00 to the right-side (On/before) Calendar and its top date and time boxes.

Apply — Applies your date/time filter criteria to the filter row in the appropriate column.

Cancel — Cancels the filtering by date/time criteria.

Page Controls, Download Option, and Job/Error Total

For multi-page lists, you can select a page to display. The Page Control bar on the screen (the bottom of any list) shows a range and enables you to enter the page number in the box or use the appropriate arrows to navigate. Note that you must hit the Enter key after typing a page number in the box for the change to take effect. Each page displays 100 documents.

The following sample paging area is from the Jobs tab when there are 868 pages of Jobs:

The following sample paging area is from the Errors tab when there is only one page of errors:

— You can use this option only when you are on the Errors tab to save the entire list of errors if the information is not filtered, or to save the current filtered view of error information to a CSV file. The CSV is called SystemErrorsReport.csv. When you are on the Jobs tab, this option is disabled and provides a tooltip to Please select Errors to download the log.

To the far right of the Page Controls is the count for the total Jobs or Errors in the appropriate tab (for example, 1-100 / 86,714).