docs(constructs): add check description property [TREE-735] [show]

ai/rocky-ai.mdx

@@ -5,7 +5,7 @@ sidebarTitle: Rocky AI
 ---
 
 Rocky AI is Checkly's AI agent. Rocky AI can help you automatically determine user impact and root cause on any failing
-check using error messages, code, metrics, traces and logs.
+check using error messages, code, check descriptions, metrics, traces and logs.
 
 ## Rocky AI Capabilities
 ### Root Cause & User Impact Analysis

constructs/api-check.mdx

@@ -90,6 +90,7 @@ The API Check configuration consists of specific API Check options and inherited
 | Property | Type | Required | Default | Description |
 |----------|------|----------|---------|-------------|
 | `name` | `string` | ✅ | - | Friendly name for your check |
+| `description` | `string` | ❌ | `null` | A description of the check. Supports markdown. Max 500 characters |
 | `activated` | `boolean` | ❌ | `true` | Whether the check is enabled |
 | `alertChannels` | `AlertChannel[]` | ❌ | `[]` | Array of AlertChannel objects for notifications |
 | `alertEscalationPolicy` | `AlertEscalationPolicy` | ❌ | - | Advanced alert settings |

constructs/browser-check.mdx

@@ -76,6 +76,7 @@ The Browser Check configuration consists of specific Browser Check options and i
 | Property | Type | Required | Default | Description |
 |----------|------|----------|---------|-------------|
 | `name` | `string` | ✅ | - | Friendly name for your check |
+| `description` | `string` | ❌ | `null` | A description of the check. Supports markdown. Max 500 characters |
 | `activated` | `boolean` | ❌ | `true` | Whether the check is enabled |
 | `alertChannels` | `AlertChannel[]` | ❌ | `[]` | Array of AlertChannel objects for notifications |
 | `alertEscalationPolicy` | `AlertEscalationPolicy` | ❌ | - | Advanced alert settings |

constructs/heartbeat-monitor.mdx

@@ -73,6 +73,7 @@ The Heartbeat Monitoring configuration consists of specific heartbeat monitoring
 | Property | Type | Required | Default | Description |
 |----------|------|----------|---------|-------------|
 | `name` | `string` | ✅ | - | Friendly name for your monitor |
+| `description` | `string` | ❌ | `null` | A description of the monitor. Supports markdown. Max 500 characters |
 | `activated` | `boolean` | ❌ | `true` | Whether the monitor is enabled |
 | `muted` | `boolean` | ❌ | `false` | Whether alert notifications are muted |
 | `alertChannels` | `AlertChannel[]` | ❌ | `[]` | Array of AlertChannel objects for notifications |

constructs/multistep-check.mdx

