Logging¶

New in version 1.1.0: Feature: #374 - Introduce logging for default crawlers

When using the default crawlers provided by this extension, crawling results are logged using a configured log writer. By default, TYPO3 configures a file writer with minimum log level warning.

However, you can always override logging configuration within your config/system/settings.php or config/system/additional.php file:

config/system/settings.php¶

return [
    'LOG' => [
        'EliasHaeussler' => [
            'Typo3Warming' => [
                'Crawler' => [
                    // Default crawler
                    'ConcurrentUserAgentCrawler' => [
                        'writerConfiguration' => [
                            \Psr\Log\LogLevel::WARNING => [
                                \TYPO3\CMS\Core\Log\Writer\FileWriter::class => [
                                    // A. Disable logging
                                    'disabled' => true,

                                    // -or- B. Configure logger
                                    'logFileInfix' => 'warming',
                                ],
                            ],
                        ],
                    ],

                    // Verbose crawler
                    'OutputtingUserAgentCrawler' => [
                        'writerConfiguration' => [
                            \Psr\Log\LogLevel::WARNING => [
                                \TYPO3\CMS\Core\Log\Writer\FileWriter::class => [
                                    // A. Disable logging
                                    'disabled' => true,

                                    // -or- B. Configure logger
                                    'logFileInfix' => 'warming',
                                ],
                            ],
                        ],
                    ],
                ],
            ],
        ],
    ],
];

Custom log table¶

The extension ships with a custom log table tx_warming_domain_model_log. In addition, a custom log writer EliasHaeussler\Typo3Warming\Log\Writer\DatabaseWriter is provided that writes all logged crawling results to said table.

Note

All log entries are written to the root page (uid=0).

Note that this log writer is not enabled by default. You must explicitly enable it in your config/system/settings.php or config/system/additional.php file:

config/system/settings.php¶

return [
    'LOG' => [
        'EliasHaeussler' => [
            'Typo3Warming' => [
                'Crawler' => [
                    // Default crawler
                    'ConcurrentUserAgentCrawler' => [
                        'writerConfiguration' => [
                            \Psr\Log\LogLevel::WARNING => [
                                \EliasHaeussler\Typo3Warming\Log\Writer\DatabaseWriter::class => [],
                            ],
                        ],
                    ],

                    // Verbose crawler
                    'OutputtingUserAgentCrawler' => [
                        'writerConfiguration' => [
                            \Psr\Log\LogLevel::WARNING => [
                                \EliasHaeussler\Typo3Warming\Log\Writer\DatabaseWriter::class => [],
                            ],
                        ],
                    ],
                ],
            ],
        ],
    ],
];