rtally 0.5.0

A real-time log stream analyzer and ranking tool similar to top command.
rtally-0.5.0 is not a library.

tally - The top command for log streams

CI

tally aggregates log lines from stdin in real time and shows a ranked top list. Unlike sort | uniq -c | sort -nr, you can see “what’s hot right now” as the stream flows.

Features

  • Real-time aggregation: continuously updated Top N while the stream is flowing
  • TUI display: bar-chart ranking in the terminal
  • Fast: Rust-based and optimized for high throughput
  • Simple: works as a drop-in pipe with no query language

Use Cases

  • Live monitoring of popular paths in access logs
  • Detect spikes in error levels or messages
  • First-pass troubleshooting for fast-moving logs

Installation

# Cargo (Rust)
cargo install rtally

# Homebrew / binary releases are planned

Note: crates.io package name may differ from binary name. See Cargo.toml.

Usage

tail -f access.log | cut -d ' ' -f 7 | tally

Field selection (no need for cut)

# 7th field (space-separated)
tail -f access.log | tally -f 7

# 3rd field (comma-separated)
tail -f access.log | tally -f 3 -d ','

Options (some planned)

  • -f, --field <N>: Aggregate the Nth field after splitting
  • -d, --delimiter <CHAR>: Delimiter character (1 char)
  • -n, --top <N>: Show top N entries (default: 10)
  • --interval <MS>: Refresh interval in ms (clamped to 50–2000)

Spec Notes

  • Input is processed as UTF-8; invalid bytes are replaced and processing continues
  • Set NO_COLOR=1 to disable ANSI color output

Performance (quick check)

# Release build
cargo build --release

# Quick check with sample input
time cat samples/bench.log | ./target/release/tally -f 1 -d '=' -n 5 --interval 200 > /dev/null

Examples

# 1) Popular paths in access log
tail -f access.log | tally -f 7

# 2) Second column in CSV
tail -f data.csv | tally -f 2 -d ','

# 3) Top 5 with faster refresh
tail -f access.log | tally -f 7 -n 5 --interval 100

FAQ

Q. The output does not refresh
A. Check if --interval is too large and whether input is actually flowing.

Q. The aggregation looks wrong
A. -f is 1-based. Check delimiter settings and how consecutive delimiters are treated.

Q. I see mojibake
A. Ensure the input is UTF-8; verify your LC_ALL.

Development

# Build
cargo build

# Test
cargo test

# Format
cargo fmt

# Lint
cargo clippy

Contributing

  • Review ROADMAP.md and PRD.md first
  • See CONTRIBUTING.md for development workflow and rules

Documents

  • CONTRIBUTING.md
  • CODE_OF_CONDUCT.md
  • SECURITY.md
  • CHANGELOG.md
  • RELEASE.md
  • LICENSE

License

  • MIT License (LICENSE)

Security

  • See SECURITY.md for reporting

tally - The top command for log streams (日本語)

tally は標準入力のログをリアルタイムで集計し、頻出項目をランキング表示するCLIツールです。 sort | uniq -c | sort -nr のように全件読み込み完了を待たず、実行直後から「今多いもの」を見られます。

主な特徴

  • リアルタイム集計: 入力が流れ続けてもトップNが更新され続ける
  • TUI表示: バーチャート付きの見やすいランキング
  • 高速: Rust実装で高スループットに対応
  • シンプル: パイプで繋ぐだけ、複雑なクエリ不要

使いどころ

  • アクセスログの人気パスをライブ監視
  • 失敗ステータスやエラー文言の急増を検知
  • バッチでは追いにくいトラブルシューティングの一次調査

インストール

# Cargo (Rust)
cargo install rtally

# 将来的に Homebrew / バイナリ配布を予定

※ crates.ioのパッケージ名はバイナリ名と異なる場合があります（Cargo.toml を参照）。

使い方

tail -f access.log | cut -d ' ' -f 7 | tally

フィールド指定（cut不要）

# 空白区切りの7番目を集計
tail -f access.log | tally -f 7

# カンマ区切りの3番目を集計
tail -f access.log | tally -f 3 -d ','

オプション（予定含む）

  • -f, --field <N>: 区切り文字で分割したN番目の要素を集計
  • -d, --delimiter <CHAR>: 区切り文字を指定（1文字）
  • -n, --top <N>: 上位N件のみ表示（デフォルト: 10）
  • --interval <MS>: 描画更新間隔（ミリ秒、50〜2000に丸め）

仕様メモ

  • UTF-8として処理し、不正なバイト列は置換して継続処理する
  • NO_COLOR=1 を設定するとANSIカラーを無効化できる

性能計測（簡易）

# リリースビルド
cargo build --release

# サンプル入力での簡易計測
time cat samples/bench.log | ./target/release/tally -f 1 -d '=' -n 5 --interval 200 > /dev/null

使用例

# 1) アクセスログの人気パス
tail -f access.log | tally -f 7

# 2) CSVの2列目を集計
tail -f data.csv | tally -f 2 -d ','

# 3) 上位5件だけ表示、更新間隔を短く
tail -f access.log | tally -f 7 -n 5 --interval 100

FAQ

Q. 出力が更新されません
A. --interval が大きすぎないか確認してください。入力が流れているかも確認してください。

Q. 集計結果が期待と違います
A. -f は1始まりです。区切りが空白か -d 指定か、連続区切り時の空フィールド扱いを確認してください。

Q. 文字化けします
A. UTF-8以外の入力が混在していないか、LC_ALL の設定を確認してください。

開発

# ビルド
cargo build

# テスト
cargo test

# フォーマット
cargo fmt

# リント
cargo clippy

コントリビューション

  • まずは ROADMAP.md と PRD.md を確認してください
  • 開発フローとルールは CONTRIBUTING.md を参照してください

ドキュメント

  • CONTRIBUTING.md
  • CODE_OF_CONDUCT.md
  • SECURITY.md
  • CHANGELOG.md
  • RELEASE.md
  • LICENSE

ライセンス

  • MIT License（LICENSE）

セキュリティ

  • 報告手順は SECURITY.md を参照してください