aranet4-exporter-go is a Prometheus exporter for the Aranet4 environmental sensing devices. Use this to add the CO2, temperature, and humidity readings from your Aranet4 devices to your Prometheus dashboards.
aranet4-exporter-go should work on most modern Linux system with Bluetooth support.
It has been tested on these platforms:
- x86 Ubuntu 22.04
- Raspberry Pi / Raspbian 3b 32-bit
Debian-based distributions can download .deb packages from the releases.
These instructions assume you are on a system using systemd and bluetoothctl
.
-
Use
bluetoothctl
to pair with your Aranet4 device as follows:$ systemctl start hciuart # or enable $ bluetoothctl > power on > agent on > scan on # find the MAC address of the Aranet4 device in the output: # [NEW] Device DD:...:1F Aranet4 26D0F > scan off > pair DD:...:1F # ... enter passcode shown on Aranet4 ... > trust DD:...:1F > agent off > quit
-
If
bluetoothctl
is not installed, you may need to install it:# Raspbian $ sudo apt-get install --no-install-recommends bluetooth pi-bluetooth bluez # Other distros $ sudo apt-get install --no-install-recommends bluetooth bluez
-
Add the MAC address and optional nickname of your devices to
/etc/default/aranet4-exporter
. -
Run
systemctl restart aranet4-exporter
. -
Run
systemctl status aranet4-exporter
to get the port that the daemon was started on, and add the URL to your Prometheus collector.
To add a new versioned release:
$ git tag -a v0.1.0 -m "v0.1.0"
$ git push origin v0.1.0
Snapshot build:
$ podman run --rm --privileged \
-v $PWD:/go/src/github.com/user/repo \
-w /go/src/github.com/user/repo \
-e GITHUB_TOKEN \
docker.io/goreleaser/goreleaser release --snapshot --rm-dist