Logging

Super captures the stdout and stderr streams of every managed process. This decouples logging from your application logic—your app just needs to print to the console.

Log Files

By default, logs are stored in the ./logs directory relative to the Super root. The file naming convention is:

• {program_id}.out (Standard Output)
• {program_id}.err (Standard Error)

Automatic Rotation

To prevent logs from consuming all disk space, Super implements automatic rotation.

You can configure this in super.toml:

[child_logging]
# Max size per file in MB (default: 10)
max_size_mb = 10

# Number of backups to keep (default: 5)
max_backups = 5

When a log file exceeds max_size_mb:

1. app.out is renamed to app.out.1.
2. Existing backups are shifted (.1 -> .2, etc.).
3. The oldest backup (beyond max_backups) is deleted.

Real-time Streaming

You don’t need to tail -f files manually. Super provides a WebSocket-based stream via the CLI.

# Stream logs for a specific program
super logs my-app

This stream aggregates both stdout and stderr in real-time.

Safety Feature: To prevent a runaway process from crashing the daemon or flooding the network, Super truncates extremely long single lines (16KB limit) before processing.