Attaching a Monitor

This guide explains how to attach and configure monitors for your websites.

1. Navigate to Website Settings

  1. From the left sidebar, go to Websites & Monitoring.
  2. All your websites will be displayed.
  3. On the website you want to attach a monitor to, click the Settings icon on the website card.
  4. You will be redirected to the Website Settings page.
  5. Scroll down to the Attached Monitors section.
  6. Click the + Add Monitor button.

2. Select Monitor Type

Choose the type of monitor you want to attach.

For Pull and Smart Pull monitors, our service will periodically send requests to your endpoint to determine its health.

3. Configure Pull / Smart Pull Monitor

  • Name: A descriptive name for the monitor.
    Examples: Primary Database, Payment Server, API Gateway
  • Interval: How often the monitor check should run (e.g. every 1 minute, 5 minutes).
  • Method: The HTTP method supported by your endpoint.
    GET, POST, or HEAD
  • URL: The full URL of your health endpoint.
    https://api.example.com/health
  • Request Headers (Optional): Add custom headers if your endpoint is protected.
    Example: Authorization → Bearer 29488yq3083whtpafiahihawpdiuahpdiug3rpfiwgfwpifg
  • Test Connection: Click this button to verify that your endpoint responds successfully before saving.

Smart Pull Response Format

For Smart Pull monitors, your API endpoint must return JSON in the following format.

{
  "status": "up",
  "services": [
    {
      "name": "Service Name",
      "status": "up | down",
      "latency": 0,
      "threshold": 0,
      "message": "Optional status message"
    }
  ]
}

Example response:

{
  "status": "up",
  "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 represents the overall system health, while each service provides granular visibility.

Saving & Monitoring Behavior

Once saved, the monitor will automatically begin checking your endpoint at the configured interval. Initial results may take a few minutes to appear.

Managing Monitors

  • Edit monitor configuration
  • Enable or disable monitors
  • View integration code
  • Delete monitors

All active monitors are displayed on the public status page.

Pausing Website Monitoring

A master switch is available at the top of the Website Settings page. Disabling it will pause Core Web Vitals tracking and all attached monitors for the website.