Monolog Configuration Reference
Edit this pageWarning: You are browsing the documentation for Symfony 2.0, which is no longer maintained.
Read the updated version of this page for Symfony 6.2 (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: ~
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
<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.
This work, including the code samples, is licensed under a
Creative Commons BY-SA 3.0
license.