Email Templates
Access Email Templates
Although the configuration settings are self-explanatory, some template configuration features and options require additional information.
- Click .
- Click an existing template to view, edit, or delete it or click New + to create a template.
- Edit or define the template.
- Click Save.
Custom Templating Variables
You can use variables that replace values in the message body when the email is sent.
The template recognizes a set of predefined variables. Review Predefined Templating Variables to verify the variable you want does not already exist.
If the predefined variables do not meet your needs, you can optionally configure custom variables. When a predefined variable and a custom variable are both configured with the same variable name, the template uses the predefined variable.
You can use the following characters while configuring custom variables:
- Alphabetic characters (a...z, A...Z)
- Numeric characters (0...9)
- Hyphen (-)
- Underscore (_)
The template uses Apache Velocity version 2.3 to process the variables. See the Velocity User Guide.
Admin Email Recipients
To add a recipient, enter an email address and click + Add. To remove a recipient, click –.
If the Allow custom email recipients checkbox is selected in the template, users of the email template can add additional email recipients when they create the email notification. However, they cannot delete any of the recipients configured by the template. Clear this checkbox if you do not want to allow template users the ability to modify the recipient list.
The only way to remove a required recipient is by modifying the template.
Email Template
Enter the subject line and the body of the message. Splunk AppDynamicsrecommends including both an HTML version and a plain text version. You can use any predefined or custom templating variables in both the HTML and plain text message bodies. Use background-color background
For-each loops are supported. See Predefined Templating Variables.
Custom Email Headers
Use this section to add custom SMTP headers to the message.
One Email Per Event
Several separate events, or separate occurrences of the same event, could potentially invoke the same notification action.
The One Email Per Event setting controls whether the action bundles the emails triggered by those events. The effect is:
- If selected, the email is sent once every minute, no matter how many events triggered the notification within that minute. This is the default.
- If not selected, an email is sent every time an event triggers it. In this case, if ten events trigger the action, the email is sent ten times, even if all those events occurred within a single minute.
Event Clamp Limit
If you have not selected the One Email Per Event checkbox, you might want to limit the display of the events that triggered the action in the email, especially if the potential list of events could be long. The clamp limit is the number of most recent triggering events to be shown in the email. This setting is disabled if One Email Per Event is selected.