# Check AirOs
The following script is used to monitor and display the basic information of Ubiquity AirOs via snmpwalk scripts and are processed to provide easy-to-read data. It can be run separately or integrated into Icinga2 as a monitoring plugin.
**Important**: *snmpwalk command is required for script to run correctly*
# Update Note
## 1.0 - Release
+ Release
# Installation
1. Download the script and give it privilages for run
```
curl -LJO https://raw.githubusercontent.com/Kalarumeth/Monitoring-AirOs/main/check_airos.sh
```
2. Move to Icinga Plugin Dir
```
Default location: /usr/lib/nagios/plugins
```
3. Add command to Icinga
```
object CheckCommand "check_airos" {
import "plugin-check-command"
command = [ PluginDir + "/check_airos.sh" ]
arguments += {
"-c" = {
order = 0
value = "$snmp_community$"
}
"-cr" = {
order = 3
value = "$crit$"
}
"-h" = {
order = 1
required = true
value = "$address$"
}
"-t" = {
order = 4
required = true
value = "$airos_type$"
}
"-wa" = {
order = 2
value = "$warn$"
}
}
}
```
# Functions
The Script is designed to monitor the following functions:
- **[airmax] AirMax:**
Show all airMax Statistics of device
```
AirMax Information
Enabled: On
Quality: 96 %
Capacity: 45 %
Priority: None
NoAck: Off
```
- **[info] Info:**
Show basic information
```
Device Information
Location: OUTSIDE
UpTime: 2 days, 18:03:25.00
LastChange: 17:01:14.00
Ubiquiti Networks, Inc. LiteBeam M5
airOs Ver: XW.ar934x.v6.3.6.33330.210818.1930
```
- **[radio] Radio:**
Show status and statistics of radio
```
Radio Information
Mode: AP Wireless Distribution System
Country: 380
Frequency: 5185
DFS: Off
TxPower: 0
Distance: 0
Chainmask: 1
Antenna: 11x14 - 23 dBi
```
- **[ram] Ram:**
Show ram usage
```
OK! RAM used: 25.27 / 62.14 Mb (40.67%)
RAM free: 36.86 Mb (59.33%)
Buffer: 2.99 Mb
Cache: 0 Kb
```
- **[station] Station:**
Show station information, work only on station setup
```
Station Information
Name: AP041
Signal: -41 dBm
Noise floor: -100
CCQ: 99 %
Con. Time: 2
TX/RX Rate: 150 MB / 150 MB
TX/RX Bytes: 3.39 GB / 7.88 GB
```
- **[wireless] Wireless:**
Show wireless information
```
Wireless Information
SSID: Bridge
Hide: On
Signal: -42 dBm
RSSI: 54 dBm
CCQ: 99
Noise floor: -99
TX/RX Rate: 150 MB / 150 MB
Security: WPA2
WDS: On
Ap Repeater: Off
Channel Width: 40
Station Count: 1
```
# How it work
Method to compose the execution string:
./check_airos.sh -c -h [-wa -cr ] -t
The following script is used to monitor and display the basic information of Ubiquity AirOs via snmpwalk scripts and are processed to provide easy-to-read data. It can be run separately or integrated into Icinga2 as a monitoring plugin.
**Important**: *snmpwalk command is required for script to run correctly*
# Update Note
## 1.0 - Release
+ Release
# Installation
1. Download the script and give it privilages for run
```
curl -LJO https://raw.githubusercontent.com/Kalarumeth/Monitoring-AirOs/main/check_airos.sh
```
2. Move to Icinga Plugin Dir
```
Default location: /usr/lib/nagios/plugins
```
3. Add command to Icinga
```
object CheckCommand "check_airos" {
import "plugin-check-command"
command = [ PluginDir + "/check_airos.sh" ]
arguments += {
"-c" = {
order = 0
value = "$snmp_community$"
}
"-cr" = {
order = 3
value = "$crit$"
}
"-h" = {
order = 1
required = true
value = "$address$"
}
"-t" = {
order = 4
required = true
value = "$airos_type$"
}
"-wa" = {
order = 2
value = "$warn$"
}
}
}
```
# Functions
The Script is designed to monitor the following functions:
- **[airmax] AirMax:**
Show all airMax Statistics of device
```
AirMax Information
Enabled: On
Quality: 96 %
Capacity: 45 %
Priority: None
NoAck: Off
```
- **[info] Info:**
Show basic information
```
Device Information
Location: OUTSIDE
UpTime: 2 days, 18:03:25.00
LastChange: 17:01:14.00
Ubiquiti Networks, Inc. LiteBeam M5
airOs Ver: XW.ar934x.v6.3.6.33330.210818.1930
```
- **[radio] Radio:**
Show status and statistics of radio
```
Radio Information
Mode: AP Wireless Distribution System
Country: 380
Frequency: 5185
DFS: Off
TxPower: 0
Distance: 0
Chainmask: 1
Antenna: 11x14 - 23 dBi
```
- **[ram] Ram:**
Show ram usage
```
OK! RAM used: 25.27 / 62.14 Mb (40.67%)
RAM free: 36.86 Mb (59.33%)
Buffer: 2.99 Mb
Cache: 0 Kb
```
- **[station] Station:**
Show station information, work only on station setup
```
Station Information
Name: AP041
Signal: -41 dBm
Noise floor: -100
CCQ: 99 %
Con. Time: 2
TX/RX Rate: 150 MB / 150 MB
TX/RX Bytes: 3.39 GB / 7.88 GB
```
- **[wireless] Wireless:**
Show wireless information
```
Wireless Information
SSID: Bridge
Hide: On
Signal: -42 dBm
RSSI: 54 dBm
CCQ: 99
Noise floor: -99
TX/RX Rate: 150 MB / 150 MB
Security: WPA2
WDS: On
Ap Repeater: Off
Channel Width: 40
Station Count: 1
```
# How it work
Method to compose the execution string:
./check_airos.sh -c