---
name: "Dancer2::Logger::File"
section: "3pm"
platform: "linux"
package: "libdancer2-perl"
version: "1.1.2+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Dancer2::Logger::File"
---

# Dancer2::Logger::File(3pm)

file-based logging engine for Dancer2

## NAME

Dancer2::Logger::File - file-based logging engine for Dancer2

## VERSION

version 1.1.2

## DESCRIPTION

This is a logging engine that allows you to save your logs to files on disk.

Logs are not automatically rotated.  Use a log rotation tool like `"logrotate"` in `"copytruncate"` mode.

## METHODS

### log($level, $message)

Writes the log message to the file.

## CONFIGURATION

The setting `"logger"` should be set to `"File"` in order to use this logging engine in a Dancer2 application.

The follow attributes are supported:

- •

  `"log_dir"`

  Directory path to hold log files.

  Defaults to *logs* in the application directory

- •

  `"file_name"`

  The name of the log file.

  Defaults to the environment name with a *.log* suffix

Here is an example configuration that use this logger and stores logs in */var/log/myapp*:

```
  logger: "File"
  engines:
    logger:
      File:
        log_dir: "/var/log/myapp"
        file_name: "myapp.log"
```

## AUTHOR

Dancer Core Developers

## COPYRIGHT AND LICENSE

This software is copyright (c) 2024 by Alexis Sukrieh.

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