ap-mrtg(8)						      System Manager's Manual							ap-mrtg(8)

NAME

       ap-mrtg, ap-rrd - AP statistics translators

SYNOPSIS

       ap-mrtg -i ip -c community -t type [-b bssid ] [-v] [-r] [-h]

       ap-rrd -i ip -c community -t type -ddb_file [-b bssid ] [-r] [-h]

DESCRIPTION

       ap-mrtg get stats from AP and return it in MRTG parsable format.
       The Multi Router Traffic Grapher (MRTG) is a tool to monitor the traffic load on network-links. MRTG generates HTML pages containing graph-
       ical   images   which   provide	 a   LIVE   visual   representation   of   this   traffic.   You   may	 get	it    from:    http://peo-
       ple.ee.ethz.ch/~oetiker/webtools/mrtg/.

       ap-rrd gets stats from an AP and writes them to an RRDtool database.
       RRDtool is a data logging and graphing system for time series data.

OPTIONS

       -i ip  AP ip address

       -c community
	      SNMP community string

       -t type
	      Statistics type <w>ireless, <e>thernet, associated <s>tations or <l>ink quality in client mode;

       -b bssid
	      Mac address of the AP to which get link quality.

       -d db_file
	      Name of the rrdtool database to write to.

       -v     report MRTG about problems connecting to AP - if you want to get report about when AP spot work enable it

       -r     reset AP when getting LinkQuality stats

       -h     print help screen

MRTG Configuration Example
       Simple mrtg.cfg for get stats from Atmel based AP:
       Target[ap_e]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t ethernet -v`
       Options[ap_e]: noinfo, growright, bits
       MaxBytes[ap_e]: 12500
       Title[ap_e]: Traffic Analysis for AP Ethernet port
       PageTop[ap_e]: <H1>Traffic Analysis for AP Ethernet port</H1>

       Target[ap_w]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t wireless -v`
       Options[ap_w]: noinfo, growright, perminute
       ShortLegend[ap_w]: pkt/min
       MaxBytes[ap_w]: 100000000
       Legend1[ap_w]:  Packets In
       Legend2[ap_w]:  Packets Out
       YLegend[ap_w]: packets/min
       Title[ap_w]: Traffic Analysis for AP Wireless port
       PageTop[ap_w]: <H1>Traffic Analysis for AP Wireless port</H1>

       Target[ap_s]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t stations -v`
       Options[ap_s]: growright, gauge, noinfo
       ShortLegend[ap_s]: stations
       MaxBytes[ap_s]: 10
       YTics[ap_s]: 10
       Legend2[ap_s]: none
       Legend1[ap_s]: Associated Stations
       YLegend[ap_s]: Associated Stations
       Title[ap_s]: Traffic Analysis for AP Associated Stations
       PageTop[ap_s]: <H1>Traffic Analysis for AP Associated Stations</H1>
       LegendO[ap_s]: none
       LegendI[ap_s]: Associated Stations

Link Quality stats
       If  the	AP  is not in client mode, it errors out. Grabbing the signal strength resets the ethernet and wireless stats and AP. It's safe do
       not use this type of stat.   Optionally you may set mac address (bssid) of the AP to which getting link	quality  stats,  by  default  used
       first returned AP.   Simple mrtg.cfg for get stats from Atmel based AP with Link Quality and reset stats:

       Target[ap_e]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t ethernet -v`
       Options[ap_e]: noinfo, growright, bits, gauge
       MaxBytes[ap_e]: 12500
       Title[ap_e]: Traffic Analysis for AP Ethernet port
       PageTop[ap_e]: <H1>Traffic Analysis for AP Ethernet port</H1>

       Target[ap_w]: `/usr/local/bin//ap-mrtg -i 192.168.0.1 -c "public" -t wireless -v`
       Options[ap_w]: noinfo, growright, perminute, gauge
       ShortLegend[ap_w]: pkt/min
       MaxBytes[ap_w]: 100000000
       Legend1[ap_w]:  Packets In
       Legend2[ap_w]:  Packets Out
       YLegend[ap_w]: packets/min
       Title[ap_w]: Traffic Analysis for AP Wireless port
       PageTop[ap_w]: <H1>Traffic Analysis for AP Wireless port</H1>

       Target[EdAP_s]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t link -b FFFFFFFF -v -r`
       MaxBytes[EdAP_s]: 100
       Options[EdAP_s]: noinfo,growright,integer,unknaszero,nopercent,gauge
       Title[EdAP_s]: Signal Analysis for EdAP Wireless port
       YLegend[EdAP_s]: Signal Strength dBm/Quality
       ShortLegend[EdAP_s]: dBm
       PageTop[EdAP_s]: <H1>Signal/Quality Strength for EdAP</H1>
       LegendI[EdAP_s]: Signal Quality
       LegendO[EdAP_s]: Signal Strength in dBm

AUTHOR

       Roman Festchook <roma@polesye.net>
       http://ap-utils.polesye.net

SEE ALSO

       ap-config(8), ap-trapd(8)

						     Wireless Access Point Utilities for Unix						ap-mrtg(8)