3.22. <Log SYSLOG> Previous topic Parent topic Child topic Next topic

This optional clause creates a SYSLOG logger, which logs all messages with a priority level of Trace or more to the syslog system. <Log SYSLOG> requires Sys::Syslog. The logging is in addition to any logging to the file defined by LogFile. For more information, see Section 3.7.13. LogFile.
Messages are logged to syslog with priority levels that depend on the severity of the message. There are 5 defined priority levels and they are logged to the equivalent syslog priority. See the Trace parameter for a description of the priority levels supported.
Ensure that your host's syslog is configured to do something with err, warning, notice, info, and debug priority messages from the Syslog facility you specify, otherwise you do not see any messages. See /etc/syslog.conf or its equivalent on your system.
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.
You can place a <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 Realms or AuthBy clauses:
      # This will log messages from within the Handler
      <Log SYSLOG>
            #Trace 2