rush is a Rust terminal client for live Rush telemetry. It tails logs or APM
spans, applies server-side searches and structured filters, lets you freeze the
screen without losing incoming records, and opens the selected record in the
Rush web UI.
It polls a sliding time window through Rush's versioned query endpoint,
/api/v1/query/execute, so it needs query-api v0.1.12 or later. It does not
need a streaming endpoint.
- Live logs and APM/span views in one TUI
- Server-side free-text search and field filters
- Pause/resume with an in-memory pending-record buffer
- Bounded deduplicated local history
- Selected-row detail panel and readable duration/severity formatting
- Exact web context:
- APM rows open
/trace/<trace_id> - Log rows open Explore Logs in a ±5 second window and highlight the timestamp
- APM rows open
- Newline-delimited JSON mode for shell pipelines
- API-key auth and tenant scoping
- TOML, environment variable, and CLI configuration
cargo install --git https://github.com/RushObservability/cli.gitThis installs the rush binary.
For local development from a checkout, use cargo install --path ..
To release, bump version in Cargo.toml (and Cargo.lock, with
cargo update -p rush-cli --offline) in a pull request. Merging it to main
tags v<version>, builds archives for Linux x86_64, macOS Intel, macOS Apple
Silicon, and Windows x86_64, and publishes them with SHA-256 checksums to a
GitHub Release. A Cargo.toml change that keeps a released version publishes
nothing.
To retry a release that failed, run gh workflow run release.yml --ref main.
Create an API key in Rush → Settings → API Keys, then export it. Environment variables are preferred on shared machines so the key is not stored in shell history or a world-readable file.
export RUSH_URL=https://rush.example.com
export RUSH_WEB_URL=https://rush.example.com
export RUSH_API_KEY='your-api-key'
export RUSH_TENANT=defaultRush API keys are tenant-scoped. --tenant sends X-Rush-Tenant, but it cannot
expand an API key beyond the tenant that issued it.
For local development the defaults are http://localhost:8080 for the API and
http://localhost:5173 for the web UI. Open tenants can be queried without a
key; locked tenants require one.
Start a log tail:
rush tail logsTail only error logs for one service:
rush tail logs \
--filter service_name=gateway \
--filter severity=ERROR \
--search 'connection timeout'Tail slow APM spans:
rush tail apm \
--filter service_name=articles \
--filter 'duration_ns>=250000000'Stream NDJSON into another command:
rush tail logs --output json --search panic | jq -r '.summary'Use the same combined search syntax as the Rush Explore page:
rush tail logs --search 'service_name=gateway POST'This sends service_name=gateway as a structured filter and searches the
remaining log text for POST.
Run rush tail --help for polling, buffer, and time-window options.
Filters support =, !=, >, >=, <, <=, and ~. The ~ shorthand is
a contains match (LIKE %value%). Quote filters containing shell operators.
Useful log fields include service_name, severity, body, trace_id,
span_id, resource.<attribute>, and log.<attribute>. Useful APM fields
include service_name, span_name, http_method, http_path,
http_status_code, duration_ns, status, trace_id, and span_id.
| Key | Action |
|---|---|
Space |
Pause/resume the visible stream; polling continues into a buffer |
Tab |
Switch between logs and APM |
/ |
Edit combined structured filters and free-text search |
f |
Edit the most recent structured field filter; creates one when none exists |
x |
Remove the last field filter |
c |
Clear search and filters |
r |
Refresh now |
j / k |
Move selection |
g / G |
Jump to newest/oldest |
Enter |
Toggle record context |
w |
Toggle main-stream message wrapping (up to three lines per row) |
o |
Open selected context in the Rush web UI |
? |
Show keyboard help |
q |
Quit |
While editing a search or filter, use Left / Right to move the cursor,
Home / End to jump, and Backspace / Delete to edit. Enter applies the
new value and Esc cancels it. The editor also supports Ctrl-A, Ctrl-E,
Ctrl-U, and Ctrl-K.
Selected-record details always word-wrap. Main-stream rows stay compact by
default; press w when you want to expand messages in place.
The default config location is platform-specific: Linux normally uses
~/.config/rush/config.toml, while macOS uses the application-support directory.
Pass --config <path> when you want an explicit location. Copy
config.example.toml as a starting point, and restrict
its permissions if it contains an API key.
Precedence is:
- CLI options
RUSH_*environment variables- TOML config
- built-in defaults
Available environment variables:
RUSH_URLRUSH_WEB_URLRUSH_API_KEYRUSH_TENANTRUSH_POLL_INTERVAL_MSRUSH_WINDOW_SECONDSRUSH_BUFFER_SIZERUSH_ALLOW_INSECURE_HTTP— set to any value to permit sendingRUSH_API_KEYover plaintexthttp://to a remote host. Refused by default, because the key would travel in cleartext. Loopback URLs such ashttp://localhost:8080are always allowed and need no override.
The client polls newest-first results from:
POST /api/v1/logswithslim: truePOST /api/v1/querywithcolumns: "list"
Each request covers a sliding recent window. The client deduplicates records,
sorts them by nanosecond timestamp, and caps memory at buffer_size. While the
screen is paused, network polling continues and unique incoming records are kept
in a second bounded buffer. Resume merges that buffer into the visible stream.
This approach works with current Rush deployments. A future SSE/WebSocket tail endpoint could reduce polling overhead without changing the TUI model.
Run the complete local pull-request gate:
make ciUseful targets include make test, make lint, make build, make release,
and make install. Run make help for the complete list. To start the TUI
through Cargo, use make run-logs or make run-apm; pass CLI options with
ARGS, for example:
make run-logs ARGS="--search 'service_name=gateway POST'"