Tibi Collector

A really lightweight and easy to configure alternative to collectord.

Motivation

I wanted a simple solution of monitoring my Linux server, and the existing solutions were way too complex for my needs. So I decided to write my own tool, which simply polls the system resources at a fixed interval. It is flexible enough so it can be made to monitor pretty much anything, as the finance plugins demonstrate.

Setup

1. Clone this repository

git clone https://github.com/chibicitiberiu/collector.git

2. Install the dependencies

sudo apt install python3 python3-pip
sudo pip3 install -r requirements.txt

Some plugins have additional dependencies:

• speedtest plugin: depends on https://github.com/taganaka/SpeedTest to be built and installed
• SMART plugin: sudo apt install smartmontools

For the database, you will need to install and setup your preferred database and also install the proper python3 drivers:

• Postgres: psycopg2
• MySQL: MySQLdb
• MySQL: pymysql
• SQLite: sqlite3
• CockroachDB: see psycopg2

Check the Peewee documentation for more details about supported databases and advanced connection URLs.

3. Configure

The configuration options can be found in the config.py file. Most options are self explanatory, and there are comments explaining how to setup the more complicated ones.

To completely disable a plugin, just comment it in the collector.py file. For example, to disable the ROBOR plugin, comment it like this:

def __init__(self):
    self.plugins = [
        .......
        # finance
        StocksPlugin(),
        #RoborPlugin()
    ]
    .....

4. Install

sudo ./install.sh

The install.sh script sets up a systemd service called tcollector. You will be able to control the service using the systemctl command.

If something isn't working properly, you can check the logs using the journalctl command:

journalctl -n 1000 _SYSTEMD_UNIT=tcollector.service

Development

All PRs are welcome.