Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
rrdbot-create(8)	  BSD System Manager's Manual	      rrdbot-create(8)

NAME
     rddbot-create -- create the RRD files for rrdbotd(8) to write values to.

SYNOPSIS
     rddbot-create [-nv] [-c confdir] [-w workdir]
     rddbot-create -V

DESCRIPTION
     rrdbotd(8)	is an SNMP polling daemon. It writes out the polled values to
     an	rrdtool(1) database. The rddbot-create tool can	create those RRD files
     for you.

     rddbot-create uses	configuration files, one per RRD, to determine where
     and how to	do its work. Details of	these files and	which settings to put
     in	them are found in the rrdbot.conf(5) manual under the CREATE SECTION
     heading.

     By	default	th RRD files are created in the	default	work directory (see
     the FILE LOCATIONS	section	below).	Files that already exist are not over-
     written or	modified in any	way.

     You can use the -n	option to see the rrdtool(1) commands that would be
     executed. This is useful if you want to customize the commands before
     running them.

OPTIONS
     The options are as	follows.

     -c	confdir	 The directory in which	configuration files are	stored.	See
		 below for info	on the various file locations.

     -n		 Rather	than create the	files, print the rrdtool(1) commands
		 that would be used to create the files.

     -v		 Print verbose messages.

     -V		 Prints	the version of rddbot-create and the locations of the
		 configuration files, RRD files	etc.

     -w	workdir	 The default directory where to	look for RRD files. See	below
		 for info on the various file locations.

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 de-
     scribed 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 fol-
     lowing:

	   /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.

SEE ALSO
     rrdbotd(8), rrdbot.conf(5), rrdbot-get(1),	rrdtool(1)

AUTHOR
     Stef Walter <stef@memberwebs.com>

rrdbot			      September	19, 2019			rrdbot

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILE LOCATIONS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=rrdbot-create&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help