Rừng là nhịp tim của một ứng dụng sản xuất.Trong những ngày đầu của một dự án, một đuôi là đủ. nhưng khi ứng dụng Symfony của bạn quy mô để xử lý , và , “Viết vào một tệp” trở thành một trách nhiệm chứ không phải là một tài sản. dev.log payments asynchronous workers high-concurrency traffic Các cung cấp các công cụ tinh vi để chuyển đổi nhật ký từ các luồng văn bản đơn giản thành dữ liệu quan sát có thể hoạt động có cấu trúc. symfony/monolog-bundle Hướng dẫn này khám phá 10 mô hình ghi nhật ký tiên tiến vượt ra ngoài mặc định.Chúng tôi sẽ sử dụng gõ nghiêm ngặt, thuộc tính PHP và cấu hình YAML hiện đại. Điều kiện 
 
 
 
 
 
 Lời bài hát: 7.4+ PHP : 8.3+ Lời bài hát: Symphony/Monolog-bundle Tác giả / Monologue symfony/notifier (để cảnh báo ví dụ) Kịch bản 1: The “Black Box” Recorder: FingersCrossed Handler Bạn muốn ghi nhật ký sửa lỗi chi tiết khi xảy ra lỗi để hiểu chuỗi các sự kiện dẫn đến nó, nhưng bạn không thể đủ khả năng để ghi đĩa I/O để ghi lại tin nhắn sửa lỗi cho mỗi yêu cầu thành công trong sản xuất. Các buffers tất cả các nhật ký trong bộ nhớ trong quá trình yêu cầu. Nếu yêu cầu kết thúc thành công, buffers được loại bỏ. Nếu một lỗi (hoặc một ngưỡng cụ thể) đạt được, toàn bộ buffers (bao gồm các nhật ký xử lý lỗi trước đó) được rửa ra cho bộ xử lý kiên trì. FingersCrossedHandler cấu hình config/packages/prod/monolog.yaml Các thông tin sau: monolog:
    handlers:
        main:
            type: fingers_crossed
            # The strategy: "error" means if an ERROR occurs, dump everything.
            action_level: error
            # Where to dump the logs if the threshold is met
            handler: nested
            # Optional: Keep a small buffer size to prevent memory leaks in long processes
            buffer_size: 50
        nested:
            type: stream
            path: "%kernel.logs_dir%/%kernel.environment%.log"
            level: debug
 Bạn sẽ nhận được chi tiết pháp y về ghi nhật ký cấp độ giải quyết chính xác khi bạn cần nó - trong một vụ tai nạn - mà không lấp đầy đĩa của bạn với tiếng ồn trong các hoạt động bình thường. Kịch bản 2: Các kênh tách biệt: Nhật ký thanh toán của bạn là một sự pha trộn của các truy vấn học thuyết, kết hợp router và logic kinh doanh quan trọng. bạn cần một tệp dành riêng cho các giao dịch tài chính có thể được kiểm toán riêng biệt. app.log Tạo kênh Monolog tùy chỉnh. cấu hình config/packages/monolog.yaml Các thông tin sau: monolog:
    channels: ['payment'] # Register the channel

    handlers:
        payment:
            type: stream
            path: "%kernel.logs_dir%/payment.log"
            level: info
            channels: ["payment"] # Only listen to this channel
        
        main:
            type: stream
            path: "%kernel.logs_dir%/%kernel.environment%.log"
            level: debug
            channels: ["!payment"] # Exclude payment logs from the main file
 Thực hiện Nhúng logger cụ thể cho kênh này bằng cách sử dụng thuộc tính Target (có sẵn từ Symfony 5.3+). namespace App\Command;

use Psr\Log\LoggerInterface;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\DependencyInjection\Attribute\Target;

#[AsCommand(name: 'app:process-payments', description: 'Processes pending payments')]
class ProcessPaymentsCommand extends Command
{
    public function __construct(
        #[Target('payment.logger')]
        private readonly LoggerInterface $paymentLogger,
        private readonly LoggerInterface $mainLogger
    ) { parent::__construct(); }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $this->mainLogger->info('Cron job app:process-payments started.');

