2017 © Pedro Peláez
 

project webstatus

A PHP library for monitoring Raspbian, Ubuntu or Debian

image

landrok/webstatus

A PHP library for monitoring Raspbian, Ubuntu or Debian

  • Saturday, March 17, 2018
  • by landrok
  • Repository
  • 1 Watchers
  • 3 Stars
  • 8 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 6 Versions
  • 0 % Grown

The README.md

WebStatus Build Status Code Climate Test Coverage

It is a simple and easy monitoring tool. It was designed for Raspbian OS but is compatible with Debian and Ubuntu., (*1)

There is nothing to configure. Just run the installer and use it., (*2)

Want to have a look ? See Live Demo, (*3)


Features

  • Easy to install, (*4)

  • A global summary for processor, memory, temperature, disk space, network and more, (*5)

  • Clear status labels & trends for main metrics, (*6)

  • Each metric is bounded to a dump of the corresponding shell command result, (*7)

  • Live monitoring for CPU, memory and network bandwith usage, (*8)

  • Easy to customize: specific processes, log files, (*9)


Supported OS

  • Raspbian >=8
  • Debian >=8
  • Ubuntu >=14.04

Install

# Download the latest version
wget https://github.com/landrok/webstatus/archive/0.4.0.tar.gz

# Unzip
tar -xf 0.4.0.tar.gz

# Install (Must be done with root rights)
./webstatus-0.4.0/bin/install.sh

If the installation failed:, (*10)

  • Check that your system is up to date
  • Create an issue and Copy/Paste installation logs

Easy install

You have a full-automated mode with -y argument:, (*11)

./webstatus-0.4.0/bin/install.sh -y

Customize title

  • Edit app/config/global-custom.ini.php
  • In the [webapp] section, change, (*12)

    • title value, for web browser status bar title
    • label value, for the HTML navbar title
    • icon value, must be selected among glyphicons, delete the "glyphicon glyphicon-", just keep the last part of the string.

    Example: To print an asterisk, the proposed class is glyphicon glyphicon-asterisk. Just indicate asterisk., (*13)


Hide IP addresses

This feature is only working for IPv4 addresses, (*14)

  • Edit app/config/global-custom.ini.php
  • In the [webapp] section, set hide-ip value to on or 1

Customize thresholds

  • Edit app/config/global-custom.ini.php
  • In the [thresholds] section, change, (*15)

    • *.mid or *.high values for each metric

    Example: To have a green flag below 50% CPU usage, an orange flag for CPU usage between 50 and 70%, and a red flag when CPU usage is over 70%, the values should be cpu.mid=50 and cpu.high=70, (*16)


Customize processes

  • Edit app/config/global-custom.ini.php
  • In the [cron] section, change, (*17)

    • processes.pattern value

    Example: To focus on apache and mysql processes, the value should be "apache|mysql", (*18)


Customize logs

Coming soon, (*19)


Customize menus

Coming soon, (*20)


Activate remote feature

Remote feature has 2 parts: a client and a server, (*21)

  • Install webstatus on the 2 machines
  • On the client machine, edit app/config/global-custom.ini.php, (*22)

    • In the [remote] section, change
    • remote.client value to on
    • remote.url value to http://your-server-url/webstatus/remote.php
  • On the server machine, edit app/config/global-custom.ini.php, (*23)

    • In the [remote] section, change
    • remote.server value to on

That's all. Now you can follow the client status on the server., (*24)

The Versions

17/03 2018

dev-master

9999999-dev https://github.com/landrok/webstatus

A PHP library for monitoring Raspbian, Ubuntu or Debian

  Sources   Download

GPLv3

The Requires

 

The Development Requires

raspberry monitoring ubuntu debian raspbian

21/05 2017

0.4.0

0.4.0.0 https://github.com/landrok/webstatus

A PHP library for monitoring Raspbian or Debian

  Sources   Download

GPLv3

The Requires

 

The Development Requires

raspberry monitoring raspbian

11/05 2017

0.3.1

0.3.1.0 https://github.com/landrok/webstatus

A PHP library for monitoring Raspbian or Debian

  Sources   Download

GPLv3

The Requires

 

raspberry monitoring raspbian

11/05 2017

0.3.0

0.3.0.0 https://github.com/landrok/webstatus

A PHP library for monitoring Raspbian or Debian

  Sources   Download

GPLv3

The Requires

 

raspberry monitoring raspbian

08/05 2017

0.2.1

0.2.1.0 https://github.com/landrok/webstatus

A PHP library for monitoring Raspbian or Debian

  Sources   Download

MIT

The Requires

 

raspberry monitoring raspbian

08/05 2017

0.2.0

0.2.0.0 https://github.com/landrok/webstatus

A PHP library for monitoring Raspbian or Debian

  Sources   Download

MIT

The Requires

 

raspberry monitoring raspbian