Metrics

Publish custom performance metrics to your status page and display them as charts for your customers.

Statuspal lets you publish custom metrics to your status page and display them as line charts. Metrics can represent anything in your system — response times, error rates, throughput, or any other time-series value.

Example custom metric chart

Create a custom metric

1. In your status page's dashboard, click Metrics, then New Metric.

2. Select Custom Metric from the Source dropdown.

3. Fill in the fields:

   • Title — Displayed at the top of the chart.

   • Unit — Displayed next to values and the average (e.g. ms, %, req/s).

4. Check Enabled and Visible, then click Submit.

Once created, Statuspal shows you the API endpoint and format for pushing data to this metric.

API data push instructions

Push data via API

Each data entry requires two fields:

• timestamp — UNIX timestamp (seconds)

• value — Decimal number

Example using cURL (replace YOUR_API_KEY, STATUS_PAGE_SUBDOMAIN, and METRIC_ID with your values):

curl -X POST "https://statuspal.io/api/v2/status_pages/STATUS_PAGE_SUBDOMAIN/metrics/METRIC_ID/data_points" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"timestamp": 1700000000, "value": 42.5}'

Data points appear on the chart as you push them. Use the cURL example shown on the metric's page in the dashboard to run a quick test.