System metrics are a great way to build trust and transparency around your organization and ensure that your page is doing work for you each and every day. Submitting data for a custom metric is as easy as sending a POST request with the timestamp and value of the data point. Take note that there are a couple of constraints and considerations when submitting data:

  • At a minimum, one data point must be submitted every 5 minutes. If there is a lag in data, the gap will be reflected on the charts for the “Day” view.
  • Each data point is cast to its nearest 30s interval, giving us a maximum of 10 data points per 5 minute period. Submitting multiple data points near each other will result in the last data point being the only one stored.
  • The timestamp value returned in the body of the response will be the casted timestamp used to store your data.
  • Data can, and should, be backfilled up to 28 days in the past.

Statuspage believes strongly that transparency should be a virtue that all companies embrace. The benefits are numerous, and include things like increasing customer trust, winning prospective customers, and deflecting possible inbound support requests if customers can self-diagnose issues.

Example metrics

Example custom metrics that we feel embody good transparency and give a lot of value to the user include:

  • API response time
  • Web server uptime
  • Average time an outbound request sits on a queue
  • Max time an incoming piece of data sits on a queue before ingested
  • Average time before first reply on customer support requests
  • Current exception rate of all requests

Adding A Metric Using Third-Party Data Sources

Here's a video detailing how to use a metrics provider to add a metric to your page.

Specific Third-Party Provider Integration Guides

Adding A Metric By Sending Us Data Via The API

You can now send add metrics to your page by sending us data via the API. Below is a video detailing how to do this.


Audience-specific page metrics

If you're using an audience-specific page, you can choose what visibility users and groups have into metrics. This is similar to how you choose the visibility of components for different users and groups.