        $amounts = [10.50, 99.99, 45.00];
        foreach ($amounts as $amount) {
            $this->paymentLogger->info('Processing payment', ['amount' => $amount, 'status' => 'success']);
        }

        $this->mainLogger->info('Cron job finished.');
        return Command::SUCCESS;
    }
}
 Chạy lệnh. bạn sẽ thấy Được tạo ra trong chỉ chứa các mục nhập cụ thể này. payment.log var/log/ Kịch bản 3: Context Enrichment: The #[AsMonologProcessor] Attribute Các nhật ký là vô dụng nếu bạn không thể liên kết chúng với một người dùng cụ thể hoặc yêu cầu ID. Bạn thấy mình tự tay thêm [‘user_id’ => $user->getId()] vào mỗi câu lệnh nhật ký duy nhất. Một bộ xử lý toàn cầu có thể tự động tiêm ngữ cảnh vào mỗi bản ghi nhật ký. Thực hiện namespace App\Log;

use Monolog\Attribute\AsMonologProcessor;
use Monolog\LogRecord;

#[AsMonologProcessor]
class RequestContextProcessor
{
    public function __invoke(LogRecord $record): LogRecord
    {
        // Simulated context since CLI commands don't have HTTP Requests
        $extra = [
            'pid' => getmypid(),
            'user' => get_current_user(),
        ];

        return $record->with(extra: array_merge($record->extra, $extra));
    }
}
 Trong , Chúng tôi sử dụng Trả lại một bản sao sửa đổi. Monolog 3 LogRecord is immutable with() Kịch bản 4: Tuân thủ GDPR: Trình bày dữ liệu nhạy cảm Một nhà phát triển vô tình đăng nhập một đối tượng người dùng, ném PII (Thông tin nhận dạng cá nhân) hoặc số thẻ tín dụng vào các nhật ký, vi phạm GDPR / PCI-DSS. Một bộ xử lý chuyên dụng có thể quét mảng ngữ cảnh và che giấu các phím nhạy cảm. Thực hiện 
namespace App\Log;

use Monolog\Attribute\AsMonologProcessor;
use Monolog\LogRecord;

#[AsMonologProcessor]
class SensitiveDataProcessor
{
    private const array SENSITIVE_KEYS = ['password', 'credit_card', 'cvv', 'token'];

    public function __invoke(LogRecord $record): LogRecord
    {
        $context = $record->context;

        foreach ($context as $key => $value) {
            if (in_array($key, self::SENSITIVE_KEYS, true)) {
                $context[$key] = '***REDACTED***';
            }
        }

        return $record->with(context: $context);
    }
}
 Kiểm tra : $logger->info('User login', ['password' => 'secret123']);
// Output in log: "User login" {"password": "***REDACTED***"}
 Kịch bản 5: Cấu trúc nhật ký: JSON cho ELK/Datadog Parsing multi-line text logs (like stack traces) trong hoặc Regex Parsers dễ dàng phá vỡ. Kibana Datadog Bạn có thể đầu ra các nhật ký dưới dạng dòng JSON. Điều này cho phép các tập hợp nhật ký tự lập chỉ mục các trường như hoặc . context.order_id extra.req_id cấu hình config/packages/monolog.yaml Các thông tin sau: monolog:
    handlers:
        json_report:
            type: stream
            path: "%kernel.logs_dir%/app.json"
            level: info
            formatter: monolog.formatter.json
            channels: ["!payment", "!event"]
 Mở Kết quả sẽ trông như: var/log/app.json {"message":"Order created","context":{"id":123},"level":200,"channel":"app","datetime":"..."}
 Kịch bản 6: Ngăn chặn spam: The Deduplication Handler Cơ sở dữ liệu của bạn đi xuống. Ứng dụng của bạn nhận được trong một phút. trình xử lý “Email on Error” của bạn gửi cho bạn Nhận được của bạn . 5,000 requests 5,000 emails SMTP server blacklisted and flooding your inbox Các Có thể tổng hợp các bản ghi nhật ký giống hệt nhau và gửi một tóm tắt duy nhất. DeduplicationHandler cấu hình config/packages/monolog.yaml Các thông tin sau: monolog:
    handlers:
        deduplication:
            type: deduplication
            handler: nested_dedup
            buffer_size: 60
            time: 60
            level: error
            channels: ["!console"]
 Nếu DB sụp đổ, bạn sẽ nhận được liệt kê tất cả các sự kiện, thay vì một email cho mỗi yêu cầu. one email every 60 seconds Kịch bản 7: Dynamic Log Levels (Runtime Debugging) Một khách hàng cụ thể đang báo cáo một vấn đề trong sản xuất.Bạn không thể sao chép nó, và bạn không thể chuyển toàn bộ máy chủ sản xuất sang cấp độ DEBUG do hiệu suất bị ảnh hưởng. Sử dụng một để chuyển cấp nhật ký một cách năng động dựa trên tiêu đề yêu cầu. ActivationStrategy Thực hiện Tạo chiến lược custom: 
