root
/
grafana
mirror of https://github.com/grafana/grafana.git
1
0
Fork 0
Code Issues Actions 137 Packages Projects Releases Wiki Activity
grafana/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-email.md

4.7 KiB
Raw Blame History

canonical description keywords labels menuTitle title weight refs
https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/configure-email/ Configure email integration to send email notifications when your alerts are firing
grafana
alerting
email
integration
products
cloud
enterprise
oss
Email Configure email for alert notifications 110
configure-contact-points notification-templates
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/manage-contact-points/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/template-notifications/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/template-notifications/

Configure email for alert notifications

Use the email integration to send alert notifications to one or more addresses.

You can customize the subject and main section of the email body. By default, the subject and body are generated from the alert data included in the notification.

Before you begin

In Grafana OSS, you must configure SMTP settings before you can enable email notifications.

{{}} In Grafana Cloud, SMTP configuration is not required. {{}}

  1. Open the configuration file. The file is typically named grafana.ini or custom.ini and located in the conf directory of your Grafana installation.

  2. Configure the SMTP settings for your email server in the [smtp] section.

  3. Save your changes and restart Grafana.

  4. Test email notifications by creating a contact point.

Configure Email for a contact point

To create a contact point with a email integration, complete the following steps.

  1. Navigate to Alerts & IRM -> Alerting -> Contact points.
  2. Click + Create contact point.
  3. Enter a name for the contact point.
  4. From the Integration list, select Email.
  5. Set up the required settings for your Email configuration.
  6. Click Save contact point.

For more details on contact points, including how to test them and enable notifications, refer to Configure contact points.

Email settings

Option Description
Addresses The list of email addresses to send the notifications. Email addresses are case sensitive.

Optional settings

Option Description
Single email Send a single email to all email addresses rather than individual emails.

Optional settings using templates

{{}} You can customize the email subject and main section of the email body, but you can't edit HTML or CSS for visual changes.

In Grafana OSS and Enterprise, you can edit the full email template. However, this is not officially supported because it's an internal API that may change without prior notice. {{}}

Option Description
Subject Sets the email subject, replacing the default template. Supports notification templates.
Message Sets the main section of the email body, replacing the default template. Supports notification templates.

{{< figure src="/media/docs/alerting/custom-email-message5.png" caption="Email notification with custom message." max-width="750px" >}}

Optional notification settings

Option Description
Disable resolved message Enable this option to prevent notifications when an alert resolves.