Setting up Email Alarm Notifications and Acknowledging Alarms

Related Products:

EMMK-101, EMMK-102, EMMK-103

Related Documents:

ISCM-0380, ISCM-0385




address groups, email templates, testing email notifications


This article explains how to create address groups, create email templates, add email templates and address groups to alarms, testing email notifications, and acknowledge alarms.

Setting up Email Alarm Notifications

Configure InsightCM to send alarm notification emails.

Before you begin, configure your role with serverSettings_edit permissions, create an address group, and create an email template. Refer to Relationships Between User Accounts and Permissions for more information about permissions.

  1. On the server machine, in File Explorer, navigate to the ProgramData\Cutsforth\InsightCM\Auth folder.

  2. Open the SmtpConfiguration.json file in a text file editor.


    The InsightCM Server acts as an SMTP client and sends messages to an SMTP server when you edit this file with information about the SMTP server.

  3. Modify each line category according to your server information.

    "Host": "<servername>",

    "Port": "<port number>",

    "UseSsl": <true or false>,

    "RequireAuthentication": <true or false>,

    "Username": "<username>",

    "Password": "Secret\\Password", "Secret\"Password"


    If your password contains backslashes or double quotations, you must use double backslashes or a backslash and double quotations respectively as shown in the above example.

    "TimeoutSeconds": <number>,

    "FromAddress": "yes-reply@localhost",

    "TestMode": <true or false>


    Test Mode prevents the server from sending emails, even when you run commands from the InsightCM console. Enable the SMTP.Emails tracepoint to view messages that the server writes to the trace log.

  4. Save the .json file and open Windows Services.

  5. Find and select InsightCM <version> and click Restart.


    Restarting the InsightCM service enables the software to read the new SMTP settings.

Add an email template and address group to an alarm.

Creating Address Groups

Create and maintain lists of email addresses to which InsightCM sends alarms and other notifications.

If there are several users that need to receive certain email notifications, create an address group. Use address groups to keep a diverse portfolio of users informed regarding the state of InsightCM or the equipment it is monitoring. Complete the following steps to create a new address group and assign the group to an alarm rule.


To customize the email sent for a specific alarm rule, create an email template and assign it to the alarm rule. Refer to Creating Email Templates to learn how to do so.

  1. Click the Navigation menu (noloc_env_navmenu.png) and select Options.

  2. Navigate to the Notifications section, select Address Groups,and click the Add button.

  3. Enter a name for the address group in the Name text box.

  4. Enter valid user email addresses and separate each email address with a comma, new line, space, or semicolon.

  5. Configure the level of visibility that individual users have regarding other recipients of the same email notification by using the various recipient text boxes.

  6. Click OK to add the new address group to the Selected Group pull-down list.


    Once you add email addresses to an address group, keep at least one email address saved to the address group.

address group

Creating Email Templates

Create templates for email notifications that the InsightCM Server sends when an alarm is set.

  1. Click the Navigation menu (noloc_env_navmenu.png) and select Options.

  2. Scroll down to the Notifications section and select Email Templates.

  3. Select the default option from the Template pull-down.

  4. Click the Edit button to give the email template a descriptive name and click OK.

  5. Write a brief description of what information this template will send about an alarm.


    The contents of this description do not show up in the alarm email.

  6. Write an informative subject line for the email template.

  7. Write the contents of the email and click OK.


    Define email templates independently of address groups to pair one address group with multiple email templates or one email template with multiple address groups. You may want to notify a single individual when a low-severity alarm occurs, but notify several individuals with the same message when a high-severity alarm occurs.

Add your email template to an alarm rule.

Adding an Email Template and Address Group to an Alarm

Assign an email template to an alarm level.

Before you begin, create an email template and create an address group.

  1. Click the Navigation menu (noloc_env_navmenu.png) and select Alarms.

  2. Select an alarm and click Edit.

  3. Under Levels, select an alarm severity level and click Edit.

  4. Select the Send Email checkbox.

  5. Select an address group.

  6. Select an email template.

  7. Click OK.

Testing Email Notifications

Use the console to test whether InsightCM sends email notifications successfully.

Before you begin, set up email alarm notifications.

  1. On the server computer, open Command Prompt.

  2. Navigate to the folder in which InsightCM is saved using the following command:

    cd C:\Program Files\Cutsforth\InsightCM
  3. Execute the following commands to test email notifications:

    InsightCMConsole.exe sendtestemail -grp [address group name]
  4. Verify whether a test email notification is sent to those in the address group.

Permission-Based Access to the Web Application

The server implements authentication for users by providing permissions to groups of users. Permissions serve as access rights that control the ability of the users to view or make changes to specific pages in the web application. Therefore, you might not see pages, tabs, or components described in this help system, or you might not be able to edit particular settings. When possible, this help system documents the permissions required to perform actions so you can seek assistance from a user who possesses the required permissions.

Acknowledging an Alarm

View the relevant data for and acknowledge a trend alarm.

  1. Click the Navigation menu (noloc_env_navmenu.png) and select Alarms > Active Trend.

  2. Select an alarm and click View to see the relevant Trend viewer data in the Alarm dialog.

  3. Click Acknowledge.

    As a result, you moved the alarm instance from the Active Trend Alarm tab to the Alarm Instances dialog, though you did not clear the instance.


    If the data rises above the set point a second time, InsightCM displays the alarm instance again on the Active Trend Alarms tab.

Do you need more help?

address group
Was this article helpful?
0 out of 0 found this helpful