Heroku
This document will help you integrate Heroku with Squadcast.
Heroku is a platform as a service (PaaS) that enables developers to build, run and operate applications entirely in the cloud.
Route detailed alerts from Heroku to the right users in Squadcast.
How to integrate Heroku with Squadcast
In Squadcast: Using Heroku as an Alert Source
(1) From the navigation bar on the left, select Services. Pick the applicable Team from the Team-picker on the top. Next, click on Alert Sources for the applicable Service
(2) Search for Heroku from the Alert Source drop-down and copy the Webhook URL
For an Alert Source to turn active (indicated by a green dot - Receiving alerts against the name of the Alert Source in the drop-down), you can either generate a test alert or wait for a real-time alert to be generated by the Alert Source.
An Alert Source is active if there is a recorded incident via that Alert Source for the Service in the last 30 days.
In Heroku: Set up a Webhook for Squadcast
(1) Navigate to the Dashboard page for your application. In the drop-down menu below, select More. You will see an option to View Webhooks that will take you to the Webhooks creation and management interface
(2) Here, click on Create Webhook
(3) Provide a suitable Name for the Webhook, paste the previously copied Webhook URL, select all the checks for which you want to create incidents in Squadcast and click on Add Webhook
This completes the configuration of a Webhook in Heroku for Squadcast!
Supported Entities and Event Types
The below table indicates the Heroku Entities for which this integration would trigger and resolve incidents in Squadcast. If Resolve is mentioned against an Entity, it means the triggered incident in Squadcast will be automatically resolved when Heroku sends a resolve signal for it. For the other Entities, Squadcast users will be notified for the triggered incident. They will have to manually resolve these incidents in Squadcast once the issues are fixed in Heroku.
| Heroku Entities | Squadcast Incident Event Types |
|---|---|
| addon-attachment | Trigger |
| addon | Trigger |
| app | Trigger |
| build | Trigger, Resolve |
| collaborator | Trigger |
| domain | Trigger |
| dyno | Trigger, Resolve |
| formation | Trigger |
| release | Trigger |
| sni-endpoint | Trigger |
| ssl-endpoint | Trigger |
Helpful Links to Heroku’s Documentation
1. You can find more details about Entities and Event Details here
2. You can find more information on setting Webhooks up here