Log Rotation Command

Configure log rotation using the log_rotation.py tool.

How This Command Works

This command orchestrates the system-admin skill's log rotation tool.

Architecture:

• The tool manages logrotate configuration
• You read the tool's output to understand rotation policies
• You DO NOT edit logrotate.conf directly - let the tool handle it

Workflow

1. Parse user request or $ARGUMENTS:

   • Action: list, add, remove, status, force
   • Log file path
   • Options: --rotate, --size, --compress

2. Invoke the log_rotation.py tool:

   python3 ./skills/system-admin/scripts/log_rotation.py <action> [OPTIONS]
   

3. Read the output and report rotation configuration

Examples

List rotation policies:

User: /log-rotation list

Run: python3 ./skills/system-admin/scripts/log_rotation.py list
Show all log rotation configurations

Add rotation for log file:

User: /log-rotation add /var/log/myapp.log --rotate 7 --size 100M --compress

Run: python3 ./skills/system-admin/scripts/log_rotation.py add /var/log/myapp.log --rotate 7 --size 100M --compress
Report configuration added

Force rotation:

User: /log-rotation force /var/log/myapp.log

Run: python3 ./skills/system-admin/scripts/log_rotation.py force /var/log/myapp.log
Force immediate rotation

Check rotation status:

User: /log-rotation status

Run: python3 ./skills/system-admin/scripts/log_rotation.py status
Show last rotation times and status

Supported Actions

• list - List rotation policies
• add - Add rotation policy
• remove - Remove rotation policy
• status - Show rotation status
• force - Force immediate rotation
• test - Test configuration

Options

• --rotate <N> - Keep N rotated files
• --size <size> - Rotate when size exceeds
• --daily|weekly|monthly - Rotation frequency
• --compress - Compress rotated files
• --postrotate <cmd> - Command to run after rotation

Important Reminders

• Test configuration before applying
• Use --compress to save disk space
• Set appropriate retention based on needs
• Consider log volume when setting size limits