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


Manual Reference Pages  -  RRDBOT-GET (1)

NAME

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

CONTENTS

Synopsis
Description
Options
Multiple Agents
Table Queries
See Also
Author

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 directory 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


.An Stefan Walter Aq stef@memberwebs.com
Search for    or go to Top of page |  Section 1 |  Main Index


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