You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Improvements to status pages docs
* First batch of improvements to status page removing auto-generated gibberish
* List subscribers page, add callout to how we handle limits, some formatting and tweaking
* Fixes after some AI-review
* fix: we actually don't send emails just yet
* Apply suggestions from code review
* Final changes
---------
Co-authored-by: María de Antón <[email protected]>
To set up a status page, select ‘New status page’ on the [Status page overview](https://app.checklyhq.com/status-pages).
7
+
To set up a Status Page, select ‘New status page’ on the [Status page overview](https://app.checklyhq.com/status-pages).
8
8
9
-
1. Begin by selecting a name for your page.
10
-
2. Next, create at least one **card** for your page. Cards define the order and grouping of services on your page. One card can contain one or multiple **services** and will show the average uptime for all the services on the card.
11
-
3. If you haven’t already created a service for your page, you can do so from the `Services` dropdown. [Read more about services here](/communicate/status-pages/overview#services).
12
-
4. Select a subdomain for your page. By default status pages will use the domain `.checkly-status-pages.com` but you can also use your own domain. See [Custom domains](/communicate/status-pages/customization#custom-domains) for details on how to configure this.
13
-
5. When you are happy with your setup, click ‘Create status page.’ You will now see a preview of your page, and below the status page name, you have a link to the public page.
9
+
1. Begin by entering a name for your page.
10
+
2. Next, fill in the first **card title**. Now add or create services in it. Group several **services** on a single card to display the average uptime for all services listed in the card. For example, you can use one card per feature, and aggregate all services associated with the feature into a single card.
11
+
4. Customize the subdomain slug for your page. Status pages use the domain `<slug>.checkly-status-pages.com` by default. See [Custom domains](/communicate/status-pages/customization#custom-domains) for more details on how to use your own domain.
12
+
5. When you are happy with your setup, click ‘Create status page.’ You will now see a preview of your page, and a link to the public version of the page below the title.
14
13
15
-
You can now share the link to your status page, and your users can subscribe to receive notifications when incidents are posted.
16
-
17
-
### Service Creation and Management
18
-
19
-
Create services that align with how your users think about your application:
20
-
21
-
```yaml
22
-
# Good service examples
23
-
Frontend Application:
24
-
- Website loading and navigation
25
-
- User interface responsiveness
26
-
- Client-side functionality
27
-
28
-
API Services:
29
-
- Core API endpoints
30
-
- Authentication services
31
-
- Data processing capabilities
32
-
33
-
Third-party Integrations:
34
-
- Payment processors
35
-
- Email delivery services
36
-
- External data sources
37
-
```
38
-
39
-
<Tip>
40
-
Create services from your users' perspective, not your internal architecture. Users care about "Login" working, not whether your "Auth microservice cluster" is healthy.
41
-
</Tip>
14
+
You can now share the link to your Status Page, and your users can subscribe to receive notifications when incidents are posted!
If your provider is Cloudflare, you also need to disable the proxy on the CNAME, it should always be set to DNS only.
24
+
If your provider is Cloudflare, you must disable the proxy on the CNAME, it should always be set to DNS only.
25
+
</Step>
17
26
18
-
3. Verify you are the owner of the domain by adding a `TXT` record to your DNS. The record can be copied from the status page configuration page after providing a custom domain and saving the page once.
27
+
<Steptitle="Verify domain ownership by adding a TXT record">
28
+
Copy the domain-verification TXT record from the Status Page configuration after you've added your custom domain and save the page.
19
29
20
-
4. Add validation `TXT` record(s). The record can be copied from the status page configuration page after providing a custom domain and saving the page once.
Copy file name to clipboardExpand all lines: communicate/status-pages/incidents.mdx
+12-9Lines changed: 12 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,13 +6,13 @@ sidebarTitle: 'Incidents'
6
6
7
7
Incidents are used to communicate downtime on one or more services. You can open incidents manually as part of your incident management process, or automatically by connecting a check to a service using incident automation.
8
8
9
-
When an incident is posted, a notification will be sent to all users subscribed to the status page, unless you opt out of notifications when creating the incident update.
9
+
When an incident is posted, a notification will be sent to all users subscribed to the Status Page, unless you opt out of notifications when creating the incident update.
10
10
11
11
## Creating an incident
12
12
13
-
Create an incident when you want to communicate downtime or known issues of your services to users via your status page.
13
+
Create an incident when you want to communicate downtime or known issues of your services to users via your Status Page.
14
14
15
-
1. Click ‘Status page’ in the sidebar and open your status page.
15
+
1. Click ‘Status pages’ in the sidebar and open your Status Page.
16
16
2. Click ‘Add incident’ at the top right, or click the fire icon at the bottom of the card that most relates to the incident you're about to create
17
17
3. Enter the name of the incident
18
18
4. Choose the severity of the incident
@@ -22,7 +22,7 @@ Create an incident when you want to communicate downtime or known issues of your
22
22
23
23
6. Write the initial incident update message, and update the status of the incident.
24
24
8. If you want to backfill the incident, select `Use custom date`. See [Backfilling incidents for more information](/communicate/status-pages/incidents#backfilling-an-incident).
25
-
9. Select if you want to notify subscribers of your status page about the incident.
25
+
9. Select if you want to notify subscribers of your Status Page about the incident.
26
26
10. Click ‘Create incident’
27
27
28
28
Your incident will now appear on all status pages that show the selected service(s). If you selected the option to notify subscribers, they will receive the update message by email.
@@ -32,7 +32,7 @@ Your incident will now appear on all status pages that show the selected service
32
32
33
33
## Updating an incident
34
34
35
-
To update an ongoing incident go to the ‘Incidents’ tab on your status page and select the incident to update.
35
+
To update an ongoing incident go to the ‘Incidents’ tab on your Status Page and select the incident to update.
Whenever you post an incident update, Checkly can automatically send email notifications to users subscribed to your status page.
48
+
Whenever you post an incident update, Checkly can automatically send email notifications to users subscribed to your Status Page.
49
49
50
50
Emails are sent out only when an update is first posted. Notifications are not sent again if the incident update is edited.
51
51
@@ -59,21 +59,25 @@ Incident notifications contain information about the incident name, the severity
59
59
60
60
## Subscribing to incident notifications
61
61
62
-
Subscribing to incident notifications is done on your status page. To subscribe, a user needs to enter a valid email address. A verification email will be sent to the registered email, and the user will be ready to receive incident notifications after confirming the subscription.
62
+
Subscribing to incident notifications is done on your Status Page. To subscribe, a user needs to enter a valid email address. A verification email will be sent to the registered email, and the user will be ready to receive incident notifications after confirming the subscription.
63
63
64
64
## Incident automation
65
65
66
66
Incident automation opens incidents automatically whenever a check fails. It works by connecting a check to a service. Multiple checks can be connected to the same service through incident automation. After connecting:
67
67
* When the check fails and triggers an alert, it will also open an incident on the connected service.
68
68
* The incident will be automatically resolved when the check recovers.
69
69
70
+
<Note>
71
+
Incident automation is available on Communicate Team and Enterprise plans. [View pricing](https://checklyhq.com/pricing)
72
+
</Note>
73
+
70
74
1. Open your check from the home dashboard.
71
75
2. Click ‘Edit’ in the check overview page.
72
76
3. For API checks, URL monitors and TCP monitors, click the ‘Incident triggers’ tab. For Browser and Multistep checks, first click ‘Settings’ then ‘Incident automation’.
73
77
4. Check the ‘Enable incident automation’ checkbox.
74
78
5. Fill in the incident name, a first status update and the severity of the incident which will be created upon the check failing.
75
79
6. Select which service the incident should be opened on.
76
-
7. Select if the status page subscribers should be notified when the incident updates are automatically posted.
80
+
7. Select if the Status Page subscribers should be notified when the incident updates are automatically posted.
We recommend to uncheck notifications when backfilling incidents to avoid notifying customers about resolved incidents.
91
94
92
95
If you only want to provide the history of the incident, you can set the first incident update to resolved. This will correctly show the incident as having occurred, but without a duration. If you want to have correct uptime on your service you should post two incident updates, with the timestamps for when the incident started and resolved respectively.
A service represents a functional piece of your application or website, such as landing page, API, support portal etc. You manage your services from the service overview page, accessible in the sidebar.
18
18
19
+
<Note>
20
+
The number of services and subscribers you can have varies by plan. [View pricing](https://checklyhq.com/pricing)
21
+
</Note>
22
+
19
23
When naming a service, use a name that is identifiable for your users, as this is used when sending out incident notifications.
20
24
21
25
Services are what connect checks and status pages. A service can listen to multiple checks and automatically opening incidents whenever one of these checks trigger a check failure alert. [See incident automation for more details](/communicate/status-pages/incidents#incident-automation).
@@ -28,9 +32,9 @@ A service can be used by multiple status pages. When an incident is opened for a
28
32
29
33
### Connecting services and status pages
30
34
31
-
To display a service on a status page, go to the status page editor and open the `Services` dropdown on the card you want to display your service on.
35
+
To display a service on a Status Page, go to the Status Page editor and open the `Services` dropdown on the card you want to display your service on.
32
36
33
-
Select your service from the list and save your status page. The page will now display the selected service.
37
+
Select your service from the list and save your Status Page. The page will now display the selected service.
34
38
35
39
You can also create new services directly from the dropdown by entering a new service name and pressing `Create`.
36
40
@@ -40,22 +44,34 @@ You can display the same service on multiple pages. An incident declared on that
40
44
41
45
Use incident automation to connect a service and a check to automatically open incidents for services based on check alerts. [See Incident automation for details](/communicate/status-pages/incidents#incident-automation).
42
46
43
-
## Status Page Best Practices
44
-
45
-
### Service Organization
46
-
-**User-centric services**: Create services based on user-facing functionality
47
-
-**Logical grouping**: Group related services together for clarity
48
-
-**Clear descriptions**: Use terminology your users understand
49
-
-**Appropriate granularity**: Balance detail with simplicity
50
-
51
-
### Incident Communication
52
-
-**Timely updates**: Provide regular updates during ongoing incidents
53
-
-**Clear messaging**: Use plain language to describe issues and impacts
54
-
-**Proactive communication**: Notify users before they notice problems
55
-
-**Transparent resolution**: Explain what was fixed and preventive measures
56
-
57
-
### Maintenance Planning
58
-
-**Advance notice**: Schedule maintenance announcements with sufficient lead time
59
-
-**Impact assessment**: Clearly communicate which services will be affected
60
-
-**Duration estimates**: Provide realistic timeframes for maintenance windows
61
-
-**Progress updates**: Keep users informed during maintenance activities
47
+
## Best practices for status pages
48
+
49
+
### Service organization
50
+
51
+
Create services that align with how your users think about your application:
52
+
53
+
```yaml
54
+
# Good service examples
55
+
Frontend Application:
56
+
- Website loading and navigation
57
+
- User interface responsiveness
58
+
- Client-side functionality
59
+
60
+
API Services:
61
+
- Core API endpoints
62
+
- Authentication services
63
+
- Data processing capabilities
64
+
65
+
Third-party Integrations:
66
+
- Payment processors
67
+
- Email delivery services
68
+
- External data sources
69
+
```
70
+
71
+
<Tip>
72
+
Create services to match how your users perceive your system, not according to your internal architecture. Users care about "Login" working, not whether your "Auth microservice cluster" is healthy.
73
+
</Tip>
74
+
75
+
### Incident communication
76
+
77
+
When an incident occurs, provide clear updates that explain what's happening and how it affects users. Write in plain language, avoiding technical jargon unless your audience is technical. Update the incident as you learn more about the issue, and close it with an explanation of what was fixed. Where possible, communicate proactively to maximize chances to warn users before they encounter problems themselves.
Enable users to stay informed about service status:
7
+
## Subscribing to incident updates
8
+
Users can choose to be notified about any incident impacting your services by subscribing through your Status Page.
11
9
12
10
<Steps>
13
-
<Steptitle="Subscription Setup">
14
-
Users provide email address for status updates
15
-
</Step>
16
-
17
-
<Steptitle="Email Verification">
18
-
Verification email sent to confirm subscription
11
+
<Steptitle="Subscribing to incident updates">
12
+
To subscribe to notifications, users click the "Get updates" button at the top of the Status Page, and then fill out a form to enter their email address.
19
13
</Step>
20
14
21
-
<Steptitle="Notification Preferences">
22
-
Users can manage notification settings
15
+
<Steptitle="Verify email">
16
+
A verification email is sent to the user's email address to confirm the subscription.
23
17
</Step>
24
18
25
-
<Steptitle="Incident Notifications">
26
-
Automatic emails for incident updates and resolutions
19
+
<Steptitle="Receive incident notifications">
20
+
From that moment on, users with a confirmed subscription will receive emails for incident updates and resolutions. They can choose to unsubscribe from these emails at any time.
27
21
</Step>
28
22
</Steps>
29
23
30
-
### Notification Content Structure
31
-
Status page notifications include comprehensive incident information:
24
+
### Notifications content structure
25
+
Here is an example of a Status Page notifications email:
32
26
33
27
```text
34
28
Subject: [INCIDENT] Payment Processing - Service Disruption
@@ -46,9 +40,17 @@ Incident Details:
46
40
We are actively working to resolve this issue and will provide updates
47
41
as more information becomes available.
48
42
49
-
View status page: https://status.yourcompany.com
43
+
View Status Page: https://status.yourcompany.com
50
44
Unsubscribe: [unsubscribe link]
51
45
52
46
Best regards,
53
47
Your Company Team
54
48
```
49
+
50
+
## How Checkly deals with subscribers limits based on your plan
51
+
52
+
To ensure your users can subscribe to your status page, **extra subscribers will be automatically billed as overages** once you've bought a Communicate Starter or Communicate Team add-on.
53
+
You can monitor your subscribers and overages from [your Checkly account billing page](https://app.checklyhq.com/settings/account/billing).
54
+
55
+
If you have not purchased any Communicate add-on, we will continue accepting new subscribers to your page, yet will only send notifications to the first 250 subscribers. Once you upgrade to get more subscribers, those existing subscribers will start receiving notifications. [View pricing for more details about limits](https://www.checklyhq.com/pricing).
0 commit comments