diff options
author | M.Gergő | 2018-09-18 10:24:22 +0200 |
---|---|---|
committer | M.Gergő | 2018-09-18 10:24:22 +0200 |
commit | f4c15053b36caf047ec69bcb18f8ccb0fe333803 (patch) | |
tree | 0ae09f3aaf9a2424dd91e6ba77d046618e566aaf /README.md | |
parent | ead267bcbfc73d15ee58819b0fba8b392333e9f3 (diff) | |
download | munin-unifi-f4c15053b36caf047ec69bcb18f8ccb0fe333803.tar.gz munin-unifi-f4c15053b36caf047ec69bcb18f8ccb0fe333803.zip |
Munin monitoring script of Ubiquiti Unifi Wireless network.
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 32 |
1 files changed, 20 insertions, 12 deletions
@@ -1,6 +1,10 @@ -This is a [Munin](http://munin-monitoring.org/) plugin to monitor your [Ubiquity Unifi](https://www.ubnt.com/products/#unifi) wireless network status. +This is a [Munin](http://munin-monitoring.org/) plugin to monitor your [Ubiquiti Unifi](https://www.ubnt.com/products/#unifi) wireless network status. It uses SNMP v2 to get network data. +**The original version of this repo is aviable here: [http://git.bmrg.hu/unifi-munin.git](http://git.bmrg.hu/unifi-munin.git/)** + +. + ## Usage unifi_munin - Munin plugin to monitor UBNT unifi wireless APs @@ -13,13 +17,17 @@ Network usage -## Installation on Debian +## Installing on Debian 1) Copy the **ubnt_unifi.php** into the **/usr/share/munin/plugins/** folder. 2) Set the rights: - `chmod 755 /usr/share/munin/plugins/ubnt_unifi.php` + + chmod 755 /usr/share/munin/plugins/ubnt_unifi.php + 3) Create a symlink to this file: - `ln -s /usr/share/munin/plugins/ubnt_unifi.php /etc/munin/plugins/ubnt_unifi` + + ln -s /usr/share/munin/plugins/ubnt_unifi.php /etc/munin/plugins/ubnt_unifi + 4) Edit the **/etc/munin/plugin-conf.d/munin-node** file, and add the following configuration lines. 5) Test the plugin with the `munin-run ubnt_unifi` command. @@ -27,13 +35,13 @@ Network usage The following environment variables are used: -` [ubnt_unifi] ` -` timeout` - Munin-update timeout for this plugin. -` env.controller` - The unifi controller hostname/ip. -` env.devices` - A "space" separated list of the hostnames or IP addresses of wireless APs. -` env.timeout` - The maximum timeout in milliseconds of SNMP requests. (Be careful of munin max update time!). -` env.retry` - Number of retry after failed/time out SNMP requets. -` env.devnetw` - The network of the APs. (It is expreimental yet.) + [ubnt_unifi] + timeout - Munin-update timeout for this plugin. + env.controller - The unifi controller hostname/ip. + env.devices - A "space" separated list of the hostnames or IP addresses of wireless APs. + env.timeout - The maximum timeout in milliseconds of SNMP requests. (Be careful of munin max update time!). + env.retry - Number of retry after failed/time out SNMP requets. + env.devnetw - The network of the APs. (It is expreimental yet.) Configuration example for Munin: @@ -52,7 +60,7 @@ Configuration example for Munin: ### AUTHOR -Copyright (C) 2018 Gergő M. +Copyright (C) 2018 Gergő J. Miklós. |