Enhanced Log v3

Advanced syslog filtering, colorization, and categorization for Unraid.

Latest release Supported Unraid versions Downloads License: GPL-3.0

Fork notice

This is a maintained fork of dkaser/unraid-enhancedlog by Derek Kaser, based on the original work by Dan Landon. This fork carries on maintaining the plugin and publishes its own releases.

Installation

In the Unraid web UI, go to Plugins → Install Plugin and enter:

https://raw.githubusercontent.com/andrebrait/unraid-enhancedlog/main/plugin/enhanced.log3.plg

Installing replaces the previous Enhanced Log plugin (the original enhanced.log, or an earlier release of this fork) and keeps your settings. The plugin was renamed to enhanced.log3 ("Enhanced Log v3") so Community Applications can tell it apart from the original.

Requirements

• Unraid 7.0.0 or later.

Issues

Report bugs and feature requests in the issue tracker of this fork.

Overview

Enhanced Log v3 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.log3/.

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.

Workflow actions use SHA-pinned versions of their latest available major releases. The custom release-drafter pin is retained because its conventional-commit changes are not on the upstream default branch. The PHP-CS-Fixer Docker action continues to track its latest image.

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 the history of the original plugin, see the Unraid forums thread. For support, open an issue in the issue tracker of this fork.