Step 5: Alerting / Monitoring

What you will accomplish

In this tutorial you will add an alert monitor to the instance you created, so you are emailed in the event that your instance fails to run.

Create an alert group

An alert group is a group of people (their emails and phone numbers) that should be notified in the event that an alert is triggered. In this example, the alert trigger is our instance failing to run.

Click the Settings link on the left-hand sidebar and open the Alert Groups tab. Click +Alert Group and give it the name "Test Alert Group".

Under the Users card of your alert group, select your user from the dropdown.

Add an alert monitor to your instance

Open your instance by clicking the Instances link on the left-hand side and selecting the instance you created in the last step. From your instance page, click the Monitors tab. Click the + Monitor button on the top-right of this page. Name the monitor "My First Monitor", and select the "Execution Failed" trigger.

Once the monitor is created you will find yourself in the monitor's Events tab.

Click the Notifications tab. Under the Groups card, select the "Test Alert Group" group you created above.

Test your alert monitor

Return to your integration in the web app by clicking Integrations on the left-hand sidebar and choosing your integration, and change the Slack webhook URL to a fake one, like https://hooks.slack.com/services/FOO/BAR/BAZ.

Publish your erroneous integration again by clicking the Publish button. Go back to the instance you created by clicking the Instances button on the left-hand side and selecting your instance. Click Deploy to deploy the latest published integration to your instance, and then click the RUN TEST button for your instance.

You should get an email stating that you instance failed to run to completion.

Next steps

Congratulations! You created a fully functioning integration, deployed an instance to a customer, and configured alert monitors to alert your team if something goes wrong.

You are now ready to create your own integrations. Here are a few things we recommend you try next:

Last updated on