https://github.com/sschleemilch/mqtt2influx

MQTT to Influx Subscribe Aggregator
https://github.com/sschleemilch/mqtt2influx

Last synced: 5 days ago
JSON representation

MQTT to Influx Subscribe Aggregator

• Host: GitHub
• URL: https://github.com/sschleemilch/mqtt2influx
• Owner: sschleemilch
• License: mit
• Created: 2023-01-14T10:05:56.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-01-15T12:14:37.000Z (almost 2 years ago)
• Last Synced: 2023-03-05T20:25:40.854Z (over 1 year ago)
• Language: Python
• Size: 29.3 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# MQTT to InfluxDB Aggregator

`mqtt2influx` is an adapter to gather mqtt subscriptions and publish them to influxdb.

```

DEVICE 1 -> +--------------+                   +----------+

DEVICE 2 -> |  MQTT Broker | -> mqtt2influx -> | InfluxDB |

DEVICE 3 -> +--------------+                   +----------+

```

It is configurable through a [YAML configuration](docs/reference.yaml) file.

## Requirements

- A running mqtt broker (e.g. [mosquitto](https://mosquitto.org/)) somewhere, for instance on a Raspberry Pi

- A running [influx db](https://www.influxdata.com/) somewhere, for instance on a Raspberry Pi

- Python > 3.7 and pip

- systemd supported Linux (e.g. Raspbian) if you want to use the installer in the release package

## Installation

The package comes with a reference `config.yaml` that you should adapt to your needs.

### Systemd

- Download and unpack the release in a directory of your choice, e.g. `/opt/mqtt2influx`

- Run `./install.sh` with `sudo` rights (since it creates a global systemd service)

- Start/Enable the service with `sudo systemctl start mqtt2influx.service`

### Manual

Of course you can also just install the `mqtt2influx` application and integrate it in whatever you want. For that, just download the package and install the wheel through

pip or pipx in e.g. a virtual environment.

## Uninstall

Navigate into your installation directory and run `./uninstall.sh`.

It will try to stop the service if it is running and will then delete the systemd service for you. Therefore you will also need to run it with `sudo` rights.

## Usage

Please refer to `mqtt2influx --help`.

## Contributing

See [here](CONTRIBUTING.md) if you would like to contribute.