Question
How to enable / disable debug logging in Plesk?
Answer
The debug mode can be enabled either via the Plesk Panel.ini Editor extension in Plesk or in the Plesk configuration file "panel.ini" directly on a Plesk server.
In Plesk for Linux, debug log entries are written to the Plesk logfile /var/log/plesk/panel.log. Also, when running Plesk utilities with debug mode enabled in a command-line interface, they will produce debug log entries in their output.
In Plesk for Windows Server, debug log entries are written to the Plesk logfile %plesk_dir%adminlogsphp_error.log.
Warning: Once you are done with troubleshooting, disable debug mode back. Otherwise, it may fill up disk space over time.
Install the Panel.ini Editor from the Extensions menu in Plesk.
Open Panel.ini Editor at Extensions > My Extensions.
In Panel.ini Editor, switch to the Editor tab. If the editor is empty, do the following:
3.1. Download the panel_ini.txt file.
3.2. Open the downloaded file and copy its content.
3.3. Paste the content into the editor.
Edit the the content and click Save:
To enable debug mode, remove a semicolon ";" at the beginning of the lines highlighted on the picture.
To disable debug mode, put a semicolon ";" back at the beginning of the lines.
Connect to a Plesk server via SSH.
Сheck if the "panel.ini" configuration file exists:
# ls -l /usr/local/psa/admin/conf/panel.ini
If the file
/usr/local/psa/admin/conf/panel.inidoes not exist or is empty, create it from the sample file/usr/local/psa/admin/conf/panel.ini:# cp /usr/local/psa/admin/conf/panel.ini.sample /usr/local/psa/admin/conf/panel.ini
Open the file
/usr/local/psa/admin/conf/panel.iniin a text editor. In this example, we are using the vi editor and the command:# plesk conf panel.ini
Edit the
panel.inifile:To enable debug mode, remove a semicolon ";" at the beginning of the bold lines shown in the example below.
To disable debug mode, put a semicolon ";" back at the beginning of the bold lines.
Example of enabled debug mode:
[debug]
; Enable debug mode (do not use in production environment)
enabled = on[log]
; Log messages verbosity level (from 0 to 7)
; 0 - only critical errors, 7 - all including debug messages, default - 3
filter.priority = 7; Enable logging of SQL queries
show.sql_query = on; Enable logging of external utilities calls
show.util_exec = on; Enable logging of stdin and stdout for external utilities calls (do not use in production environment)
show.util_exec_io = onSave the changes and close the file. The changes will be applied immediately, no service restart is required.
Example of Plesk utility output when debug mode is enabled:
# /usr/local/psa/bin/ip_ban --update -ban_period 600 -ban_time_window 600 -max_retries 10
DEBUG [dbquery] [0] SQL: SET sql_mode = ''
DEBUG [dbquery…
