Harpseal is a python app that collects system resources, usage and others by plugins which are extendable. Harpseal gives you easy accessible API to draw a graph or to analysis data by JSON format.


  • Plugin — Harpseal is built upon a plugin system which allows support for new plugin to be easily created and added. It’s quite easy in fact as you can see in this documentation. even you don’t know anything about Harpseal structures.
  • HTTP API - JSON/JSONP (callback)
    • It is possible to create a cluster monitoring system with super simple HTTP API.
    • As I’ve written above, even you can get jsonp callback mechanism; the more easily, you can create it with Javascript only.
  • Light-weighted: with event-driven. Harpseal requires a lower memory footprint than many of system resource monitoring tools.
  • Free. Harpseal is totally free to use even for commercial purposes.
  • Super easy to install: it’s super easy to install and set up Harpseal server on your Debian-based linux distros because it’s already ready.

Getting Started


Harpseal requires the following dependencies:

  • Python 3.3 and asyncio or Python 3.4+
  • aiohttp library
  • psutil library for built-in plugins
  • mongoengine library for data storage
  • IPy library




(TBA with installation)

Built-in Plugins

  • cpu - CPU watch plugin; it watches for each CPU usage, PID count and CPU times.
  • mem - Memory watch plugin; it watches for detailed memory usage data including swap memory.
  • disk - Disk watch plugin; it watches for each disk IOs and spaces.
  • net - Network watch plugin; it logs for network statistics.

Indices and tables


All source codes are distributed under the Apache License.


SuHun Han / @ssut