Monitors

What Are Monitors?

A monitor continuously checks the availability and health of your website or service. If a check fails or a threshold is exceeded, alerts can be triggered to notify you in real time.

Monitors can be used to track simple endpoints as well as complex systems made up of multiple internal dependencies.

Types of Monitors

• Pull / Ping (HTTP/HTTPS): Periodically sends a request to a URL and verifies that it responds with a successful 2xx status code.
• Push / Heartbeat (Planned): Your services (such as cron jobs or background workers) send a request to our endpoint at a defined interval. If a heartbeat is missed, an alert is triggered.
• Smart Pull: A single health endpoint that reports the status of multiple internal services in one request, allowing you to monitor complex systems while consuming only one monitoring slot.

Smart Pull Monitor

Smart Pull monitors allow your application to expose a single health endpoint that returns the status of multiple internal services such as databases, caches, queues, or downstream APIs.

Your health endpoint must return JSON in the following format:

{
  "status": "up",               // overall system status
  "services": [
    {
      "name": "Primary Database",
      "status": "up",
      "latency": 45,
      "threshold": 1000,
      "message": "Connections healthy"
    },
    {
      "name": "Redis Cache",
      "status": "down",
      "message": "Connection refused"
    }
  ]
}

The top-level status determines the monitor’s global state, while individual services are shown as sub-status indicators.

Upcoming Monitor Types

• Smart Heartbeat: Push-based monitoring with multi-service support.
• Port Monitors: Validate that TCP/UDP ports are open and accepting connections.
• Keyword Monitors: Detect the presence or absence of specific text on a page.