monolog.rst

pair: Monolog; Configuration reference

Monolog Configuration Reference

monolog:
    handlers:

        # Examples:
        syslog:
            type:                stream
            path:                /var/log/symfony.log
            level:               ERROR
            bubble:              false
            formatter:           my_formatter
        main:
            type:                fingers_crossed
            action_level:        WARNING
            buffer_size:         30
            handler:             custom
        custom:
            type:                service
            id:                  my_handler

        # Prototype
        name:
            type:                 ~ # Required
            id:                   ~
            priority:             0
            level:                DEBUG
            bubble:               true
            path:                 "%kernel.logs_dir%/%kernel.environment%.log"
            ident:                false
            facility:             user
            max_files:            0
            action_level:         WARNING
            stop_buffering:       true
            buffer_size:          0
            handler:              ~
            members:              []
            from_email:           ~
            to_email:             ~
            subject:              ~
            email_prototype:
                id:     ~ # Required (when the email_prototype is used)
                method: ~
            formatter:            ~

<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:monolog="http://symfony.com/schema/dic/monolog"
    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
                        http://symfony.com/schema/dic/monolog http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">

    <monolog:config>
        <monolog:handler
            name="syslog"
            type="stream"
            path="/var/log/symfony.log"
            level="error"
            bubble="false"
            formatter="my_formatter"
        />
        <monolog:handler
            name="main"
            type="fingers_crossed"
            action-level="warning"
            handler="custom"
        />
        <monolog:handler
            name="custom"
            type="service"
            id="my_handler"
        />
    </monolog:config>
</container>

Note

When the profiler is enabled, a handler is added to store the logs' messages in the profiler. The profiler uses the name "debug" so it is reserved and cannot be used in the configuration.