Skip to Content

Error log file and configuration file to troubleshoot

Ezeelogin Troubleshooting: Error Logs and Configuration Files  


SynopsisThis article provides information about error log files for both backend operations and web interface(Webgui), along with instructions on monitoring console errors.



Location of configuration and log files for troubleshooting.

  • The configuration file is located at /usr/local/etc/ezlogin/ez.conf
  • Ezeelogin has two log files one for the web interface and one for the backend ssh interface.

1. FRONTEND OR WEB INTERFACE LOGS { Application log }

  • The front end or web interface runs on PHP; hence, we have a separate log file for it. The log files are stored in the /{system folder specified at the installation time.
  • If you experience any issues on the web interface or GUI, refer to this log file for details.

  Run the following command to navigate to the log directory:

 root@Gateway:~# cd $(awk '/^system_folder/ {print $2}' /usr/local/etc/ezlogin/ez.conf)/application/logs/

  • You can find the same path by checking the system_folder in /usr/local/etc/ezlogin/ez.conf. The path would be /{system folder}/application/logs/. After changing to that directory, you can check the latest log. Refer the below screenshot.


 2. BACKEND OR SSH LOGS

  • The backend or SSH error logs for each Ezeelogin user are stored in the /home/{username}/ezsh.log file. Replace {username} with the user who is facing the issue.
  • If you are having any issues with the ssh logins, this is the log file to look at.

For detailed debug log for troubleshooting, do append the parameter log_level trace in ez.conf 

root@Gateway:~  vi /usr/local/etc/ezlogin/ez.conf

log_level trace

NOTE  "log_level trace parameter will only work from Ezeelogin version 7.23.0"

3. How to check error from browser console  ?

  • Open the web page where you encountered errors.
  • Right-click on the page and select "Inspect" from the menu. This will open the Chrome DevTools.

  • In the DevTools window, navigate to the "Console" tab.

  •  Any errors, warnings, or logs will be displayed in the console.

Related Articles:

How do I get detailed logs from Ezeelogin error logs?

Issue with Log Retain Duration.

How to truncate the SSH session logs recorded.