Logger Configuration

Loggers record the state of every monitor after each interval.

Loggers are defined in the main configuration file, which by default is monitor.ini. The section name is the name of your logger, which you should then add to the loggers configuration value.

Common options

These options are common to all logger types.

type
Type:

string

Required:

true

the type of the logger; one of those in the list below.

depend
Type:

comma-separated list of string

Required:

false

Default:

none

a list of monitors this logger depends on. If any of them fail, no attempt will be made to log.

groups
Type:

comma-separated list of string

Required:

false

Default:

default

list of monitor groups this logger should record. Use the special value _all to match all groups. See the group setting for monitors.

tz
Type:

string

Required:

false

Default:

UTC

the timezone to convert date/times to

dateformat
Type:

string

Required:

false

Default:

timestamp

the date format to write for log lines. (Note that the timezone is controlled by the tz configuration value.) Accepted values are:

  • timestamp (UNIX timestamp)

  • iso8601 (YYYY-MM-DDTHH:MM:SS)

heartbeat
Type:

bool

Required:

false

Default:

false

if set, the logger only logs for monitors which executed on an iteration. Intended to be combined with the gap property of a Monitor.

enabled
Type:

boolean

Required:

false

Default:

true

Set to false to turn off the logger

Loggers

Note

The type of the logger is the first word in its heading.