Uptime Monitor — Documentation

Everything you need to know about monitoring your websites, understanding your alerts, and getting the most out of your uptime monitoring dashboard.

Getting Started

Once you've signed up and logged in, you'll land on your Dashboard — the command center for all of your monitored websites. From here you can add monitors, check statuses, view incident history, and tweak your notification preferences.

Your plan determines how many monitors you can create, how frequently they're checked, and how many monitoring nodes you can select. You'll see your current usage right on the dashboard so there are never any surprises.

Your Dashboard

The dashboard gives you an instant overview of your monitoring estate:

Summary Cards

At the top you'll see four cards:

Usage Bar

Below the cards, a progress bar shows how many monitors you've used out of your plan's allowance (e.g. "5 / 25"). This helps you keep track of your capacity at a glance.

Monitor List

Your monitors are displayed in a clean list-view with columns for:

• Status — A coloured indicator dot (green = up, red = down, yellow = intermittent)
• Monitor — The display name (or hostname), the full URL, paused badge if applicable, and any tags you've assigned
• Uptime (24h) — The percentage uptime over the last 24 hours, highlighted in yellow if below 99%
• Last Check — How long ago the most recent check was performed (e.g., "2 minutes ago")
• Actions — A "⋮" menu with options to View Details, Edit, Pause/Resume, or Delete

Adding a Monitor

Click the + Add New Monitor button on your dashboard to open the monitor creation form.

Basic Information

Monitoring Options

Alert Settings

Tip: Setting "Alert After" to 3 (the default) is a good balance — it avoids false alarms from momentary hiccups while still catching real downtime quickly.

Monitor Types & Options

HTTP/HTTPS Check

The most common type. The system sends an HTTP request to your URL and checks:

1. Does the response status code match your expected code?
2. Did the response arrive within the timeout threshold?

If either check fails, the monitor is marked as potentially down.

Keyword Check

In addition to the HTTP checks above, keyword monitoring also scans the page body for a specific word or phrase. This is useful for catching situations where your server returns a 200 OK but shows an error page, maintenance message, or unexpected content.

You can choose between:

• Contains keyword — Triggers a failure if the keyword is not found on the page
• Does not contain keyword — Triggers a failure if the keyword is found on the page (useful for detecting error messages)

SSL Certificate Monitoring

When enabled, the system periodically checks your SSL certificate's expiry date and alerts you when it's within your configured warning window. This helps you avoid unexpected certificate expirations that take your site offline.

Alerts & Notifications

How Alerting Works

Your monitors are checked from multiple independent nodes in different locations. This distributed approach dramatically reduces false positives — a single node having a network hiccup won't trigger an alert.

Here's the typical flow:

1. Multiple nodes check your site at each interval
2. If one or more nodes report failure, the monitor enters an "intermittent" state
3. Once enough nodes agree the site is down (based on consensus), the monitor status changes to "down"
4. If the failure count reaches your alert threshold (e.g., 3 consecutive failed rounds), you receive a notification
5. When the site recovers, you automatically receive a recovery notification

Notification Channels

Notification Types

In your Settings, you can toggle which types of notifications you want to receive:

• Downtime Alerts — When a monitor goes down
• Recovery Alerts — When a monitor comes back up
• SSL Expiry Alerts — When an SSL certificate is approaching its expiry date

Monitor Details & Statistics

Click View Details from a monitor's action menu to open a detailed breakdown.

What you'll see:

• Current Status — Up, Down, or Intermittent
• Uptime percentages — For the last 24 hours, 7 days, and 30 days
• Recent Incidents — A timeline of recent downtime events, showing when each incident started, when it ended, and total duration. Timestamps are displayed in your configured timezone
• Export options — Download a detailed CSV or JSON report for the selected monitor

Reports & Data Export

Per-Monitor Reports

From the Monitor Details view, you can download reports in two formats:

Both formats include check timestamp, status, HTTP status code, response time, the checking node, and any error messages.

Digest Reports

Want a regular summary without logging in? Enable Digest Reports in your Settings to receive periodic email summaries of your entire monitoring estate:

Import & Export Monitors

If you have many sites to monitor, you don't need to add them one by one. Use the Import/Export feature (available via the button on your dashboard) to manage monitors in bulk.

Exporting

Click Download CSV to export all of your current monitors to a CSV file. This file includes every configuration detail — URL, name, interval, group, tags, alert settings, webhook URLs, node selections, and more. Use it as a backup or to migrate monitors between accounts.

Importing

To import monitors:

1. Click the Import tab in the Import/Export dialog
2. Select a CSV file (maximum 2 MB)
3. Click Import Monitors

The import process is smart:

• New URLs are created as new monitors
• Existing URLs (matching by URL) are updated with the new configuration
• You'll see a summary showing how many were created, updated, and if any rows had errors
• Import will fail gracefully if it would exceed your plan's monitor limit

Tip: Click Download Sample CSV to get a pre-formatted template with all supported columns and example data. This is the easiest way to get started with a bulk import.

Public Status Page

You can share a public status page with your users or clients to keep them informed about service availability — no login required.

The status page shows:

• Overall system status — "All Systems Operational", "Partial System Outage", or "Major System Outage" with a colour-coded banner
• Per-service status — Each monitored service listed with a coloured dot (green/yellow/red) and its current 30-day uptime percentage
• Uptime history — A visual bar chart showing each service's 30-day uptime as a progress bar, colour-coded by health (green ≥ 99.9%, yellow ≥ 99%, red < 99%)

This page updates automatically whenever your monitors are checked.

Settings

Access your settings via the Settings button on the dashboard. Here you can configure:

Notification Settings

API Credentials

Your account includes API access for programmatic monitor management. In Settings you can:

