Section 3.25. <Log FILE>

3.25. <Log FILE>

This optional clause creates a FILE logger, which logs all messages with a priority level of Trace or more to a file. The logging is in addition to any logging to the file defined by global LogFile. For more information, see Section 3.7.13. The log file is opened, written, and closed for each message, which means you can rotate it at any time.

Tip

The logger becomes active when it is encountered in the configuration file. It logs parse errors from later in the configuration file and subsequent run-time events. Parse errors from earlier in the configuration file are not logged through this clause.

CAUTION

Logging to STDOUT by specifying Filename as a single dash - is no longer supported in Radiator 4.18.

Tip

Global LogFile and Trace configuration parameters are basically the same as the following:

<Log FILE>
      #Trace 0
      Filename filename
</Log>

Tip

You can place <Log xxxxxx> clause inside any clause in the configuration file. This causes messages originating from within that clauses code to be logged with the logger prior to being logged with any global loggers. This can be handy for debugging or tracing only certain Handler or AuthBy clauses:

<Handler>
      # This logs messages from within the Handler
      <Log FILE>
            Trace 4
            Filename xxxxxx
            ...
      </Log>
</Handler>