Promegraph

June 28, 2025

Membuat grafik prometheus

Perkenalkan alat cli untuk membuat grafik / visualisasi query prometheus, promegraph. Alat ini lahir dari keinginan buat memvisualisasikan data time-series Prometheus dengan cepat dan efisien, langsung dari terminal kesayangan kita.

instalasi

Jika rust cargo sudah ada, gunakan cargo install:

$ cargo install --locked --git https://github.com/sakti/promegraph.git
    Updating git repository `https://github.com/sakti/promegraph.git`
  Installing promegraph v0.1.0 (https://github.com/sakti/promegraph.git#a347506a)
    ...
    Finished `release` profile [optimized] target(s) in 30.64s
   Replacing /Users/sakti/.cargo/bin/promegraph
    Replaced package `promegraph v0.1.0 (/Users/sakti/dev/promegraph)` with `promegraph v0.1.0 (https://github.com/sakti/promegraph.git#a347506a)` (executable `promegraph`)

Atau gunakan docker:

$ docker run --rm ghcr.io/sakti/promegraph
error: the following required arguments were not provided:
  <EXPR>

Usage: promegraph <EXPR>

For more information, try '--help'.

Penggunaan

Jalankan perintah promegraph dengan expresi PromQL yang wajib diisi. PromQL ini akan dieksekusi pada target server dengan default http://localhost:8428/ dan dapat diganti menggunakan opsi flag -a atau --addr. Untuk selengkapnya gunakan flag -h.

Usage: promegraph [OPTIONS] <EXPR>

Arguments:
  <EXPR>  Promql expression

Options:
  -a, --addr <ADDR>          Prometheus server address [default: http://localhost:8428/]
  -s, --step <STEP>          Step [default: 15]
  -d, --duration <DURATION>  Duration in minutes [default: 1]
  -b <BACKEND>               [default: textplots] [possible values: plotters, textplots]
  -h, --help                 Print help
  -V, --version              Print version

Source code tersedia di https://github.com/sakti/promegraph.

Return to blog

footer