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 on the left-hand sidebar and open the Alert Groups tab. Click +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 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.

Add alert monitor in Prismatic app

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

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

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 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.

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