PROMETHEUS-SENSOR-EXPORTER(1)

📦 version 0.1.0, in ubuntu resolute, ubuntu stonking

💖 NAME 💖

okay so bestie, <rainbow>prometheus-sensor-exporter</rainbow> — it's a Prometheus exporter for I²C temperature and humidity sensors. literally that's the whole vibe. 🎀

✨ SYNOPSIS ✨

prometheus-sensor-exporter [--web.listen-address ADDRESS]
[--web.telemetry-path PATH] SENSOR...

prometheus-sensor-exporter {-h|--help}

🌸 DESCRIPTION 🌸

prometheus-sensor-exporter is a Prometheus exporter for I²C temperature and humidity sensors. no cap. it just sits there, reads your lil sensors, and serves the numbers up for Prometheus. main character energy tbh. 👑

here's who it can talk to (the supported sensors, periodt):

  • Bosch Sensortec BME280, BMP180, BMP280, BMP388
  • Sensirion SHT30, SHT31, SHT35

💅 OPTIONS 💅

  • --web.listen-address ADDRESS — the address where it exposes metrics and the web interface. (default :9775)
  • --web.telemetry-path PATH — the path under which it exposes metrics. (default /metrics)
  • SENSOR — one or more sensor configurations. each sensor configuration is a comma-separated list. the first element is the model name, and all the following elements are sensor options (scroll down for those, bestie).

🦋 SENSOR OPTIONS 🦋

  • MODEL — the model name of the sensor. the supported models are, and I'm listing all of them because I love you:
    • BME280
    • BMP180
    • BMP280
    • BMP388
    • SHT30
    • SHT31
    • SHT35
  • address=ADDRESS — the I²C address (uint8). (default depends on the model)
  • bus=BUS — the I²C bus number (int). (default 0)
  • repeatability=low|medium|high — the repeatability (only for SHT sensors, iykyk).
  • temp_offset=OFFSET — a fixed temperature offset in °C. this offset gets added to the measured temperature (float64). (default: 0.0)
  • humidity_offset=OFFSET — a fixed humidity offset in percent. this offset gets added to the measured relative humidity (float64). (default: 0.0)

🌈 EXAMPLES 🌈

here's an example where you monitor two sensors: one Bosch BME280 on I²C bus 0 (using the default address) and one Sensirion SHT35 on I²C bus 1 with address 0x45. obsessed, honestly.

prometheus-sensor-exporter BME280,bus=0 SHT35,bus=1,address=0x45

📜 COPYING 📜

Copyright © 2021-2025 Benjamin Drung. free use of this software is granted under the terms of the ISC License. slay. 🫶

💜 AUTHOR 💜

Benjamin Drung

okay that's the whole page, bestie 💖 this was prometheus-sensor-exporter version 0.1.0, dated 2026-02-16, and it's from the prometheus-sensor-exporter manual. go forth and read your sensors, you absolute icon. 🌟🎀🦋

📦 where this page comes from