> For the complete documentation index, see [llms.txt](https://docs.statuspal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.statuspal.io/next/monitoring/connect-checks-to-status-pages.md).

# Connect checks to status pages

Link a monitoring check to a status page service so outages open and resolve incident notices on their own, and show live response times to your visitors.

A monitoring check on its own alerts your team. Connected to a status page, it also keeps your customers informed: when the check goes down, the linked service changes status and an incident notice is published, and when it recovers, both are put back without anyone touching the dashboard.

{% hint style="info" %}
**This creates status page notices, not Incident Management incidents.** A connected check publishes an incident notice on your status page for subscribers. It never declares an Incident Management incident, so no responders are paged, no Slack channel opens, and no runbook runs. To coordinate your internal response, declare an incident yourself.
{% endhint %}

## Automate service status and incident notices

Open a check from **Monitoring → Checks**, choose **Edit check**, and switch on **Status page automation**. Two fields appear:

* **Status page**: the page whose service this check should drive. Only pages you have access to are listed.
* **Service**: the service on that page, shown together with its container, for example "API → EU". If a service sits in several containers, each combination is a separate option, so pick the one this check actually probes.

<figure><img src="https://4089725725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQG79S8GZWmqk3Plak6MO%2Fuploads%2Fgit-blob-aa2a148f61dd340409cf969db1556b1cc77b47dc%2Fmonitoring-check-status-page-automation.png?alt=media" alt="The Status page automation section of the check form, switched on, with StatusPal STG selected as the status page, API → UE selected as the service, and the Display response time chart toggle enabled"><figcaption></figcaption></figure>

Save the check. From now on, the check's up and down periods drive that service.

**When the check goes down**, after failing for longer than its down threshold:

1. An incident notice titled **Automated Incident** is published on the status page with the status **Investigating**, the service marked as **Degraded**, which becomes the service's status, and a first update reading "Incident created by monitoring check."
2. The check's notification recipients receive their alert email as usual.

If an incident notice is already open for that service, no second notice is created and the service keeps the status that notice gave it. The check leaves that notice alone and does not change how the service looks, so a service you marked **Unavailable** by hand stays Unavailable.

**When the check recovers**:

1. The notice the check opened, if it is still open, receives a **Resolved** update reading "Incident resolved by monitoring check."
2. The linked service is set back to **Operational**. If another incident notice affecting it is still open, the service takes the impact that notice gives it instead.

The check only ever resolves its own notice. Notices opened by people, or by another check or automation, stay open with the impact they set, until someone resolves them.

## Notify subscribers

With Status page automation on, switch on **Notify subscribers** to tell your subscribers when the check opens its notice and when it resolves it, the same way as an update you post with **Notify subscribers** ticked. It is off by default: the notice and its updates still appear on the status page, but no email or Slack message goes out, the RSS feed skips them, and your check's notification recipients are the only people alerted.

{% hint style="warning" %}
**Flapping checks can flood your subscribers.** Every time the check goes down and comes back, subscribers get two messages. Tune the down threshold before you switch this on.
{% endhint %}

The automated notice is an ordinary notice. While it is open you can rename it, post your own updates, and adjust the impact from the notices list, and the check will still resolve it when the endpoint comes back. See [Incident, Maintenance & Info Notices](https://docs.statuspal.io/next/status-pages/incident-maintenance-and-info-notices.md) for everything you can do with a notice.

{% hint style="warning" %}
**Tune the down threshold before connecting a check.** Every Down period becomes a notice on your status page. A threshold of 0 publishes an incident on the first failed probe, which turns a single network blip into a published outage. The default of 5 minutes is a sensible starting point. See [Configure checks](https://docs.statuspal.io/next/monitoring/configure-checks.md).
{% endhint %}

There is no status-only mode for checks: a connected check always publishes a notice alongside the status change. If you want status changes without notices, use an incoming webhook automation instead. See [Automate status updates](https://docs.statuspal.io/next/status-pages/automate-status-updates.md).

## Pause during maintenance

With Status page automation on, switch on **Pause during maintenance** to keep the check quiet while you work on its service. While a maintenance that affects the linked service is in its window, from its start time until its end time or until you complete it, the check's results change nothing: no status change, no notice, and no alert email. The check keeps probing, and its results still appear on the check page and in the response time chart.

Nothing happens when the maintenance ends. The check acts again on its next change of state, so if the endpoint is still down when the maintenance ends, no notice opens until the check comes back up and goes down again. Check the service yourself after a maintenance.

## Display response time charts on your status page

With Status page automation on, you can also switch on **Display response time chart**. Switch it on to publish the check's response times on the status page, right below your services. Visitors see the same measurements you see on the check page, averaged across the regions that probe the endpoint.

<figure><img src="https://4089725725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQG79S8GZWmqk3Plak6MO%2Fuploads%2Fgit-blob-b63bf283fa86cd29fe95a5260f48f9a3305c3dd4%2Fstatus-page-response-time-chart.png?alt=media" alt="A response time chart on a status page titled Test Response time, with Day, Week, and Month period switches, an average of 161.28 ms, and a line hovering between 100 and 500 milliseconds over 24 hours"><figcaption></figcaption></figure>

The chart is titled after the check, in the form "*Check name* Response time", so a check named "Test" shows up as "Test Response time". Name checks the way you want customers to read them. Each chart offers **Day**, **Week**, and **Month** views, opens on Day, and shows the average for the selected period in its corner. Periods with no measurements yet display a short "No data available" message instead of an empty chart.

You can switch on the chart for as many connected checks as you like. Each one gets its own chart on the page. Turning the toggle off, or disabling Status page automation, removes the chart immediately while the check keeps running.

The chart reads the same data as the **Response time** panel on the check page, with one difference in the periods offered: the check page goes down to the last hour, the status page chart goes up to a month. See [Understand check results](https://docs.statuspal.io/next/monitoring/understand-check-results.md) for how the measurements are taken.
