木造は生産アプリケーションの心拍です プロジェクトの初期に、単純な 尾は十分ですが、あなたのSymfonyアプリケーションのスケールが処理するように で、 そして 「ファイルに書き込む」は、資産ではなく責任になります。 dev.log payments asynchronous workers high-concurrency traffic THE 単純なテキスト ストリームからログを構造化された、操作可能な観測可能なデータに変換するための高度なツールを提供します。 symfony/monolog-bundle このガイドでは、デフォルトを超える10の高度なログパターンを探索します. We will use strict typing, PHP Attributes, and modern YAML configuration. 前提条件 
 
 
 
 
 
 シンフォニー: 7.4+ PHP: 8.3+ シンフォニー/モノログバンドル モノロジー / Monologue Symphony/notifier (for alerting examples) 『ブラックボックス』レコーダー『FingersCrossed Handler』 エラーが発生した場合に詳細なデバッグログを必要とし、その結果につながるイベントの順序を理解するが、デバッグメッセージを記録するディスクI/Oを手に入れることはできない。 THE バッファは、リクエスト中にメモリ内のすべてのログをバッファします。リクエストが成功した場合、バッファは廃棄されます。エラー(または特定の限界)が達成された場合、バッファ全体(以前のデバッグログを含む)は、持続処理に洗浄されます。 FingersCrossedHandler 構成 config/packages/prod/monolog.yaml について: 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
 あなたは、正常な操作中にディスクを騒音で満たさずに、バグレベルログの法的詳細を正確にあなたが必要とするときに取得します。 シナリオ2:分離されたチャンネル:「支払い」ログ 君の Doctrine クエリ、ルーター マッチング、および重要なビジネス ロジックの組み合わせです. You need a dedicated file for financial transactions that can be audited separately. app.log モノログチャンネルを作成します。 構成 config/packages/monolog.yaml について: 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
 実施 ターゲット属性 (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;
    }
}
 コマンドを実行して見る 創作中 これらの具体的な入力のみを含む。 payment.log var/log/ シナリオ3:Context Enrichment: The #[AsMonologProcessor] Attribute ログは、特定のユーザーまたはリクエスト ID にそれらを関連付けることができない場合に役に立ちません. You find yourself manually adding [‘user_id’ => $user->getId()] to each single log statement. Logs are useless if you can’t correlate them to a specific user or request ID. You find yourself manually adding [‘user_id’ => $user->getId()] to each single log statement. グローバルプロセッサは、すべてのログレコードにコンテキストを自動的に注入できます。 実施 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));
    }
}
 イン で、 わたしたちは使用 変更されたコピーを返します。 Monolog 3 LogRecord is immutable with() シナリオ4:GDPRコンプライアンス:機密データ編集 開発者は、誤ってユーザーオブジェクトをログインし、PII(個人識別情報)またはクレジットカード番号をログに dumpingし、GDPR/PCI-DSSに違反します。 専門プロセッサは、コンテキストアレイをスキャンし、敏感なキーをマスクすることができます。 実施 
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);
    }
}
 検証: $logger->info('User login', ['password' => 'secret123']);
