Implementing a server monitor with Python enables the early detection of issues to prevent actual crashes. With a few well-organized lines of code, you can monitor CPU usage, RAM, swap, disk space, critical services, and trigger automatic alerts when certain thresholds are exceeded. Python is well-suited for this task due to its mature libraries such as psutil, which provides information on processes and system usage including CPU, memory, disks, network, and sensors. Additionally, the standard library includes modules like smtplib for sending SMTP emails and logging for recording events in files.
The primary goal is not to replace tools like Prometheus, Zabbix, or Wazuh, but to create a lightweight, understandable, and adaptable monitor for small servers, labs, VPS, internal projects, or quick Linux administration alerts. A reliable monitor should focus on monitoring resources that often lead to incidents: high CPU usage, low RAM availability, excessive swap usage, full disk space, services going down, and repeated errors. Additionally, it should prevent frequent duplicate alerts, requiring a cooldown mechanism.
The architecture is straightforward: a Python script reads a configuration file, checks server metrics, validates thresholds, generates logs, stores alert status, and sends notifications via email or webhook. To run it periodically, systemd timer is used, which enables services to be activated at set intervals using options like OnBootSec and OnUnitActiveSec. The monitor can be installed on any Linux server with Python 3, requiring only the external dependency of psutil. To maintain system cleanliness, it is recommended to utilize a virtual environment.
The configuration file defines thresholds, monitored disks, critical services, and alert methods. For simplicity, JSON is used and supported by Python’s standard library through functions like json.load and json.dump. Confidential information like credentials for emails, tokens, or private URLs should be stored in environment variables or a file with restricted permissions.
The script monitors CPU, RAM, swap, disk, and systemd services using functions like psutil.cpu_percent, psutil.virtual_memory, and psutil.disk_usage. To manage log files efficiently, RotatingFileHandler is employed to prevent unlimited file growth. Proper permission assignment is crucial to ensure that the monitor can read metrics and check services without having administrator privileges to modify the server.
Incorporating moderate thresholds initially and observing normal behavior over several days is recommended to avoid overly sensitive alerts that might be ignored later. Python’s smtplib allows the creation of an SMTP client session for sending emails following official documentation guidelines on constructing messages with the email package.
Webhooks facilitate sending alerts to external systems like ChatOps, internal endpoints, n8n, Node-RED, Slack, Mattermost, Discord, Telegram via a bridge, or a custom API. The script uses urllib.request, a standard Python module for opening URLs and making HTTP requests. systemd on modern Linux servers enables service and timer creation, ensuring the script runs predictably at set intervals.
Setting appropriate thresholds depends on the server type, with considerations for varying resource usage patterns. While the basic script provides a foundation, it can be expanded into a more comprehensive solution for enterprises with inventory management, server tags, criticality levels, dashboards, and centralized monitoring. However, it is important to manage the monitor correctly to mitigate risks, such as securing passwords, avoiding arbitrary command execution, establishing clear rules for service restarts, and implementing authentication for public webhooks.
In the event of non-alerting, thorough investigation involving systemd, script logs, environment variables, and SMTP or webhook connectivity is recommended before making any changes. Employing Python along with psutil allows for monitoring various server aspects efficiently, including CPU, memory, swap, disk, and systemd services.
While both tools can be effective, systemd timer integration offers superior support for services, logs, and state control. Prioritize alerting and logging over automated restarts to prevent potential loop failures. It’s essential to understand that this solution is lightweight and suitable for educational purposes, VPSs, labs, or basic alerts, while larger enterprises benefit from centralized monitoring platforms for comprehensive observability and security.
Developing a server monitor with Python serves as a valuable way to enhance Linux administration skills, automate tasks, and establish basic observability. Through utilizing tools like psutil for resource monitoring, systemctl for service checks, smtplib or webhooks for alerts, and systemd timer for scheduled executions, administrators can proactively manage server operations. Implementing this tool judiciously with reasonable thresholds, logging, cooldown periods, protected secrets, well-defined services, and thorough testing can significantly enhance server reliability and preempt potential failures. By embracing proactive monitoring practices, administrators move towards a more professional, preventative, and secure operational environment.
About the Author
