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.
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.
The saved search will automatically appear in the monitor and alert menu. Your next step is to configure the monitor settings.
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.
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
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.
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.
Whenever tag accessibility issues are restored, the user can re-enable all System-disabled monitors at once by clicking the health check button in the header. When the health check is finished, a notification is sent out indicating the number of monitors that could not be enabled.
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
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.