diff options
| author | Stef Walter <stef@memberwebs.com> | 2008-03-02 01:25:00 +0000 |
|---|---|---|
| committer | Stef Walter <stef@memberwebs.com> | 2008-03-02 01:25:00 +0000 |
| commit | 9a78f86f773cbf34e29ec51fc06e3f04072c88d0 (patch) | |
| tree | 00054e6e536769a35b4215567755494486cc36ec /doc/rrdbot-get.1 | |
| parent | ec1a79b0f75cfd34085e046ecb30382a402ea318 (diff) | |
- Support failover between multiple agents
- Support table queries
- Major refactoring of internals.
Diffstat (limited to 'doc/rrdbot-get.1')
| -rw-r--r-- | doc/rrdbot-get.1 | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/doc/rrdbot-get.1 b/doc/rrdbot-get.1 index 48e4689..e9515d6 100644 --- a/doc/rrdbot-get.1 +++ b/doc/rrdbot-get.1 @@ -76,6 +76,34 @@ Prints the version of .Nm and the locations of the configuration files, RRD files etc. .El +.Sh MULTIPLE AGENTS +.Nm +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. +.Pp +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. +.Pp +To use failover, simply use multiple host names with commas (without a space) +separating them. For example: +.Bd -literal -offset indent +snmp://public@two.example.com,one.example.com/sysUptime.0 +.Ed +.Sh TABLE QUERIES +.Nm +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. +.Pp +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. +.Pp +For example to get the outbound packet count on the 'eth0' interface, you would use: +.Bd -literal -offset indent +snmp://public@example.com/ifInUcastPkts?ifDescr=eth0 +.Ed .Sh SEE ALSO .Xr rrdbotd 8 , .Xr rrdbot.conf 5 , |