.. _admin-manual-logging:

Logging
-------

This extension makes use of the Logging system introduced in TYPO3 CMS 6.0. It
is far more flexible than the old one writing to the "sys_log" table. Technical
details may be found in the :ref:`TYPO3 Core API docs for logging <t3coreapi:logging>`.

As an administrator, what you should know is that the TYPO3 Logger forwards log
records to "Writers", which persist the log record.

By default, with a vanilla TYPO3 installation, messages are written to the
default log file (:file:`var/log/typo3_*.log`).


.. _admin-manual-logging-dedicatedogfile:

Dedicated log file for LDAP
^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you want to redirect every logging information from this extension to
:file:`var/log/ldap.log` and send log entries with level "WARNING" or above to
the system log, you may add following configuration to
:file:`typo3conf/AdditionalConfiguration.php`:

.. code-block:: php

	$GLOBALS['TYPO3_CONF_VARS']['LOG']['Causal']['IgLdapSsoAuth']['writerConfiguration'] = [
	    \TYPO3\CMS\Core\Log\LogLevel::DEBUG => [
	        \TYPO3\CMS\Core\Log\Writer\FileWriter::class => [
	            'logFile' => \TYPO3\CMS\Core\Core\Environment::getVarPath() . '/log/ldap.log'
	        ],
	    ],

	    // Configuration for WARNING severity, including all
	    // levels with higher severity (ERROR, CRITICAL, EMERGENCY)
	    \TYPO3\CMS\Core\Log\LogLevel::WARNING => [
	        \TYPO3\CMS\Core\Log\Writer\SyslogWriter::class => [],
	    ],
	];

.. hint::

	Be sure to read :ref:`Configuration of the logging system <t3coreapi:logging-configuration>` to fine-tune your
	configuration on any production website.