• View your API Key — Copy it with the clipboard button
• View your API Secret — Click the eye icon to reveal, then copy
• View your Webhook Secret — Used for securing incoming webhook requests
• Regenerate All Keys — Create new credentials (useful if you suspect a key has been compromised)

Important: Regenerating your API keys will invalidate all existing keys immediately. Any integrations using the old keys will stop working until updated.

API Access

For advanced users and integrations, you can manage monitors programmatically through the REST API.

Available Endpoints

Authentication

Include these headers with every API request:

Troubleshooting

"You have reached your monitor limit"

Your plan has a maximum number of monitors. You'll see this message when trying to add a monitor beyond your limit. To resolve:

• Delete monitors you no longer need
• Upgrade your plan for a higher limit

A monitor shows "Down" but the site loads fine in my browser

This can happen for a few reasons:

• Geographic routing — Your site might be accessible from your location but unreachable from the monitoring nodes' locations. Check your firewall/CDN settings to ensure monitoring node IPs aren't blocked
• Intermittent issues — The site might be experiencing brief outages between your manual checks. Review the incident timeline in Monitor Details for exact timestamps
• Expected status code mismatch — If your site returns a redirect (301/302) or another non-200 status code, make sure your monitor's "Expected Status Code" matches

I'm not receiving email alerts

1. Check your notification preferences — Make sure "Downtime Alerts" is enabled in Settings
2. Check the alert emails — Verify the email addresses on the specific monitor (or your account's primary email)
3. Check your spam folder — Alert emails can sometimes be caught by spam filters
4. Check the alert threshold — If set to 6 failed checks with a 5-minute interval, it takes 30 minutes of downtime before you're notified. Try lowering the threshold

My monitor shows "Intermittent" status

This means some monitoring nodes can reach your site while others cannot. Common causes:

• Regional connectivity issues — Your site's hosting may have routing problems in certain regions
• Rate limiting or WAF blocking — Your firewall or CDN might be blocking some monitoring node IPs
• DNS propagation — Recent DNS changes haven't reached all monitoring locations yet

The monitor will return to "Up" once all nodes can reach the site consistently.

CSV import isn't working

• Ensure the file is a .csv file under 2 MB
• Use the Download Sample CSV template to ensure your columns match the expected format
• Check that all URLs include http:// or https://
• Verify the import wouldn't exceed your monitor limit

SSL certificate alerts keep firing

• Verify your SSL certificate's actual expiry date (you can check at ssllabs.com or in your browser's certificate viewer)
• Adjust the "SSL Expiry Warning" days on the monitor to a shorter window if you renew certificates at the last minute
• Make sure your SSL certificate chain is complete — missing intermediate certificates can cause detection issues

FAQ

How often are my sites checked?

That depends on the check interval you set for each monitor and what your plan allows. Options range from every 1 minute to every 60 minutes. Lower-tier plans may have a higher minimum interval (e.g., 5 minutes).

What happens when my site goes down?

1. Multiple monitoring nodes detect the issue
2. The system waits for your configured alert threshold (e.g., 3 consecutive failures) to rule out false positives
3. An incident is created and you're notified via your configured channels (email, Slack, Discord)
4. When the site recovers, you receive a recovery notification with the total duration of the outage

Can I monitor a site that requires authentication?

The monitoring system performs standard HTTP requests. If your site sits behind HTTP Basic Auth, the monitors won't be able to reach it. However, you can monitor a public health-check endpoint or login page that returns a known status code.

What is the "Intermittent" status?

It means your site is reachable from some monitoring nodes but not all. Think of it as a warning state — the system hasn't confirmed a full outage, but something isn't right. It usually resolves on its own, but if it persists, investigate potential regional connectivity or firewall issues.

Can I choose which monitoring nodes check my site?

Yes! When creating or editing a monitor, you'll see a list of available nodes with their geographic locations. Select the ones most relevant to your audience. The number of nodes you can select depends on your plan.

How is uptime calculated?

Uptime is calculated as the percentage of successful checks out of total checks over a given period (24 hours, 7 days, or 30 days). For example, if your site was checked 1,440 times in 24 hours and 1,435 were successful, your 24-hour uptime is 99.65%.

Can I use Slack and Discord alerts at the same time?

Absolutely. Each monitor has its own Slack and Discord webhook fields, so you can send alerts to both platforms simultaneously. You also still receive email alerts unless you've disabled them.

What do the alert threshold numbers mean?

The "Alert After" setting controls how many consecutive failed check rounds must occur before an alert is sent. A higher number means fewer false alarms but slower notification. For a 5-minute interval with a threshold of 3, you'd be notified after roughly 15 minutes of sustained downtime.

Can I temporarily stop monitoring a site?

Yes — use the Pause option from the monitor's action menu. Paused monitors don't consume checks or trigger any alerts. Resume them anytime with one click.

How do I share a status page with my clients?

Your account has a public status page that shows the real-time health of all your active monitors. Share the status page URL with your clients or embed it on your website. No login is required to view it.

Can I import monitors from another monitoring tool?

Yes. Export your monitors from the other tool as a CSV, then format the columns to match our expected template (download the Sample CSV from the Import/Export dialog for reference). The import process will create new monitors for any URLs that don't already exist.

What's the difference between the primary email and per-monitor alert emails?

• Primary email (in Settings) is your fallback — it's used when a monitor doesn't have any specific alert emails configured
• Per-monitor alert emails override the primary email for that specific monitor, letting you route alerts to different team members or inboxes

Will regenerating API keys break my existing integrations?

Yes. Regenerating creates entirely new credentials. Any scripts, integrations, or webhook configurations using the old keys will need to be updated with the new ones immediately.