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  -  AP-MRTG (8)

NAME

ap-mrtg - AP to MRTG data translator

CONTENTS

Synopsis
Description
Options
MRTG Configuration Example
Link Quality stats
Author
See Also

SYNOPSIS

ap-mrtg -i ip -c community -t type [-b bssid ] [-v] [-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/.

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.
-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)

Search for    or go to Top of page |  Section 8 |  Main Index


--> AP-MRTG (8) Wireless Access Point Utilites for Unix

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