Як сконфігурувати Monolog для виключення конкретних HTTP-кодів з логу

Дата оновлення перекладу 2025-08-29

Як сконфігурувати Monolog для виключення конкретних HTTP-кодів з логу

Іноді ваші логи стають переповненими небажаними HTTP-помилками, наприклад, 403 і 404. При використання обробників fingers_crossed ви можете виключити ведення логів цих HTTP-кодів, засновуючись на конфігурації MonologBundle:

        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
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/monolog
        https://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
12
13
        // config/packages/prod/monolog.php
use Symfony\Config\MonologConfig;

return static function (MonologConfig $monolog): void {
    $mainHandler = $monolog->handler('main')
        // ...
        ->type('fingers_crossed')
        ->handler('...')
    ;

    $mainHandler->excludedHttpCode()->code(403);
    $mainHandler->excludedHttpCode()->code(404);
};
    

Warning

Комбінування excluded_http_codes з passthru_level нижче, ніж error (тобто, debug, info, notice або warning) не виключить повідомлення логів для цих HTTP-кодів насправді, тому що їх логи ведутья на рівні error і вище, а passthru_level головує над HTTP-кодами, перерахованими в excluded_http_codes.