Skip to main content

Documentation

Complete guide to setting up website monitoring with PingZen. API documentation, code examples, and best practices.

Sometimes a monitor’s history stops being useful: you pointed it at a staging URL for a week, a misconfiguration produced a wall of false downtime, or you are reusing an existing monitor for a brand-new service. Deleting and recreating the monitor loses its ID, alert wiring and probe assignments. Reset Statistics is the middle ground — it wipes the accumulated data and starts the timeline from zero while keeping the monitor itself intact.

This action is irreversible. There is no undo and no backup of the wiped rows.

Where to Find It

The control lives in the monitor edit form, not on the monitor detail page:

  1. Open the monitor and click Edit (or the pencil icon).
  2. Expand Advanced Options at the bottom of the form.
  3. Click the red Reset statistics button.
  4. A confirmation dialog asks you to type the monitor’s name before the button activates.

The button only appears when editing an existing monitor — never while creating one.

What Gets Wiped

Removed

  • All individual check results
  • The status timeline (uptime bars)
  • Hourly and daily uptime aggregates
  • Per-probe state (last error, freshness)
  • All incidents for this monitor (an open one is auto-resolved first)
  • Alert delivery history
  • Cached uptime / response-time fields (status returns to unknown)

Preserved

  • The monitor itself and its ID
  • All configuration (URL, protocol, interval, thresholds)
  • Alert rules attached to the monitor
  • Probe assignments and aggregation rule

After the reset, the monitor keeps running on its normal schedule — the very next check starts a fresh timeline.

Confirmation & Safety

Resetting statistics is gated by two layers so it can never fire by accident:

  • Type-to-confirm in the UI — you must type the exact monitor name; the confirm button stays disabled until it matches.
  • Explicit flag in the API — the request must carry confirm: true, otherwise it is rejected with 422 Unprocessable Entity. This protects against accidental shell or LLM-tool invocations.

Only one reset can run per monitor at a time. If a reset is already in progress, a second attempt returns 409 Conflict — wait a moment and retry.

Large Monitors

For monitors with millions of stored checks the wipe is batched on the server and can take up to a few minutes. The UI shows a Resetting… state and waits up to 180 seconds for the operation to finish, then reports how many checks, ranges and incidents were removed. The monitor’s status badge, in-flight state and cached SSL info are refreshed automatically once the reset completes.

API & MCP

The same operation is available outside the UI:

  • REST: POST /api/v1/monitors/:id/reset-stats with body { "confirm": true }. See the API Reference → for authentication and the response summary.
  • MCP: the reset_monitor_stats tool exposes the same action to AI clients (it is annotated destructive and also requires confirmation).

Just want to stop checks temporarily? Use Pause instead — it freezes the schedule without touching any history, and you can resume at any time.

Common Questions

What protocols can I monitor?

PingZen supports 23 protocols: HTTP/HTTPS, WebSocket (WS/WSS), TCP, UDP, ICMP Ping, gRPC, DNS, WHOIS, SSL certificates, Email (SMTP/IMAP/POP3), FTP/FTPS, DNSBL, PageSpeed, SOCKS5, MTProxy, API Check, and Transaction. You can monitor websites, APIs, servers, databases, and any network service.

How fast can I get alerts?

Telegram alerts are delivered within 1-2 seconds of detection. Slack and Discord notifications arrive almost instantly. You can configure multiple alert channels for redundancy.

Can I organize monitors by project?

Yes! PingZen supports workspaces, which let you organize monitors by project, environment, or team. Each workspace can have its own alert configurations and team members.

Is there an API for automation?

Absolutely. PingZen provides a full REST API with OpenAPI documentation. You can create, update, and delete monitors programmatically.

How do status pages work?

Status pages are public, branded pages showing your services' uptime. You can display real-time status and allow customers to subscribe for updates.

What happens if I reach my monitor limit?

We'll notify you when approaching your limit. You can pause some monitors or contact us for increased capacity. We never stop monitoring without warning, ensuring your critical services stay protected.

Ready to stop missing downtime?

Join thousands of teams who trust PingZen. Setup takes 30 seconds.