Logging er hjertet i en produktionsapplikation. I de tidlige dage af et projekt, en simpel er tilstrækkelig. men som din Symfony-applikation skalerer at håndtere , der og , "skrivning til en fil" bliver en forpligtelse snarere end en aktiv. dev.log payments asynchronous workers high-concurrency traffic Den tilbyder sofistikerede værktøjer til at omdanne logs fra enkle tekststrømme til strukturerede, håndterbare observationsdata. symfony/monolog-bundle Denne vejledning udforsker 10 avancerede logging mønstre, der går ud over standard. Vi vil bruge streng typing, PHP attributter og moderne YAML konfiguration. Forudsætninger 
 
 
 
 
 
 Symfoni: 7,4 + PHP: 8.3 og mere Symfoni/monolog bundle Monolog og monolog Symfoni / Notifier (for advarselseksempler) Scenarie 1: The “Black Box” Recorder: FingersCrossed Handler Du vil have detaljerede debug logs, når en fejl opstår for at forstå sekvensen af begivenheder, der fører til det, men du har ikke råd til disk I/O til at logge debug beskeder for hver vellykket anmodning i produktion. Den buffer alle logfiler i hukommelsen under forespørgslen. Hvis forespørgslen afsluttes med succes, bortskaffes bufferen. Hvis en fejl (eller en bestemt tærskel) opnås, skylles hele bufferen (herunder tidligere debug-logfiler) til persistenshåndtereren. FingersCrossedHandler Konfiguration af config/packages/prod/monolog.yaml er: 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
 Du får den forensiske detalje af debug-niveau logging nøjagtigt, når du har brug for det - under et nedbrud - uden at fylde din disk med støj under normale operationer. Scenarie 2: Segregerede kanaler: Den "betalings" log Din er en blanding af doktrinforespørgsler, router matching og kritisk forretningslogik. Du har brug for en dedikeret fil til finansielle transaktioner, der kan auditeres separat. app.log Opret en monologskanal. Konfiguration af config/packages/monolog.yaml er: 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
 gennemførelse Indsprøjte loggeren specifikt til denne kanal ved hjælp af Target-attributtet (tilgængelig siden 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;
    }
}
 Kør kommandoen. du vil se Skabt i Det gælder kun disse specifikke indtastninger. payment.log var/log/ Scenario 3: Kontekst Berigelse: Den #[AsMonologProcessor] Attribut Logs er ubrugelige, hvis du ikke kan korrelere dem med en bestemt bruger eller anmodning ID. Du finder dig selv manuelt tilføje [‘user_id’ => $user->getId()] til hver enkelt log udtalelse. En global processor kan automatisk injicere kontekst i hver logpost. gennemførelse 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));
    }
}
 i , der Vi bruger Tilbage til en ændret kopi. Monolog 3 LogRecord is immutable with() Scenarie 4: GDPR-overensstemmelse: Redaktion af følsomme data En udvikler logger utilsigtet et brugerobjekt, dumping PII (Personligt Identificerbare Oplysninger) eller kreditkortnumre i logs, der overtræder GDPR / PCI-DSS. En specialiseret processor kan scanne kontekstmassen og maskere følsomme nøgler. gennemførelse 
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);
    }
}
 Kontrol af: $logger->info('User login', ['password' => 'secret123']);
