Writes a message to a log file.

WriteLog( text=string, type=string, application=boolean, file=string, log=string );

Returns: void

Argument Description
string, required

Message text to log.

string, optional

Type (severity) of the message:

  • information (default)
  • warning
  • error
  • fatal
boolean, optional

log application name, if it is specified in a cfapplication tag.

string, optional

Message file. Specify only the main part of the filename. For example, to log to the Testing.log file, specify "Testing". The file must be located in the default log directory. You cannot specify a directory path. If the file does not exist, it is created automatically, with the suffix .log.

string, optional

If you omit the file argument, writes messages to standard log file. Ignored, if you specify file argument.

  • application: writes to Application.log, normally used for application-specific messages.
  • scheduler: writes to Scheduler.log, normally used to log the execution of scheduled tasks.


writeLog(log="MyLog", text=now(), type="error");

See also