Notes about scripts in the contrib directory

------------------------------------------------------------------ nrg-snmpwalk

usage: nrg-snmpwalk host community

nrg-snmpwalk does ``snmpwalk'' of the SNMP agent on ``host'' using the SNMP read community string ``community''. It only does ``snmpwalk'' on SNMP OIDs listed in etc/nrg-oid-names that start with dot. FIXME Some of the SNMP OIDs listed in /etc/nrg-oid-names are ``fully qualified'' so ``nrg-snmpwalk'' fails to return their values.

------------------------------------------------------------------ rrdlastds

usage: rrdlastds [-v] [-a] [-c num] [-l label] [-s stamp] some.rrd -v print the start and end times (also --verbose) -a autoscale DS values (also --autoscale) -c num convert DS values by ``num'' (also --conversion) -l label label DS values with ``label'' (also --label) -s time report about DS values at the time ``time'' (also --start)

  The -s option supports the traditional "seconds since the Unix epoch"
  and the AT-STYLE time specification (see man rrdfetch)

rrdlastds prints details about the current DS values for a RRD. It gets it's DS values from the RRA with the shortest time resolution. To simply print the current values, do


 rrdlastds some.rrd

To print the current values and describe the entire polling interval to which they apply, do:

 rrdlastds some.rrd -v

To print all the details about the data rrdlastds uses to report the current values, do

 rrdlastds some.rrd -d

To report about DS values at some specific point in time, do

 rrdlastds some.rrd -s timestamp

To converty from bytes/sec to bits/sec and autoscale the values, do

 rrdlastds some.rrd -a -c 8 -l "bits/s"

------------------------------------------------------------------ rrdtrim

rrdtrim replaces DS values above a certain max value with a new given value.

For example, given an RRD with data for traffic on a 56k frame-relay circuit, you can ``throw away'' (set to NaN) any values that exceed 56 kbits/sec (7000 bytes/sec) by executing:

 rrdtrim some.rrd 7000 NaN