systimeline

CLI tool to analyze systemd logs and generate a chronological timeline of errors and service failures.

Requirements

• Linux with systemd
• Python 3
• journalctl

Installation

git clone <repo>
cd systimeline

Usage

python cli.py

Options

• --boot BOOT - Boot number to analyze (0=current, -1=previous boot)
• --service SERVICE - Filter by service name (e.g., nginx)
• --json - Output in JSON format

Examples

# Show errors from current boot
python cli.py

# Show errors from previous boot
python cli.py --boot -1

# Filter by specific service
python cli.py --service nginx

# Output in JSON format
python cli.py --json

# Combine options
python cli.py --boot -1 --service docker --json

Output Format

[TIMESTAMP] service.name ERROR_TYPE

Error types:

• FAILED - Service failed
• Dependency failed - Dependency failure
• Restart loop detected - Restart loop detected

Exit Codes

• 0 - Success
• 1 - Error (journalctl not available, systemd not available, etc.)
• 130 - Interrupted by user