namespace App\Command;

use Psr\Log\LoggerInterface;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;

#[AsCommand(name: 'app:dynamic-debug', description: 'Tests dynamic log level activation')]
class DynamicDebugCommand extends Command
{
    public function __construct(private readonly LoggerInterface $logger) {
        parent::__construct();
    }

    protected function configure(): void
    {
        $this->addOption('force-debug', null, InputOption::VALUE_NONE, 'Force debug logging for this run');
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        if ($input->getOption('force-debug')) {
            $output->writeln('Debug mode forced via option. (Simulated, as Monolog ActivationStrategy relies on Http/Request state typically. But you can add processors/handlers dynamically in real apps based on this flag).');
        }

        $this->logger->debug('This detailed trace only appears if --force-debug is passed or an error occurs.');
        $this->logger->info('Standard processing information.');

        return Command::SUCCESS;
    }
}
 Kịch bản 8: Messenger Logging: Worker Context Logs từ Bạn thấy "Xử lý tin nhắn", nhưng bạn không biết ID tin nhắn nào gây ra lỗi vì nhân viên chạy như các quy trình chạy lâu. messenger:consume Sử dụng để chèn ID tin nhắn vào ngữ cảnh Monolog cụ thể cho quy trình nhân viên. Symfony’s EventListener Thực hiện 
namespace App\EventListener;

use Psr\Log\LoggerInterface;
use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
use Symfony\Component\Messenger\Event\WorkerMessageReceivedEvent;

