Skip to content
Manager for Craft

Monitoring

Know within fifteen minutes when a site stops reporting

Each connected site sends a heartbeat every five minutes and a fuller runtime report every six hours. Manager tells you when a site goes quiet, when its TLS certificate is about to expire, how much disk it has left and whether its queue is healthy.

Fourteen days, no card. Craft CMS 5 and later.

A site that stops talking is not a site that is fine

A connector that stops checking in is its own signal. It might be a server that fell over, a deployment that removed the cron entry, or a site that was decommissioned and nobody told you.

The failure that costs the most is rarely dramatic. It is the disk that filled at 94 per cent three weeks ago and nobody looked, or the queue that stopped draining and took the search index with it.

What arrives, and how often

  1. Heartbeat, every five minutes

    It carries no data at all and needs no permission. Its only content is that it arrived.

  2. Inventory, every hour

    Craft version and edition, PHP version, database engine and version, every plugin and Composer package with its version.

  3. Runtime, every six hours

    Disk free and total, bytes and file count per asset volume, PHP limits, OPcache state, and render timings.

  4. Failed sign-ins, every thirty minutes

    Counts only, read from the columns Craft already keeps rather than by logging attempts.

  5. The TLS certificate, once a day

    Manager opens a connection to the site's own hostname, completes the handshake, reads the certificate and closes. This is the one thing it goes and looks at itself.

  6. Availability is derived from what arrived

    Over 24 hours, 7 days and 30 days. A gap counts as an outage once it exceeds three intervals, so fifteen minutes at the default cadence.

What it measures, stated plainly

This is connector availability, not visitor-facing uptime

Manager makes no HTTP request to your site. It measures whether the site has been talking to us. A site with a dead web server and a live cron entry keeps reporting, and the screen says so.

The certificate check is the one exception, and it is bounded

It goes to the hostname an operator typed, not one that arrived in a payload. A domain resolving to a loopback, private or metadata address is refused by the same guard that protects webhook destinations, so a check cannot be turned into a request for cloud credentials. Five second timeout, nothing sent, no response body read.

A certificate that cannot be read is not a certificate problem

Usually it is DNS, a firewall, or a site that has moved. It shows on the site as unreachable rather than opening an expiry finding, because sending somebody to look at the wrong thing costs more than saying less.

Response times are server render time

Mean, median, 95th percentile and slowest, sampled from a ring of at most 200 requests on your own server. Not time to first byte, and not measured from a datacentre somewhere else.

Disk, per asset volume

Bytes and file count by volume handle, plus free and total space on the storage volume. Never a path, a filename or a directory listing.

Queue and migration state

Queue depth, failed job count and whether migrations are pending. Counts only, never the contents of a queued job.

No cron, no problem

On hosting where you cannot add a cron entry, the connector drives its own schedule from ordinary web traffic. It reads nothing from the request and no URL reaches it.

Failed sign-in counts are a floor

Craft clears its counter on a successful sign-in, so the number you see is at least that many, not exactly that many. Every screen showing it says so.

The outcome

You find out that a site went quiet from Manager rather than from the client, that a disk is filling before it fills, and that a certificate did not renew a month before anyone sees a browser warning.

Read how it works

The documentation lives in the public repository, next to the code it describes, and every page carries a link to edit it.

Monitoring documentation

Related

See your whole fleet in about ten minutes

Add a site, install the connector with Composer, paste the one-time code. The first report arrives on the next run. Fourteen days free, no card, and nothing on your sites changes.

Craft CMS 5 and later. Read-only by default. AGPL-3.0-or-later.