enhanced.log – Enhanced Syslog Plugin for Unraid

Overview

enhanced.log is a powerful syslog enhancement plugin for Unraid, providing advanced log filtering, colorization, categorization, and analytics. It helps users quickly identify important system events, troubleshoot issues, and customize log viewing to their needs.

Features

• Advanced Filtering: Filter syslog entries by category, keyword, or custom rules.
• Colorization: Assign colors to log lines based on severity or content for easier scanning.
• Categorization: Automatically group log entries (e.g., drive-related, file system, network).
• Custom Match Rules: Define your own patterns for highlighting or categorizing log lines.
• Log Analytics: View counts and trends for recurring log messages.
• Persistent Settings: All configuration is saved and restored across reboots.

Configuration

Configuration files are stored in /boot/config/plugins/enhanced.log/.

Development

Requirements

• PHP 7.4+ (Unraid built-in)
• Composer for dependency management

Testing

1. Clone the repository.
2. Run ./composer install to install dependencies.

Release

1. Use the provided GitHub Actions workflow for release automation.

Contributing

Pull requests and issues are welcome! Please see CONTRIBUTING.md for contribution guidelines, including code checks, commit message conventions, and licensing. You can also open an issue to discuss your idea.

License

This project is licensed under the GNU General Public License v3.0.

Portions copyright (C) 2015-2025 Dan Landon
Copyright (C) 2025 Derek Kaser

See License.txt and LICENSE for details.

Acknowledgements

• Based on original work by Dan Landon.
• Inspired by the Unraid syslog viewer and community feedback.

For more information, see the Unraid forums thread or open an issue on GitHub.