Developers can locate and access application error logs for ColdFusion or Lucee to diagnose runtime issues, identify stack traces, and troubleshoot application-specific failures.
Before you begin
You will need:
Developer access to the server
Access to the specific application's directory or the server's configuration files
Locating Application Error Logs
Depending on your environment and how the application is configured, error logs can be found in several locations.
Checking the Default System Logs
By default, ColdFusion and Lucee log system-wide errors and some application errors to a central directory.
Log in to the server.
Navigate to the ColdFusion or Lucee installation directory.
Locate the
cfusionorluceefolder, typicallyC:\ColdFusion####\cfusionorC:\lucee.Open the
logsfolder.Look for files named
exception.log,error.log, ormessages.log.
Note: The exact filename may vary depending on the version of ColdFusion or Lucee you are running.
Checking Application-Specific Logs
If the application uses a custom logging framework (such as Log4j or a custom CFML logging class), the logs may be stored within the application's own directory.
Navigate to the application's root directory.
Look for a
logsfolder or alogsfile within the application's directory.Check for files ending in
.logor.txtthat contain the application name.
Locating Logs via the Administrator Interface
If you have access to the ColdFusion Administrator or Lucee Administrator, you can verify the paths where the system is currently writing logs.
Log in to the ColdFusion Administrator or Lucee Administrator.
Navigate to System Settings > Logging.
Review the paths listed for Error Log, Exception Log, and Message Log.
Confirm the result
You have located a log file that contains recent entries related to your application.
The log file contains a stack trace or a descriptive error message for the issue you are investigating.
Troubleshooting common log issues
The log file is empty or not updating
If the log files exist but do not contain new entries:
Verify that the ColdFusion or Lucee service is running.
Check that the user account running the service has "Write" permissions to the log directory.
Ensure the application is actually hitting the error; some errors may be caught by a custom error handler and not passed to the system log.
You cannot find any log files
If no logs are being generated:
Check the Logging section in the Administrator interface to ensure the paths are valid and the files are not being directed to a non-existent directory.
Verify that the disk space on the server is not full.
