Monitors

Monitors continuously check your services and alert you when issues occur. Run checks from multiple geographic regions to detect localized outages and ensure global availability.

Setup Workflow

Scroll horizontally on smaller screens to view all steps.

Monitor Types

Supercheck offers five monitor types, each designed for specific use cases:

HTTP Monitor

The most versatile monitor type for APIs and web services.

What it checks:

• HTTP/HTTPS endpoint availability
• Response status codes (2xx, 3xx, 4xx, 5xx)
• Response time and latency
• Response body content (keyword validation)
• HTTPS connectivity

Configuration options:

• HTTP Method — GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
• Custom Headers — Add authentication tokens, API keys, or custom headers
• Request Body — Send JSON or form data for POST/PUT requests
• Authentication — Basic Auth or Bearer Token support
• Expected Status — Validate specific status codes or ranges
• Keyword Validation — Check for presence or absence of text in response

Website Monitor

Simplified monitoring for web pages with built-in SSL tracking.

What it checks:

• Page returns an expected status code (2xx by default)
• SSL certificate is valid
• SSL certificate expiration date
• Optional keyword presence on page

Best for:

• Marketing websites
• Landing pages
• Public-facing web applications
• SSL certificate expiration alerts

Ping Monitor

TCP reachability monitoring for hosts that do not expose an HTTP endpoint.

What it checks:

• Host is reachable over TCP on port 443 or 80
• Connection latency (response time)

Best for:

• Server availability
• Network infrastructure
• VPN endpoints
• Internal services

Port Monitor

Verify that specific services are listening on expected ports.

What it checks:

• TCP or UDP port is open and accepting connections
• Connection can be established within timeout
• Service is responding on the specified port

Best for:

• Database servers (PostgreSQL 5432, MySQL 3306)
• Cache servers (Redis 6379, Memcached 11211)
• Mail servers (SMTP 25/587, IMAP 993)
• Custom services on non-standard ports

UDP checks send a packet; a passing result does not confirm that the application replied. Use TCP or an application-level check when you need response verification.

Synthetic Monitor

Run full Playwright browser tests on a schedule to validate complete user flows.

What it checks:

• Complete user journeys (login, checkout, form submission)
• JavaScript-rendered content
• Multi-step workflows
• Visual elements and interactions

Best for:

• Critical user flows (login, signup, checkout)
• Single-page applications (SPAs)
• Complex workflows requiring browser interaction
• End-to-end validation of user experience

Set up a synthetic monitor:

1. Create a Playwright test in the Playground
2. Save the test to your project
3. Create a Synthetic Monitor and select your test
4. Set the check interval (minimum 5 minutes)
5. Monitor runs your test and reports pass/fail status

📚 Playwright Documentation — Learn more about writing browser tests

Multi-Location Monitoring

Run checks from multiple geographic locations to detect regional outages and measure latency from different parts of the world.

Default Locations

Cloud deployments may include additional regions such as US East (Ashburn), EU Central (Nuremberg), and Asia Pacific (Singapore). Use the monitor's location picker to see which regions your project can use.

Choose Monitoring Locations

Select the regions you want to monitor, then use the location filter on the monitor detail page to compare results.

Supercheck enqueues checks to the online subset of enabled locations allowed by the project. Overall status still evaluates configured locations: missing results cannot satisfy All, and the majority is measured against configured locations. The multi-location alert threshold path is selected when more than one unique location is configured and enabled; an offline location does not switch a partial cycle to per-result thresholding. Missing configured locations count as failures, so a partial result is stored as Down. If worker-registry access fails, affected monitors remain Down until checks resume. Review per-location results to find a regional outage even when the overall status is Up.

Alert Configuration

Configure when and how you receive notifications about monitor status changes.

Alert Settings

Threshold Logic

Thresholds prevent alert fatigue from transient issues:

Monitor Details Page

The monitor details page provides comprehensive visibility into your monitor's health, performance, and history.

Header Section

The header displays essential monitor information at a glance:

• Monitor Name — The name you assigned to the monitor
• Test ID — For synthetic monitors, shows the linked Playwright test ID (click to copy)
• Action Buttons — Quick access to Pause, Edit, Delete, and AI Analyze operations

AI Analyze

Click AI Analyze in the header to generate an AI-powered analysis report for your monitor.

What AI Analyze Provides:

• Health Assessment — Clear status summary based on actual metrics
• Performance Analysis — Response time trends using your monitor's exact data
• Issue Diagnosis — Suggested causes with available error messages and timestamps
• Recommendations — Actionable next steps based on observed issues (only when problems exist)

Key Metrics Bar

Nine key metrics are displayed prominently below the header:

Availability Overview

A visual bar chart showing the status of the last 100 individual checks:

• Green bars — Successful checks (monitor was up)
• Red bars — Failed checks (monitor was down)
• Location Filter — Filter by specific region or view all locations combined

This visualization helps you quickly identify patterns like intermittent failures or sustained outages.

Response Time Chart

An interactive line chart displaying response times over time:

• 100 Data Points — Shows the most recent 100 check results
• Multi-Location Data — Region is shown in the hover details
• Hover Details — View exact response time and timestamp on hover
• Visual Patterns — Identify latency spikes, trends, and anomalies

The chart helps you spot performance degradation before it impacts users.

Recent Check Results Table

A paginated table showing detailed results for each check:

Features:

• Pagination — Navigate through historical results (10 per page)
• Date Filter — Filter results by specific date
• Location Filter — View results from a specific region only

Monitor Reports

For Synthetic Monitors, detailed reports are generated when checks fail. Access reports by clicking the report icon in the Error column of the Recent Check Results table.

Report Contents

Monitor Status

Check Intervals