This documentation supports the 25.1 version of BMC Helix ITSM Insights, which is available only to BMC Helix customers (SaaS).To view an earlier version, select the version from the Product version menu.

Identifying clusters of incoming incidents


The Real-time incident correlation dashboard displays incoming incidents as clusters based on the user-configurable grouping fields, text fields, and sliding time windows. The dashboard automatically refreshes every minute.


Each tile on the dashboard represents a cluster. The ranking of tiles can go up or down after each refresh. The clusters that have a major incident or a possible major incident are marked in the dashboard as shown in the following image:

image-2024-1-2_14-6-6.png

Before you begin

Make sure that the BMC Helix ITSM administrator has provided the required permissions to work with incidents.

To search by cluster name

To search for a cluster, start typing the cluster name in the search box on the Real-time incident correlation dashboard.

The application displays clusters with name that match or partially match the search text. If you press the Enter key or click the search button after an initial search, this action does not trigger a new search unless the search text is updated.

2024-01-02_14-06-56.png


To view and manage incident relationships

Drill down into a cluster to view the duplicate and original incidents. You can relate multiple incidents as duplicates of a single original incident.

ITSM Insights retrieves the relationship between incidents from BMC Helix ITSM: Smart IT. When you add or remove a relationship in BMC Helix ITSM: Smart IT, the same is updated in ITSM Insights as well.

  1. Click the cluster name. 
    The incidents in the cluster are displayed in a tabular format.
    By default, the Hide Duplicates checkbox is selected and the duplicate incidents are not displayed.  
    image-2024-1-2_14-34-11.png
    If you want to view the duplicate incidents in a cluster, clear the Hide duplicates check box.
    image-2024-1-2_14-35-3.png
  1. In the Relationships column, depending on whether the incident is an original or a duplicate, click Show duplicates or Show original to see the related incidents.  
    • Show duplicate: Displays the duplicate incidents in a separate window. From here, you can also change the original incident or remove the original relationship
    • Show original: Launches Smart IT to display the original incident.

To change original and remove original relationships

Click Show duplicates to see the related incidents. 

  • To change the original incident, select one or more incidents and click Change original. Select a new original incident and click Continue to save the changes.
    image-2024-1-2_14-43-39.png

    Click Save in the resulting dialog box to change the original incident.

    image-2024-1-2_14-48-10.png

  • To remove the association with an original incident, select one or more incidents, and click Remove relationship. In the resulting dialog box, click Save.

    image-2024-1-2_14-47-16.png


To relate incidents as duplicates of an original incident

  1. Select the incidents from the table. 
    You can identify original incidents in the cluster by their icons:

    Icon

    Incident description

    RecOrig.png

    Represents the first incident in the cluster if the incident is not related to any duplicates. It is usually suggested by the algorithm.

    Original.png

    Represents an incident that is associated as an original in ITSM Insights or BMC Helix ITSM.

  2. Click Manage Original/Duplicate.
    The Relate selected incidents to Original window is displayed.
    image-2024-1-30_14-44-37.png
    To view a list of incidents within the cluster that can be marked as an original, click the Incidents associated with the cluster tab.
    To search for an incident available outside the cluster that can be marked as an original, click the Search for existing incident tab.

    Important

    You cannot mark duplicate incidents as the original of each other.

  3. Perform one of the following steps:

    A list of incidents that can be associated as originals is displayed.
    The first incident of the cluster is indicated as the recommended original. If an incident is already associated as an original in BMC Helix ITSM, it is indicated as an original, as mentioned in the table.

    An original incident that is in Closed or Resolved status is not displayed.

    Perform these steps to mark an incident within the cluster as an original:

    1. In the Relate selected incidents to Original window, click the Incidents associated with the cluster tab.
    2. Select an original incident and click Continue.
      image-2024-1-30_14-45-46.png

    3. Click Yes in the Mark as duplicate dialog box.
      image-2024-1-30_16-13-57.png

    Perform these steps to search and mark an incident that is available outside the cluster as an original:

    1. In the Relate selected incidents to Original window, click the Search for existing incident tab.
    2. Specify some search criteria, such as a company name, summary, incident ID, or associated keywords. To search for all incident records, enter the % wildcard character.
      Based on your search criteria, the top 50 matching incidents are displayed.
    3. Select the incident and click Continue.
      image-2024-1-30_16-20-43.png
    1. Click Yes in the Mark as duplicate dialog box.
      image-2024-1-30_16-21-31.png

To export a list of incidents from a cluster as a CSV file

You can select and export the incidents within a cluster to a .csv file and use this file for offline analysis. Also, you can share the file with other users for a second opinion about your analysis. 

Important

  • The fields in the data set appear as columns in the exported .csv file.
  • Resolved and closed incidents do not appear in the .csv file.
  • You can export a maximum of 9999 incidents in the .csv file.
  • Only .csv file format is supported for the exported document.
  • If you update the incident status, apply filters, or change relationships, we recommend that you export the .csv file again to get the updated incident information in it. 

  1. Click the cluster name that you want to export.
    The drill-down view is displayed.
  2. (Optional) Apply the necessary filters to view the incidents that you want to export in the table.
  3. Select the incidents that you want to export, and click Export.
  4. In Export Selection, click CSV.
    image-2024-1-3_11-8-27.png
  5. (Optional) To download all incidents available in the table, click CSV in Export entire document.

Tip

Perform the additional steps to view the downloaded .csv file for languages with Unicode characters, such as Chinese, French, Japanese, etc.

View the additional steps to open a .csv file with Unicode characters
  1. Open Microsoft Excel.
  2. From the Data menu, select From Text/CSV, and import the downloaded .csv file that you want to view.
    A modal window appears.
  3. From the File Origin list, select 65001:Unicode (UTF-8).
  4. Click Transform Data.

 

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