This module exposes serves over HTTP the information collected by mod_host_status_check and mod_host_status_heartbeat in a convenient format for automated monitoring tools.


mod_http_status_check relies on Prosodys HTTP server and mod_http for serving HTTP requests. See Prosodys HTTP server documentation for information about how to configure ports, HTTP Host names etc.

Simply add this module to modules_enabled for the host you would like to serve it from.

There is a single configuration option:

    -- The maximum number of seconds that a host can go without sending a heartbeat,
    -- before we mark it as TIMEOUT (default: 5)
    status_check_heartbeat_threshold = 5;


Works with Prosody 0.9.x and later.


With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server= mod_http_host_status_check

For earlier versions see the documentation for installing 3rd party modules