// Output in log: "User login" {"password": "***REDACTED***"}
 Scenario 5: Struktureret logning: JSON for ELK/Datadog Partering af tekstlogs med flere linjer (såsom stabelspor) i eller Regex parsers bryder let. Kibana Datadog Du kan udstede logs som JSON-linjer. Dette gør det muligt for log aggregatorer at nativt indeksere felter som eller . context.order_id extra.req_id Konfiguration af config/packages/monolog.yaml er: monolog:
    handlers:
        json_report:
            type: stream
            path: "%kernel.logs_dir%/app.json"
            level: info
            formatter: monolog.formatter.json
            channels: ["!payment", "!event"]
 Åbent Produktionen skal se ud som: var/log/app.json {"message":"Order created","context":{"id":123},"level":200,"channel":"app","datetime":"..."}
 Forebyggelse af spam: Deduplication Handler Din database går ned. Din ansøgning modtager Din “Email on Error” handler sender dig At få din . 5,000 requests 5,000 emails SMTP server blacklisted and flooding your inbox Den Du kan samle identiske logfiler og sende en enkelt sammenfatning. DeduplicationHandler Konfiguration af config/packages/monolog.yaml er: monolog:
    handlers:
        deduplication:
            type: deduplication
            handler: nested_dedup
            buffer_size: 60
            time: 60
            level: error
            channels: ["!console"]
 Hvis DB falder ned, modtager du Liste alle forekomster, i stedet for en e-mail pr. anmodning. one email every 60 seconds Scenario 7: Dynamiske logniveauer (Runtime Debugging) Du kan ikke gengive det, og du kan ikke skifte hele produktionsserveren til DEBUG-niveauet på grund af ydeevnen. Brug en at skifte logniveau dynamisk baseret på en forespørgselsheader. ActivationStrategy gennemførelse Opret en custom strategi: 
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;
    }
}
 Scenario 8: Messenger Logging: Arbejdskraftens kontekst Logs fra Du ser "Håndtering af meddelelse", men du ved ikke, hvilket meddelelses-id der forårsagede fejlen, fordi medarbejderne kører som langvarige processer. messenger:consume Brug af at indsætte meddelelses-id'et i Monolog-konteksten specifikt for arbejdstagerprocessen. Symfony’s EventListener gennemførelse 
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,
        ]);
    }
}
 Undtagelse af 404s fra fejllogs Bots scanner dit websted til eller Genererer Disse blokerer dit fejlovervågningsværktøj (Sentry / Slack) med falske positive. .env wp-login.php thousands of 404 NotFoundHttpException logs Brug kanaludelukkelsen eller en bestemt konfiguration til at ignorere bounced logs, eller bedre - konfigurer at blive ignoreret af hovedfejl håndtering. NotFoundHttpException Konfiguration af config/packages/monolog.yaml er: monolog:
    handlers:
        fingers_crossed:
            type: fingers_crossed
            action_level: error
            handler: nested
            excluded_http_codes: [404, 405]
            buffer_size: 50
 Scenarie 10: Notifier Bridge: ChatOps E-mail-advarsler er langsomme og ofte ignoreret. Du vil have kritiske infrastrukturfejl til at kanaler med det samme. Slack Brug af Bridget med . symfony/notifier Monolog Forudsætninger composer require symfony/notifier symfony/slack-notifier
 Konfiguration af config/packages/monolog.yaml er: monolog:
    handlers:
        slack_alerts:
            type: service
            id: Symfony\Bridge\Monolog\Handler\NotifierHandler
            level: critical
 Konfigurer derefter notifikatoren chatter i og din DSN i . 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 niveauer til Notifier betydning. En kritisk log bliver en . NotifierHandler High Priority Slack notification automatically Konklusionen Logging er ikke et biprodukt af kode - det er en funktion af din infrastruktur. I en junior udviklerens tankegang er logning et sikkerhedsnet – noget, du kun skal tjekke, når tingene går i stykker. Men når du skalerer til Senior- og Lead-roller, skal dit perspektiv skifte. Ved at flytte til Symfony 7.4 og udnytte den fulde kraft af Monolog 3 overgår vi fra "logging" til "observation". Gør dine logfiler til en forespørgselbaseret database. Structured JSON håndtere løse "signal-til-støj" ratio, sparer dig gigabytes af lagring samtidig med at bevare kritisk kontekst. FingersCrossed at sikre, at hver logindgang bærer DNA'et af anmodningen (bruger-id, anmodnings-id) omdanner timer af debugging til minutter af verifikation. Processors Beskyt din indbakke og din sundhed. Deduplication Implementering af disse mønstre adskiller en skrøbelig applikation fra et robust, enterprise-grade system.Når dit produktionsmiljø står over for en trafikspike eller et stille data korruption problem, vil disse konfigurationer være forskellen mellem en stressende alt-nighter og en hurtig, præcis hotfix. Kilde: Du kan finde den fulde implementering og følge projektets fremskridt på GitHub: [ ] https://github.com/mattleads/MonologPatterns https://github.com/mattleads/MonologPatterns Lad os forbinde! Hvis du fandt dette nyttigt eller har spørgsmål om implementeringen, vil jeg gerne høre fra dig. Lad os holde kontakten og holde samtalen på tværs af disse platforme: 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] Du er her: [https://x.com/MattLeads] Tilgængelig på: [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

Denne lyd er produceret på historiens originalsprog!

Symfony 7.4: 10 avancerede logging mønstre, du bør vide om

About Author

KOMMENTARER

HÆNG TAGS

DENNE ARTIKEL BLEV PRÆsenterET I

Related Stories

Meet Hubstaff: HackerNoon Company of the Week

Meet Sentry: HackerNoon Company of the Week

Meet Tailscale: HackerNoon Company of the Week

Meet HubSpot: HackerNoon Company of the Week

Meet Hubstaff: HackerNoon Company of the Week

Meet Sentry: HackerNoon Company of the Week

Meet Tailscale: HackerNoon Company of the Week

Meet HubSpot: HackerNoon Company of the Week

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps