mesh-log-aggregator

mesh-log-aggregator — Centralized log viewer across ALL JSONL ledgers

Data & Ledgers

Usage

mesh logs|log  [options]

Commons Entry


# mesh-log-aggregator

**Layer:** Infrastructure (Observability)
**CLI:** `mesh logs|log <command>`
**Ledger:** N/A (read-only aggregator)

Centralized log viewer across all 47+ JSONL ledgers in the hive. Provides unified tail, search, stats, recent entries, count ranking, and full export with source tagging.

## Commands
- `tail [N]` — Last N entries across all ledgers, sorted by time
- `search <term> [max]` — Full-text search across all ledgers
- `sources` — List all JSONL files with entry counts
- `stats` — Aggregate statistics (ledger count, entries, size, categories)
- `recent [min]` — Entries from last N minutes
- `count` — Entry counts sorted descending
- `export [file]` — Export all entries to single JSONL with `_source` tags

## Integration
- Reads all `.jsonl` files under `$HIVE` (excludes `_archived/`)
- Normalizes timestamp fields (`ts`, `timestamp`, `time`, `_ts`)
- Single python3 pass per command for performance