NAME

Beekeeper::Logger - Default logger used by worker processes.

VERSION

Version 0.03

SYNOPSIS

use Beekeeper::Worker ':log';
use base 'Beekeeper::Worker';

log_debug 'Ready';

DESCRIPTION

By default all workers use a Beekeeper::Logger logger which logs errors and warnings both to files and to a topic on the message bus.

Logs location can be specified with option log_file in config file pool.config.json.

If no location is specified log files are are saved on /var/log when running pools as root, or /var/log/{user} when running as another user (if that directory already exists).

Log entries are also sent to a topic /topic/log in the message bus. The command line tool bkpr-log allows to inspect this topic in real time. Having a common topic for logs allows to easily shovel them to an external log management system.

To replace this default log mechanism for another one of your choice, just override in your worker class the inherithed method log_handler.

AUTHOR

José Micó, jose.mico@gmail.com

COPYRIGHT AND LICENSE

Copyright 2015-2021 José Micó.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language itself.

This software is distributed in the hope that it will be useful, but it is provided “as is” and without any express or implied warranties. For details, see the full text of the license in the file LICENSE.