Skip to main content

Step 5: Alerting / Monitoring

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 at the bottom of the left-hand sidebar and open the Alert Groups tab. Click + Add alert group and give it the name "Test Alert Group".

Add alert group in Prismatic app

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

Add user to alert group in Prismatic app

Add an alert monitor to your instance#

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

Add alert monitor in Prismatic app

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

Under the Notifications card, in the Receivers field, select the "Test Alert Group" you created above and click the Save button in the upper right.

Add alert group to alert monitor in Prismatic app

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 Explore > Instances on the left-hand sidebar and selecting your instance. Click Deploy to deploy the latest published integration to your instance, and then click the Save & 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.

Next up, let's prepare the integration for the integration marketplace.