Configuration

Resmon configuration is in a single file: /opt/resmon/resmon.conf. This can be changed by passing the -c argument to resmon when starting it up.

The config file is in two parts, general options and module configuration. The general options part looks something like this:

INTERVAL 30;
PORT 81;
STATUSFILE /var/run/resmon-status.txt;
TIMEOUT 10;
AUTHUSER foo;
AUTHPASS bar;

The following options can be set:

  • port - which port to listen on
  • interval - how long to wait between each check
    • Note: each module can have an independent interval that will cache the result in between individual checks.
  • statusfile - filename to write resmon's status to. This is useful for quickly checking on the status directly on the server without needing access to a web browser.
  • lib - (optional) an addition directory which can contain resmon modules
  • timeout - (optional, default 10 seconds) abort any check that takes longer than this with a 'BAD - Check timeout' status
  • authuser - user to authenticate as
  • authpass - if authuser is defined, the password to authenticate with

The next part is a series of module definitions. The format looks like this:

Core::ModuleName {
    check_name1 : param1 => value1, param2 => value2
    check_name2 : param1 => foo, param2 => bar
}

For more information on this section, including what modules are available and what they do, take a look at the Module information page.