Notification channels

To aid the automatic failure detection feature, Dashbird allows integrations with several notification channels. Notification channels currently supported by Dashbird include:

  1. Email.
  2. Slack.
  3. Amazon SNS.
  4. Webhooks.

For each notification channel that has been integrated, Dashbird will send out notifications for alerts and alarms violations in case something goes wrong.

Setting up a notification channel is fairly easy to do so.

Setting up Email notifications

When you create a Dashbird account, the email used for signup is automatically added up a notification channel to send alerts to. You can add additional email addresses as notification channels

  • Go to settings and click on Notifications under the Account section.

set up dasbhird email notifications

  • Click on Connect notification channel and select E-mail

dashbird email notifications

  • Now provide the email address to be added as a notification channel and click on save. The new email address has been added as a notification channel.

dashbird email alerts

Setting up Slack notifications

To set up Slack as a notification.

  • Go to settings and click on Notifications under the Account section.

dashbird slack notifications

  • Click on Connect notification channel and select Slack.
  • Now click on Add to Slack. You’ll be redirected to Slack integrations.
  • Follow the on-screen instructions, review the information slack will be able to access and select the slack channel where notifications are to be sent and then click Allow. Slack will now be added as a notification channel.

dashbird slack integration

Setting up Amazon SNS notifications

To add Amazon SNS as a notification channel:

  • Go to settings and click on Notifications under the Account section.
  • Now click on Connect notification channel and select AWS SNS.
  • To add AWS SNS as a notification channel we need to provide the SNS topic ARN for the topic we want to publish the notifications. This can be found in the AWS Console on the SNS service.

add dashbird sns

We also need to add a topic access policy that allows Dashbird to publish to the provided SNS topic. To do so, go to the SNS console and select the SNS topic that we want to integrate.

sns alerts dashbird

  • Click on Edit and under the Access policy tab, add the auto-generated policy by Dashbird. Make sure to change the Resource object in the generated policy with the ARN of SNS topic.
  • Click Save changes.

set up sns dashbird

Once ARN is added save changes in Dashbird and SNS topic is now added as a notification channel.

dashbird sns

Setting up Webhook notifications

Webhooks are a great way to integrate systems with Dashbird. As soon as a critical event occurs, Dashbird will send out alerts to the Webhook destination. Setting up webhooks in Dashbird is fairly easy

  • Just provide a name for the webhook channel and your webhook endpoint URI and save changes. The webhook is added as a notification channel and can now be used to set up policies.

To set up notification channels, open the organization menu (from the top right corner), and click on “Notification settings”.

dashbirs webhooks

Dashbird signs webhook requests with x-dashbird-signature header so you can verify that requests are sent by us. Verifying requests can be done by

  • concatenating the endpoint URI (in the same exact way you configured it in Dashbird) and request body 
  • performing a SHA-256 digest on the string 
  • generating a hex representation 
  • comparing the result to x-dashbird-signature request header.

Here’s an example NodeJS pseudocode to generate a signature:

const crypto = require('crypto')
const signature = crypto.createHmac('sha256', webhookSecret)
    .update(requestURL)
    .update(requestBody)
    .digest('hex')

 

Can’t find what you’re looking for? We’d love to help. Send us a message through the chat bubble or email us.

 

No results found