WARNING: You are browsing the documentation for Symfony 3.1 which is not maintained anymore. Consider upgrading your projects to Symfony 4.2.

MonologBundle Configuration ("monolog")

3.1 version

Maintained

3.4 4.2 current 4.3 master

Unmaintained

2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 3.0 3.2 3.3 4.0 4.1

MonologBundle Configuration ("monolog")¶

For a full list of handler types and related configuration options, see Monolog Configuration.

Full Default Configuration¶

YAML

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
            # By default, buffer_size is unlimited (0), which could
            # generate huge logs.
            buffer_size:         0
            handler:             custom
        console:
            type:                console
            verbosity_levels:
                VERBOSITY_NORMAL:       WARNING
                VERBOSITY_VERBOSE:      NOTICE
                VERBOSITY_VERY_VERBOSE: INFO
                VERBOSITY_DEBUG:        DEBUG
        custom:
            type:                service
            id:                  my_handler

        # Default options and values for some "my_custom_handler"
        # Note: many of these options are specific to the "type".
        # For example, the 'service' type doesn't use any options
        # except id and channels
        my_custom_handler:
            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
            activation_strategy:  ~
            stop_buffering:       true
            buffer_size:          0
            handler:              ~
            members:              []
            channels:
                type:     ~
                elements: ~
            from_email:           ~
            to_email:             ~
            subject:              ~
            mailer:               ~
            email_prototype:
                id:                   ~ # Required (when the email_prototype is used)
                method:               ~
            formatter:            ~

XML

<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"
        />

        <!-- By default, buffer-size is unlimited (0), which could
             generate huge logs. -->
        <monolog:handler
            name="main"
            type="fingers_crossed"
            action-level="warning"
            handler="custom"
            buffer-size="0"
        />

        <monolog:handler
            name="console"
            type="console"
        />

        <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.

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.