如何配置 Monolog 以排除日志中的特定 HTTP 状态码

编辑此页

有时您的日志会被不需要的 HTTP 错误（例如 403 和 404）淹没。当使用 fingers_crossed 处理程序时，您可以基于 MonologBundle 配置排除记录这些 HTTP 状态码。

        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.ac.cn/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:monolog="http://symfony.ac.cn/schema/dic/monolog"
    xsi:schemaLocation="http://symfony.ac.cn/schema/dic/services
        http://symfony.ac.cn/schema/dic/services/services-1.0.xsd
        http://symfony.ac.cn/schema/dic/monolog
        http://symfony.ac.cn/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);
};
    

警告

将 excluded_http_codes 与低于 error 的 passthru_level (即 debug, info, notice 或 warning) 组合使用实际上不会排除这些 HTTP 状态码的日志消息，因为它们是以 error 或更高级别记录的，并且 passthru_level 优先于 excluded_http_codes 中列出的 HTTP 状态码。

本作品，包括代码示例，根据 Creative Commons BY-SA 3.0 许可协议获得许可。

版本