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
graphical images which provide a LIVE visual representation of this
traffic. You may get it from:
http://people.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)