How to Configure Monolog to Exclude Specific HTTP Codes from the Log

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

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

How to Configure Monolog to Exclude Specific HTTP Codes from the Log

4.1

The ability to exclude log messages based on their status codes was introduced in Symfony 4.1 and MonologBundle 3.3.

Sometimes your logs become flooded with unwanted HTTP errors, for example, 403s and 404s. When using a fingers_crossed handler, you can exclude logging these HTTP codes based on the MonologBundle configuration:

YAML
XML
PHP

        1
2
3
4
5
6
7
8
        # config/packages/prod/monolog.yaml
monolog:
    handlers:
        main:
            # ...
            type: fingers_crossed
            handler: ...
            excluded_http_codes: [403, 404, { 400: ['^/foo', '^/bar'] }]
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
        <!-- config/packages/prod/monolog.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 type="fingers_crossed" name="main" handler="...">
            <!-- ... -->
            <monolog:excluded-http-code code="403">
                <monolog:url>^/foo</monolog:url>
                <monolog:url>^/bar</monolog:url>
            </monolog:excluded-http-code>
            <monolog:excluded-http-code code="404" />
        </monolog:handler>
    </monolog:config>
</container>
    

        1
2
3
4
5
6
7
8
9
10
11
        // config/packages/prod/monolog.php
$container->loadFromExtension('monolog', [
    'handlers' => [
        'main' => [
            // ...
            'type'                => 'fingers_crossed',
            'handler'             => ...,
            'excluded_http_codes' => [403, 404],
        ],
    ],
]);
    

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

Menu

How to Configure Monolog to Exclude Specific HTTP Codes from the Log

How to Configure Monolog to Exclude Specific HTTP Codes from the Log

What is Symfony?

Learn Symfony

Screencasts

Community

Blog

Services

Deployed on