How to enable logging - Generating Log Files for Support

When troubleshooting issues, our support staff may ask you to provide a log file. These logs help us identify errors, failed requests, or other important system activity.
Follow the steps below to enable logging and generate a log file:

⚙️ How to Enable Logging in Clientexec

Open your config.php file, located in the root directory of your Clientexec installation.
Edit the following two lines:

define('LOG_LEVEL', 4);
define('LOG_TEXTFILE', '/home/user/logs/ce.log');

🔒 Important:
Use quotes around the file path for LOG_TEXTFILE.
Make sure the specified file exists and is writable by the web server.
Do not place the log file in your web root directory (e.g., public_html) — it may contain sensitive data like passwords.

🔢 Logging Levels (0–6)

Use a number between 0 and 6 for LOG_LEVEL. (Though generally our support staff will ask you to set it to level 4). Each level logs additional details:
0 – No logging
1 – Security attack attempts, errors and important messages (recommended level)
2 – Reserved for debugging (only logs if DEBUG is true in config.php)
3 – Warnings and EventLogs, VIEW/ACTION and Request URIs and URI redirections and POST/COOKIE values
4 – Plugin events, curl requests, some function calls with their parameters, etc.
5 – Include suppressed actions and SMTP traffic
6 – Action responses (ajax, serialized, XML as array)

🧪 Reproducing the Problem

To generate a useful log file:
Set the appropriate LOG_LEVEL (usually 4, or 5 for SMTP issues)
Reproduce the problem
Disable logging afterward by resetting the config.php lines to:

define('LOG_LEVEL', 1);
define('LOG_TEXTFILE', false);

📤 Submitting Logs to Support

Use log level 4 for most issues
Use log level 5 for SMTP/email problems
Attach the generated log file to your support ticket and then you can delete the log file.

Updated on: 14/06/2025