freebsd-ports/net-mgmt/rrdbot/files/pkg-message.in
Jeremy Chadwick 63e4fa118f RRDBot is an SNMP polling daemon which writes the polled values to an RRD
database. It can poll many different SNMP sources in an efficient manner.

It has no large external dependencies, and its configuration is stored in text
files. It has full support for MIB definition files and using textual MIBs
instead of numerical OIDs.

A nice feature is the querying of SNMP tables without using a specific index.
Indexes of the rows in an SNMP table may change from time to time, and are less
than ideal for long term tracking of a given value. For example RRDBot can
query the traffic on your router based on the 'xl0' interface name.

RRDBot also contains tools to simplify the creation of RRD files, and the
various archives contained in them.
2008-09-23 02:02:16 +00:00

32 lines
1.2 KiB
Text

Post-Installation Procedure
===========================
Before starting the rrdbot daemon for the first time, you need to
perform some necessary steps:
1. Create configuration file(s) of what you wish to monitor, and
and place them in %%PREFIX%%/etc/rrdbot
2. Create the RRD files based on the above configuration file(s),
using %%PREFIX%%/sbin/rrdbot-create
When creating your rrdbot configuration files which use the "archive"
feature, be sure your archive durations are correct mathematically
when compared to the actual SNMP polling interval. For example,
assuming your SNMP polling interval is 30:
6/minute -- won't work (6*30 = 180 seconds)
2/minute -- will work (2*30 = 60 seconds)
Otherwise you'll receive this kind of warning when using rrdbot-create:
rrdbot-create: my.conf: archive has too many data points for polling interval. ignoring
Once you've followed these steps, you can start the daemon by setting
rrdbot_enable="yes" in rc.conf, and then execute:
%%PREFIX%%/etc/rc.d/rrdbot start
If you forgot to run rrdbot-create, rrdbotd will start but will silently
fail when trying to write data to the non-existent RRD. So please be
sure to follow the above!