Monitoring for user defined matches

The monitoring functionality enables you to set up alerts for process behaviors of interest. This behavior can be based on saved search conditions as well as pattern fingerprints.

To learn more about fingerprints first, please refer to fingerprints document.

The following are examples where monitoring for matches could be interesting:

  • Combination of process values satisfying predefined conditions.
  • Matching a certain pattern that indicates machine wear.
  • Troublesome behavior caught in a signature fingerprint.

Search matches

The first step to take in setting up a search based monitor, is to establish and input your search criteria. In the example below, a value based search with three conditions was created. To save the search query, click the save icon  next to the search query, as indicated by the red circle below. When saving, you are asked to define a 'Name' and an optional 'Description' for the saved search.

blobid0.pngblobid1.png

The saved search will automatically appear in the monitor and alert menu. Your next step is to configure the monitor settings.

Fingerprint matches

To match fingerprint behavior, you need to create a fingerprint. More information on how to set up fingerprints can be found here. An example fingerprint is shown below. 

When you save a fingerprint, it will automatically appear in the monitor and alert menu, where you can switch on the monitoring feature for matching or deviating behaviour.

Configure monitors

To configure your monitor, navigate to the monitor and alert menu  and select the saved search or fingerprint. The monitors can be filtered and organized by type or latest update date. In the monitor and alert menu the type of search or fingerprint is indicated by its symbol, as follows:

  • Similarity search   
  • Value based search   
  • Digital step search   
  • Area search  
  • Fingerprint 

The following monitoring options can be configured: 

  • Show in Inbox: Notifications that will be sent to your personal inbox.
  • Send email message: Set up an email alert by checking the box for email alerts and entering your email address, with subject line and message. See the email example alert below.
    • Adding multiple email addresses: Set up an email alert for multiple email addresses by entering the email addresses separated with commas. 
  • Create context item: TrendMiner will automatically create context items for every monitor result. Specify the component on which these context items need to be created as well as the context item type. Depending on the type, you will have the possibility to provide default values for custom fields.  
  • Call webhook: Use this option to integrate with other 3rd party tools. Click here for more information regarding webhooks.  

 Note: Make sure the toggle switch for the corresponding pattern is switched on. 

 

 

States of monitors  

Monitors can be in one of the following states: Enabled, Disabled, or System-disabled (see screenshot below). A disabled monitor can be enabled by switching the respective toggle. By default, each user can enable maximum 10 monitors.  

blobid2.png

Whenever issues are encountered during the automatic monitoring process (e.g. tags not accessible, incorrect minimum duration, trigger of fingerprint monitor no longer existing, context item creation is misconfigured), the respective monitor will be set to System-disabled. This makes sure users always have a correct overview of which monitors have been enabled by themselves and which of them are in a healthy state. For each monitor that goes to System-disabled, a notification is sent out describing the root cause. TrendMiner will no longer check for results for System-disabled monitors.   

Whenevetag accessibility issues are restoredthe user can re-enable all System-disabled monitors at once by clicking the health check button blobid3.png in the header. When the health check is finished, a notification is sent out indicating the number of monitors that could not be enabled.  

blobid4.png

Note: It is highly advised to run the health check whenever any underlying issue is resolved. This will make sure all events, since the monitor went to system-disabled, are still captured and context items (if set up), will be backfilled. In case a user manual disables and re-enables the monitor again, all missed events will be lost.  

Note 2: The health check button only verifies if tag accessibility issues are resolved. If this is the case, the monitors will be enabled again. If the monitor still contains other issues, it will be system-disabled in the next monitoring run. Please follow the guidelines in the notification to fix the underlying issue. 

Known issue: Fingerprints which were set to system-disabled due to an unfound trigger will be re-enabled when running the health check, but it will switch to Detect Matches as opposed to Detect Deviations. From 2021.R2.1 onwards these fingerprint monitors are completely disabled to avoid confusion. 

Example email alert

monitoring002

If your TrendMiner screens do not match the screens you see above, this means you probably run an older version of TrendMiner. Contact your administrator for upgrade options.