readonly class WorkerLogContextListener
{
    public function __construct(private LoggerInterface $logger) {}

    #[AsEventListener]
    public function onMessageHandling(WorkerMessageReceivedEvent $event): void
    {
        $this->logger->info('Worker started message', [
            'message_class' => $event->getEnvelope()->getMessage()::class,
        ]);
    }
}
 Cách loại trừ 404s khỏi Error Logs Bot quét trang web của bạn để hoặc Tạo Chúng chặn công cụ giám sát lỗi của bạn (Sentry / Slack) với các dương tính giả. .env wp-login.php thousands of 404 NotFoundHttpException logs Sử dụng việc loại trừ kênh hoặc một cấu hình cụ thể để bỏ qua các nhật ký bounced, hoặc tốt hơn - cấu hình để bị bỏ qua bởi người xử lý lỗi chính. NotFoundHttpException cấu hình config/packages/monolog.yaml Các thông tin sau: monolog:
    handlers:
        fingers_crossed:
            type: fingers_crossed
            action_level: error
            handler: nested
            excluded_http_codes: [404, 405]
            buffer_size: 50
 Kịch bản 10: Notifier Bridge: ChatOps Cảnh báo email chậm và thường bị bỏ qua. Bạn muốn thất bại cơ sở hạ tầng quan trọng để ping một kênh ngay lập tức Slack Sử dụng Bridge với . symfony/notifier Monolog Điều kiện composer require symfony/notifier symfony/slack-notifier
 cấu hình config/packages/monolog.yaml Các thông tin sau: monolog:
    handlers:
        slack_alerts:
            type: service
            id: Symfony\Bridge\Monolog\Handler\NotifierHandler
            level: critical
 Sau đó cấu hình notifier chatter trong Và DSN của bạn trong . config/packages/notifier.yaml .env framework:
    notifier:
        chatter_transports:
            slack: '%env(SLACK_DSN)%'
        texter_transports:
        channel_policy:
            urgent: ['chat/slack']
            high: ['chat/slack']
            medium: ['chat/slack']
            low: ['chat/slack']
        admin_recipients:
            - { email: admin@example.com }
 maps log levels to Notifier importance. A critical log becomes a . NotifierHandler High Priority Slack notification automatically Kết luận Logging không phải là một sản phẩm phụ của mã - nó là một tính năng của cơ sở hạ tầng của bạn. Trong tư duy của một nhà phát triển cấp thấp, đăng nhập là một mạng lưới an toàn - một cái gì đó để kiểm tra chỉ khi mọi thứ bị phá vỡ. nhưng khi bạn mở rộng sang vai trò cấp cao và lãnh đạo, quan điểm của bạn phải thay đổi. Bằng cách chuyển sang Symfony 7.4 và tận dụng toàn bộ sức mạnh của Monolog 3, chúng ta chuyển từ “logging” sang “observability”. biến nhật ký của bạn thành một cơ sở dữ liệu có thể truy vấn. Structured JSON Các bộ xử lý giải quyết tỷ lệ "tín hiệu đến tiếng ồn", tiết kiệm cho bạn gigabyte dung lượng lưu trữ trong khi duy trì bối cảnh quan trọng. FingersCrossed Đảm bảo mỗi mục nhập nhật ký mang DNA của yêu cầu (User ID, Request ID) biến giờ gỡ lỗi thành phút xác minh. Processors Bảo vệ hộp thư đến của bạn và sức khỏe của bạn. Deduplication Việc thực hiện các mô hình này phân biệt một ứng dụng dễ bị tổn thương với một hệ thống cấp doanh nghiệp mạnh mẽ.Khi môi trường sản xuất của bạn phải đối mặt với một sự gia tăng lưu lượng truy cập hoặc một vấn đề hỏng hóc dữ liệu, những cấu hình này sẽ là sự khác biệt giữa một sự căng thẳng toàn diện và một hotfix nhanh, chính xác. Mã nguồn: Bạn có thể tìm thấy việc thực hiện đầy đủ và theo dõi tiến trình của dự án trên GitHub: [ ] https://github.com/mattleads/MonologPatterns https://github.com/mattleads/MonologPatterns Chúng ta hãy kết nối! Nếu bạn thấy điều này hữu ích hoặc có câu hỏi về việc triển khai, tôi muốn nghe từ bạn. Hãy giữ liên lạc và giữ cho cuộc trò chuyện diễn ra trên các nền tảng này: 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] X (Twitter): [https://x.com/MattLeads] Điện thoại: [https://t.me/MattLeads] GitHub: [https://github.com/mattleads] https://www.linkedin.com/in/matthew-mochalkin/ https://x.com/MattLeads https://t.me/MattLeads https://github.com/mattleads

Read My Stories

Nghe bài viết này bằng Tiếng Anh, đọc bởi robot thông minh của HackerNoon

Symfony 7.4: 10 mô hình logging tiên tiến bạn nên biết về

About Author

BÌNH LUẬN

chuyên mục

BÀI VIẾT NÀY CŨNG CÓ MẶT TẠI

Related Stories

85 Stories To Learn About Productivity Hacks

189 Stories To Learn About Reading Books

178 Stories To Learn About Essay

287 Stories To Learn About Blockchain Development

85 Stories To Learn About Productivity Hacks

189 Stories To Learn About Reading Books

178 Stories To Learn About Essay

287 Stories To Learn About Blockchain Development

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps