Skip to main content

Notifications

Notifications are a great way to stay up to date with activities in your warehouse. You can let re_data send you notifications for alerts that occured within a specified date range.

re_data currently supports the following channels for notifications.

Slack​

To send alerts to a slack channel, we make use of incoming webhooks which is a simple way to post messages from apps into Slack.

The steps required to enable incoming webhooks and get started can be found in the slack API docs. Once you have created an incoming webhook successfully, you should see a new entry under Webhook URLs for Your Workspace section, with a Webhook URL that'll look something like this:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

The webhook url can now be used with the re_data notify command as shown below,

re_data notify slack \
--start-date 2021-01-01 \
--end-date 2021-01-31 \
--webhook-url https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX \
--subtitle="[Optional] Markdown text to be added as a subtitle in the slack message generated"

or configure in re_data.yml

~/.re_data/re_data.yml
notifications:
  slack:
    webhook_url: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Below is a sample alert notification message sent by a slack app created.

SlackMessage

By default, the most recent 10 alerts are shown (for each table) and you can generate the Observability UI to show more details relating to alerts.

Email​

Before you can send alerts via email, you need to have configured an email account on the SMTP server you are going to use to send the email.

~/.re_data/re_data.yml
notifications:
  email:
    mail_from: [email protected]
    smtp_host: smtp.sendgrid.net
    smtp_port: 465
    smtp_user: username
    smtp_password: xxxxx
    use_ssl: true
    use_tls: false

If you configure both use_ssl: true & use_tls: true the tls protocol will be used. TLS will enable you to use different mail ports which SSL does not support on some mail servers, eg 587.

Email alerts can now be sent using the command as shown below

re_data notify email \
--start-date 2021-01-01 \
--end-date 2021-01-31
info

Having issues?​

If you have more questions, got stuck anywhere, or something is not working as expected, please let us know on Slack! 😊, we will help you asap, and it will help us improve this quick start guide.