firefly-exporter/README.md

35 lines
962 B
Markdown

# Budget Exporter
Export Firefly-iii budget data for prometheus consumption.
## Usage
Install `Flask` and `requests` in your python environment:
pip install -r requirements.txt
Create a personal access token in your firefly installation:
Go to
[https://your-firefly-installation/profile](https://your-firefly-installation/profile)
, create a token and copy the (very long) string.
Put your personal access token and your API host in your environment:
export FIREFLY_PERSONAL_ACCESS_TOKEN="abcd.....1234"
export FIREFLY_API_HOST="https://your-firefly-installation"
Run the exporter:
FLASK_APP=exporter.py python -m flask run -h 127.0.0.1 -p 5000
Now scrape `/metrics` on port localhost:5000.
## Docker
Or use the prebuilt docker image:
docker run -e FIREFLY_API_HOST="https://your-firefly-installation" -e FIREFLY_PERSONAL_ACCESS_TOKEN="abcd....1234" -p 9449:5000 zknt/firefly-exporter
and scrape port 9449 on your docker host.