Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .github/screenshots/readme-carousel.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed .github/screenshots/ss-01.png
Binary file not shown.
Binary file removed .github/screenshots/ss-02.png
Binary file not shown.
Binary file removed .github/screenshots/ss-03.png
Binary file not shown.
Binary file removed .github/screenshots/ss-04.png
Binary file not shown.
Binary file removed .github/screenshots/ss-05.png
Binary file not shown.
Binary file removed .github/screenshots/ss-08.png
Binary file not shown.
Binary file removed .github/screenshots/ss-09.png
Binary file not shown.
25 changes: 9 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,29 +12,22 @@

## Why RunRight

Grafana, Datadog, and Sentry tell you how your application behaves. They do not tell you whether you are paying for the right machine. RunRight answers that one question: given your actual p95 CPU and memory usage, what is the cheapest specific AWS or GCP instance type that still leaves headroom?
Grafana, Datadog, and Sentry tell you how your application behaves. They do not tell you whether you are paying for the right machine. **RunRight solves that: given your actual p95 CPU and memory usage, it recommends the cheapest AWS or GCP instance type that still fits your workload.**

- **No code changes.** It runs as a sidecar process, not an SDK or agent you instrument your app with.
- **Minimal overhead.** Polls `/proc` via gopsutil at a configurable interval (default 5s). Typical footprint: under 5 MB RSS, under 0.1% CPU on the sampler process. Your build time is not affected.
- **Actionable output.** Instead of a graph you have to interpret, you get a specific instance recommendation with a cost delta and a tier label.
- **Works with what you have.** Exports via OTLP, Prometheus, or flat JSON. If you already ship metrics to Datadog or Grafana Cloud, RunRight plugs straight in.
### Key Features

- **No code changes.** Runs as a sidecar—not an SDK or agent you instrument. Drop it in any CI pipeline.
- **Minimal overhead.** Polls `/proc` every 5s. Footprint: under 5 MB RSS, under 0.1% CPU. Your builds stay fast.
- **Actionable insights.** Get specific instance recommendations with cost delta and tier labels—no graphs to interpret.
- **Works with your stack.** Exports via OTLP, Prometheus, or JSON. Integrates with Datadog, Grafana Cloud, or any observability tool.

---

## In action

<p align="center"><sub>Per-run CPU & memory samples</sub></p>
<p align="center">
<img src=".github/screenshots/ss-04.png" width="49%" alt="Run detail: CPU and memory metrics" />
<img src=".github/screenshots/ss-05.png" width="49%" alt="Recommendations: right-sized, cheaper-option, more-headroom tiers" />
</p>

<p align="center"><sub>Instance recommendations by tier: right-sized / cheaper-option / more-headroom</sub></p>

<p align="center"><sub>All jobs · Run history per job</sub></p>
<p align="center"><sub>Live product tour: dashboard, run insights, recommendations, and job history</sub></p>
<p align="center">
<img src=".github/screenshots/ss-01.png" width="49%" alt="Jobs list" />
<img src=".github/screenshots/ss-09.png" width="49%" alt="Job detail: run history" />
<img src=".github/screenshots/readme-carousel.gif" width="98%" alt="RunRight UI carousel: jobs, run detail, recommendations, and history" />
</p>

<p align="center"><sub>Pipe your data into Grafana, Datadog, or any metrics tool. Raw runs land in Postgres.</sub></p>
Expand Down
Loading