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

FreeBSD Manual Pages

  
 
  

home | help
rrdbot-get(1)		FreeBSD	General	Commands Manual		 rrdbot-get(1)

NAME
     rddbot-get	-- retrieves an	SNMP value from	an SNMP	uri

SYNOPSIS
     rddbot-get	[-Mnr] [-m mibdir] [-s srcaddr]	[-t timeout]
		snmp://community@host/oid
     rddbot-get	-V

DESCRIPTION
     rddbot-get	retrieves an SNMP value	from an	SNMP URI. The format is	the
     same as is	used by	rrdbotd(8).  You can use rddbot-get for	testing	SNMP
     polling while configuring rrdbotd(8).

OPTIONS
     The options are as	follows.

     -m	mibdir	 The directory in which	to look	for MIB	files. The default di-
		 rectory is usually sufficient.

     -M		 Display MIB parsing warnings.

     -n		 Display numeric OIDs.

     -r		 Recursively walk the SNMP values under	the given OID.

     -s	srcaddr	 Source	address	to send	SNMP packets from.

     -t	timeout	 The amount of time (in	seconds) to wait for an	SNMP response.
		 Defaults to 5 seconds.

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

MULTIPLE AGENTS
     rddbot-get	supports failover between multiple agents. If an SNMP query
     fails on one agent	or a value is not found	when querying an agent,	then
     it	will switch to another configured agent.

     When combined with	a query	(see TABLE QUERIES) you	can use	this feature
     to	search for a given value in a table on one of multiple agents.

     To	use failover, simply use multiple host names with commas (without a
     space) separating them. For example:

	   snmp://public@two.example.com,one.example.com/sysUptime.0

TABLE QUERIES
     rddbot-get	can query a value that corresponds to a	certain	row in an SNMP
     table. On many SNMP agents	the indexes of rows in tables are not fixed,
     and this allows you to retrieve a certain value no	matter what row	of the
     table it is on.

     Add the OID and value you want to search for in the table to the end of
     the SNMP URL. Only	one query value	is supported.

     For example to get	the outbound packet count on the 'eth0'	interface, you
     would use:

	   snmp://public@example.com/ifInUcastPkts?ifDescr=eth0

SEE ALSO
     rrdbotd(8), rrdbot.conf(5), rrdbot-create(8)

AUTHOR
     Stefan Walter <stef@memberwebs.com>

rrdbot			       February	25, 2021			rrdbot

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | MULTIPLE AGENTS | TABLE QUERIES | SEE ALSO | AUTHOR

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

home | help