Monitoring

HTTP/HTTPS Monitors

Monitors automatically check your services at regular intervals and update component statuses when failures are detected.

How Monitors Work

PingBase sends HTTP/HTTPS requests to your service endpoints at configurable intervals. Each check records the response status code, response time, and SSL certificate validity. If a check fails (unexpected status code, timeout, or connection error), it counts toward the failure threshold.

Monitors run on distributed workers to ensure reliability. A single failed check does not trigger an incident — the failure threshold must be exceeded first.

Monitor Types

TypeDescription
HTTPSends an HTTP request and checks the response status code.
HTTPSSame as HTTP but also validates the SSL certificate.
PINGSends ICMP ping packets to check host reachability.
TCPAttempts a TCP connection to a specific host and port.
DNSPerforms a DNS lookup and validates the response.
KeywordChecks if the response body contains (or doesn't contain) a specific keyword.

Configuration Options

NameA descriptive name for the monitor.
Target URLThe endpoint to check (e.g., https://api.example.com/health).
MethodHTTP method: GET, POST, PUT, DELETE, HEAD, PATCH.
HeadersCustom HTTP headers to include in the request (JSON format).
BodyRequest body for POST/PUT requests.
Expected StatusOne or more HTTP status codes considered successful (default: 200).
IntervalHow often to check, in seconds (default: 60, minimum: 30).
TimeoutMaximum time to wait for a response, in seconds (default: 10).
RetriesNumber of retry attempts before marking a check as failed (default: 3).
Retry IntervalSeconds between retry attempts (default: 30).
Failure ThresholdConsecutive failures before creating an incident (default: 3).

Auto-Incident Creation

When consecutive failures exceed the Failure Threshold, PingBase automatically:

  1. 1Creates an incident with status "Investigating" and impact "Minor"
  2. 2Updates the linked component status to "Major Outage"
  3. 3Sends notifications to all subscribers
  4. 4When the monitor recovers, automatically resolves the incident

Response Time Tracking

Every monitor check records the response time in milliseconds. This data is available in Dashboard → Analytics where you can view response time trends, p50/p95/p99 percentiles, and identify performance degradation over time.