Cache and freshness

It can be harmful to the server to run all checks on each HTTP endpoint call, so the application is running them periodically every X seconds specified by –refresh-time switch or REFRESH_TIME environment variable (in docker)

Refresh time

If you use an official docker image, then you can set an environment variable.

Example: check once a day (good for domains whois check).


From CLI you can set –refresh-time=86400

Wait time

Some checks could call external APIs, those can have limits. A good example is a domain-expiration check which is using whois. Set –wait=60 to for example wait 60 seconds before each check - where check is a single entry on the list of checks.

Customizing check freshness time per check

Beside the global setting of refresh time there could be a per-check setting called “results_cache_time”.

Example of caching the check result for at least 300 seconds

    "type": "swap-usage-max-percent",
    "results_cache_time": "300",
    "input": {
        "max_allowed_percentage": 0