Debug Log Manager

Description

Debug Log Manager allows you to:

  • Enable WP_DEBUG with one click to log PHP, database and JavaScript errors when you need to, and disable it when you’re done. No need to manually edit wp-config.php file.
  • Create the debug.log file for you in a non-default location with a custom file name for enhanced security.
  • Copy the content of the default / existing debug.log file into the custom debug.log file, and delete the default / existing debug.log file. So there is continuation in logging and enhanced security going forward.
  • Parse the debug.log file and view distinct errors and when they last occurred, which is better than looking at the raw log file (potentially) full of repetitive errors.
  • Quickly find and filter more specific errors for your debugging work.
  • Make error details easier to read by identifying error source (core / plugin / theme) and separating file path and line number.
  • Easily view files where PHP errors occurred. This includes WordPress core, plugin and theme files.
  • Enable auto-refresh to automatically load new log entries. No need to manually reload the browser tab, or to tail -f the log file on the command line.
  • Easily clear the debug.log file to save disk space and more easily observe newly occurring errors on your site.
  • Show an indicator on the admin bar when error logging is enabled.
  • Add a dashboard widget showing the latest errors logged.
  • Use error_log() to output error info into your debug log. e.g. error_log( $error_message ) for simple, string-based error message, or error_log( json_encode( $error ) ) when inspecting a more complex error info, e.g. array or object.

A simpler and more compact version of Debug Log Manager is included as part of the System Dashboard plugin, should you prefer a single plugin that does more.

Give Back

Check These Out Too

  • System Dashboard: Central dashboard to monitor various WordPress components, processes and data, including the server.
  • Variable Inspector: Inspect PHP variables on a central dashboard in wp-admin for convenient debugging.
  • Code Explorer: Fast directory explorer and file/code viewer with syntax highlighting.
  • Database Admin: Securely manage your WordPress website’s database with a clean and user-friendly interface based on a custom-themed Adminer app. Only available on Github.
  • Admin and Site Enhancements helps you to easily enhance various admin workflows and site aspects while replacing multiple plugins doing it.
  • Flexible Scroll Top and Floating Share Buttons is a lightweight combo with minimalist UI.
  • WordPress Newsboard: The latest news, articles, podcasts and videos from 100+ WordPress-focused sources.

Screenshots

  • Debug Log Manager main page
  • Fatal errors with the stack trace
  • More log entries sample
  • Admin bar indicator and dashboard widget

FAQ-e

Will this work with the managed WordPress hosting I am on?

Maybe. It’s been tested with Kinsta and GridPane (with Secure Debug turned off). If you find it’s not working with your managed host, please post in the support forum about the issue / error you encounter. I may ask for a test site that I can work with.

How was this plugin built?

Debug Log Manager is built using the excellent WPConfigTransformer class from WP Debug Log – Config Tool, DataTables.js, jSticky and jQuery Toast.

Reviews

25 May 2023
I wish I had found out about this plugin a long time ago. It saves time when debugging client sites.
22 October 2022 1 reply
A stitch in time saves nine. This plugin is so important I have it as the #2 item in my admin menu (below only Dashboard). Proactively finding and fixing errors is essential to running a successful site. This plugin does a simple job, and it does it very well. Some niceties are the JavaScript logging, and the counting of log occurrences. The UI is simple, but appropriate. The developer is responsive. I have used a couple of other logger plugins and this is by far the best one.
19 September 2022
This is a great plugin for dev especially for people who tinker in the code. Not only does it help debug things, it's a great way to learn what kinds of mistakes you commonly make, and avoid them in the future. Great job Bowo!
Read all 4 reviews

Contributors & Developers

“Debug Log Manager” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Debug Log Manager” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.1.4 (2023.04.15)

2.1.3 (2023.02.25)

2.1.0 (2023.02.21)

  • Correctly parse the content of entries added via the error_log() function. Instead of print_r(), please use json_encode(), if you’re trying to output a PHP $variable containing an array or object into the debug log. e.g. error_log( json_encode( $variable_name ) ). Props to @guyinpv for reporting the issue.

2.0.0 (2022.12.03)

  • WordPres core, plugin or theme files where PHP errors occurred can now be easily viewed by simply clicking on the file path in each error entry. This is done using core’s plugin/theme editor (modified to load in view-only mode) and the wordpress-develop repo on Github for core files.
  • SCRIPT_DEBUG constant is now set to true in wp-config when error logging is enabled, which should help with debugging javascript errors.
  • Added a button to disable plugin/theme editor below the error entries table. This is for when you’re done with debugging, i.e. you’ve disabled error logging and cleared the debug log file, and wants to keep things secure.

1.9.1 (2022.12.02)

  • Fixed styling issue for external link dashicon in entries when datatable is auto-refreshed.

1.9.0 (2022.12.02)

  • Detect PHP Exception error type and add it to the entries table filter.
  • Make error entries easier to read by identifying error source (core / plugin / theme) and separating file path and line number.

1.8.7 (2022.10.22)

  • Fix for missing wp_date() function for WordPress before v5.3.
  • Suppress all admin notices when viewing log entries. Thanks to a nice patch from @brianhenryie.
  • Improve inline comments for some of the code.

1.8.6 (2022.10.09)

  • Fix wrong reference to old app.js. Change to admin.js.

1.8.5 (2022.10.08)

  • Smooth out the behaviour of scroll-to-fix-on-top the position of DLM page’s header.
  • Change default number of entries to show on dashboard widget from 10 to 5.

1.8.4 (2022.10.08)

1.8.3 (2022.10.07)

  • CSS fix for dashboard widget to ensure error messages wrap properly, i.e. not overflow the widget container.

1.8.2 (2022.10.05)

  • CSS fixes for dashboard widget footer as well as main page header and footer sizing.

1.8.0 (2022.10.02)

  • Add dashboard widget showing the latest errors logged, the error logging status and a link to the Debug Log Manager page.

1.7.0 (2022.09.28)

1.6.4 (2022.09.27)

  • Fix PHP Warning issue: “Trying to access array offset on value of type bool” reported by @brianhenryie and @hogash.

1.6.3 (2022.09.27)

  • Further fixes (HTML, CSS, JS) to ensure error details are properly wrapped inside the data table and not cause the table to overflow the page width. This includes scenarios when auto-refresh is enabled and pagination is in use.

1.6.2 (2022.09.26)

  • CSS fix to ensure error details are properly wrapped inside the data table and not cause the table to overflow the page width.

1.6.1 (2022.09.26)

  • Improve detection of anchor text in wp-config.php for the WP_Config_Transformer class. Make sure toggling of WP_DEBUG works for wp-config.php that uses either “Happy publishing” or “Happy blogging”.

1.6.0 (2022.09.25)

  • Add admin bar status icon. Will only show up if error logging is enabled and on pages other than the Debug Log Manager main page, including the front end.

1.5.3 (2022.09.24)

  • Improve log parser for handling error messages that contain the # and [ characters, e.g. “Argument #1” or “[internal function]”

1.5.2 (2022.09.22)

  • Disable auto-refresh when pagination is used. Otherwise, table will always go back to the first page.

1.5.1 (2022.09.21)

  • Fix typo in Error Type dropdown filter for ‘JavaScript’ preventing filter to work properly for this error type.

1.5.0 (2022.09.21)

  • Add Error Type dropdown filter.

1.4.0 (2022.09.21)

  • JavaScript errors on wp-admin and the front end is now logged by default.
  • Improve copy around error types for simplicity and clarity.
  • Fix an issue where AJAX calls for the auto-refresh feature won’t properly stop in multiple scenarios of clicking the Error Logging and/or Auto-Refresh toggles.

1.3.3 (2022.09.20)

1.3.1 (2022.09.18)

  • Fix bugs around the auto-refresh feature. Disabling auto-refresh works only on the toggle and wp_option entry but not on the actual ajax calls. If auto-refresh is enabled, it only worked on clicking the toggle but not on page load. Both issues are fixed.

1.3.0 (2022.09.18)

  • Implement toast notifications on various action completions, e.g. clearing log file.
  • Change date format to M j, Y – H:i:s, e.g. Dec 31, 2021 – 20:06:34.
  • Implment auto-refresh feature that will automatically load the latest error entries every 5 seconds.

1.2.0 (2022.09.16)

  • Fix detection of existing debug log file, if there is one, so it is copied correctly into DLM’s debug log file.
  • Auto update entries table when logging is enabled, including when copying entries from existing debug.log file.
  • Code refactor: added autoloader of plugin’s PHP classes.

1.1.0 (2022.09.13)

  • Improve implementation of WP PHP Coding Standards across the codebase.
  • Improve variable sanitization and escaping.
  • Set initial data table sort based on the # column so that Last Occurence column is properly sorted according to the timestamp.
  • Add get_value() method to WP_Config_Transformer class to work with existing debug log constants in wp-config.php.
  • Enable $options argument for the add() and update() method in WP_Config_Transformer to ensure formatting of debug log constants is correct in wp-config.php.

1.0.1 (2022.08.31)

  • Refactor code for better organization and maintainability.
  • Improve plugin description / README.md.

1.0.0 (2022.08.29)

  • Initial stable release.