How to Send Discord Notifications

Resoto constantly monitors your infrastructure, and can alert you to any detected issues.

One way to receive these alerts is via Discord. In this guide, we will configure Resoto to send alerts to a Discord text channel.

Prerequisites

This guide assumes that you have already installed and configured Resoto to collect your cloud resources.

You will also need the Manage Webhooks permission for the target text channel in your Discord server.

Directions

1. Create a webhook in your Discord server. Be sure to select the channel to which you want Resoto to send alerts.

   tip

   Customize the webhook name and avatar to make it easier to distinguish multiple webhooks for different alerts or services.

2. Install the discord Infrastructure App using the app install command:

   > app install discord

3. Define search criteria for which to trigger an alert. For example, let's say we have an account called test-account where instances with more than 4 GB of RAM are not permitted:

   > search is(instance) and instance_memory>4 and /ancestors.account.reported.name==test-account

4. Pipe the result of the search query to the discord app with your desired alert text and Discord webhook URL:

   > search is(instance) and instance_memory>4 and /ancestors.account.reported.name==test-account | discord --title="Large instances found in test-account" --webhook="https://discord.com/api/webhooks/..."

   If the defined condition is currently true, you should see a new message appear in the specified Discord text channel:

   

   tip

   A default webhook URL can be defined in the discord app configuration so that you can simply execute discord --title="...":

   > config edit resoto.apps.discord

5. To automate the alerts, create a job:

   > jobs add --id notify_large_test_instances --wait-for-event post_collect 'search is(instance) and instance_memory>4 and /ancestors.account.reported.name==test-account | discord --title="Large instances found in test-account" --webhook="https://discord.com/api/webhooks/..."'

Further Reading

• Search
• Automation
• Command-Line Interface
• Resoto Infrastructure Apps