BSD Ports

net-mgmt/rrdbot 0.9.7.d20200312_2 DragonFly

Threaded SNMP polling daemon which stores data in RRDs

System
DragonFly
Repository
DPorts
Maintainer
[email protected] (as in FreeBSD)
Categories
net-mgmt
Package size
251.4 KiB, 1524.1 KiB installed

Description

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.

In the other systems

SystemPortVersion
DragonFlynet-mgmt/rrdbot0.9.7.d20200312_2
FreeBSDnet-mgmt/rrdbot0.9.7.d20200312_3
HardenedBSDnet-mgmt/rrdbot0.9.7.d20200312_3
GhostBSDnet-mgmt/rrdbot0.9.7.d20200312_3

Install

Binary package:

pkg install rrdbot

From DPorts:

cd /usr/dports/net-mgmt/rrdbot && make install clean

Dependencies

Run dependencies 1

No port depends on this one.

Configuration

No options to configure.

Service scripts
none

Message after installing

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 /usr/local/etc/rrdbot
2. Create the RRD files based on the above configuration file(s),
   using /usr/local/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:

  /usr/local/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!