Skip to main content

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.

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.
DetailDefault
Check intervalEvery 5 minutes
HTTP methodHEAD
Expected status200
Timeout10 seconds
Failure threshold2 consecutive failures before alert

​
Enabling Uptime Monitoring

1

Open your app settings

Go to your app in Stardeck and open the Settings page.
2

Click the Uptime tab

Select the Uptime tab to view and manage your monitors.
3

Create a monitor

Click Add Monitor, enter the URL you want to track, give it a name, and save.
If you don’t see the Uptime tab, it may not be available on your current plan. Contact support for help.

​
Ask the Agent to Set It Up

You can also ask the Stardeck 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.
Creating, updating, and deleting monitors requires Agent mode. In Chat, Plan, and Design modes the agent can only list your existing monitors.

​
Notifications

When a monitor detects downtime, Stardeck can notify you by email. You control this per monitor:
SettingWhat it does
Notify on downSends an email when the monitor goes down
Notify on recoverySends an email when the monitor comes back up
Notification emailsWho 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:
SettingOptionsDefault
HTTP methodHEAD or GETHEAD
Expected status codesAny valid HTTP status200
Timeout1-30 seconds10s
Failure threshold1-10 consecutive fails2

​
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).