From discord channels: Get information and warning status of Linux server like service, port, ping, ssl certificate, disk/folder/cpu/ram/swap usage, ip connection, ... (Python and shell library, Linux ONLY)
Project description
Discord Bot Linux Monitor (Python library)
What is it
This python library is designed to be used as a Linux service to monitor the Linux server manually with discord commands and to send warning or information of the Linux server status to a discord channel periodically (if relevant).
It is possible to have separate 'private discord channel' and 'public discord channel' for:
- Sendind discord commands to the bot (visual example in next section)
- Getting periodic status of the Linux server (doing periodically some commands from next section)
- Getting warnings if there is an issue in the Linux server (periodic status check)
Example of warning:
It is compatible with python 3+ and usable only on Linux.
List of Discord commands:
Public and private discord channel commands
Displayed infos are not the same if you do the command in private or public channel (all info are displayed in private channel, some are hidden from public channels)
/usage
: ๐ View disk space, Load average, CPU, RAM, ... ๐
/os_infos
: ๐ฅ View basic system information ๐ฅ
/ping
: ๐ Ping websites ๐
/websites
: ๐ Check websites access (GET requests) ๐
/certificates
: ๐ Check SSL certificates ๐
/services_status
: ๐ฉบ Check services are running ๐ฉบ
/restart_all
: ๐ Restart all services ๐
/restart_service {service_name}
: ๐ Restart a service ๐
-
/stop_service {service_name}
: ๐ซ Stop a service ๐ซ -
/list_services
: ๐ List all available services ๐
/ports
: ๐ Check ports ๐
-
/list_commands
: ๐ List all available commands ๐ -
/execute_command
: ๐ Execute a command ๐ -
/execute_all_commands
: ๐ Execute all commands ๐
Private discord channel commands:
/force_sync
: ๐ Force discord command synchronization ๐
/users
: ๐ฅ View connected users ๐ฅ
/user_logins
: ๐ฅ View last user connections ๐ฅ
/reboot_server
: ๐ Restart the entire server ๐
/list_processes
: ๐ List active processes ๐
/kill_process
: ๐ซ Stop a process by PID ๐ซ
How to install (for first launch)
- Install package calling
python -m pip install discordbotlinuxmonitor
(orpython setup.py install
from the root of this repository) - Copy and edit config-example.json file depending on your need (on first launch, remove all
restart_command
from config file to prevent potential looping service restart issues on your server in case your config file is not well configured) - Launch the lib for testing it works:
# Get help
python3 -m discordbotlinuxmonitor --help
# Use "--debug" to show more information during command
# Use "--nodebug" to not show any warning information during command
# Start the discord bot Linux monitor (First time)
python3 -m discordbotlinuxmonitor --config_file config-example.json --force_sync_on_startup --debug
# Start the discord bot Linux monitor (after first time)
python3 -m discordbotlinuxmonitor --config_file config-example.json
- Go to discord (restart discord if you were already in it)
- You should see welcome messages on channels you configured in the config file and be able to communicate with the bot using command defined in previous section
How to install this lib as a service (to keep it running in the Linux server as a monitor)
- Stop the discord bot and create a service to have it running even after computer reboot:
### Define all base info
DISCORD_BOT_SERVICE_USER="discordbotlinuxmonitor"
DISCORD_BOT_SERVICE_GROUP="discordbotlinuxmonitor"
DISCORD_BOT_SERVICE_NAME="discord-bot"
DISCORD_BOT_SERVICE_FILE="/etc/systemd/system/${DISCORD_BOT_SERVICE_NAME}.service"
DISCORD_BOT_FOLDER="/opt/DiscordBot/"
### Add rights to user launching the library depending on what you want it to do ###
# Only if this library should be able to reboot the server on demand:
echo "$DISCORD_BOT_SERVICE_USER ALL=(ALL) NOPASSWD: /sbin/reboot" >> /etc/sudoers.d/$DISCORD_BOT_SERVICE_USER
# Only if this library should be able to kill a process on demand:
echo "$DISCORD_BOT_SERVICE_USER ALL=(ALL) NOPASSWD: /bin/kill" >> /etc/sudoers.d/$DISCORD_BOT_SERVICE_USER
# Add also all processes added in your config JSON file you want the library to be able to execute
# Example for the existing config-example.json file:
echo "$DISCORD_BOT_SERVICE_USER ALL=(ALL) NOPASSWD: /bin/systemctl" >> /etc/sudoers.d/$DISCORD_BOT_SERVICE_USER
echo "$DISCORD_BOT_SERVICE_USER ALL=(ALL) NOPASSWD: /etc/init.d/apache2" >> /etc/sudoers.d/$DISCORD_BOT_SERVICE_USER
echo "$DISCORD_BOT_SERVICE_USER ALL=(ALL) NOPASSWD: /etc/init.d/mariadb" >> /etc/sudoers.d/$DISCORD_BOT_SERVICE_USER
### Create a specific user and group to launch the discord bot service ###
echo "Creating user $DISCORD_BOT_SERVICE_USER..."
sudo useradd -r -s /usr/sbin/nologin $DISCORD_BOT_SERVICE_USER
sudo mkdir -p /home/$DISCORD_BOT_SERVICE_USER
sudo chown $DISCORD_BOT_SERVICE_USER:$DISCORD_BOT_SERVICE_GROUP /home/$DISCORD_BOT_SERVICE_USER
sudo usermod -d /home/$DISCORD_BOT_SERVICE_USER $DISCORD_BOT_SERVICE_USER
### Install DiscordBotLinuxMonitor lib for the user ###
echo "Installing DiscordBotLinuxMonitor for user $DISCORD_BOT_SERVICE_USER..."
sudo -u $DISCORD_BOT_SERVICE_USER -s
python3 -m venv /home/$DISCORD_BOT_SERVICE_USER/venv
source /home/$DISCORD_BOT_SERVICE_USER/venv/bin/activate
python3 -m pip install discordbotlinuxmonitor
deactivate
exit
# Create the Discord bot folder where you should put the json file
sudo mkdir $DISCORD_BOT_FOLDER
### Create a systemd service file for the Discord bot ###
cat <<EOF > $DISCORD_BOT_SERVICE_FILE
[Unit]
Description=Discord Bot Linux Monitor Service
After=network.target
[Service]
ExecStart=/home/$DISCORD_BOT_SERVICE_USER/venv/bin/python3 -m discordbotlinuxmonitor --config_file ${DISCORD_BOT_FOLDER}config.json
WorkingDirectory=$DISCORD_BOT_FOLDER
User=$DISCORD_BOT_SERVICE_USER
Group=$DISCORD_BOT_SERVICE_GROUP
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target
EOF
echo "Service file created at $DISCORD_BOT_SERVICE_FILE"
### Reload systemd to recognize the new service ###
echo "Reloading systemd..."
sudo systemctl daemon-reload
### Enable and start the service ###
echo "Enabling and starting the Discord bot service..."
sudo systemctl enable $DISCORD_BOT_SERVICE_NAME
- Copy your config file into
$DISCORD_BOT_FOLDER/config.json
- Launch the service:
sudo systemctl start $DISCORD_BOT_SERVICE_NAME
License
This project is under MIT license. This means you can use it as you want (just don't delete the library header).
Contribute
If you want to add more examples or improve the library, just create a pull request with proper commit message and right wrapping.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file discordbotlinuxmonitor-1.5.1.tar.gz
.
File metadata
- Download URL: discordbotlinuxmonitor-1.5.1.tar.gz
- Upload date:
- Size: 12.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60b94bd8fae9638f451d4c41a8806a9a16d9d95f67c078384aec287ab2219318 |
|
MD5 | 237bbdc6d8d7dcfa97a8f8efae45ebe8 |
|
BLAKE2b-256 | 3f09d781a597d1b7da6b27f09e4d71c2d32b998e143338bf17641ee8b8833c5f |
File details
Details for the file DiscordBotLinuxMonitor-1.5.1-py3-none-any.whl
.
File metadata
- Download URL: DiscordBotLinuxMonitor-1.5.1-py3-none-any.whl
- Upload date:
- Size: 13.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 72636ed9cd79bd327f9ee565fb2686f5623dea49c07d1a8063230545c3b3a019 |
|
MD5 | c6a9d857cc8ff0e35eb3c76b47258111 |
|
BLAKE2b-256 | 78197ce0d3e1a8515d3fc3fc4c39032fac02e78f410c10dfadb70bd3bb7f6931 |