Give some more info in readme

This commit is contained in:
Mario Voigt 2025-03-03 22:41:59 +00:00
parent 3336126ceb
commit 115d43cc79

View File

@ -1,11 +1,23 @@
# Prometheus Exporter # Prometheus Exporter
Export BFFH Data as Prometheus Metric Export BFFH Data as Prometheus Metric.
# Env Variables The exporter uses the [pyfabapi](https://docs.fab-access.org/books/schnittstellen-und-apis/page/fabaccess-api#bkmrk-pyfabapi) (Python API wrapper for FabAccess API) to access the resource list (machines) and their states and meta information (names, categories).
* POLLING_INTERVAL_SECONDS = 5
* EXPORTER_PORT = 9000 Sample line:
* BFFH_HOST = localhost ```
* BFFH_PORT = 59661 bffh_machine_state{category="Central Stairs",machine_id="zam-raum1-ecke1-lamp",machine_name="1 Lampe"} 1.0
* BFFH_USER = Admin1 ```
* BFFH_PASSWORD = secret
# Installation & Documentation
Please see [docs.fab-access.org](https://docs.fab-access.org/books/schnittstellen-und-apis/page/monitoring-prometheus-loki-und-grafana#bkmrk-installation-von-fab) for installation steps and how to use together with Grafana.
## Installation with Docker
In case you want to use the provided Dockerfile, you can use the following environment variables to run:
* `POLLING_INTERVAL_SECONDS` = 5
* `EXPORTER_PORT` = 9000
* `BFFH_HOST` = localhost
* `BFFH_PORT` = 59661
* `BFFH_USER` = Admin1
* `BFFH_PASSWORD` = secret