Configuration - General
This is the miscellaneous config-file, but there are some critical pieces here:
-
datadir
(REQUIRED) -
The data for a given host is stored under datadir/hostname
.
There are also other status files stored in this directory.
-
staletime
(UNUSED) -
How long before we count a status as stale. (seconds)
-
minuptime
-
How long a host must be up before it stops being flagged as recently up.
(seconds)
-
keepalerts
(UNUSED) -
How long to keep records of alerts after the condition no longer exists.
(seconds)
-
uptimealert
-
If this is set, the alert-monitor will cause a warning level condition on the
fake rrd MISC for the fake variable UPTIME, for any host whose uptime
is less than this value. Whether this will trigger an alert depends on
the alerts file.
-
pinger
-
If defined, this names the ping-collector to be used before all the
other collectors. (Unless you write your own, you put ping-collector
here.) If you don't include this line, then you'll want to make sure
the the ping-collector
is listed in the collectors
line (below).
-
collectors
-
This line tells run-remstats which collectors to run. The default
list is all of them, so you can gain some benefit by pareing this line
down to those you are using, but remember it if you add new
rrds that need other collectors later. Note: you
list the names of the collectors without the '-collector
' on the
end. E.G. the ping-collector
would be included as just 'ping
'.
-
monitors
-
This line tells run-remstats which monitors to run. The default is
all of them.
-
pagemakers
-
This tells run-remstats which pagemakers to run at the end, if the
config-dir has changed. The default is all of them.
-
max-port-patterns
-
This tells the port-collector how many parenthesised patterns there can
be, at most, in valuepattern
s or infopattern
s. The default is 10.
-
watchdogtimer
-
This sets the limit that run-remstats will apply to each of the programs
that it runs, so that, e.g., a hanging collector will not hang the whole
remstats cycle.
-
keeplogs
-
This tells how long cleanup will permit old files to hang around, in seconds.
-
pagetemplatedir -
This tells where the page templates for L<page-writer
are kept. This
allows you to change the look of pages with a one-line change here. Assuming
that you have a different set of page templates in another directory.
[