Skip to main content

py3status http monitor show the status of http endpoints

Project description

py3status-http-monitor

Python module for monitoring http services in your py3status bar.

Screenshot

Status Bar with py3status_http_monitor

Prerequisites

This is an i3 / py3status module, so you'll need those first off.

Installation

From Git

git clone https://github.com/mcgillij/py3status-http-monitor.git
mkdir -p ~/.i3/py3status && cd ~/.i3/py3status
ln -s <PATH_TO_CLONED_REPO>/src/py3status-http-monitor/http_monitor.py ./

With Pip, Pipenv or Poetry

pip install py3status-http-monitor
pipenv install py3status-http-monitor
poetry add py3status-http-monitor && poetry install

Building Arch package w/PKGBUILD

git clone https://aur.archlinux.org/py3status-http-monitor.git
cd py3status-http-monitor.git
makechrootpkg -c -r $HOME/$CHROOT

Installing built Arch package

sudo pacman -U --asdeps py3status-http-monitor-*-any.pkg.tar.zst

Configuration

Next you will need to add the services you want to monitor, and optionally choose some appropriate emoji's.

~/.config/i3/i3status.conf

...
general {
        colors = true
        interval = 15
}

order += "http_monitor apache"
order += "http_monitor medusa"
order += "http_monitor pihole"
order += "http_monitor nextcloud"
order += "http_monitor plex"
order += "http_monitor virtualbox"
order += "http_monitor airsonic"
order += "clock"
order += "mail"
...

http_monitor  'nextcloud' {
   service_location = "http://yourserver:8181"
   service_name = '⛅'
}

http_monitor  'virtualbox' {
   service_location = "http://yourserver:81/vb/"
   service_name = '💻'
}

http_monitor  'plex' {
   service_location = "http://yourserver:32400/web/index.html#"
   service_name = '🎥'
}

http_monitor  'airsonic' {
   service_location = "http://yourserver:4040"
   service_name = '🍃'
}

http_monitor  'pihole' {
   service_location = "http://yourserver:80"
   service_name = '🕳️ '
}

http_monitor  'apache' {
   service_location = "http://yourserver:81"
   service_name = '🪶'
}

http_monitor  'medusa' {
   service_location = "http://yourserver:8081"
   service_name = '🐍'
}

Configuration Options

You can pass in the following configuration options:

  • service_location
  • service_name
  • timeout
  • cache_timeout

Restart i3

Once the package is installed and configured you just need to restart i3.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for py3status-http-monitor, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size py3status_http_monitor-0.1.2-py3-none-any.whl (4.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size py3status-http-monitor-0.1.2.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page