https://github.com/tbotnz/RRDReST

Converts RRD Files to a easy to consume ReST API
https://github.com/tbotnz/RRDReST

cacti librenms mrtg observium rrd rrd-files rrdcache rrdcached rrdtool

Last synced: about 2 months ago
JSON representation

Converts RRD Files to a easy to consume ReST API

• Host: GitHub
• URL: https://github.com/tbotnz/RRDReST
• Owner: tbotnz
• Created: 2021-06-27T02:59:15.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2021-10-11T05:49:14.000Z (over 3 years ago)
• Last Synced: 2024-08-02T16:00:39.531Z (10 months ago)
• Topics: cacti, librenms, mrtg, observium, rrd, rrd-files, rrdcache, rrdcached, rrdtool
• Language: Python
• Homepage:
• Size: 1.01 MB
• Stars: 27
• Watchers: 3
• Forks: 6
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# RRDReST

simple micro service for converting your RRD's to web services

![rrdReST](/rrdshot.PNG)

### getting started

- ensure you have ```rrdtool``` installed and you can access the rrd files from the server

- git clone the project ``` git clone https://github.com/tbotnz/RRDReST && cd RRDReST ```

- install the requirements ```pip3 install -r requirements.txt```

- run the app with uvicorn ```uvicorn rrdrest:rrd_rest --host "0.0.0.0" --port 9000```

- access the swagger documentation via ```http://127.0.0.1:9000/docs```

### examples

- last 24 hours ```curl 127.0.0.1:9000/?rrd_path=tests/port-id15.rrd```

- epoch date time filter ```curl 127.0.0.1:9000/?rrd_path=tests/port-id15.rrd&epoch_start_time=1622109000&epoch_end_time=1624787400```

### rrdtool

- tested with version 1.7