For single command instalation on linux use: bash -c "$(curl https://www.hellcloud.net/pingmon/download/pingmon_aio_installer.sh)"
For more options, including the mutch less feature rich windows version, go to the download page.
If you have any questions or you have found a bug, you can contact me via email: [email protected].
/~~~~~~\
/` -s- ~~~~\ Pingmon Ultimate is the ultimate ping logging bash script. Ideal for diagnosing and monitoring networks or keeping unstable connections alive.
/`:::: ~~~~ It can even lunch a specified script when after a specified amount of field pings on one IP address.
/`::::: :
/` :::::...::::
/` `:::::::::::
/` `:::::::::
/` :::::::::
: ::::::::::
: :::::::::::
: :::::::::::
: . ::::::::::
: :. ::::::::'
: :: .:::::::'
: ::..:::::::'
: :::::::::'
: :::::::::
:..::......::
##########################################################################################################################################
Key Features
- Latency Logging: Accurately logs network latencies to help diagnose network issues.
- Configurable Log Rotation: Manage your log files efficiently with customizable log rotation setting.
- Log Retention: Set log retention policies to automatically delete old logs and save disk space.
- Paralel ping: If configured Pingmon can ping multiple IPs at the same time. (It is not recommended to try more then 1000.)
- Action scripts: If configured Pingmon can call an "action script" if a marked IP fails to respond set amount of times.
System Requirements
Operating System: Debian Linux or any distro based on it. (Only tested on Debian 12)
Installation
Automatic
1. Go to the folder where you want to install Pingmon
2. Run: bash -c "$(curl https://www.hellcloud.net/pingmon/download/pingmon_aio_installer.sh)"
3. Write your IP addresses to the "IPAddresses.txt".
4. Edit the config.conf file. (optional)
5. Run ./control/enable.sh
6. Check if it works.
Manual
1. Unzip it in the folder where you want to install it.
2. Run install.sh
3. Write your IP addresses to the "IPAddresses.txt".
4. Edit the config.conf file. (optional)
5. Run ./control/enable.sh
6. Check if it works.
IP list syntax
Pingmon reads strings separated by spaces or linebreaks.
All strings containing "#" are considered comments.
Pingmon remembers the last comment he read and pairs it to the current IP he works with.
Therefor if "print comments" is on, Pingmon will print the last comment he read before he logs the ping result.
Action scripts
To mark the IPs for fail monitoring use comment "#example.sh#" or "#example.sh#40#".
The "example.sh" is a name of the action script in the "action_scripts" folder that will be executed when Pingmon counts the configured amount of fails.
The number "40" in the second example is an overwrite of the fail count before action configured in the config.conf file.
The fails are counted for all the IPs that go after the action comment.
To stop that you need to overwrite it with another comment.
Action scripts are lunched with IP as $1 and fail count as $2.
Example of the IP list file
127.0.0.1 <---------------- Pingmon does not count fails for this IP. If "print comments" is on, there will be no comment in front of it in the log.
#example.sh#40#
127.0.0.2 <---------------- If Pingmon counts 40 fails on this IP, the action script "example.sh" will be called. If "print comments" is on, there will be "#example.sh#40#" comment in front of it in the log.
127.0.0.3 <---------------- Same as above
127.0.0.4 <---------------- Same as above
#example2.sh#
127.0.0.5 <---------------- If Pingmon counts a globaly set amount of fails on this IP, the action script "example2.sh" will be called. If "print comments" is on, there will be "#example2.sh#" comment in front of it in the log.
127.0.0.6 <---------------- Same as above
#no_more_action
127.0.0.7 <---------------- Pingmon does not count fails for this IP. If "print comments" is on, there will be "#no_more_action" comment in front of it in the log.
127.0.0.8 <---------------- Same as above
127.0.0.9 <---------------- Same as above