> ## Documentation Index
> Fetch the complete documentation index at: https://getmonitor.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Monitors

> Learn how to set up uptime monitors for your websites, APIs, and services

## Creating a New Monitor

To create a new monitor, click the **+ New** button in the Monitors sidebar or click **Add monitor** from the monitors list.

<img src="https://mintcdn.com/getmonitor/td41YLWmoRx8W12h/images/product/console.getmonitor.io_en-US_org_fvd0bqahqfj5nnf2d4m5n373_monitors_new_full.png?fit=max&auto=format&n=td41YLWmoRx8W12h&q=85&s=de95726ea079da2033f545985343f818" alt="New Monitor Form" width="1920" height="968" data-path="images/product/console.getmonitor.io_en-US_org_fvd0bqahqfj5nnf2d4m5n373_monitors_new_full.png" />

## Basic Configuration

### Monitor Name

Give your monitor a descriptive name that identifies what you're monitoring.

**Examples:**

* "Production API"
* "Marketing Website"
* "Payment Gateway"
* "Customer Portal"

<Tip>
  Use clear, descriptive names so team members can quickly identify what each monitor checks.
</Tip>

### URL

Enter the full URL you want to monitor, including the protocol (http\:// or https\://).

**Examples:**

* `https://api.example.com/health`
* `https://www.example.com`
* `https://app.example.com/status`

The URL will be checked every minute to verify availability and measure response time.

## Advanced Settings

Click **Advanced Settings** to access additional configuration options.

### Check Type

Choose how you want to monitor your endpoint:

<Tabs>
  <Tab title="Monitor Uptime">
    Checks if your endpoint is accessible and responding. This is the most common monitor type.

    **Best for:**

    * Websites
    * API health checks
    * Service availability monitoring
  </Tab>

  <Tab title="Check for Content">
    Verifies that your endpoint is not only accessible, but also contains specific content.

    **Best for:**

    * Ensuring pages load completely
    * Validating API responses
    * Content verification
  </Tab>
</Tabs>

### Expected Response Code

Select the HTTP status code that indicates a successful request.

**Common Options:**

* **200: OK** - Standard successful response (default)
* **201: Created** - For POST requests that create resources
* **204: No Content** - For successful requests with no response body
* **Other codes** - Select from dropdown for specific requirements

<Note>
  Most monitors should use 200 (OK). Only change this if your endpoint intentionally returns a different success code.
</Note>

### Follow Redirects

Enable this option to have monitors follow HTTP redirects (301, 302, etc.).

**When to enable:**

* ✓ Your URL redirects to another page (e.g., http → https)
* ✓ You want to check the final destination after redirects

**When to disable:**

* ✗ You want to verify the redirect itself works correctly
* ✗ You're testing redirect behavior

<Warning>
  If disabled, redirect responses (301, 302) may be treated as failures unless you set the expected response code accordingly.
</Warning>

### Timeout

Set the maximum time to wait for a response before considering the check failed.

**Available Options:**

* **5 seconds** - For fast, local services
* **15 seconds** - For most web applications
* **30 seconds** - Standard timeout (recommended)
* **60 seconds** - For slower endpoints or complex operations

<Tip>
  Start with 30 seconds. Only increase if you have endpoints that legitimately require longer response times.
</Tip>

### Alert Sensitivity

Configure how many consecutive failures must occur before triggering an alert.

**Purpose:**

* Reduces false alarms from temporary network issues
* Ensures alerts only fire for sustained problems
* Balances early warning with accuracy

**Recommended Settings:**

* **1-2 retries** - Critical services requiring immediate notification
* **3-4 retries** - Most production services (balanced approach)
* **5+ retries** - Services with occasional expected timeouts

## Editing Monitor Settings

You can modify monitor configuration at any time from the monitor's Settings page.

<img src="https://mintcdn.com/getmonitor/td41YLWmoRx8W12h/images/product/console.getmonitor.io_en-US_org_fvd0bqahqfj5nnf2d4m5n373_monitors_h57gelnp2cn3es7jg4x3vwp6_settings.png?fit=max&auto=format&n=td41YLWmoRx8W12h&q=85&s=a1ccf288e26985d2ba36f5603d7040e0" alt="Monitor Settings" width="1920" height="968" data-path="images/product/console.getmonitor.io_en-US_org_fvd0bqahqfj5nnf2d4m5n373_monitors_h57gelnp2cn3es7jg4x3vwp6_settings.png" />

### Updating Configuration

1. Navigate to your monitor in the sidebar
2. Click **Settings**
3. Modify any configuration options
4. Changes are saved automatically

## Configuration Examples

### Example 1: Simple Website Monitor

```
Name: Company Website
URL: https://www.example.com
Check Type: Monitor uptime
Expected Response Code: 200: OK
Follow Redirects: Enabled
Timeout: 30 seconds
Alert Sensitivity: 3 retries
```

### Example 2: API Health Check

```
Name: Production API Health
URL: https://api.example.com/health
Check Type: Monitor uptime
Expected Response Code: 200: OK
Follow Redirects: Disabled
Timeout: 15 seconds
Alert Sensitivity: 2 retries
```

### Example 3: Content Verification

```
Name: Landing Page Content Check
URL: https://www.example.com/landing
Check Type: Check for content
Expected Response Code: 200: OK
Follow Redirects: Enabled
Timeout: 30 seconds
Alert Sensitivity: 4 retries
```

## Best Practices

<AccordionGroup>
  <Accordion title="Monitor Health Check Endpoints">
    Instead of monitoring your homepage, create dedicated `/health` or `/status` endpoints that verify your application is functioning correctly.
  </Accordion>

  <Accordion title="Use HTTPS When Possible">
    Always use `https://` URLs when your service supports it to ensure secure monitoring.
  </Accordion>

  <Accordion title="Set Realistic Timeouts">
    Configure timeouts based on your actual response times. Check your statistics to see typical response times, then set timeouts 2-3x higher.
  </Accordion>

  <Accordion title="Balance Alert Sensitivity">
    Too few retries creates false alarms. Too many delays real alerts. Start with 3-4 retries for most services.
  </Accordion>

  <Accordion title="Test Your Configuration">
    After creating a monitor, wait a few minutes and check the Statistics page to verify it's working correctly.
  </Accordion>
</AccordionGroup>

## What Happens After Creation

Once you create a monitor:

1. **Immediate checks begin** - Your monitor starts checking every minute
2. **Data collection starts** - Statistics and uptime data begin accumulating
3. **Alerts activate** - Configured alert rules begin monitoring for failures
4. **Status page updates** - If linked to a status page, the component reflects monitor status

<Card title="View Monitor Statistics" icon="chart-bar" href="/docs/monitoring/monitor-statistics">
  Learn how to analyze your monitor's performance data
</Card>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Monitor shows as Down immediately">
    **Possible causes:**

    * URL is incorrect or inaccessible
    * Expected response code doesn't match actual response
    * Timeout is too short
    * Redirects are disabled but URL redirects

    **Solution:** Check the Statistics page to see the actual response code and response time.
  </Accordion>

  <Accordion title="Getting too many false alerts">
    **Solution:** Increase alert sensitivity (more retries) to reduce false positives from transient issues.
  </Accordion>

  <Accordion title="Response time seems incorrect">
    **Note:** Response time includes DNS lookup, connection time, and data transfer. This is the total time your users experience.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="View Statistics" icon="chart-line" href="/docs/monitoring/monitor-statistics">
    Analyze performance and uptime metrics
  </Card>

  <Card title="Configure Alerts" icon="bell" href="/docs/monitoring/monitor-alerts">
    Set up notifications for downtime
  </Card>

  <Card title="Add to Status Page" icon="browser" href="/docs/status-pages/components">
    Display monitor status publicly
  </Card>

  <Card title="Monitor Overview" icon="list" href="/docs/monitoring/monitors-overview">
    Back to monitors overview
  </Card>
</CardGroup>
