Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/go-pluto/styx
Export Data from Prometheus to csv, gnuplot & matplotlib
https://github.com/go-pluto/styx
csv gnuplot go grafana matplotlib prometheus
Last synced: 5 days ago
JSON representation
Export Data from Prometheus to csv, gnuplot & matplotlib
- Host: GitHub
- URL: https://github.com/go-pluto/styx
- Owner: go-pluto
- License: mit
- Created: 2017-08-16T21:36:01.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-02-03T12:34:48.000Z (9 months ago)
- Last Synced: 2024-08-01T19:45:43.367Z (3 months ago)
- Topics: csv, gnuplot, go, grafana, matplotlib, prometheus
- Language: Go
- Homepage: https://speakerdeck.com/metalmatze/prometheus-styx
- Size: 1.18 MB
- Stars: 98
- Watchers: 5
- Forks: 24
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# styx
Export Prometheus data as CSV or directly plot with gnuplot & matplotlib.
## Installation
```bash
go install github.com/go-pluto/styx@latest
```
If you want to simply export data from Prometheus as CSV then you don't need to install any thing else.
### Optional Dependencies
If you want to plot directly with gnuplot, you need to install gnuplot first.
#### gnuplot
```bash
brew install gnuplot # macOS
apt-get install gnuplot # Debian / Ubuntu
pacman -S gnuplot # ArchLinux
```
#### matplotlib
```bash
pip install matplotlib
pip2 install matplotlib # macOS
```
## Usage
Once you've [installed](#Installation) styx you can export data.
My recommendation is to actually build the queries in the Prometheus UI
only if you've played with the data there and you know which query is best,
copy the query and use it to export the data with styx.
#### CSV
```bash
# export the data for the last hour from http://localhost:9090
styx 'go_goroutines'
styx 'sum(go_goroutines)'
styx 'go_goroutines{job="prometheus"}'
styx 'go_goroutines > 100'
# export the data for the last 6 hours from http://localhost:9090
styx --duration 6h 'sum(go_goroutines)'
# export the data from a specific prometheus for the last hour.
styx --prometheus http://prom.example.com 'sum(go_goroutines)'
```
#### gnuplot
```bash
# plot the data for the last hour from http://localhost:9090
styx gnuplot 'sum(go_goroutines)' > goroutines.gnuplot
# plot the data for the last 6 hours from http://localhost:9090
styx gnuplot --duration 6h 'sum(go_goroutines)' > goroutines.gnuplot
# plot the data from a specific prometheus for the last hour.
styx gnuplot --prometheus http://prom.example.com 'sum(go_goroutines)' > goroutines.gnuplot
```
Once you have written the generated content into a file you can use this to
edit and plot the graph:
```bash
gnuplot -p < test.gnuplot
```
#### matplotlib
```bash
# plot the data for the last hour from http://localhost:9090
styx matplotlib 'sum(go_goroutines)' > goroutines.py
# plot the data for the last 6 hours from http://localhost:9090
styx matplotlib --duration 6h 'sum(go_goroutines)' > goroutines.py
# plot the data from a specific prometheus for the last hour.
styx matplotlib --prometheus http://prom.example.com 'sum(go_goroutines)' > goroutines.py
```
Once you have written the generated content into a file you can use this to
edit and plot the graph:
```bash
python goroutines.py
```