DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

User manual

Viewing log entries depends on the Writer that was used to store them. While the File Writer provides a quick text-based access, the Database Writer makes it possible to have a full backend module, complete with search and filtering.

Log files

This is as straightforward as it gets. Open the log file and you should see something like:

2016-11-04T16:23:02+01:00 [NOTICE] Empty data (SandboxController.php 47)
2016-11-04T16:23:02+01:00 [INFO] Logging object test (SandboxController.php 48)
2016-11-04T16:23:02+01:00 [OK] Logging test (SandboxController.php 49)
2016-11-04T16:23:02+01:00 [INFO] Logging test (SandboxController.php 50)
2016-11-04T16:23:02+01:00 [NOTICE] Logging test (SandboxController.php 51)
2016-11-04T16:23:02+01:00 [WARNING] Logging test (SandboxController.php 52)
2016-11-04T16:23:02+01:00 [ERROR] Logging test (SandboxController.php 53)

Viewing a single entry

The Database Write writes log entries in the page where the call happened or at the root of the TYPO3 CMS installation if the call didn’t happen within the context of a page. Those records can be seen in the WEB > List module. Records are ordered with the most recent on top.

The log entries in the WEB > List module

List of log entries in the WEB > List module

To view the details of a single entry, click on the “Edit” icon.

The details of a log entry

Viewing the details of a log entry (all fields are read-only)

The backend module

The backend module can be used to view all entries written to the database no matter on which page they are stored. Furthermore it provides a number of search, filtering and ordering features.

The backend module

The Developer’s Log backend module with features highlighted

Hitting the “Reload” button (1) will load all log entries that were written since you started viewing the backend module. The table is refreshed. Checking the “Automatic reload” checkbox will trigger the reload action at predefined intervals (as per the extension configuration).

The “Group runs” option (2) changes the table display to visually separate log entries that belong to the same “run”, i.e. the same execution of a request to TYPO3 CMS.

The entries list grouped by runs

The list of log entries grouped by runs

The search bar (3) is a simple keyword search, but it acts on all columns, including the extra data. The various filters (4) each correspond to a given column and will filter data accordingly. All filters can be reset by clicking on the “Clear all filtes” button.

Data can be sorted by clicking on any column header (5). The extra data is collapsed by default and can be viewed by clicking on any downward-pointing arrow (6). Clicking on the arrow in the header cell (7) expands extra data for all rows.

Clearing log entries

In the docheader stands a menu for clearing log entries. From there, you can choose to delete all entries or delete them for a given period of time or for a given key.

Clear entries menu

The menu for clearing log entries