psdash is a system information web dashboard for linux using data mainly served by psutil - hence the name.

• Features
• Installation
• Getting started
• Configuration
• Screenshots
• License

• Overview
  Dashboard overview of the system displaying data on cpu, disks, network, users, memory, swap and network.

• Processes
  List processes (top like) and view detailed process information about each process.

  Apart from a detailed process overview this is also available for each process:

  • Open files
  • Open connections
  • Memory maps
  • Child processes
  • Resource limits

• Disks
  List info on all disks and partitions.

• Network
  List info on all network interfaces and the current throughput. System-wide open connections listing with filtering. Somewhat like netstat.

• Logs
  Tail and search logs. The logs are added by patterns (like /var/log/*.log) which are checked periodically to account for new or deleted files.

• Multi-node/Cluster Support for multiple agent nodes that is either specified by a config or will register themselves on start-up to a common psdash node that runs the web interface.

• All data is updated automatically, no need to refresh

The GUI is pretty much a modified bootstrap example as I'm no designer at all. If you got a feel for design and like to improve the UI parts of psdash, please create a pull request with your changes. It would be much appreciated as there's much room for improvements.

Make sure your system is able to build Python C extensions. On Debian derivatives such as Ubuntu this should translate to installing the build-essential and python-dev packages using apt-get:

# apt-get install build-essential python-dev

And on RHEL (Fedora, CentOS etc.) distributions:

# yum groupinstall "Development Tools"
# yum install python-devel

Installation using pip:
$ pip install psdash

Since pip 1.5.1 you are forced to add --allow-external argparse since the latest argparse is hosted on google code.

Installation from source:
$ python setup.py install

Starting psdash:
$ psdash

Starting a psdash agent:
$ psdash -a --register-to [http|https]://[host]:[port] --register-as my-agent-node

This will start psdash in agent mode and try to register the node to the main psdash node pointed to by the --register-to option. An agent node will setup an RPC server rather than a webserver at the host and port specified by -p/--port and -b/--bind respectively. The main psdash node (serving HTTP) will present a list of registered nodes that are available to switch between.

Available command-line arguments:

$ psdash --help
usage: psdash [-h] [-l path] [-b host] [-p port] [-d] [-a]
              [--register-to host:port] [--register-as name]

psdash [version] - system information web dashboard

optional arguments:
  -h, --help            show this help message and exit
  -l path, --log path   log files to make available for psdash. Patterns (e.g.
                        /var/log/**/*.log) are supported. This option can be
                        used multiple times.
  -b host, --bind host  host to bind to. Defaults to 0.0.0.0 (all interfaces).
  -p port, --port port  port to listen on. Defaults to 5000.
  -d, --debug           enables debug mode.
  -a, --agent           Enables agent mode. This launches a RPC server, using
                        zerorpc, on given bind host and port.
  --register-to host:port
                        The psdash node running in web mode to register this
                        agent to on start up. e.g 10.0.1.22:5000
  --register-as name    The name to register as. (This will default to the
                        node's hostname)

psdash uses the configuration handling offered by Flask. The configuration file pointed to by the environment varible PSDASH_CONFIG will be read on startup.
e.g: $ PSDASH_CONFIG=/home/user/config.py psdash

In addition to the built-in configuration values that comes with Flask there's a number of psdash specific ones as well:

Overview: Listing processes: Overview of a process: Connections of a process: Environment of a process: Network: Disks: Tailing a log: Searching a log:

Released under CC0 (Public Domain Dedication).

http://creativecommons.org/publicdomain/zero/1.0/