Hey CheckMates! 👋
Sharing a quick overview of LogHub — a feature that simplifies troubleshooting on Quantum gateways by aggregating all system logs into a single unified file.
Note: LogHub is part of the Insights monitoring and debugging suite, accessible via the Insights CLI terminal interface.
The Problem We're Solving
We all know the pain: hunting through hundreds of log files scattered across the system, trying to figure out which one contains the information we need. On clusters, multiply that by the number of members. It's time-consuming and easy to miss critical information.
What LogHub Does
- Automatically monitors 150+ log sources (messages, cpwd.elg, fwk.elg, cpd.elg, and many more)
- Aggregates everything into a single file: /var/log/loghub.log
- On Scalable Platforms: collects logs from ALL cluster members in real-time
- Provides powerful filtering by time range, severity, search strings, log files, and member ID
How to Use It
The preferred way is through the Insights CLI

You can also use the standalone loghub-cli:
Using TUI:
loghub-cli

Show and Filter Logs
Usage: loghub-cli show logs [OPTIONS]
Show LogHub logs with filters
Options:
--from TEXT Start time (supports: YYYY-MM-DD HH:MM:SS, YYYY-MM-DD,
YYYY-MM, MM-DD, HH:MM)
--to TEXT End time (supports: YYYY-MM-DD HH:MM:SS, YYYY-MM-DD,
YYYY-MM, MM-DD, HH:MM)
--max-logs INTEGER Maximum number of logs to show [default: 500]
--log-files TEXT Filter by log files (e.g. file1, file2)
--search-string TEXT Filter by string in log messages
--format [raw|csv] Filter by log format (e.g. raw, csv)
--help Show this message and exit.
Examples:
# Show last 100 logs containing "error"
loghub-cli show logs --search-string "error" --max-logs 100
# Show logs from specific time range
loghub-cli show logs --from "2026-03-08 09:00" --to "2026-03-08 10:00"
# Filter by specific log files
loghub-cli show logs --log-files cpwd.elg,fwk.elg
# Short time formats (today at 10:00)
loghub-cli show logs --from "10:00" --to "11:00"
# Date without year (current year assumed)
loghub-cli show logs --from "03-08" --to "03-09"
# Export to CSV
loghub-cli show logs --format csv --max-logs 1000 > logs.csv
Enabling/Disabling Feature
Usage: loghub-cli daemon [OPTIONS] COMMAND [ARGS]...
Apply action on LogHub daemons
Options:
--help Show this message and exit.
Commands:
register Register LogHub daemons in GaiaDB
restart Restart LogHub daemons
start Start LogHub daemons
stop Stop LogHub daemons, For permenent stop use unregister option
unregister Unregister LogHub daemons from GaiaDB.