https://github.com/lewispb/promproto
https://github.com/lewispb/promproto
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/lewispb/promproto
- Owner: lewispb
- License: mit
- Created: 2025-12-11T20:24:28.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-11T21:01:53.000Z (7 months ago)
- Last Synced: 2025-12-20T18:14:11.651Z (7 months ago)
- Language: Ruby
- Size: 20.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Promproto
A command-line tool to fetch and display Prometheus metrics in protobuf format.
## Installation
```bash
gem install promproto
```
## Usage
```bash
# Fetch metrics from a target
promproto localhost:9394
# Watch mode - continuously refresh
promproto -w localhost:9394
# Custom refresh interval (in seconds)
promproto -w -n 5 localhost:9394
# Full URL
promproto http://localhost:9394/metrics
```
## Features
- Fetches metrics using the Prometheus protobuf exposition format
- Color-coded output for easy reading
- Supports both classic and native histograms
- Watch mode for continuous monitoring
- Automatic URL normalization (adds http:// and /metrics if missing)
## Native Histograms
When the server exports native histograms, promproto displays:
- Schema and zero threshold
- Zero bucket count
- Positive and negative bucket spans with computed bounds
- Visual bar charts for bucket counts
## Requirements
- Ruby 3.1+
- google-protobuf gem
## License
MIT