hubio-sync logs

View hubio-sync application logs.

Synopsis

hubio-sync logs [flags]

Description

Display application log files. By default, shows the last 50 lines of the main application log. Use the follow flag to continuously stream new log entries.

For service/daemon logs, use hubio-sync service logs instead.

Flags

Flag	Short	Default	Description
`--job-id`			View logs for a specific job ID
`--follow`	`-f`	false	Continuously stream log entries
`--lines`	`-n`	50	Number of recent lines to display

Examples

Show Recent Logs

hubio-sync logs

Output:

Log file: /Users/username/Library/Logs/hubio-sync/hubio-sync.log

2025-12-03T14:30:00.123Z INFO Starting migration job mysql-prod-to-s3
2025-12-03T14:30:01.456Z INFO Connected to source: MySQL
2025-12-03T14:30:02.789Z INFO Connected to destination: S3
2025-12-03T14:30:03.012Z INFO Starting file transfer: 2500 files
...

Show More Lines

hubio-sync logs -n 100

Follow Logs

hubio-sync logs -f

Output:

Log file: /Users/username/Library/Logs/hubio-sync/hubio-sync.log

Press Ctrl+C to stop following logs...

2025-12-03T14:30:00.123Z INFO Starting migration job
2025-12-03T14:30:01.456Z INFO Processing file 1/2500
2025-12-03T14:30:02.789Z INFO Processing file 2/2500
...

View Job-Specific Logs

hubio-sync logs --job-id abc123-def456

Combine Flags

# Follow logs for a specific job
hubio-sync logs --job-id abc123-def456 -f

# Show last 200 lines and follow
hubio-sync logs -n 200 -f

Log File Locations

Platform	Path
macOS	`~/Library/Logs/hubio-sync/`
Linux	`~/.local/state/hubio-sync/logs/`
Windows	`%LOCALAPPDATA%\hubio-sync\logs\`

Log Files

File	Description
`hubio-sync.log`	Main application log
`daemon.log`	Background daemon log
`job_<id>.log`	Job-specific log (if available)

Log Levels

The application logs at different levels:

Level	Description
DEBUG	Detailed debugging information
INFO	General operational messages
WARN	Warning messages
ERROR	Error messages

Service Logs

For logs when running as a system service:

# View service logs
hubio-sync service logs

# macOS
log show --predicate 'process == "hubio-sync"' --last 1h

# Linux systemd
journalctl -u hubio-sync -f

# Windows
Get-EventLog -LogName Application -Source hubio-sync

Troubleshooting

No Log Files Found

If no log files exist:

The application may not have run yet
Logs may be in a different location
Check service logs with hubio-sync service logs

Permission Denied

If you see permission errors:

Run the command with appropriate permissions
Check log directory permissions

Large Log Files

For large log files, use pagination:

# View with less
hubio-sync logs -n 1000 | less

# Search for errors
hubio-sync logs -n 1000 | grep ERROR