ap-mrtg(8)

🌸 NAME 🌸

hiii bestie, welcome to ap-mrtg(8) — from the System Manager's Manual — aka the page that also covers its sibling ap-rrd(8). Together they're the 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 gets stats from an AP and hands them back in a format MRTG can parse, no cap 🔥. And what is MRTG? The Multi Router Traffic Grapher — a tool that monitors the traffic load on network-links. It makes HTML pages stuffed with graphical images that give you a LIVE visual representation of that traffic, like literally watching your network breathe 🫶. You can grab it from: http://people.ee.ethz.ch/~oetiker/webtools/mrtg/.

ap-rrd gets stats from an AP and writes them straight into an RRDtool database. RRDtool is a data logging and graphing system for time series data, and it ate, honestly 📈✨

---

✨ OPTIONS ✨

• -i ip — the AP's ip address 📍
• -c community — the SNMP community string 🔑
• -t type — which kind of stats you want: <w>ireless, <e>thernet, associated <s>tations, or <l>ink quality in client mode; 👑
• -b bssid — the Mac address of the AP you wanna get link quality from 🎀
• -d db_file — the name of the rrdtool database you're writing to 💾
• -v — report to MRTG about problems connecting to the AP — if you want to get a report about when the AP stops working, enable it 👀
• -r — reset the AP when getting LinkQuality stats 😭
• -h — print the help screen 🙈

---

🌈 MRTG Configuration Example 🌈

here's a simple mrtg.cfg for getting stats from an Atmel based AP, periodt:

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 🧚

⚠️ bestie listen — if the AP is not in client mode, it errors out. And grabbing the signal strength resets the ethernet and wireless stats and the AP. It's safe do not use this type of stat, fr fr. 💀

Optionally you may set the mac address (bssid) of the AP you're getting link quality stats from — by default the first returned AP is used. And here's a simple mrtg.cfg for getting stats from an 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)

---

and that's the whole page, bestie 🫶 this was Wireless Access Point Utilities for Unix — ap-mrtg(8) — go forth and graph your APs, you absolute icon 💖✨🌈