DataIQ 2.2 Admin Guide

Email alerts

Configure DataIQ to send system alerts through email to a system administrator. For example, if the storage management volume is out of capacity, it can alert the administrator that additional storage is needed.

1. From DataIQ, from the Settings tab, select General management > Configure email alerts.
2. Set up your email server info. DataIQ uses the information to send alerts. For example:

   global:
     smtp_smarthost: 'SMTP_SERVER:PORT'
     smtp_from: 'dataiq.alerts@myorganization.org'
     smtp_auth_username: 'USERNAME'
     smtp_auth_identity: 'ID'
     smtp_auth_password: 'PASSWORD'
     smtp_require_tls: false
     resolve_timeout: 5m

   NOTE If your email server does not require authentication, use empty strings for username and password, for example:

   global:
     smtp_smarthost: mailhub.myorganization.org:25
     smtp_from: 'dataiq.alerts@myorganization.org'
     smtp_auth_username: ''
     smtp_auth_identity: 'ID'
     smtp_auth_password: ''
     smtp_require_tls: false
     resolve_timeout: 5m

3. Set up your notification times. You can set up email notifications to send at scheduled times or at regular intervals. You can also set up a nag delay to send additional mail when an alert has not been read or responded to.

   route:
     group_by: ['alertname', 'severity']
     group_wait: 15s
     group_interval: 45s
     repeat_interval: 4h
     receiver: 'default-receivers'
      
       routes:
       - receiver: 'default-receivers'

   • group_by: Groups the alerts, for example, by alert name, severity, or both.
   • group_wait: How long the system waits before sending an alert.
   • group_interval: How often to check for alerts.
   • repeat_interval: If an alert has not been responded to, send another alert after this amount of time.
   • receiver: and routes: receiver: sends mail to recipients in the 'default-receivers' group, which is also defined in this file.
4. Add an email recipient. To add more recipients, add a to: section for each recipient.

   receivers:
   - name: 'default-receivers'
     email_configs:
     - to: 'system_administrator@myorganization.org'
       send_resolved: true
       html: '{{ template "email.default.html" . }}'
     - to: 'dataiq_admin@myorganization.org'
       send_resolved: true
       html: '{{ template "email.default.html" . }}'

   To set up alerts based on tagged data, see Send email alerts to data owners based on tags.

   To set up alerts for storage monitoring, see Add latency alerts.