Global Configuration

You can set the logging and Health Monitor options for the entire AlarmPoint System using the Global Configuration page.

Note that the settings on the Global Configuration page apply to the main AlarmPoint logs and Health Monitor. Individual components such as Nodes and Device Engines also have log settings to create and maintain separate log files. For more information about logging configuration levels, see Configuring Node Logging.

About the Health Monitor

The Health Monitor component is responsible for monitoring the community of nodes, generating Alerts when error conditions are detected, and taking corrective action where possible. Its functions can be categorized as follows:

The Health Monitor triggers an Alert when any of the following conditions are met:

For detailed information about the conditions under which Health Monitor messages are generated, see Health Monitor Messages.

Note: When a disconnected database or Node is reconnected, the Health Monitor sends a notification indicating the successful resolution.

The Health Monitor supports the following notification mechanisms:

The Health Monitor generates two types of messages: detailed and terse. Detailed messages are used for emails sent by the Health Monitor, and terse messages are used when sending a notification to non-email text Devices. All detailed messages are also included in the AlarmPoint log files.

Note: The Health Monitor generates two messages for inter-node communication errors: one message that includes the entire stack trace, and one that includes a simplified (terse) message. You can eliminate the stack trace message by opening the hmApplicationContext.xml file (located at node/assets/resources/spring/integration) in a text editor and setting notifyNodeCommunicationExceptions to "false". After making the change, restart the node.
To set Global Configuration settings:
  1. On the Global Configuration page, specify the following information:

 

Setting

Description

Log Settings

Maximum File Size

Maximum allowable file size for each log file. When this limit is reached, AlarmPoint archives the log file and creates a new one.

Note that if the Number of Backups is set to “0”, AlarmPoint discards the log file, and creates a new one.

 

Number of Backups

Maximum number of the most recent log files to retain. If the maximum number of backups is reached, AlarmPoint deletes the oldest log files first.

 

Log Level

Default level of logging for components in the AlarmPoint system. Individual component log settings override this parameter.

Note that more detailed log levels produce log files that cover a smaller window of time, determined by the maximum file size and the maximum number of backups.

Health Monitor Settings

Mail Host

Name of the mail host to use for email messages generated by the Health Monitor.

 

Mail Port

Port number to use for the Health Monitor mail.

 

Mail Sender

Email address that appears in the “From” field of the notification email message.

 

Mail Recipient

Email address of the default Health Monitor mail recipient.

 

Notification Target

If available, the user name of the Company Administrator the Health Monitor should attempt to notify via AlarmPoint in the event of a system health event.

  Integration Agent Heartbeat Failure Threshold Specifies how many consecutive "heartbeats" an Integration Agent can miss before the Health Monitor sends a warning message. The value must be between 1 and 9999; the default is 5.

Notification Processing

Notification Processing Timeout

Length of time, in minutes, that a notification can remain in a serviceable state before it is automatically delinked. The default setting is one hour.

Note that a live notification could remain serviceable but undispatched for several reasons. For example, if a live notification for WCTP is created but the only configured WCTP engine goes down for a period longer than the specified timeout, the notification will be delinked.

Specifying a value that is too short (e.g., five minutes)could result in notification delivery failure if the Device Engines cannot process the number of notifications quickly enough. If this happens, increase the Notification Processing Timeout setting, or increase the number of available threads on your affected Device Engines.

Service Provider Failure

Enable Notifications

Enables Health Monitor notifications for Service Provider failures.

 

Threshold

Number of failures per Check Period that must be met or exceeded to trigger a notification. To prevent the Health Monitor from sending any notifications, enter “0”.

 

Check Period

How often, in minutes, to check whether the conditions for provider failure have been met.

 

Suppression Period

Length of time, in minutes, to suppress notifications for a provider after an instance of provider failure. The next time that provider fails after the suppression period will generate another notification and restart the suppression period for that provider.

Bounced Mail Settings

AlarmPoint uses the Bounced Mail Settings to respond to emails that are not related to a notification. AlarmPoint sends a message using the Bounced Mail Settings to indicate that the email was invalid.

 

Mail Host

Name of the mail host to use for email messages responding to invalid responses.

 

Mail Port

Port number to use for the invalid responses mail.

 

Mail Sender

Email address that appears in the “From” field of the “invalid response” notification email message.

Note: This email address must not be the same as the email account used to send notifications from an SMTP/POP Device Engine.

  1. Click Save to apply your changes.