Skip to main content

pyLookout

A simple Python program to check Linux system's resource utilization and service availability.

Currently it can:

  • Check CPU, RAM and Disk space
  • Send notifications via SendGrid and Simplepush

Planned functionality:

  • Send notifications via Telegram, WhatsApp and IRC.
  • Check container status.
  • Report new active SSH sessions.
  • Monitor logs to find suspicious activity.
  • Run continuously as a service in the background.

Installation

To install the app, clone the repository and install with pip:

git clone https://github.com/Lab-Brat/pyLookout.git
cd pyLookout
python -m pip install .

Usage

To send notifications pyLookout reads API keys from the environment.

SendGrid requires to specify sending and destination email addresses, and also an API key:

SENDGRID_TO
SENDGRID_FROM
SENDGRID_API_KEY

Simplepush requires only the API key and sends notifications to the app"

SIMPLEPUSH

To run the program, first install it with pip. It will create an executable in /home/$USER/.local/bin/, (which should be in $PATH), and launch it:

pylookout

It will gather server metrics and send a notificationa via preferred method if a certain total utilization percentage is reached (75% by default).

Add it to crontab to run on a schedule.

Metadata

Release files for pylookout 0.2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pylookout 0.2.6
File Size Uploaded Provenance
pylookout-0.2.6.tar.gz 7.0 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for pylookout 0.2.6
File Interpreter ABI Platform
pylookout-0.2.6-py3-none-any.whl Python 3 none any Details

Total release size: 15.3 kB

Release files / pylookout-0.2.6.tar.gz

Download URL pylookout-0.2.6.tar.gz
Size 7.0 kB
Tags Source
SHA-256 checksum
How to use checksums
764bf7f48550a2a7033185ca5690aad732270350495a19393b59d8c50f306a8b
BLAKE2b-256 checksum
How to use checksums
6d6c4ef202cc08bca094533aaf40c4471a4b7a3f6b09dfb9be5ea406606e0458
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.3

Release files / pylookout-0.2.6-py3-none-any.whl

Download URL pylookout-0.2.6-py3-none-any.whl
Size 8.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fce2a4e0c2423009dced1389e612601df0e99958d6966983aaa4fb76683e5338
BLAKE2b-256 checksum
How to use checksums
8a4c49d3610fabcf727ff6b14d5fb02b7d67e324da0a0f338c71036884d930c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.3

Security for pylookout 0.2.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page