tally - The top command for log streams

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)
• --no-color: Disable ANSI colors (overrides NO_COLOR)
• --json <KEY>: Aggregate JSON key (e.g. path)
• --width <N>: Fixed table width (min 40)
• --no-final: Disable final text output after EOF

Spec Notes

• Input is processed as UTF-8; invalid bytes are replaced and processing continues
• Set NO_COLOR=1 to disable ANSI color output
• Table width is fixed at startup unless --width is specified
• Interactive keys are enabled only when stdin is a TTY

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) JSON path aggregation
cat /logs/access.log | tally --json path

# 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に丸め）
• --no-color: ANSIカラーを無効化（NO_COLOR を上書き）
• --json <KEY>: JSONのキーを集計（例: path）
• --width <N>: テーブル幅を固定（最小40）
• --no-final: EOF後の最終テキスト出力を無効化

仕様メモ

• UTF-8として処理し、不正なバイト列は置換して継続処理する
• NO_COLOR=1 を設定するとANSIカラーを無効化できる
• テーブル幅は起動時に固定され、--width で指定可能
• インタラクティブ操作はstdinがTTYのときのみ有効

性能計測（簡易）

# リリースビルド
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) JSONのpathだけ集計
cat /logs/access.log | tally --json path

# 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 を参照してください