// Output in log: "User login" {"password": "***REDACTED***"}
 シナリオ 5. Structured Logging: JSON for ELK/Datadog マルチラインテキストログ(stack traces など)のパスティング または Regex Parsers は簡単に壊れます。 Kibana Datadog JSON ラインとしてログを出力できます. This allows log aggregators to natively index fields such as JSON または . context.order_id extra.req_id 構成 config/packages/monolog.yaml について: monolog:
    handlers:
        json_report:
            type: stream
            path: "%kernel.logs_dir%/app.json"
            level: info
            formatter: monolog.formatter.json
            channels: ["!payment", "!event"]
 オープン 出力は以下のようになるはずです。 var/log/app.json {"message":"Order created","context":{"id":123},"level":200,"channel":"app","datetime":"..."}
 シナリオ6:Spam Prevention: The Deduplication Handler データベースがダウンロード アプリケーションがダウンロード あなたの「Email on Error」トレーダーがあなたを送信します。 「GET YOUR . 5,000 requests 5,000 emails SMTP server blacklisted and flooding your inbox THE 同一のログレコードを集計し、単一の概要を送信できます。 DeduplicationHandler 構成 config/packages/monolog.yaml について: monolog:
    handlers:
        deduplication:
            type: deduplication
            handler: nested_dedup
            buffer_size: 60
            time: 60
            level: error
            channels: ["!console"]
 DBが故障した場合、あなたは リクエストごとに 1 件のメールではなく、すべてのイベントをリストします。 one email every 60 seconds シナリオ7 ダイナミックログレベル(Runtime Debugging) 特定のクライアントが生産中の問題を報告しています. あなたはそれを再生できませんし、パフォーマンスのヒットのために生産サーバー全体をDEBUGレベルに切り替えることはできません。 使用 1 リクエストヘッダーに基づいてログレベルをダイナミックに切り替える。 ActivationStrategy 実施 「Custom Strategy」を作成する: 
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;
    }
}
 シナリオ8:Messenger Logging: Worker Context Logs from 「メッセージの処理」が表示されますが、従業員が長いプロセスとして実行されているため、どのメッセージ IDがエラーを引き起こしたかを知りません。 messenger:consume 利用 メッセージ ID を、従業員プロセス用に特定の Monolog コンテキストに注入します。 Symfony’s EventListener 実施 
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,
        ]);
    }
}
 シナリオ9:エラーログから404を除外する あなたのサイトをスキャンするボット または 生成 これらは、エラーモニタリングツール(Sentry/Slack)を偽ポジティブで遮断します。 .env wp-login.php thousands of 404 NotFoundHttpException logs チャンネル除外または特定の構成を使用して、ボンクしたログを無視するか、より良い - 設定 主なエラー操作者に無視される。 NotFoundHttpException 構成 config/packages/monolog.yaml について: monolog:
    handlers:
        fingers_crossed:
            type: fingers_crossed
            action_level: error
            handler: nested
            excluded_http_codes: [404, 405]
            buffer_size: 50
 シナリオ10: Notifier Bridge: ChatOps 電子メールの警告は遅く、しばしば無視されます。あなたは重要なインフラストラクチャの故障をピンアップしたい チャンネルはすぐに Slack 利用 bridged with . symfony/notifier Monolog 前提条件 composer require symfony/notifier symfony/slack-notifier
 構成 config/packages/monolog.yaml について: monolog:
    handlers:
        slack_alerts:
            type: service
            id: Symfony\Bridge\Monolog\Handler\NotifierHandler
            level: critical
 その後、notifier chatter を設定します。 あなたのDSNは . 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 }
 Notifier importance にログレベルをマップします. A critical log becomes a . NotifierHandler High Priority Slack notification automatically 結論 ログはコードの副産物ではなく、インフラの特徴です。 ジュニア・デベロッパーの考え方では、ログはセキュリティネットワークであり、物事が壊れたときにチェックするものですが、シニアとリーダーの役割にスケールするにつれて、あなたの視点は変わらなければなりません。 Symfony 7.4 に移行し、Monolog 3 のパワーを最大限に活用することで、「ログ」から「観察」へと移行します。 あなたのログを検索可能なデータベースに変換します。 Structured JSON マネージャーは「信号対騒音」比率を解決し、重要な文脈を保存しながらギガバイトのストレージを節約します。 FingersCrossed リクエストのDNA(ユーザID、リクエストID)を持ち込む各ログエントリの確保により、デバッグ時間を検証分に変える。 Processors あなたのインボックスとあなたの健康を守ります。 Deduplication これらのパターンの実装により、脆弱なアプリケーションを強力なエンタープライズクラスのシステムと区別できます。 あなたの生産環境がトラフィックのピークや静かなデータ破壊の問題に直面するとき、これらの構成は、ストレスの高いすべてと迅速かつ正確なホットフィックスの違いになります。 ソースコード: GitHub で完全な実装を検索し、プロジェクトの進捗状況を追跡できます。 ] https://github.com/mattleads/MonologPatterns https://github.com/mattleads/MonologPatterns つながろう! これが役に立ったか、実装に関する質問があったら、あなたから聞きたいと思います. 連絡をとって、これらのプラットフォームを通じて会話を続けましょう: 
 
 
 
 
 リンク: [https://www.linkedin.com/in/matthew-mochalkin/] ツイッター(Twitter): [https://x.com/MattLeads] テレグラム: [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

このオーディオは、ストーリーの元の言語で制作されています。

Symfony 7.4: 10 Advanced Logging Patterns You Should Know About オリジナルタイトル

About Author

コメント

ラベル

この記事は

Related Stories

タップして稼ぐ：テレグラムはソラナより先に次の100億人の暗号通貨ユーザーを獲得する可能性がある

ユーザー中心の暗号通貨製品の作成: 顧客からのフィードバックの重要性

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

18 種類の開発者ツールで生産性を向上しましょう 🚀🔥

タップして稼ぐ：テレグラムはソラナより先に次の100億人の暗号通貨ユーザーを獲得する可能性がある

ユーザー中心の暗号通貨製品の作成: 顧客からのフィードバックの重要性

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

18 種類の開発者ツールで生産性を向上しましょう 🚀🔥

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps