Documentation

Everything you need to monitor with confidence.

Learn how to set up PingBeacons, monitor websites and APIs, track SSL certificates, watch scheduled jobs with heartbeats, and respond to incidents.

New to PingBeacons?

Start with the Getting Started guide. It walks you through creating your first monitor and understanding what happens when PingBeacons detects a problem.

How PingBeacons works

For website, API, and SSL monitors, PingBeacons performs the checks for you. Heartbeat monitoring works in the opposite direction: your scheduled job sends a signal to PingBeacons when it runs.

1

Create a monitor

Choose what you want to monitor and provide the required website, API, SSL, or heartbeat details.

2

PingBeacons watches it

Checks and heartbeats are recorded so you can see the latest status and monitoring history.

3

Problems become incidents

When a monitored service fails or an expected heartbeat is missed, PingBeacons can record the problem as an incident.

4

You receive an alert

Your notification preferences determine how PingBeacons keeps you informed about incidents, recoveries, and SSL expiry.

5

Recovery is tracked

When the service becomes healthy again, PingBeacons records the recovery so the incident history remains useful.

What can I monitor?

Websites

Check whether a website is responding and track response times, failures, incidents, and recoveries.

APIs

Watch API endpoints so availability problems can be detected without waiting for users to report them.

Scheduled jobs

Use heartbeat monitoring for cron jobs, backups, imports, reports, synchronization jobs, and scheduled scripts.

SSL certificates

Keep certificate validity and expiry visible so upcoming SSL expiry does not go unnoticed.

Quick heartbeat example

A heartbeat monitor gives you a unique URL. Call that URL after your scheduled job completes successfully.

curl -fsS "YOUR_HEARTBEAT_URL"

For example, a daily backup cron job could use:

0 2 * * * /path/to/backup.sh && curl -fsS "YOUR_HEARTBEAT_URL"
Keep your heartbeat URL private

Do not commit a real heartbeat URL to a public Git repository or expose it in browser-side JavaScript. Anyone who knows the URL may be able to send a heartbeat to that monitor.

Read the complete heartbeat setup guide

Recommended first setup

Add your main website

Start with the production website your users depend on most.

Add important API endpoints

Monitor APIs that are critical to login, checkout, application data, or other important workflows.

Monitor important scheduled jobs

Add heartbeat monitoring to backups and other jobs that could fail silently.

Review notification preferences

Make sure the alerts you care about are enabled before relying on your monitors in production.