https://github.com/thetechromancer/nmon
Monitors, detects, and records changes in the network, such as new hosts or new open ports. Includes the option to run a custom script/program on hosts which have changed.
https://github.com/thetechromancer/nmon
Last synced: 7 months ago
JSON representation
Monitors, detects, and records changes in the network, such as new hosts or new open ports. Includes the option to run a custom script/program on hosts which have changed.
- Host: GitHub
- URL: https://github.com/thetechromancer/nmon
- Owner: TheTechromancer
- License: lgpl-3.0
- Created: 2018-03-20T02:40:41.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-03-20T03:37:14.000Z (about 8 years ago)
- Last Synced: 2025-03-31T23:33:49.472Z (about 1 year ago)
- Language: Python
- Homepage:
- Size: 18.6 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nmon
A script which monitors, detects, and records additions to network(s), such as new hosts or new open ports. Includes the option to run a custom script/program on new or changed hosts.
Run as often as necessary (for example, every hour on a cron job). Nmon will inspect the network, compare to existing database, record changes, and then exit.
#### Usage:
~~~~
usage: nmon.py [-h] [-t TARGET] [-s SAVEDIR] [-d] [-r RUN] [-l] [--log]
[--debug]
Monitors and logs additions to network(s)
optional arguments:
-h, --help show this help message and exit
-t TARGET, --target TARGET
target hosts or subnets (comma-separated)
-s SAVEDIR, --savedir SAVEDIR
directory in which to save log file, etc.
-d, --delete delete saved cache
-r RUN, --run RUN run this command on new/changed hosts (host ip is
appended)
-l, --list list all recorded hosts
--log open log
--debug print debugging information
~~~~
#### Example:
Simply run nmon and view the log to see additions to the network. (target defaults to local subnet if none is specified)
~~~~
# ./nmon.py
[+] Loading database /root/.cache/nmon/10.0.0.0-24/db
[+] No existing database found - starting fresh
[+] Running Nmap scan: "nmap 10.0.0.0/24"
[+] Saved 3 new host(s) and 1 new open port(s)
# ./nmon.py
[+] Loading database /root/.cache/nmon/10.0.0.0-24/db
[+] Running Nmap scan: "nmap 10.0.0.0/24"
[+] Saved 1 new host(s) and 2 new open port(s)
# ./nmon.py --log
[Mon Mar 19 22:11:10 2018] New host on network:
10.0.0.1
00:0C:29:45:30:AF (VMware)
PORTS
22
[Mon Mar 19 22:11:10 2018] New host on network:
10.0.0.200
F0:9F:C2:64:50:22 (Ubiquiti Networks)
[Mon Mar 19 22:11:10 2018] New host on network:
10.0.0.116
0E:B4:B2:7E:A4:12
[Mon Mar 19 22:11:36 2018] New host on network:
10.0.0.115
0E:B4:40:FE:A3:86
PORTS
22
443
[+] Log can be found at /root/.cache/nmon/10.0.0.0-24/log
~~~~
#### Tips:
* Use the '-r' option to run a custom script/program on new or changed hosts. For example:
`nmon.py -r 'nmap -A'` or `nmon.py -r enum4linux`
* To start fresh, delete the cache for the current target with `-d`