@@ -74,6 +74,7 @@ new MultiStepCheck("complex-multistep-check", {
 | Property | Type | Required | Default | Description |
 |----------|------|----------|---------|-------------|
 | `name` | `string` | ✅ | - | Friendly name for your check |
+| `description` | `string` | ❌ | `null` | A description of the check. Supports markdown. Max 500 characters |
 | `activated` | `boolean` | ❌ | `true` | Whether the check is enabled |
 | `alertChannels` | `AlertChannel[]` | ❌ | `[]` | Array of AlertChannel objects for notifications |
 | `alertEscalationPolicy` | `AlertEscalationPolicy` | ❌ | - | Advanced alert settings |

constructs/playwright-check.mdx

@@ -73,6 +73,7 @@ The Playwright Check Suite configuration consists of specific Playwright Check S
 | Property | Type | Required | Default | Description |
 |----------|------|----------|---------|-------------|
 | `name` | `string` | ✅ | - | Friendly name for your check |
+| `description` | `string` | ❌ | `null` | A description of the check. Supports markdown. Max 500 characters |
 | `activated` | `boolean` | ❌ | `true` | Whether the check is enabled |
 | `alertChannels` | `AlertChannel[]` | ❌ | `[]` | Array of AlertChannel objects for notifications |
 | `alertEscalationPolicy` | `AlertEscalationPolicy` | ❌ | - | Advanced alert settings |

detect/synthetic-monitoring/api-checks/configuration.mdx

@@ -212,4 +212,12 @@ This list shows all content types that we scrub from the response data.
 |`video/x-ms-wmv`|
 |`video/x-msvideo`|
 |`video/x-flv`|
-|`video/webm`|
+|`video/webm`|
+
+## Additional Settings
+
+* **Name:** Give your check a clear name to identify it in dashboards and alerts
+* **Description:** Add context about what this check does and why it matters. Supports markdown, max 500 characters. When a failure occurs, [Rocky AI](/ai/rocky-ai) uses the description to provide more accurate [root cause and user impact analysis](/resolve/ai-root-cause-analysis/overview)
+* **Tags:** Use tags to organize checks across [dashboards](/communicate/dashboards/overview/) and [maintenance windows](/communicate/maintenance-windows/overview)
+* **Retries:** Define how failed runs should be retried. See [retry strategies](/communicate/alerts/retries)
+* **Alerting:** Configure your [alert settings](/communicate/alerts/configuration), [alert channels](/communicate/alerts/channels), or set up [webhooks](/integrations/alerts/webhooks) for custom integrations

detect/synthetic-monitoring/playwright-checks/configuration.mdx

@@ -90,6 +90,7 @@ Learn more about [best practices to organize and structure your Playwright tests
 A Playwright Check Suite inherits multiple properties from [the abstract `Check` class](/cli/constructs-reference/#check):
 
 - `name`
+- `description`
 - `activated`
 - `muted`
 - `locations`

detect/uptime-monitoring/dns-monitors/configuration.mdx

@@ -323,6 +323,7 @@ Set how often the monitor runs (every 10 seconds to 24 hours):
 ### Additional Settings
 
 * **Name:** Give your monitor a clear name to identify it in dashboards and alerts
+* **Description:** Add context about what this monitor does and why it matters. Supports markdown, max 500 characters. When a failure occurs, [Rocky AI](/ai/rocky-ai) uses the description to provide more accurate [root cause and user impact analysis](/resolve/ai-root-cause-analysis/overview)
 * **Tags:** Use tags to organize monitors across [dashboards](/communicate/dashboards/overview/) and [maintenance windows](/communicate/maintenance-windows/overview)
 * **Retries:** Define how failed runs should be retried. See [retry strategies](/communicate/alerts/retries)
 * **Alerting:** Configure your [alert settings](/communicate/alerts/configuration), [alert channels](/communicate/alerts/channels), or set up [webhooks](/integrations/alerts/webhooks) for custom integrations

detect/uptime-monitoring/heartbeat-monitors/configuration.mdx

@@ -2,4 +2,12 @@
 title: Heartbeat Configuration
 description:  Ensure your critical automated processes are running as expected.
 sidebarTitle: Configuration
----
+---
+
+### Additional Settings
+
+* **Name:** Give your monitor a clear name to identify it in dashboards and alerts
+* **Description:** Add context about what this monitor does and why it matters. Supports markdown, max 500 characters. When a failure occurs, [Rocky AI](/ai/rocky-ai) uses the description to provide more accurate [root cause and user impact analysis](/resolve/ai-root-cause-analysis/overview)
+* **Tags:** Use tags to organize monitors across [dashboards](/communicate/dashboards/overview/) and [maintenance windows](/communicate/maintenance-windows/overview)
+* **Retries:** Define how failed runs should be retried. See [retry strategies](/communicate/alerts/retries)
+* **Alerting:** Configure your [alert settings](/communicate/alerts/configuration), [alert channels](/communicate/alerts/channels), or set up [webhooks](/integrations/alerts/webhooks) for custom integrations

detect/uptime-monitoring/icmp-monitors/configuration.mdx

@@ -101,6 +101,7 @@ Set how often the monitor runs (every 10 seconds to 24 hours):
 ### Additional Settings
 
 * **Name:** Give your monitor a clear name to identify it in dashboards and alerts
+* **Description:** Add context about what this monitor does and why it matters. Supports markdown, max 500 characters. When a failure occurs, [Rocky AI](/ai/rocky-ai) uses the description to provide more accurate [root cause and user impact analysis](/resolve/ai-root-cause-analysis/overview)
 * **Tags:** Use tags to organize monitors across [dashboards](/communicate/dashboards/overview/) and [maintenance windows](/communicate/maintenance-windows/overview)
 * **Retries:** Define how failed runs should be retried. See [retry strategies](/communicate/alerts/retries)
 * **Alerting:** Configure your [alert settings](/communicate/alerts/configuration), [alert channels](/communicate/alerts/channels), or set up [webhooks](/integrations/alerts/webhooks) for custom integrations

detect/uptime-monitoring/tcp-monitors/configuration.mdx

@@ -65,6 +65,7 @@ Set how often the monitor runs (every 10 seconds to 24 hours):
 ### Additional Settings
 
 * **Name:** Give your monitor a clear name to identify it in dashboards and alerts
+* **Description:** Add context about what this monitor does and why it matters. Supports markdown, max 500 characters. When a failure occurs, [Rocky AI](/ai/rocky-ai) uses the description to provide more accurate [root cause and user impact analysis](/resolve/ai-root-cause-analysis/overview)
 * **Tags:** Use tags to organize monitors across dashboards and [maintenance windows](/communicate/maintenance-windows/overview)
 * **Retries:** Define how failed runs should be retried. See [retry strategies](/communicate/alerts/retries)
 * **Alerting:** Configure your [alert settings](/communicate/alerts/configuration), [alert channels](/communicate/alerts/channels), or set up [webhooks](/integrations/alerts/webhooks) for custom integrations

detect/uptime-monitoring/url-monitors/configuration.mdx

@@ -139,6 +139,12 @@ Define where notifications are sent when checks fail or recover. Additional chan
 **Global Alert Settings**: By default, monitors inherit your account's notification preferences. Select "Use specific notification settings" to customize alerts for individual monitors.
 </Note>
 
+### Additional Settings
+
+* **Name:** Give your monitor a clear name to identify it in dashboards and alerts
+* **Description:** Add context about what this monitor does and why it matters. Supports markdown, max 500 characters. When a failure occurs, [Rocky AI](/ai/rocky-ai) uses the description to provide more accurate [root cause and user impact analysis](/resolve/ai-root-cause-analysis/overview)
+* **Tags:** Use tags to organize monitors across [dashboards](/communicate/dashboards/overview/) and [maintenance windows](/communicate/maintenance-windows/overview)
+
 
 
 

integrations/alerts/webhooks.mdx

@@ -44,6 +44,7 @@ You can use the following event-related variables in both URL and payload.
 | `API_CHECK_RESPONSE_STATUS_TEXT` | The response status text, e.g. "OK". Only populated for API checks.                                                                                                                |
 | `CHECK_ERROR_MESSAGE`            | The check error message                                                                                                                                                            |
 | `CHECK_ID`                       | The UUID of the check                                                                                                                                                              |
+| `CHECK_DESCRIPTION`              | The description of the check, if set                                                                                                                                               |
 | `CHECK_NAME`                     | Full name of the check                                                                                                                                                             |
 | `CHECK_RESULT_ID`                | The UUID of the result that triggered this message                                                                                                                                 |
 | `CHECK_TYPE`                     | The check type, e.g. API, BROWSER  .                                                                                                                                               |

quickstarts/api-check.mdx

@@ -10,12 +10,15 @@ Learn more about all the [API Check capabilities](/detect/synthetic-monitoring/a
 
 ![Screenshot of the create API check page](/images/docs/images/api-checks/overview-create-check.png)
 
-### Name and tags
+### Name, tags, and description
 
-A meaningful name will not only help you and others identify your checks within Checkly, but it will help provide a better alerting experience if your checks fall into an alert state.
+* **Name:** A meaningful name helps you and your team quickly identify checks and improves the clarity of alerts when something fails
 
-Tags can relate your checks together. They also determine which checks are shown on your [dashboards](/dashboards/).
+* **Tags:** let you group related checks and control which ones appear on your [dashboards](/dashboards/)
 
+* **Descriptions:** add context about what a check does or why it exists
+
+Together, these fields improve alert clarity and play an important role in incident investigation. [Rocky AI](/resolve/ai-root-cause-analysis/overview) uses this information to provide more accurate root cause and user impact analysis.
 
 ### HTTP request
 

quickstarts/heartbeat-monitor.mdx

@@ -34,7 +34,7 @@ Before creating your heartbeat monitor, make sure you have:
 
 ## Step 1: Basic Configuration
 
-Start by giving your monitor a descriptive name and relevant tags. Choose something descriptive that clearly identifies what the monitor is tracking, like "Nightly Database Backup" or "Weekly Reports Job".
+Start by giving your monitor a descriptive name and relevant tags and description. Choose something descriptive that clearly identifies what the monitor is tracking, like "Nightly Database Backup" or "Weekly Reports Job".
 
 Use tags to group related monitors and make them easier to find and manage.
 

quickstarts/multistep-check.mdx

@@ -18,11 +18,15 @@ You'll need a series of API endpoints that work together to complete a business
 ![Multistep check edit page](/images/docs/images/multistep-api-checks/create-multistep-check.png)
 </Frame>
 
-### Name and tags
+### Name, tags, and description
 
-A meaningful name will not only help you and others identify your checks within Checkly, but it will help provide a better alerting experience if your checks fall into an alert state.
+* **Name:** a meaningful name will not only help you and others identify your checks within Checkly, but it will help provide a better alerting experience if your checks fall into an alert state
 
-Tags can relate your checks together. They also determine which checks are shown on your [dashboards](/dashboards/).
+* **Tags:** let you relate your checks together. They also determine which checks are shown on your [dashboards](/dashboards/)
+
+* **Descriptions:** add context about what a check does or why it exists
+
+Together, these fields improve alert clarity and play an important role in incident investigation. [Rocky AI](/resolve/ai-root-cause-analysis/overview) uses this information to provide more accurate root cause and user impact analysis.
 
 ### Playwright script
 

quickstarts/tcp-monitor.mdx

@@ -68,6 +68,7 @@ Set how often the monitor runs (every 10 seconds to 24 hours):
 
 * **Name:** Give your monitor a clear name to identify it in dashboards and alerts
 * **Tags:** Use tags to organize monitors across dashboards and [maintenance windows](/communicate/maintenance-windows/overview)
+* **Description:** A description of the check. Supports Markdown. Maximum length: 500 characters
 * **Retries:** Define how failed runs should be retried. See [retry strategies](/communicate/alerts/retries)
 * **Alerting:** Configure your [alert settings](/communicate/alerts/configuration), [alert channels](/communicate/alerts/channels), or set up [webhooks](/integrations/alerts/webhooks) for custom integrations
 

quickstarts/url-monitor.mdx

@@ -62,6 +62,7 @@ Set how often the monitor runs (every 10 seconds to 24 hours).
 
 * **Name:** Give your monitor a clear name to identify it in dashboards and alerts
 * **Tags:** Use tags to organize monitors across dashboards and [maintenance windows](/communicate/maintenance-windows/overview)
+* **Description:** A short description of the check. Supports Markdown. Maximum length: 500 characters
 * **Retries:** Define how failed runs should be retried. See [retry strategies](/communicate/alerts/retries)
 * **Alerting:** Configure your [alert settings](/communicate/alerts/configuration), [alert channels](/communicate/alerts/channels), or set up [webhooks](/integrations/alerts/webhooks) for custom integrations
 

resolve/ai-root-cause-analysis/overview.mdx

@@ -22,7 +22,7 @@ synthetic checks and / or monitoring checks.
   />
 </Frame>
 
-Using any available artifacts like error message, user code, logs, metrics, trace routes, packet captures, Playwright traces, screenshots
+Using any available artifacts like error message, user code, check description, logs, metrics, trace routes, packet captures, Playwright traces, screenshots
 and other evidence, it will quickly assess what the impact is of a failure and what the underlying (possible) root cause is.
 It will also provide a suggested code fix for any check based on (Playwright) code.
 

snippets/general-monitor-options-table.mdx

@@ -1,6 +1,7 @@
 | Property | Type | Required | Default | Description |
 |----------|------|----------|---------|-------------|
 | `name` | `string` | ✅ | - | Friendly name for your monitor |
+| `description` | `string` | ❌ | `null` | A description of the monitor. Supports markdown. Max 500 characters |
 | `activated` | `boolean` | ❌ | `true` | Whether the monitor is enabled |
 | `alertChannels` | `Array<AlertChannel \| AlertChannelRef>` | ❌ | `[]` | Array of AlertChannel objects for notifications |
 | `alertEscalationPolicy` | `AlertEscalationPolicy` | ❌ | - | Advanced alert escalation settings |