Skip to content

Latest commit

 

History

History
81 lines (56 loc) · 2.04 KB

README.md

File metadata and controls

81 lines (56 loc) · 2.04 KB
Raw

DHT Prometheus Exporter

A Prometheus exporter for DHT22/AM2302 sensors runnable on Raspberry Pi

This repository contains a Prometheus exporter designed for the DHT22/AM2302 temperature and humidity sensors, optimized for use on Raspberry Pi devices.

Prerequisites

Before you begin, ensure you have the necessary tools and dependencies installed:

  • Install Golang and set up your environment variables:
sudo apt-get install golang
export GOPATH="$HOME/go"
export GOBIN="$GOPATH/bin"
export PATH="$PATH:$GOBIN"
  • Make: Required for building the source code:
sudo apt install make
  • Dep: Golang's dependency management tool:
go get -u github.com/golang/dep/cmd/dep

Installation

Follow these steps to install the DHT Prometheus Exporter on your Raspberry Pi:

  1. Download the project:
go get -u github.com/guivin/dht-prometheus-exporter
cd $GOPATH/src/github.com/guivin/dht-prometheus-exporter
  1. Build and install the project:
make all
  1. Create a dedicated system user that belongs to the gpio group (for GPIO pin access):
useradd --user-group --groups gpio --no-create-home --system --shell /usr/sbin/nologin dht-prometheus-exporter
  1. Set up the configuration file. Copy the default configuration file and modify it according to your needs:
cp dht-prometheus-exporter.yml /etc/dht-prometheus-exporter.yml
sudo chown dht-prometheus-exporter:dht-prometheus-exporter /etc/dht-prometheus-exporter.yml
sudo chmod 0640 /etc/dht-prometheus-exporter.yml
  1. Integrate with systemd for easy service management:
cp dht-prometheus-exporter.service /etc/systemd/system
sudo systemctl daemon-reload
sudo systemctl start dht-prometheus-exporter

Usage

Retrieve the metrics from the exporter by querying the designated HTTP endpoint (adjust the port if your configuration differs):

  GET http://localhost:8080/metrics

This command will output the current readings from your DHT22/AM2302 sensors, making the data available for Prometheus scraping and subsequent analysis or visualization.