Checkmate

Check retention

How long check history is kept before it is cleaned up.

Checkmate stores every check it runs, so retention is the main lever on database size.

The setting lives under Settings > Monitoring > Check retention.

FieldValue
Retention period (days)30 by default, up to 366
UnlimitedKeeps check data indefinitely

Check data older than the retention period is cleaned up automatically. Setting Unlimited disables the cleanup entirely, on a busy instance that will grow without bound, so pair it with monitoring of your disk.

Warning

Lowering the retention period deletes check history that is already older than the new value. Export anything you need first.

The retention period is also published on status pages as the window their charts can cover.

See also

On this page

Was this page helpful?