home | help 
rrdbot-get(1)		     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  con-
		 figuration 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				  August, 2006			   rrdbot-get(1)
home | help