Create README.md

README.md

@@ -0,0 +1,72 @@
+# 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
+
+~~~sh
+git clone https://github.com/chibicitiberiu/collector.git
+~~~
+
+### 2. Install the dependencies
+
+~~~sh
+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:
+
+~~~python
+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.