Monitoring for errors in GOKb synchronization with the local KB

Monitoring the status of jobs that load data into the agreements internal knowledge base is possible using the ERM Agreement Jobs widget. While mostly we would expect (or at least hope!) that jobs will complete successfully without errors, we can use a widget to look out for jobs that have created errors and investigate their cause.

Checking for jobs with errors 

Jobs that complete without errors are given a result of "success". Jobs with errors can receive the result of "partial_success" (if they ran to completion but generated errors) or "failure" or "interrupted" if they did not manage to run to completion.

1. Navigate to the Dashboard app, and click the Actions button (top right) and select "New"
2. In the "Widget name" enter "Jobs with errors"
3. In the "Widget definition" dropdown select "ERM Agreement Jobs"
4. Click "Add filter" and from the "Filter by" dropdown select "Job result"
5. In Filter 1, Rule 1:
   1. change the "Comparator" to "is not"
   2. change the "Value" to "success"
6. Click "Add filter" again and from the "Filter by" dropdown select "Job status"
7. In Filter 2, Rule 1
   
   1. change the "Comparator" to "is"
   2. change the "Value" to "ended"
8. The result should be two filters as follows:
   1. 
9. Scroll to the bottom of the widget configuration form and click the "Add column" button twice. This will add two additional columns to the display, all initially set to "Job name"
   
   1. Leave the first as "Job name", change the second one to "Number of errors" and third to "End time" by selecting the values from the dropdown menu
   2. You could decide to add other or different columns to your display depending on your requirements. You can also change the label used for each column if you do not want to use the default value which is added when you select the Column from the dropdown
10. Set the "Sort by" option to "End time" and set the "Sort direction" to "asc" (ascending)
    1. 
11. Click "Save and close" to save the widget configuration and display the widget on the dashboard
12. This widget has no filter on when the job ran, so any jobs with errors will remain in the widget (until they are knocked off the list depending on the number of rows you have selected to display). Therefore it is important to check the details of this carefully to know if there is a new entry on the list. The end time and job name can help you know if a new job has been added to the list since you last checked as they both include the date and time
    1.