ruuvitag-gollector

Collects data from RuuviTag sensors to InfluxDB and other databases.

Supports the RAWv2 format emitted by RuuviTags with 2.x firmware.

Setup

Compile and install the ruuvitag-gollector binary:

git clone https://github.com/niktheblak/ruuvitag-gollector.git
cd ruuvitag-gollector
make build
make install

Then copy the example configuration file configs/example-config.yaml to $HOME/.ruuvitag-gollector/config.yaml or /etc/ruuvitag-gollector/config.yaml if you're installing the collector globally. and fill your preferred configuration values. For reference of possible configuration values, run ruuvitag-gollector -h.

At the very least you need to add the MAC addresses and human-readable names of your RuuviTags into the config file under the ruuvitags key:

[ruuvitags]
"CC:CA:7E:52:CC:34" = "Backyard"
"FB:E1:B7:04:95:EE" = "Upstairs"
"E8:E0:C6:0B:B8:C5" = "Downstairs"

If you want to save data to InfluxDB (local or remote), add the following options to your config file:

[influxdb]
enabled = true
addr = "http://localhost:8086"
bucket = "ruuvitag"
measurement = "ruuvitag"
token = "abc123"

For a complete configuration example, see example config.

The following exporters are supported for sending measurements:

• InfluxDB
• PostgreSQL
• Webhook, meaning a URL that accepts an HTTP POST request with the measurement as JSON in the request body
• AWS DynamoDB
• AWS SQS
• GCP Pub/Sub
• MQTT

See the command-line help for the arguments needed by each exporter:

ruuvitag-gollector -h

Running

Now you can try to run it manually (you typically need to run as root to allow the collector process access to Bluetooth hardware):

sudo ruuvitag-gollector collect

To collect values continuously, run:

sudo ruuvitag-gollector daemon

Complete Example Configuration

interval = "0m"
device = "default"
console = false

[ruuvitags]
"CC:CA:7E:52:CC:34" = "Backyard"
"FB:E1:B7:04:95:EE" = "Upstairs"
"E8:E0:C6:0B:B8:C5" = "Downstairs"

[influxdb]
enabled = true
addr = "http://localhost:8086"
database = "ruuvitag"
measurement = "ruuvitag"
token = "abc123"

[aws]
access_key_id = "MYAWSAKKESSKEY"
secret_access_key = "my+aws+secret+key"
region = "us-east-2"
[aws.dynamodb]
enabled = true
table = "ruuvitag"
[aws.sqs]
enabled = true
queue.url = "https://us-east-2.queue.amazonaws.com/321667262165/measurements"

[postgres]
enabled = true
conn = "postgres://postgres:mysecretpassword@postgres/postgres?sslmode=disable"
table = "measurements"

[http]
enabled = true
url = "https://my-api.herokuapp.com/receive"
token = "MyHerokuToken"
  
[mqtt]
enabled = true
addr = "tcp://localhost:8883"
client_id = "ruuvitag-gollector"
username = "mqtt_user"
password = "my_secret_password"
ca_file = "root_ca.pem"
auto_reconnect = true
reconnect_interval = 30