This page provides an overview of email templates in AppDynamics. Email templates are optional for email notification actions.
You must have account-level Configure Email Templates permission to create an email template. See Alert and Respond.
Access Email Templates
Although the configuration settings are self-explanatory, some template configuration features and options require additional information.
- Click Alert & Respond > Email Templates.
- Click an existing template to view, edit, or delete it or lick 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.
The template uses Apache Velocity version 1.7 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. AppDynamics recommends 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
instead of background
for HTML email templates.
For-each loops are supported. See Predefined Templating Variables.
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.
Test Email Template
After you save the email template, you can test the template by sending an email.