balance-subscriber 0.0.1rc1

MQTT listener to save data

MQTT subscriber

A service to listen for messages and save the data.

Installation

Install Python package

Create a virtual environment

sudo mkdir -p /opt/balance-subscriber
sudo python3 -m venv /opt/balance-subscriber/venv

Activate the virtual environment

source /opt/balance-subscriber/venv/bin/activate

Install this package

pip install --upgrade balance-subscriber

Set up service

Create a service account called balance-subscriber.

sudo useradd --system balance-subscriber

This user must have permissions to write to the target data directory.

Install the systemd service.

cp --verbose ./systemd/balance-subscriber.service /etc/systemd/system/balance-subscriber.service

Configure the service

systemctl edit myservice

This will create an override configuration file in the directory /etc/systemd/system/balance-subscriber.service.d. Edit this file to set the options for the service, such as the target data directory.

[Service]
Environment="DATA_DIR=/tmp"
Environment="HOST=localhost"

The available options are listed in the configuration section.

Configuration

The following options are available.

Setting	Description
DATA_DIR	The target directory to serialise MQTT messages to.
HOST	MQTT broker host name
PORT	MQTT broker port
TOPICS	MQTT topics

These settings are specified in the configuration file for the systemd service as described in the installation section.

Usage

The app will run as a service in the background.

Monitoring

View service status

sudo systemctl status balance-subscriber.service

View logs

sudo journalctl -u balance-subscriber.service --since "1 hour ago"