This topic describes the settings on the Agent Manager - Alerts tab.
Figure 1. Agent Manager Alerts Tab
You can enable the following optional health alerts to receive alerts when network communication problems occur between the Agent and Agent Manager, such as network connection problems.
Enable Agent health
You can enable this option so that if network communication problems occur with an Agent, an alert is generated and displayed in the Enterprise Synthetic Console.
Select this option to enable the Agent health alerts, then set the Priority of the alerts: Low, Medium (Default), or High.
Enable Agent Manager health
Optional. Agent Manager health alerts trigger when problems occur that prevent data from being processed into the database. For example, alerts are generated when the schedule database maintenance fails to run or data isn't moving from the Agent Manager into the database.
To disable the Enable Agent Manager health alert option, de-select the option.
Set the priority of this type of alert. Low, Medium (Default), or High. This priority is used to specify the importance/severity of this type compared to the other types of alerts generated in Enterprise Synthetic.
Alert when data files exceed
(Default: 2000 files). When the number of data files on the Agent Manager exceeds this number, an alert is triggered.
Alert when trace files exceed
(Default: 500 files): When the number of trace files on the Agent Manager exceeds this number, an alert is triggered.
Enable Data Health
Optional. Data Health data ensures that transactions are running on Agents successfully and in a timely manner.
Data health data is generated when transaction data is not returned from the Agent(s) for a transaction. For example, if transactions are not running because the script database was not published to the Agent before the transactions, or if the transactions are not named correctly.
To disable the Enable data health option, de-select the Enable data health option.
Set the Priority of this type of data: Low, Medium (Default), or High. This priority is used to specify the importance/severity of this type compared to the other types of data generated in Enterprise Synthetic.
(Default: 30 minutes). The Delay threshold is used to increase the number of minutes to receive data for a transaction before generating a Data Health alert. You can set this threshold from 15 to 120 minutes.
If no transaction data is received within the estimated duration + the Delay threshold, a Data Health alert is generated for the transaction.
For example, if the estimated duration is set to 2 minutes, and the Delay threshold is set to 15 minutes, a Data Health alert is generated when no data for a transaction has been returned within the total 17 minutes.
The estimated duration is configured in a task's configuration setting. For more information, see Tasks Content Pane.
Write to Windows event log
You can write the health alert notification to the Windows event log to be consumed by Windows Event Viewer or other software. The alert is written to the event log before being passed to the executable or email notification.
The Notification executable section lets you configure an external program to process the notification and, for example, issue an incident ticket into the third party tracking system such as ServiceNow. The executable is launched after optionally writing to the event log and before any other notification processing. Select Enable health alert executable to process the health alert with an external program.
The Custom executable path and name field contains the default path to the pre-installed DLL that runs the PowerShell script generating the ServiceNow REST event. You will need to add details of your ServiceNow account to the
sym-to-servicenow-rest-event.ps1 script to make it work. You will find the script in the
C:\Program Files (x86)\Compuware\Synthetic
ServiceNow REST event endpoint.
ServiceNow user name with authorization to create events. See !!Customizing ServiceNow Security Policies and Profiles.!!
ServiceNow password for the user with authorization to create events.
Optional, by default this is set to 0 for debugging to be off. If set to 1 the file service-now.log will be appended with debug information.
See Health Alert Scripting for advanced information on customizing and controlling the Enterprise Synthetic Health Alert Notification User Exit.
Specifies the email address to send a health alert notification email that includes a description of the health alert and the Agent Manager machine name.
For more information about the task's estimated duration, see: