-
Title
Configuring database agent email notifications, recipients, and messages -
Description
Is there a means to set up a global email default for configure a default notification address either for all rules or for individual rule or severities from within the database cartridge so that new database instances that are added to Foglight will use these defaults?
-
Cause
You can define a default email address to be used by every new agent created in the future, by selecting the Default email button when configuring email notification. The Email addresses entered are applied to all monitored agents not only for the agents that were selected to enter the Alarm administration. -
Resolution
We recommend that you set email notifications for the alarms you are most interested in tracking closely. For example, you may want email notifications of any Critical or Fatal situation. Or you may want to be informed whenever a key metric, such as CPU usage, is no longer operating within acceptable boundaries.
Configuring an email server
You need to define the global mail server variables (connection details) to be used for sending email notifications. The setting of the email should be configured in Foglight Administration > Email configuration.
Defining Default Email settings
You can define a default email address to be used by every new agent created in the future, by selecting the Default email button when configuring email notification.The Email addresses entered are applied to all monitored agents not only for the agents that were selected to enter the Alarm administration.
Enabling or disabling email notifications
You can enable or disable email notifications for all alarms, a category of alarms, or a selected rule. Email notifications are sent only if all the following conditions are met:
- The alarm email notification setting is enabled for the affected rule.
- Changes in the monitored environment trigger an alarm.
- Alarm notification is enabled at the triggered severity level.
To enable or disable email notifications:
- In the Alarms view, click the Settings tab.
- Decide on the scope for the change: all alarms, a category of rules, or a selected rule.
- Complete the steps for the selected scope:
Scope Procedure All alarms Click All Alarms. In the Alarms Settings tab, click the Define Email Settings button. Select either Enabled or Disabled from the Alarms notification status list. Click Set. Category of rules Click a category. Click the Define Email Settings button. Select either Enabled or Disabled from the Alarms notification status list. Click Set. Selected ruleSelected rule Click a rule. In the Alarms Settings tab, click the Define Email Settings tab. Click the link that displays Defining email notifications, recipients, and messages
You control who receives email messages, the subject line, and some text in the body of the email. The body of the email always contains information about the alarm. This information is not editable. You can also control whether an email is sent based on severity levels. You can set different distribution lists for different rules and different severity levels, or set the same notification policy for all rules.
To configure email notifications:
1 In the Alarms view, click the Settings tab.
2 Decide on the scope for the change: all alarms, a category of rules, or a selected rule.
3 Complete the steps for the selected scope:
Scope Procedure All alarms Click All Alarms. In the Alarms Settings tab, click the Define Email Settings button. Continue to Step 4. Category of rules Click a category. Click the Define Email Settings button. Continue to Step 4. Selected rule Click a rule. Click the Define Email Settings tab.
- To change the severity level that warrants an email notification, click the link that displays the severities. Select the desired level of severity and click Set.
- To configure email recipients and the message, select the tab for a severity level, and click Edit. Skip to Step 5.
4 If you selected All Alarms or a category, in the Email Notification Settings dialog box, do one of the following:
- To change the severity levels that warrant an email notification, from the Messages will be enabled for severities box, select the desired levels of severity.
- To configure the same email recipients and message for all severity levels, click Configure settings for all severities and then click All severities.
- To configure different email recipients and messages for each of the severity levels, click Configure severity-specific settings and then click a severity level.
5 In the Message Settings dialog box, configure the email recipients and message.
- To — Type the addresses of the people who need to act when this alarm triggers.
- CC — Type the addresses of the people who want to be notified when the alarm triggers.
NOTE: If a mail server is not found, you are prompted to configure a mail server. For instructions, see Configuring Email Notifications in the user guide for the database cartridge that is being used. Note that you can use registry variables in place of email addresses. Type the variable name between two hash (#) symbols, for example: #EmailTeamName#. For more information, see Defining variables to contain email recipients in the user guide for the database cartridge that is being used.
- Subject — Optional. Edit the text of the subject line to better suit your environment. Avoid editing the variables, which are identified with the @ symbol.
- Body Prefix — Optional. Add text that should appear preceding the alarm information in the body of the email.
6 Click Set to save the message configuration and close the dialog box.
7 If the Edit Notification Settings dialog box is open, click Set.
8 Click Save changes.
Defining variables to contain email recipients
You can create registry variables that contain one or more email addresses and (optionally) their scheduled notifications, and use these registry variables when defining email notifications. This procedure describes how to create a registry value.
To create a registry variable:
- On the navigation panel, under Dashboards, click Administration | Rules & Notifications | Manage Registry Variables.
- Click Add.
- The New Registry Variable Wizard opens.
- Select the registry variable type String, and click Next.
- In the Name field, enter a name, for example: EmailTeamName
Optional — Add a description. - Click Next.
- Select Static Value.
- In the Enter desired value box, enter one or more email addresses (separated by commas).
* NOTE: Email groups are not permitted. - Click Finish.
The Edit Registry Variable dashboard displays the newly created registry variable.
To use a registry variable in email notifications, type the variable name between two hash (#) symbols, for example: #EmailTeamName#. For more information, see Defining email notifications, recipients, and messages.
Defining scheduled email notifications
If someone wants to receive an email about an alarm regularly, such as once a day, you use a registry variable schedule to set up the notification.
To schedule the sending of email notifications for a registry variable:
- If you are continuing from Defining variables to contain email recipients, the registry variable is already open for editing in the Edit Registry Variable dashboard.
* TIP: To edit a different variable, navigate to the Administration | Rules & Notifications | Manage Registry Variables dashboard, click the variable name, and select View and Edit Details. - In the Performance Calendars List table, click Add.
The Performance Calendar Wizard opens. - Select a schedule, for example: End of Day
- Click Next.
- Select Static Value.
- In the Enter desired value box, enter one or more email addresses (separated by commas) to receive email notifications based on the schedule.
* TIP: The addresses may the same as or different from the addresses assigned to the registry variable. - Click Finish.
The Edit Registry Variable dashboard displays the newly created schedule. If desired, repeat to add other schedules.