Logs & Debug

Using logs for troubleshooting and debugging.

Viewing Logs

Application Logs

Find application logs:

• Location: Application data directory
• Format: Text files
• Content: Application events

Windows:

%APPDATA%\BShellX\logs\

macOS:

~/Library/Application Support/BShellX/logs/

Linux:

~/.config/BShellX/logs/

SSH Logs

SSH connection logs:

• Connection events
• Authentication attempts
• Session information

Sync Logs

Cloud sync logs:

• Sync events
• Error messages
• Conflict details

Log Levels

Error

Critical errors:

• Connection failures
• Activation failures
• Data corruption

Warning

Potential issues:

• Performance warnings
• Resource warnings
• Configuration issues

Info

General information:

• Connection events
• Feature usage
• Status updates

Debug

Detailed information:

• Detailed events
• Performance metrics
• Debugging data

Using Logs for Troubleshooting

Connection Issues

Check SSH logs:

1. Find connection log
2. Look for error messages
3. Identify failure point
4. Apply solution

Activation Issues

Check activation logs:

1. Find authorization log
2. Look for error codes
3. Identify failure reason
4. Apply solution

Sync Issues

Check sync logs:

1. Find sync log
2. Look for error messages
3. Identify sync failure
4. Apply solution

Debug Mode

Enable Debug Mode

To enable debug mode:

1. Open Settings
2. Find Debug section
3. Enable debug logging
4. Restart application

Debug SSH

SSH debug mode:

ssh -vvv user@server

Shows:

• Connection details
• Authentication process
• Error details

Debug Application

Application debug:

• More detailed logs
• Performance metrics
• Internal state

Log Management

Clear Logs

To clear logs:

1. Open log directory
2. Delete old logs
3. Or use application clear function

Archive Logs

To archive logs:

1. Compress log files
2. Store in safe location
3. Keep for reference

Log Rotation

Automatic log rotation:

• Old logs archived
• New logs created
• Size limits applied

Best Practices

Regular Checks

• Check logs regularly
• Look for warnings
• Address issues early

Log Analysis

• Identify patterns
• Find root causes
• Document solutions

Log Retention

• Keep important logs
• Archive old logs
• Clean up regularly

Related Documentation

• Connection Failed - Connection troubleshooting
• Activation Failed - Activation troubleshooting
• Sync Errors - Sync troubleshooting