NAME

Log::Dispatch::FileWriteRotate - Log to files that archive/rotate themselves, w/ File::Write::Rotate

VERSION

This document describes version 0.062 of Log::Dispatch::FileWriteRotate (from Perl distribution Log-Dispatch-FileWriteRotate), released on 2021-07-21.

SYNOPSIS

            

              
              
use Log::Dispatch::FileWriteRotate;
my $file = Log::Dispatch::FileWriteRotate(
    min_level => 'info',
    # will be passed to File::Write::Rotate
    dir       => '/var/log',
    prefix    => 'myapp',
    suffix    => '.log',
    period    => 'monthly',
    size      => 25*1024*1024,
    histories => 12,
);
$file->log(level => 'info', message => "Your comment\n");
            
          

DESCRIPTION

This module functions similarly to Log::Dispatch::FileRotate, but uses File::Write::Rotate as backend, thus interoperates more easily with other modules which use File::Write::Rotate as backend, e.g. Tie::Handle::FileWriteRotate or Process::Govern.

CONTRIBUTOR

Steven Haryanto <sharyanto@cpan.org>

METHODS

new(%args)

Constructor. This method takes a hash of parameters. The following options are valid: min_level and max_level (see Log::Dispatch documentation); dir, prefix, suffix, period, size, and histories (see File::Write::Rotate).

log_message(message => STR)

Send a message to the appropriate output. Generally this shouldn't be called directly but should be called through the log() method (in LLog::Dispatch::Output>).

fwr

Expose File::Write::Rotate object. You can do access this object e.g. to compress logfiles:

            

              
              
$file->fwd->compress;
            
          

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Log-Dispatch-FileWriteRotate.

SOURCE

Source repository is at https://github.com/perlancar/perl-Log-Dispatch-FileWriteRotate.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Log-Dispatch-FileWriteRotate

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

Log::Dispatch

File::Write::Rotate

Log::Dispatch::FileRotate

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2021, 2019, 2015, 2013, 2012 by perlancar@cpan.org.

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

cpanm Log::Dispatch::FileWriteRotate

perl -MCPAN -e shell
install Log::Dispatch::FileWriteRotate