Setting up email notifications for alerts

If you want email notifications to be sent when alerts occur, you must provide information about your SMTP server. You must also enter email addresses for the recipients of alert notifications.

Before you begin

About this task

Because alarms and alerts are independent systems, the email setup used for alert notifications is not used for alarm notifications and AutoSupport messages. However, you can use the same email server for all notifications.

If your StorageGRID deployment includes multiple Admin Nodes, you can select which Admin Node should be the preferred sender of alert notifications. The same preferred sender is also used for alarm notifications and AutoSupport messages. By default, the primary Admin Node is selected. For details, see the instructions for administering StorageGRID.

Procedure

  1. Select Alerts > Email Setup.
    The Email Setup page appears.
    Alerts Email Setup Disabled
  2. Select the Enable Email Notifications check box to indicate that you want notification emails to be sent when alerts reach configured thresholds.
    The Email (SMTP) Server, Transport Layer Security (TLS), Email Addresses, and Filters sections appear.
  3. In the Email (SMTP) Server section, enter the information StorageGRID needs to access your SMTP server.
    If your SMTP server requires authentication, you must provide both a username and a password. You must also require TLS and provide a CA certificate.
    Field Enter
    Mail Server The fully qualified domain name (FQDN) or IP address of the SMTP server.
    Port The port used to access the SMTP server. Must be between 1 and 65535.
    Username (optional) If your SMTP server requires authentication, enter the username to authenticate with.
    Password (optional) If your SMTP server requires authentication, enter the password to authenticate with.

    Alerts Email SMTP Server
  4. In the Email Addresses section, enter email addresses for the sender and for each recipient.
    1. For the Sender Email Address, specify a valid email address to use as the From address for alert notifications.
      For example: storagegrid-alerts@example.com
    2. In the Recipients section, enter an email address for each email list or person who should receive an email when an alert occurs.
      Click the plus icon plus icon to add recipients.

    Alerts Email Recipients
  5. In the Transport Layer Security (TLS) section, select the Require TLS check box if Transport Layer Security (TLS) is required for communications with the SMTP server.
    1. In the CA Certificate field, provide the CA certificate that will be used to verify the identify of the SMTP server.
      You can copy and paste the contents into this field, or click Browse and select the file.

      You must provide a single file that contains the certificates from each intermediate issuing certificate authority (CA). The file should contain each of the PEM-encoded CA certificate files, concatenated in certificate chain order.

    2. Select the Send Client Certificate check box if your SMTP email server requires email senders to provide client certificates for authentication.
    3. In the Client Certificate field, provide the PEM-encoded client certificate to send to the SMTP server.
      You can copy and paste the contents into this field, or click Browse and select the file.
    4. In the Private Key field, enter the private key for the client certificate in unencrypted PEM encoding.
      You can copy and paste the contents into this field, or click Browse and select the file.
      Note: If you need to edit the email setup, click the pencil icon to update this field.

      Alerts Email TLS
  6. In the Filters section, select which alert severity levels should result in email notifications, unless the rule for a specific alert has been silenced.
    Severity Description
    Minor, major, critical An email notification is sent when the minor, major, or critical condition for an alert rule is met.
    Major, critical An email notification is sent when the major or critical condition for an alert rule is met. Notifications are not sent for minor alerts.
    Critical only An email notification is sent only when the critical condition for an alert rule is met. Notifications are not sent for minor or major alerts.

    Alerts Email Filters10
  7. When you are ready to test your email settings, perform these steps:
    1. Click Send Test Email.
      A confirmation message appears, indicating that a test email was sent.
    2. Check the inboxes of all email recipients and confirm that a test email was received.
      Note: If the email is not received within a few minutes or if the Email notification failure alert is triggered, check your settings and try again.
    3. Sign in to any other Admin Nodes and send a test email to verify connectivity from all sites.
      Note: When you test alert notifications, you must sign in to every Admin Node to verify connectivity. This is in contrast to testing alarm notifications and AutoSupport messages, where all Admin Nodes send the test email.
  8. Click Save.
    Sending a test email does not save your settings. You must click Save.
    The email settings are saved.