> ## Documentation Index
> Fetch the complete documentation index at: https://checkly-422f444a-mda-troubleshooting-section.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# URL Monitor Configuration

> Configure your URL monitor to ensure your HTTP-based services are always available.

### Basic Setup

Monitor public URLs by specifying the endpoint you want to track.

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-entry.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=4b7f822ec17d95dcd045102770ece97a" alt="URL monitor setup interface showing IP family selection, URL input field, Skip SSL, Follow redirects and Should fail option" width="2518" height="388" data-path="images/url-monitor-entry.png" />
</Frame>

* **Request method:** Always GET.
* **URL:** The HTTP(S) URL to monitor (e.g. [https://api.example.com](https://api.example.com)).
* **IP family:** Defaults to IPv4.
* **Follow redirects:** Automatically follow 30x redirects.
* **Skip SSL:** Skip SSL certificate validation.
* **This request should fail:** Treat HTTP error codes (4xx and 5xx) as passed. Please note that successful responses still pass. Only failed assertions will cause the check to fail.

### Assertions

Use assertions to validate the status code of your URL request. When one or more assertions fail, an alert is triggered:

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-assertions.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=f43da87874b9dc9291a3685d70c5f5d5" alt="URL monitor assertions interface showing status code configuration" width="2376" height="440" data-path="images/url-monitor-assertions.png" />
</Frame>

For more details, see our documentation on [Assertions](/detect/assertions).

### Response Time Limits

Set performance thresholds to ensure your application meets speed requirements:

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-response-times.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=7684a1a44f3a1fb1698b4fb371474d9e" alt="URL monitor response time limits interface showing degraded and failed thresholds" width="2394" height="500" data-path="images/url-monitor-response-times.png" />
</Frame>

**Degraded After**: Time threshold (in milliseconds) after which the check is marked as degraded but not failed. Use for performance warnings without triggering failure alerts.

**Failed After**: Time threshold after which the check fails completely. Use for hard performance limits where slow responses should trigger alerts.

### Frequency

Determine how often your monitors run.

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-frequency.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=82db2019ad2cde59d87988c6105c88ec" alt="URL monitor frequency selection interface showing available check intervals" width="1580" height="366" data-path="images/url-monitor-frequency.png" />
</Frame>

Choose a frequency that balances monitoring coverage with resource usage. Higher frequencies provide faster detection but may not be necessary for all services.

### Scheduling Strategy

Choose when and how your checks run across multiple locations:

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-scheduling.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=b35513df51e33921227eced6e9d0de92" alt="URL monitor scheduling strategy interface showing round robin vs fixed schedule options" width="2380" height="356" data-path="images/url-monitor-scheduling.png" />
</Frame>

**Round Robin** (Default): Checks run on one of the selected locations each time it is scheduled.

**Parallel**: Checks run from all selected locations simultaneously. Higher consumption but provides immediate global visibility for critical services.

### Locations

Select from Checkly's global monitoring locations to test your URLs from different regions:

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-locations.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=023f75a3b2e4fb680ff0d0c94989097f" alt="URL monitor locations selection interface showing global monitoring locations" width="2360" height="1386" data-path="images/url-monitor-locations.png" />
</Frame>

We recommend to chose at least 2-3 locations that best represent your user base for optimal monitoring coverage.

See [Locations](/concepts/locations) for the complete list of available regions and guidance on location selection.

<Info>
  **Private Locations**: Run checks from your own infrastructure to monitor internal applications, check services behind firewalls, or maintain data residency compliance. [Set up Private Locations →](/detect/private-locations/overview)
</Info>

### Retries

Select the retry strategy to determine how failed checks are retried:

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-retries.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=475da0974d0c22a7290a4cc6b277d064" alt="URL monitor retries interface showing retry strategy options" width="1287" height="245" data-path="images/url-monitor-retries.png" />
</Frame>

| Strategy        | Description                                                                              |
| --------------- | ---------------------------------------------------------------------------------------- |
| **None**        | No retries - fail immediately on first failure for fastest detection                     |
| **Single**      | Retry once after failure with configurable delay                                         |
| **Fixed**       | Retry a specific number of times with consistent intervals between attempts              |
| **Linear**      | Increase retry delay linearly with each attempt to avoid overwhelming failed services    |
| **Exponential** | Double the retry delay with each attempt for maximum protection against service overload |

### Alert Settings

Configure notifications for your team:

<Frame>
  <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/zdTA41lFVeJ0Tste/images/url-monitor-alert.png?fit=max&auto=format&n=zdTA41lFVeJ0Tste&q=85&s=3889efa490a09bf0866b5b9646dc9e7c" alt="URL monitor alert settings interface showing notification configuration options" width="2446" height="1372" data-path="images/url-monitor-alert.png" />
</Frame>

#### Notification Scope

Choose how alerts are configured for this monitor:

| Option                                       | Description                                                        |
| -------------------------------------------- | ------------------------------------------------------------------ |
| **Use global account notification settings** | Inherit notification preferences from Global Notification Settings |
| **Use specific notification settings**       | Configure alert behavior exclusively for this check                |

#### Escalation Rules

Control when alerts are triggered:

**Primary Trigger** (Choose one):

* **When a check has failed X time(s)**: Sends alert after specified consecutive failures
* **When a check is failing for more than Y minutes**: Sends alert if failure duration exceeds threshold

**Additional Condition** (Optional):

* **When a check is failing in Z% of locations**: Only applies to checks running in parallel across multiple locations

#### Reminders

Configure follow-up alerts after initial failure notification:

| Setting               | Description                                            |
| --------------------- | ------------------------------------------------------ |
| **Maximum reminders** | Number of follow-up alerts (0 = no reminders)          |
| **Reminder interval** | Time between reminders (only if maximum reminders > 0) |

#### Alert Channels

Define where notifications are sent when checks fail or recover. Additional channels can be configured in global notification settings.

**Alert Types** (per channel):

* ✅ **Success/Recovery**: Check has recovered from failure
* ⚠ **Degraded**: Check is degraded but not failed
* ❌ **Failure**: Check has failed

<Note>
  **Global Alert Settings**: By default, monitors inherit your account's notification preferences. Select "Use specific notification settings" to customize alerts for individual monitors.
</Note>
