EXT: Log analyzer¶

Thank you¶

A big thank you goes to Stonebriar Community Church, http://www.stonebriar.org , for sponsoring this extension's development and release to the TYPO3 Extension Repository.

What does it do?¶

This extension is used to list changes made in the TYPO3 system that have been integrated with the TYPO3 system log. When combined with the difference_viewer extension, the changes are clearly presented on a front-end page. This extension also provides a means to email the daily change report to a defined backend usergroup.

Screenshots¶

Backend List

Email

Report Summary

Report Change Log

Installing log_analyzer¶

For installing of log_analyzer plug-in follow next steps:

Select “Ext Manager” from TYPO3 Backend “Tools” section

In the drop-down “Menu” choose “Import extensions”

Search for “log_analyzer”

Download and install.

Configure settings to your environment.

Advanced Configuration¶

Target group - Developers

In log_analyzer/config.php you may perform some advanced configuration.

//Names of the tables and their convenient names, that will be used in “Content record type” list and “Type” column. You may define convenient names for tables from database here.

$tables_names = array(

'pages' => 'Pages',

'tt_news' => 'News',

'tt_content' => 'Content',

);

// names of the fields and their convenient names, that will be used in “Title” column

$tables_fields = array(

'pages' => 'pages.title',

'tt_news' => 'tt_news.title',

'tt_content' => 'pages.title',

'be_users' => 'be_users.realName',

);

//$report_type is used for internal class. This property MUST NOT be changed!!!

$report_type = array(

'be' => 1,

'view_daily' => 2,

'view_custom' => 3,

'xls_mail' => 4,

);

// filter for crontab. You may choose ‘all’ to send reports for all tables, where changes took place, or some specific.

$cron_tables = array(

'all',

//'tt_news',

//'tt_content'

);

// log enable/disable for debug uses

if (!defined(LOGGER))

define('LOGGER',true);

If you want to use log you should chmod log_analyzer plug-in folder to 0775 and possibly create file log in this folder via “touch log”.

Crontab¶

Edit log_analyzer/cron_job.sh to your web server environment and create a daily cronjob to call the script. You might have to `chmod 0775 cron_job.sh`.

Creation of new Log-recipient¶

Create a new backend usergroup group called “log_subscribers” or whatever was specified in your log_analyzer configuration.

Create or edit the backend user to receive the log_analyzer reports and add the backend usergroup “log_subscribers”.

Usage of Backend aggregator¶

Mode “Dashboard”

In TYPO3 backend press “Log Analyzer” module icon.

In right part of the screen filters for report’s generation are located

Press “Calendar Wizard” (“ ”) button near field “From” to display calendar style date input.

In the window with calendar choose day(for example, 12 ^th of November) and in field “From” will appear 11-12-2007.

Press “Calendar Wizard” button near field “To”. And window with calendar will appears.

In the window with calendar choose day(for example, 15th of November) and in field “To” will appear 11-15-2007.

In list “Content record type” choose type of record that you want to see in generated report, for example: All(for choosing two and more items in this list, press “Shift” button and then press on the names of content record types with the help of right mouse button)

In list “Author” choose author of changes, whom you want to see in generated report, for example: All(for choosing two and more items in this list, press “Shift” button and then press on the names of authors with the help of right mouse button)