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

# Uptime Monitoring

> Track your site's availability and get alerted when things go down

Stardeck can monitor your live URLs and alert you when something goes wrong. You'll know about outages before your customers do.

## How It Works

Once enabled, Stardeck checks your URLs every **5 minutes**. If a check fails multiple times in a row, it marks the URL as **down** and sends you an alert. When the URL comes back, you get a recovery notification.

| Detail            | Default                             |
| ----------------- | ----------------------------------- |
| Check interval    | Every 5 minutes                     |
| HTTP method       | HEAD                                |
| Expected status   | 200                                 |
| Timeout           | 10 seconds                          |
| Failure threshold | 2 consecutive failures before alert |

## Enabling Uptime Monitoring

<Steps>
  <Step title="Open your app settings">
    Go to your app in Stardeck and open the **Settings** page.
  </Step>

  <Step title="Click the Uptime tab">
    Select the [**Uptime** tab](https://www.stardeck.ai/projects/~/dashboard/observability/uptime)
    to view and manage your monitors.
  </Step>

  <Step title="Create a monitor">
    Click **Add Monitor**, enter the URL you want to track, give it a name, and save.
  </Step>
</Steps>

<Info>
  If you don't see the Uptime tab, it may not be available on your current plan. [Contact
  support](mailto:support@stardeck.ai) for help.
</Info>

## Ask the Agent to Set It Up

You can also ask the Developer Agent to create uptime monitors for you in **Agent mode**. Just describe what you want:

**Monitor your production site**

```
Set up uptime monitoring for https://myapp.com
```

**Monitor an API endpoint**

```
Create an uptime monitor for my API at https://api.myapp.com/health using GET requests
```

**Monitor with custom settings**

```
Add an uptime monitor for https://myapp.com with a 5 second timeout,
notify me at ops@myapp.com when it goes down
```

The agent handles creating the monitor with the right settings. It can also list, update, and delete your existing monitors.

<Note>
  Creating, updating, and deleting monitors requires **Agent mode**. In Chat, Plan, and Design modes
  the agent can only list your existing monitors.
</Note>

## Notifications

When a monitor detects downtime, Stardeck can notify you by email. You control this per monitor:

| Setting             | What it does                                  |
| ------------------- | --------------------------------------------- |
| Notify on down      | Sends an email when the monitor goes down     |
| Notify on recovery  | Sends an email when the monitor comes back up |
| Notification emails | Who gets the alerts                           |

By default, both down and recovery notifications are enabled and sent to your organization's admins.

## Monitor Settings

Each monitor can be customized:

| Setting               | Options                | Default |
| --------------------- | ---------------------- | ------- |
| HTTP method           | HEAD or GET            | HEAD    |
| Expected status codes | Any valid HTTP status  | 200     |
| Timeout               | 1-30 seconds           | 10s     |
| Failure threshold     | 1-10 consecutive fails | 2       |

## Viewing Uptime Data

Open the **Uptime** tab in your app settings to see:

* **Status** for each monitor (up, down, or unknown)
* **Uptime percentage** over 24 hours, 7 days, or 30 days
* **Response time** trends
* **Incident history** with downtime duration

## Uptime Reports

### Downloading a PDF Report

You can download a PDF report of your uptime data from the Uptime tab:

* **All monitors**: Click **Download Report** in the monitor list header to get a summary of all monitors.
* **Single monitor**: Open a monitor's detail view and click **Download Report** for a report on that specific monitor.

Reports include uptime percentage, average response time, and a full incident history for the selected period (7 days or 30 days).

### Scheduled Report Emails

Set up automatic weekly or monthly report emails with PDF attachments:

1. In the Uptime tab, click **Report Schedule**
2. Enable scheduled reports
3. Choose a frequency: **Weekly**, **Monthly**, or **Both**
4. Pick the day of the week (for weekly) or day of the month (for monthly)
5. Add the email addresses that should receive the reports

Reports are sent at 7:00 AM UTC on the scheduled day.

You can also ask the agent to configure this:

```
Set up weekly uptime reports every Monday, send to ops@myapp.com
```

## Pausing a Monitor

If you need to temporarily stop checking a URL (during planned maintenance, for example), you can pause a monitor from the Uptime tab or ask the agent:

```
Pause the uptime monitor for myapp.com
```

Paused monitors won't run checks or send alerts until you resume them.

## Common Questions

### How quickly will I know about an outage?

With the default settings (5-minute interval, 2-failure threshold), you'll be notified within about 10 minutes of an outage starting.

### Can I monitor internal or private URLs?

No. Monitored URLs must be publicly accessible. Private network addresses (localhost, 10.x.x.x, 192.168.x.x, etc.) are blocked to prevent security issues.

### What counts as "down"?

A check fails if the response status code doesn't match your expected codes, the request times out, or there's a connection error. The monitor is marked as down only after the failure threshold is reached (default: 2 consecutive failures).