Skip to main content

Overview

Synthetics Uptime Monitoring lets you proactively detect outages and performance degradation before your users notice. Lightweight probe agents deployed across multiple global regions execute checks against your endpoints on a configurable schedule and report results back to EasyAlert. When a monitor detects a failure confirmed from multiple locations, an incident is created automatically, triggering your escalation policies and notifying the right people.

Multi-Protocol Checks

Monitor HTTP APIs, TCP ports, DNS records, ICMP ping, SSL certificates, and gRPC services

Global Probe Network

Run checks from distributed locations worldwide to detect regional issues

Smart Alerting

Multi-location confirmation prevents false positives from transient network blips

Detailed Analytics

Uptime percentages, response time charts, connection timing waterfall, and aggregated metrics

Monitor Types

EasyAlert supports six monitor types, each tailored to a different protocol or use case.
Monitor websites, REST APIs, and any HTTP/HTTPS endpoint.Best for: API health checks, website availability, webhook endpointsKey config fields:
  • HTTP method (GET, POST, PUT, etc.)
  • Custom headers and request body
  • Authentication (Basic, Bearer token)
  • Expected status codes (default: 200)
  • Body content assertions (contains string, regex match)
  • Maximum response time threshold (for degraded status)
  • Redirect following, HTTP version enforcement
  • Proxy support, HTTP/3 (QUIC), CEL expressions for JSON validation
Example:

Creating a Monitor

1

Open the Create Dialog

Navigate to Synthetics and click the New Monitor button.
2

Enter a Name

Give the monitor a descriptive name (e.g., “Production API Health Check”).
3

Select a Monitor Type

Choose from HTTP(S), TCP, DNS, Ping, SSL, or gRPC. The form updates to show type-specific fields.
4

