Skip to main content
OCLC Support

Option LogSession

Learn how to use the Option LogSession config.txt directive with other log directives in EZproxy.

Option LogSession specifies that the EZproxy session identifier should be substituted for %u in log formats specified with the LogFormat or LogSPU directives. By including this option in config.txt, your web server log analysis software may be able to link together all of the requests placed during a single EZproxy session. If the Audit facility is active and the audit file has not been deleted by AuditPurge, you can also cross-reference the session identifier from the web server log file back to the original user who was accessing EZproxy.

If Option LogSession and Option LogUser both appear in config.txt, then Option LogSession takes priority and prevents Option LogUser from having any effect.

If you want to record both the login username and the session identifier, use Option LogUser to allow %u to be recorded as the username, and %{ezproxy-session}i to record the session identifier.

Option LogSession  is a non-repeatable position-independent config.txt directive.


Option LogSession


Enable the EZproxy session identifier to be recorded in EZproxy web server log files.

Option LogSession

Related directives 

Audit, AuditPurge, LogFormat, LogSPU, Option LogUser