Monolog Configuration Reference

Version: 2.0
Edit this page

Warning: You are browsing the documentation for Symfony 2.0, which is no longer maintained.

Read the updated version of this page for Symfony 6.0 (the current stable version).

Monolog Configuration Reference

  • YAML
  • XML
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
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:            ~

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.