From 6a3a03c5b4089285ebe18aa87734383c48e85621 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:10:26 +0100 Subject: [PATCH 1/9] Incident management tweaks Some copy tweaks on incident management for clarity --- communicate/status-pages/incidents.mdx | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index 2d985f34..97ae36d4 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -13,20 +13,19 @@ When an incident is posted, a notification will be sent to all users subscribed Create an incident when you want to communicate downtime or known issues of your services to users via your status page. 1. Click ‘Status page’ in the sidebar and open your status page. -2. Click ‘Add incident’ +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 3. Enter the name of the incident -4. Select the severity of the incident +4. Choose the severity of the incident 5. Select which services are impacted in the dropdown list. > Note that incidents will be posted on all status pages where a service is present. [See Services for more details](/communicate/status-pages/overview#services). -6. Provide an incident update message. -7. Select the status of the incident. +6. Compose the initial incident update message, and adjust the status of the incident. 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). 9. Select if you want to notify subscribers of your status page about the incident. 10. Click ‘Create incident’ -Your incident will now appear on all status pages that show the selected service(s). +Your incident will now appear on all status pages that show the selected service(s). If you ticked the option to notify subscribers, they will receive the update message by email. > All times on status pages are displayed in UTC. @@ -37,8 +36,11 @@ To update an ongoing incident go to the ‘Incidents’ tab on your status page ![Incidents view](/images/docs/images/status-pages/status-pages-incidents-1.png) - -Here you can post a new status update for the incident, or you can edit existing updates. You can also edit the impacted services or the incident severity, and delete the incident. +From there, you can: + * post a new status update for the incident, + * edit existing updates, + * change the impacted services or incident severity, + * or delete the incident entirely. ## Incident notifications @@ -56,7 +58,7 @@ Incident notifications contain information about the incident name, the severity ## Subscribing to incident notifications -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 only after confirming the subscription will the user start receiving incident notifications. +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. ## Incident automation @@ -66,11 +68,11 @@ Incident automation works by connecting a check to a service. When the check fai 1. Open your check from the home dashboard. 2. Click ‘Edit’ in the check overview page. -3. For API checks, URL monitors and TCP monitors, click the ‘Incident triggers’ tab. For Browser and Multistep checks, first click ‘Settings’ then ‘Incident triggers’. +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’. 4. Check the ‘Enable incident automation’ checkbox. -5. Fill in the incident name, a first status update and the severity of the incident. +5. Fill in the incident name, a first status update and the severity of the incident which will be created upon the check failing. 6. Select which service the incident should be opened on. -7. Select if the status page subscribers should be notified when the automatic incident updates are posted. +7. Select if the status page subscribers should be notified when the incident updates are automatically posted. 8. Save your check. ![Incident automation](/images/docs/images/status-pages/status-pages-incident-automation-1.png) @@ -86,4 +88,4 @@ To backfill an incident, follow the steps 1 - 7 in the [Creating an incident](/c We recommend to uncheck notifications when backfilling incidents to avoid notifying customers about resolved incidents. -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. \ No newline at end of file +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. From f72f3f237b2904bbf1dbb2eab4bfede5e9ffa886 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:12:34 +0100 Subject: [PATCH 2/9] nit fix --- communicate/status-pages/incidents.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index 97ae36d4..d9dc9d2c 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -39,7 +39,8 @@ To update an ongoing incident go to the ‘Incidents’ tab on your status page From there, you can: * post a new status update for the incident, * edit existing updates, - * change the impacted services or incident severity, + * change the impacted services, + * change the incident severity, * or delete the incident entirely. ## Incident notifications From e69da182d270dacc5bf4c465b9a0f9151072998c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:14:22 +0100 Subject: [PATCH 3/9] nit subtitle --- communicate/status-pages/incidents.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index d9dc9d2c..7a2b7d06 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -1,6 +1,6 @@ --- title: 'Incident Management' -description: 'Comprehensive guide to creating, managing, and automating incidents on Checkly status pages including subscriber notifications and backfilling capabilities.' +description: 'Comprehensive guide to creating, managing, and automating incidents on Checkly status pages including subscriber notifications and incident backfilling capabilities.' sidebarTitle: 'Incidents' --- From 30ac3eb731eb1112725fc8bb464a3a4231c708d2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:15:40 +0100 Subject: [PATCH 4/9] nit formatting bullets --- communicate/status-pages/incidents.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index 7a2b7d06..4722d3e3 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -37,11 +37,11 @@ To update an ongoing incident go to the ‘Incidents’ tab on your status page ![Incidents view](/images/docs/images/status-pages/status-pages-incidents-1.png) From there, you can: - * post a new status update for the incident, - * edit existing updates, - * change the impacted services, - * change the incident severity, - * or delete the incident entirely. + * Post a new status update for the incident + * Edit existing updates + * Change the impacted services + * Change the incident severity + * Delete the incident entirely ## Incident notifications From 2d4e7a12c9673b0cd89188a88757edaa37e0b522 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:17:50 +0100 Subject: [PATCH 5/9] simplify incident automation opening --- communicate/status-pages/incidents.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index 4722d3e3..20ddf3ac 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -63,9 +63,7 @@ Subscribing to incident notifications is done on your status page. To subscribe, ## Incident automation -Automatically open incidents whenever a check would alert with incident automation. The incident will be automatically resolved when the check recovers. - -Incident automation works by connecting a check to a service. When the check fails and triggers an alert it will also open an incident on the connected service. Multiple checks can be connected to the same service through incident automation. +Incident automation allows to automatically open incidents whenever a check fails. It works by connecting a check to a service. When the check fails and triggers an alert it will also open an incident on the connected service. Multiple checks can be connected to the same service through incident automation. The incident will be automatically resolved when the check recovers. 1. Open your check from the home dashboard. 2. Click ‘Edit’ in the check overview page. From 738bce68ac81d3e8a86bb46bc6e9406e36dc35e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:59:30 +0100 Subject: [PATCH 6/9] Update communicate/status-pages/incidents.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: María de Antón --- communicate/status-pages/incidents.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index 20ddf3ac..f18a226d 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -25,7 +25,7 @@ Create an incident when you want to communicate downtime or known issues of your 9. Select if you want to notify subscribers of your status page about the incident. 10. Click ‘Create incident’ -Your incident will now appear on all status pages that show the selected service(s). If you ticked the option to notify subscribers, they will receive the update message by email. +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. > All times on status pages are displayed in UTC. From 5cd4b57255473a0c1cb62a93f907b7bc5600e664 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 12:00:07 +0100 Subject: [PATCH 7/9] Update communicate/status-pages/incidents.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: María de Antón --- communicate/status-pages/incidents.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index f18a226d..5de4a7ba 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -1,6 +1,6 @@ --- title: 'Incident Management' -description: 'Comprehensive guide to creating, managing, and automating incidents on Checkly status pages including subscriber notifications and incident backfilling capabilities.' +description: 'Guide to creating, managing, and automating incidents on Checkly status pages including subscriber notifications and incident backfilling capabilities.' sidebarTitle: 'Incidents' --- From 92c91127eaa2b94ce452cde1961f8c3eed4d22cc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 12:00:27 +0100 Subject: [PATCH 8/9] Update communicate/status-pages/incidents.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: María de Antón --- communicate/status-pages/incidents.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index 5de4a7ba..4427793e 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -63,7 +63,9 @@ Subscribing to incident notifications is done on your status page. To subscribe, ## Incident automation -Incident automation allows to automatically open incidents whenever a check fails. It works by connecting a check to a service. When the check fails and triggers an alert it will also open an incident on the connected service. Multiple checks can be connected to the same service through incident automation. The incident will be automatically resolved when the check recovers. +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: +* When the check fails and triggers an alert, it will also open an incident on the connected service. +* The incident will be automatically resolved when the check recovers. 1. Open your check from the home dashboard. 2. Click ‘Edit’ in the check overview page. From 35090dce7bf346cc164d4892d8f83aab98c6d8e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Herv=C3=A9=20Labas?= <431257+thebiglabasky@users.noreply.github.com> Date: Tue, 25 Nov 2025 12:00:42 +0100 Subject: [PATCH 9/9] Update communicate/status-pages/incidents.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: María de Antón --- communicate/status-pages/incidents.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communicate/status-pages/incidents.mdx b/communicate/status-pages/incidents.mdx index 4427793e..cfc4c78d 100644 --- a/communicate/status-pages/incidents.mdx +++ b/communicate/status-pages/incidents.mdx @@ -20,7 +20,7 @@ Create an incident when you want to communicate downtime or known issues of your > Note that incidents will be posted on all status pages where a service is present. [See Services for more details](/communicate/status-pages/overview#services). -6. Compose the initial incident update message, and adjust the status of the incident. +6. Write the initial incident update message, and update the status of the incident. 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). 9. Select if you want to notify subscribers of your status page about the incident. 10. Click ‘Create incident’