Phased rollout This version is currently available to SaaS customers only. It will be available to on-premises customers soon.

Configuring the recurrent job settings for proactive problem management


As a problem coordinator, you can configure recurrent clustering jobs for proactive problem management based on the specific requirements of your organization. You can create a maximum of three recurrent jobs.

To create a recurrent job

  1. Click Manage Job.
  2. On the Proactive problem management settings page, click Create recurrent job
    Create Recurrent Job.PNG
  3. In the General section, enter a job name. 
  4. Select the language for the incident text processing. Even though your incident text contains mixed language, pre-processing is done on the basis of the selected language.
  5. In the Data Set section, you can specify the data fields on which you can create clusters and filter data. Select the fields on which you want to create clusters. 
    Data Set 1.PNG
    To also view the required system fields, select the Show fields required by the system check box.

    Important

    The following system fields cannot be removed: Submit Date, Status, Instance ID, Summary (Description), Incident Number, Calculated priority (Priority), Reported Date, Last Resolved Date, Total Time Spent, Resolution category 1 (Resolution Category).

  6. You can specify filters on the fields to further refine your data set. 

    Searching for a string without a wildcard (%) is not supported in a filter that has a text field. We recommend using a wildcard (%) for a search in such filters.

    Data Set 2.PNG

  7. In the Schedule section, you can toggle to enable or disable the scheduled job run. You can configure a maximum of three recurrent jobs. 
    • Specify how often the job needs to run: daily, monthly, or weekly. The default value is monthly.
    • For a weekly job, specify the day of the week on which the job should run. By default, this value is Monday.

      Weekly Job Run.PNG
    • For a monthly job, specify the day of the month on which the job should run and select every n month to indicate frequency of the job run. For example, if you select 2, it means that the job is to be run every two months. 

      Monthly Job Run.PNG
    • Specify the date from which the job is to be run. You can also specify an end date or leave it blank.
    • Specify the look back period. Look back time period is the period used to search for incident data for a job run. For example, a look back period of one month means that the job uses a month's data until the day the job is run.
    • Select Look back date field, which is the date field that is used to search for incidents within the look back time period.
  8. In the Create clusters section, specify the parameters by which the data is to be grouped. 
    Create Clusters.PNG
    1. For the first level of grouping, select from one of the data fields. If you select Machine learning, you cannot select the second level grouping. 
    2. For the second level of grouping, you can select Machine learning or another set of data fields (excluding the data field already selected in level 1 grouping). 
    3. If you have selected Machine learning, you can specify the text fields that will be clustered. Summary is the default text field used for clustering. If more than one text field is provided, these fields are concatenated into one field.

      Important

      If you have not selected Machine Learning in any of the Group by fields, then a clustering job is not run and incidents are grouped by the selected fields.

  9. In the Advanced machine learning section, you can specify the number of clusters. To allow the system to set the number of clusters, click the Let the system set the number of clusters check box.

    Advanced ML.PNG
  10. You can upload custom stop words in a .txt file, where each stop word is defined on a new line. Every time you upload a new file, it overrides the old file and the stop words in the new file are used.

    View the use of % in stop words

    The following table describes the usage of in stop words:

    Incident summary

    Stop word

    Description

    ITSMInsights is running low on memory

    ITSM%

    Removes the stop word ITSM and the characters following it. 
    In this case, ITSMInsights is removed from the resulting cluster label.

    ITSMInsights is running low on memory

    %Ins%

    Removes the stop word Ins and the characters preceding and following it.
    In this case, ITSMInsights is removed from the resulting cluster label.

    ITSMInsights is running low on memory

    %Insights

    Removes the stop word Insights and the characters preceding it.
    In this case, ITSMInsights is removed from the resulting cluster label.

    Important

    Stop words are case-sensitive. We recommend matching the case of your stop word with that of the word in the description that you want to remove.

  11. Click Save.

The job configuration is saved. A job might take several minutes to complete, depending on the incident data to be processed. Refresh the jobs table to check if the job is completed. If multiple problem coordinators schedule jobs to be run at the same time, the jobs might get queued. 

When the job run is completed, the jobs table displays the job status in the Jobs table. If the job run was not successful, the Last job message column displays the reason why the job failed. Once the job is successfully run, you can select it from the Jobs list in the dashboard to view the clusters.

Important

Depending on number of records or incidents and the kind of incident data, the number of clusters on the dashboard could be less than the number you have specified.

To edit a recurrent job

To edit a recurrent job, click the edit icon in the Actions column. Make the necessary changes to the job.

The changes you have done will take effect in the next scheduled job.

To delete a recurrent job

To delete a recurrent job, click the delete icon in the Actions column. When you delete a job, the job definitions, that is, the data fields and filters applied are also deleted. Also, all job runs associated with that job are deleted.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*