Introduction
Statuspage is the one of the top status and incident communication tool, and helps keep customers and employees informed during downtime to build trust and cut support costs. It supports collecting and reporting on performance metrics metrics to show performance trends over time, which is a great way to build trust and transparency around your organization and ensure that your page is doing work for you each day. This integration enables you to submit performance data from Catchpoint into Statuspage.
Prerequisites
- Statuspage admin account.
- Catchpoint test with Test Data Webhook enabled.
Installation & Configuration
Configuration in Statuspage – Create Metric:
- Log in to Statuspage.
- Click on Your page.
- Click on System metrics.
- Click Add a metric to create a new one.
- Choose Data source as I’ll submit my own data from this metric.
- Enter the metric name as Display name.
- Input the appropriate type of units in the Display Suffix field (e.g. ms, bytes, score).

- Click Add metrics to save the changes.
- Statuspage displays a script you can use to make a
POSTrequest submitting data for the newly created metric. Make a note of this script; it contains your page_id and metric_id, which you will use to post data from Catchpoint.
Configuration in Statuspage – Create API Key:
- In Statuspage, click on your profile icon at the lower left of the screen.
- Click on API info.
- If you don’t have an API key already created, then click on Create key.
- Provide an API key name.
- Click Confirm.
- Copy the API key so that we can use it to configure in Catchpoint portal.
Configuration in Catchpoint Portal – Test Data Webhook:
- Log in the Catchpoint Portal, then go to Settings > API.
- Click Add URL.
- Enter a Name.
- Enter URL, the endpoint where the alert data will be posted, using the following syntax (replace
<page_id>and<metric_id>with the values captured from Statuspage):
https://api.statuspage.io/v1/pages/<page_id>/metrics/<metric_id>/data.json - Select Template under Format.
- Click Add New, to create a new template.
- Enter a template Name.
- Paste the below sample template:
{
"data":
{
"timestamp": ${TimestAmpEpoch},
"value": ${TimingVisuallyCompleteTime}
}
}
- Click Save.
- Select the newly created template.
- Add an email address to On Failure Alert.
- Expand Request.
- Click Add API Request Headers.
- Add Header field with a key of “Authorization” and value of “OAuth <Statuspage_API_Key>” (replacing
<statuspage_API_Key>with the key value captured from Statuspage). - Click Save.
Note:
- The Test Data Webhook option must be enabled in the properties of each test that you want to send metrics to Statuspage.
- Once the metric value is sent to Statuspage, set the metrics status as active.
- Based on the use case, use choose the metric macro that meets your requirement.
- One metric can be sent at a time.
Results
Metrics in Statuspage can be viewed in the metrics panel.