Configure the Target

  • HTTP / SSL: Enter the full URL (e.g., https://api.example.com/health). If you omit the scheme, https:// is prepended automatically.
  • TCP / gRPC: Enter the host and port.
  • DNS / Ping: Enter the hostname.
5

Set Check Interval and Locations

Choose how often checks run (30 seconds to 30 minutes) and which probe locations to use. All online locations are selected by default.
6

Configure Type-Specific Settings

Expand the type-specific section to configure protocol details (HTTP headers, DNS record types, TCP send/expect, etc.).
7

Set Alert Settings

Configure the incident severity, number of confirmations required, and whether alert grouping is enabled.
8

Optional: Advanced Settings

Expand Advanced Options to configure SSL settings (for HTTP/SSL types), IP protocol preference, tags, and description.
9

Save

Click Create Monitor. The monitor begins checking on the next probe cycle.

Monitor Configuration

Check Intervals

Shorter intervals detect outages faster but generate more check data. Start with 1-minute intervals for production services and adjust based on your needs.

Probe Locations

Checks are executed from globally distributed probe agents. When creating or editing a monitor, all online probe locations are pre-selected. The Probe Globe in the toolbar provides a visual overview of available locations, their regions, and current status. Each probe location independently executes the check and reports results. This distributed approach helps you detect region-specific outages versus global failures.

Multi-Location Confirmation

The Confirmations setting controls how many locations must report failure before a status change is triggered.
  • Default: 2 confirmations
  • Range: 1 – 10 (limited by the number of selected locations)
  • If a location is offline, the threshold adjusts dynamically
Setup: Monitor with locations us-east-1, eu-west-1, ap-southeast-1 and 2 confirmations.
If only 1 location had failed, the monitor would remain UP — the failure is treated as a transient network issue.
Multi-location confirmation is the primary mechanism for preventing false-positive alerts. Always set confirmations to at least 2 when using multiple locations.

IP Protocol

When a specific protocol is selected, you can enable Protocol Fallback to try the opposite protocol if the preferred one fails to connect.

HTTP Configuration

  • Method: GET (default), HEAD, POST, PUT, PATCH, DELETE, OPTIONS
  • Headers: Custom key-value pairs sent with every request
  • Compression: gzip, br, deflate, identity, or auto
  • Valid HTTP Versions: Restrict to HTTP/1.0, HTTP/1.1, or HTTP/2
  • Basic Auth: Username and password
  • Bearer Token: Authorization header with a bearer token
  • Expected Status Codes: List of acceptable HTTP status codes (default: [200])
  • Max Response Time: Threshold in milliseconds — responses exceeding this are marked degraded
  • SSL enforcement: failIfSsl / failIfNotSsl to enforce or reject HTTPS
  • Body Contains: Simple string match
  • Body Regex: Regular expression match
  • Fail If Body Matches: List of regex patterns — fail if body matches any
  • Body Size Limit: Maximum response body size in bytes
  • CEL Expressions: Common Expression Language rules for structured JSON body validation
  • Follow Redirects: Enabled by default
  • Fail If SSL / Fail If Not SSL: Enforce HTTPS presence or absence
  • Proxy URL: Per-check HTTP/SOCKS proxy
  • No Proxy: Comma-separated bypass list
  • HTTP/3 (QUIC): Enable experimental HTTP/3 support
  • Expected Headers: Key-value pairs the response must contain
  • Header regex matching: Fail-if-matches / fail-if-not-matches rules for response headers

TCP Configuration

  • Send / Expect: Single-step data exchange after connecting
  • Query/Response Steps: Multi-step sequences — each step sends data and expects a response
  • TLS: Wrap the connection with TLS from the start
  • STARTTLS: Upgrade a plain connection to TLS mid-stream
  • Minimum TLS Version: Enforce TLSv1.2 or TLSv1.3

DNS Configuration

Advanced regex matching is available for answer, authority, and additional sections.

SSL Configuration

SSL configuration is available for both HTTP and SSL monitor types. For HTTP monitors, it appears under Advanced Options.

Ping Configuration

gRPC Configuration


Monitor Status

Every monitor has one of seven statuses:

Status Transitions

How Status Is Evaluated

  1. Probes independently execute checks at the configured interval
  2. Each check result is recorded with status up, down, degraded, or error
  3. If enough locations report failure (≥ confirmations), the monitor transitions to Down
  4. If a check exceeds the maxResponseTime threshold (HTTP), the check is marked Degraded
  5. When recovery is detected across locations, the monitor transitions back to Up

Viewing Monitors

Monitor List

The Synthetics page shows all your monitors in a searchable, paginated table:

Stats Cards

At the top of the list, summary cards show:
  • Total Monitors — count of all monitors
  • Up — monitors currently healthy
  • Down — monitors currently failing
  • Degraded — monitors with performance issues
  • Paused — monitors that are suspended
  • Search: Filter monitors by name
  • Status Filter: Show only monitors with a specific status (Up, Down, Degraded, Paused, Pending)
  • Type Filter: Show only monitors of a specific protocol (HTTP, TCP, DNS, Ping, SSL, gRPC)

Monitor Detail

Click any monitor to open its detail page with rich analytics and configuration views. Header area displays the monitor name, status badge, type badge, target URL/host, and action buttons (Run Now, Pause/Resume, Edit, Delete). If the monitor has an active incident, a banner links directly to it. Quick stats cards show:
  • Uptime percentage for the selected period
  • Current response time
  • Number of probe locations
  • Total checks in the period
Uptime bar visualizes status changes over time with period selectors (24h, 7d, 30d, 90d). Tabs:
  • Response Time Chart — time series of response times
  • Connection Timing Waterfall — per-phase breakdown (DNS, TCP, TLS, Server, Content Transfer). HTTP monitors only
  • Aggregate Metrics — hourly/daily/monthly summary with percentiles
  • Location Status — per-location check results
  • Configuration — check interval, timeout, confirmations, severity

Uptime Analytics

Uptime Percentage

Select a period using the buttons in the uptime card header: Uptime is calculated based on status changes, not individual check counts. This means short-lived failures that don’t trigger a status change won’t affect the uptime percentage. The Uptime Bar provides a visual timeline of status changes in the selected period. Each colored segment represents a period where the monitor was in a specific status.

Response Time

The response time chart shows average, minimum, and maximum response times over the selected period. Data points are bucketed by time based on the period: You can filter response time data by a specific probe location.

Response Timings (HTTP Only)

For HTTP monitors, the Connection Timing Waterfall breaks down each request into its constituent phases:
Use the waterfall to identify bottlenecks. A slow DNS phase might indicate resolver issues, while high server processing suggests backend problems.

Aggregated Metrics

The Aggregate Metrics card shows summarized data at hourly, daily, or monthly granularity:
  • Total / Success / Failed / Degraded check counts
  • Response time percentiles: p50, p95, p99
  • Average / Min / Max response time
  • Uptime percentage per period
  • Downtime in seconds
  • Per-location breakdown via location metrics

Check History

The Checks tab provides a paginated table of every individual check result:
  • Filter by location or status
  • Columns: Location, Status, Response Time, Status Code, Error Message, Timestamp
  • Configurable page size (10, 20, 50, 100)

Status Changes

The Status Changes tab shows a timeline of every transition:
  • From → To status with color indicators
  • Reason for the change
  • Duration in the previous state (e.g., “was 2h 15m in Up”)
  • Linked Incident — click to navigate to the incident

Maintenance Windows

Maintenance windows let you schedule periods where status changes won’t trigger incident alerts. Checks continue to run during maintenance, but the monitor’s status is set to Maintenance.

Creating a Maintenance Window

1

Open the Maintenance Tab

Navigate to the monitor’s detail page and select the Maintenance tab.
2

Click Schedule

Click the Schedule button to open the creation dialog.
3

Enter Details

  • Title — descriptive name (e.g., “Database Migration”)
  • Description — optional details
  • Start — date and time when maintenance begins
  • End — date and time when maintenance ends
4

Save

Click Schedule to create the maintenance window.

Behavior During Maintenance

  • Checks continue to run — results are still recorded
  • Status changes do not trigger incidents or alerts
  • The monitor status shows as Maintenance in the UI
  • When the window ends, normal alerting resumes automatically

Managing Windows

Each maintenance window shows:
  • Title and description
  • Start and end times
  • Active badge if currently in effect
  • Past badge if the window has ended
  • Recurrence indicator if the window repeats
To delete a window, click the trash icon and confirm.
Deleting an active maintenance window immediately resumes normal alerting. Any status changes that occur after deletion will trigger incidents as usual.

Incident Integration

Automatic Incident Creation

When a monitor transitions to Down, EasyAlert automatically:
  1. Creates an incident with the configured severity (critical, high, medium, or low)
  2. Links the incident to the monitor
  3. Triggers the assigned escalation policy
  4. Displays a banner on the monitor detail page linking to the incident

Alert Grouping

When Alert Grouping is enabled (default), subsequent failures from the same monitor are grouped into the existing open incident rather than creating new ones. This prevents incident spam during extended outages.

Automatic Resolution

When a monitor recovers (transitions back to Up), the linked incident is automatically resolved. The resolution note includes downtime duration information.

SSL Certificate Monitoring

For HTTP and SSL monitor types, EasyAlert tracks SSL certificate information:
  • Issued To — the domain the certificate covers
  • Issuer — the certificate authority
  • Expires At — expiration date
  • Days Until Expiry — countdown to expiration
  • Certificate Chain — full chain validation
  • Serial Number / Fingerprint / Protocol — detailed certificate metadata

Expiry Alerts

Configure the Alert Days Before Expiry setting (default: 30 days) to receive warnings before a certificate expires. The SSL configuration also supports enforcing a minimum TLS version.
SSL certificate data is collected during regular checks and cached on the monitor. View it in the SSL tab on the monitor detail page.

Bulk Operations

The monitor list supports multi-select for bulk actions:
  1. Use the checkbox column to select monitors (available for users with write permission)
  2. A bulk action bar appears showing the count of selected monitors
  3. Available actions:
    • Bulk Pause — pause all selected monitors
    • Bulk Resume — resume all selected monitors
  4. Maximum 100 monitors per bulk operation
You can also trigger an immediate check using Run Now from the monitor detail page. This queues the check for the next probe cycle.

Data Retention


Best Practices

Always monitor from at least 2-3 locations. This enables multi-location confirmation and helps distinguish between regional and global outages.
Use at least 2 confirmations to avoid false positives from transient network issues. For critical services with many locations, consider 3 or more.
  • Critical services: 30s – 1 minute
  • Standard production: 2 – 5 minutes
  • SSL expiry / low-priority: 10 – 30 minutes
Don’t just check for a 200 status code. Add a body assertion (e.g., "status":"ok") to verify the application is actually healthy, not just returning a generic error page.
Before deploying changes that might cause brief downtime, schedule a maintenance window. This prevents noisy incident alerts during planned work.
Set the alert days before expiry to at least 30 days. This gives you enough time to renew certificates before they cause outages.
Apply key-value tags to monitors for grouping and filtering (e.g., environment: production, team: platform).
For HTTP monitors, regularly check the waterfall breakdown. A sudden increase in DNS lookup time or TLS handshake time can indicate infrastructure issues before a full outage occurs.

Common Patterns

Type: HTTP URL: https://www.example.com Method: GET Expected Status: 200 Body Contains: A unique string from the homepage Interval: 1 minute Confirmations: 2
Type: HTTP URL: https://api.example.com/health Method: GET Expected Status: 200 Body Contains: "status":"ok" Max Response Time: 2000ms Interval: 30 seconds Confirmations: 2
Type: SSL URL: https://example.com Alert Days Before Expiry: 30 Check Chain: enabled Interval: 30 minutes Confirmations: 1
Type: TCP Host: db.example.com Port: 5432 TLS: enabled Interval: 2 minutes Confirmations: 2
Type: DNS Host: api.example.com Record Type: A Expected Values: ["203.0.113.10"] Nameserver: 8.8.8.8 Interval: 5 minutes Confirmations: 2
Create separate monitors for the same service targeting different regions:
  • US Monitor: Locations us-east-1, us-west-2 — 30s interval
  • EU Monitor: Locations eu-west-1, eu-central-1 — 30s interval
  • APAC Monitor: Locations ap-southeast-1, ap-northeast-1 — 30s interval
Use different escalation policies per region to route alerts to the right team.

Troubleshooting

  1. Verify that at least one probe location is online (check the Probe Globe)
  2. Confirm the target URL/host is correct and accessible from the internet
  3. Check that the monitor is not paused
  4. Wait for the first check cycle to complete (up to 1 interval)
  1. Increase the confirmations count to 2 or 3
  2. Add more probe locations for better confirmation coverage
  3. Check if a firewall or WAF is blocking probe IPs
  4. For HTTP monitors, verify expected status codes include all valid responses (e.g., add 301 if redirects are expected)
  1. Check the maxResponseTime threshold — it may be set too aggressively
  2. Review the Response Timing Waterfall to identify which phase is slow
  3. Consider that network latency between the probe location and your server affects total response time
  4. Try filtering response time data by specific locations to find slow regions
  1. Ensure the monitor type is HTTP or SSL
  2. Wait for at least one successful check to complete
  3. Verify the target URL uses HTTPS
  4. Check that the server is presenting a valid certificate
  1. This is normal if the service is consistently healthy — status changes only appear on transitions
  2. Check the Checks tab to verify individual check results are being recorded
  3. Verify the confirmations threshold isn’t higher than the number of failing locations
  1. Verify the maintenance window times are correct (check timezone)
  2. Confirm the window’s start time has actually passed
  3. Ensure the window was created for the correct monitor
  4. Check that the window hasn’t already ended
  1. Bulk actions require write permission on synthetics
  2. The checkbox column only appears for users with write access
  3. Select at least one monitor to see the bulk action bar
  4. Maximum 100 monitors can be selected per bulk operation
  1. Filter the Response Time chart by the affected location
  2. Compare with other locations to determine if the issue is regional
  3. Check the Connection Timing Waterfall (HTTP) to identify the slow phase
  4. Consider adding a monitor from a nearby location for comparison

Quick Reference

Monitor Types

Check Intervals

Status Meanings

Default Settings