GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
rrdbotd(8) FreeBSD System Manager's Manual rrdbotd(8)

rddbotd
an SNMP poller which writes to an round robin database

rddbotd [-M] [-b bindaddr] [-c confdir] [-w workdir] [-m mibdir] [-d debuglevel] [-p pidfile] [-r retries] [-t timeout]

rddbotd -V

rddbotd is an SNMP polling daemon which writes the polled values to an rrdtool(1) RRD database. An can poll many different SNMP sources in an efficient manner.

Table queries are supported, where the OID index of a certain value is not known beforehand, or may change regularly.

In addition multiple SNMP agents may be specified for a certain value. If one SNMP agent cannot be contacted or errors for some reason, another one will be tried.

The configuration (eg: SNMP sources, polling intervals) are located in files in a directory, with one configuration file per RRD. The format of the configuration files are described in: rrdbot.conf(5)

The options are as follows.
bindaddr
Address to bind to and send SNMP packets from.
confdir
The directory in which configuration files are stored. See below for info on the various file locations.
debuglevel
Don't detach from the console and run as a daemon. In addition the debuglevel argument specifies what level of error messages to display. 0 being the least, 4 the most.
mibdir
The directory in which to look for MIB files. The default directory is usually sufficient.
Display MIB parsing warnings.
pidfile
Specifies a location for the a process id file to be written to. This file contains the process id of rddbotd and can be used to stop the daemon.
retries
The number of times to retry sending an SNMP packet. Defaults to 3 retries.
timeout
The amount of time (in seconds) to wait for an SNMP response. Defaults to 5 seconds.
Prints the version of rddbotd and the locations of the configuration files, RRD files etc.
workdir
The default directory where to look for RRD files. See below for info on the various file locations.

To determine the default location for the configuration files and RRD files run this command:
# rrdbotd -V

The configuration files for SNMP pollers are laid out in a directory tree, with one file per RRD. Subdirectories can be used to organize the configuration files. The contents of the configuration files are described in rrdbot.conf(5).

By default the RRD files mirror the directory structure and names of the configuration files, with an .rrd extension appended to the filename.

For example if your configuration files are in a structure like the following:

/usr/local/etc/rrdbot/
  gateways/
    gateway-load.conf
    gateway-traffic.conf
  temperature/
    inside-temperature.conf
    outside-temperature.conf
  machine-load.conf

Then the default RRD files would be in a similar directory structure:

/var/db/rrdbot/
  gateways/
    gateway-load.conf.rrd
    gateway-traffic.conf.rrd
  temperature/
    inside-temperature.conf.rrd
    outside-temperature.conf.rrd
  machine-load.conf.rrd

The default location for an RRD file can be overridden by using the rrd option in the configuration file.

You can use the rrdbot-create(8) tool to create the needed RRD files in the appropriate places.

rrdbot.conf(5), rrdbot-create(8), rrdbot-get(1), rrdtool(1)

Stef Walter ⟨stef@memberwebs.com⟩
August, 2006 rrdbot

Search for    or go to Top of page |  Section 8 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.