Monitor states
TrendMiner monitors can have 3 different states:
Enabled: the monitor is running correctly and generating alerts when triggered.
Disabled: the monitor is disabled and not generating alerts.
System-disabled: Whenever issues are encountered with respect to tag accessibility during the automatic monitoring process, 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.
Monitor Health Check
Whenever the underlying issues are resolved (e.g. tag permissions are restored), the user can re-enable all System-disabled monitors at once by clicking the health check button in the header. Whenever 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.
Important
Health check ONLY checks for tag accessibility issues. There could be other issues causing monitors to go to the system-disabled state (e.g. invalid search definitions). In these other cases, the health check will enable the monitor, but the monitors will go to system-disabled in the next monitoring round.
Global Health Check
The monitor health check as provided in the UI can be triggered by individual users and also runs a health check on the monitors of an individual user only. If tag accessibility issues caused monitors of multiple users to go to system-disabled admins can trigger a global monitor health check via the TrendMiner API:
Browse to the TrendMiner API Console
Execute the following API call:
PUT /hps/api/monitors/health-check?global=true
After clicking "Send" the response shows a "202 Accepted".
The global monitor health check is triggered. It can take a few minutes to complete. Once completed all admin users will receive a notification.