MGS/AWG - Monit Package

Monit plugin is a Unix system management and proactive monitoring tool. This document will help guide set up the Monit tool on the ICCN AWG gateway. This Monit package is included in the AWG system by default.

Monit is a utility for managing and monitoring processes, programs, files, directories, and filesystems on a Unix system. Monit conducts automatic maintenance and repair and can execute meaningful causal actions in error situations. E.g., Monit can start a process if it does not run, restart a process if it does not respond, and stop a process if it uses too many resources. You can use Monit to monitor files, directories, and filesystems for changes, such as timestamp changes, checksum changes, or size changes.

Monit is controlled via an easy-to-configure control file based on a free-format, token-oriented syntax. Monit logs to Syslog or to its own log file and notifies you about error conditions via customizable alert messages. Monit can perform various TCP/IP network checks and protocol checks and can utilize SSL for such checks. Monit provides an HTTP(S) interface, and you may use a browser to access the Monit program.

Configuring Monit settings

Monit tool helps you to receive alerts on specific metrics of the gateway.

After logging in to the gateway, navigate to Services -> Monit -> Settings

Make sure of the following:

●     Enable Monit: Check

●     Mail Server Address: Address of the mail server you are using

●     Mail Server port: Port of the mail server you are using

●     Mail Server Username: Email Address from which you want the email to be received

●     Mail Server Password: password of the email configured above

●     Mail server SSL connection: Check

You will be notified to click on Save and on Apply.

Next, navigate to the Alert Settings tab and click on the ‘plus’ sign to configure alerts and add the email on which you want the alerts to be received. Make sure of the following:

●     Enable Alert: Checked

●     Recipient: Email address on which you want to receive alerts         

●     Events: Select what alerts you would like

●     Click on Save and on Apply as it prompted

Restart the Monit service by clicking on the Refresh button on the top-right as seen in the above screenshot.

You will start receiving alerts as soon as any of the chosen metrics throws a trigger.