Metsästys on tuotannon sovelluksen sydämenlyönti. Hankkeen alkuvaiheessa yksinkertainen tausta riittää. Mutta kun Symfony-sovelluksesi skaalautuu käsittelemään ja ja ”Kirjoittaminen tiedostoon” muuttuu velvoitteeksi sen sijaan, että se olisi omaisuus. dev.log payments asynchronous workers high-concurrency traffic Sillä tarjoaa kehittyneitä työkaluja päiväkirjojen muuntamiseen yksinkertaisista tekstivirroista jäsenneltyihin, toimiviin havaittavuustietoihin. symfony/monolog-bundle Tässä oppaassa tutkitaan 10 edistyksellistä kirjautumismallia, jotka ylittävät oletukset. Käytämme tiukkaa kirjoittamista, PHP-attribuutteja ja nykyaikaista YAML-muotoilua. Edellytykset 
 
 
 
 
 
 Säveltäjä: 7.4+ PHP: 8,3 tai enemmän Sinfonia / monologipaketti Monologit ja monologit symfonia/ilmoittaja (esimerkkejä hälytyksistä) Kuva 1. Musta laatikko: FingersCrossed Handler Haluat yksityiskohtaisia vianmäärityspäiväkirjoja, kun virhe ilmenee ymmärtääksesi siihen johtavien tapahtumien jakson, mutta et voi varaa levyn I/O:ta kirjaamaan viestejä jokaisesta onnistuneesta pyynnöstä tuotannossa. Sillä Puolustavat kaikki muistipäiväkirjat pyynnön aikana. Jos pyyntö päättyy onnistuneesti, puolustaja hylätään. Jos virhe (tai tietty kynnysarvo) saavutetaan, koko puolustaja (mukaan lukien aiemmat vianmäärityspäiväkirjat) pestään pysyvyyden käsittelijälle. FingersCrossedHandler Konfigurointi config/packages/prod/monolog.yaml Näytä tarkat tiedot 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
 Saat oikeuslääketieteellisen yksityiskohdan debug-tason lokalisoinnista juuri silloin, kun tarvitset sitä - kaatumisen aikana - ilman levyn täyttämistä melulla normaalin toiminnan aikana. Skenaario 2. Segregated Channels: The “Payment” Log Sinun on sekoitus Doctrine-kyselyistä, reitittimen vastaamisesta ja kriittisestä liiketoiminnan logiikasta. Tarvitset erityisen tiedoston taloudellisiin transaktioihin, joita voidaan tarkastaa erikseen. app.log Luo mukautettu Monolog-kanava Konfigurointi config/packages/monolog.yaml Käyttöohjeet 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
 toteuttaminen Injektoi lokikirjain erityisesti tälle kanavalle käyttämällä Target-ominaisuutta (saatavilla Symfony 5.3+:sta lähtien). 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äynnistä komento, niin näet Luotu sisään Se sisältää vain näitä erityisiä merkintöjä. payment.log var/log/ Skenaario 3. Context Enrichment: The #[AsMonologProcessor] attribuutti Lokit ovat hyödyttömiä, jos et voi korreloida niitä tietyn käyttäjän tai pyynnön ID: n kanssa. Löydät itsesi lisäämällä manuaalisesti [‘user_id’ => $user->getId()] jokaiseen yksittäiseen lokikirjoitukseen. Globaali prosessori voi automaattisesti ruiskuttaa kontekstia jokaiseen lokitiedostoon. toteuttaminen 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));
    }
}
 ja ja Me käytämme palauttaa muutetun kopion. Monolog 3 LogRecord is immutable with() Skenaario 4. GDPR:n noudattaminen: Arkaluonteisten tietojen kirjoittaminen Kehittäjä kirjautuu vahingossa käyttäjän kohteeseen, polkemalla PII (henkilökohtaisesti tunnistettavat tiedot) tai luottokorttinumerot lokeihin, mikä rikkoo GDPR/PCI-DSS:ää. Erikoistunut prosessori voi skannata kontekstimarginaalin ja peittää arkaluonteiset avaimet. toteuttaminen 
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);
    }
}
 Todentaminen : $logger->info('User login', ['password' => 'secret123']);
// Output in log: "User login" {"password": "***REDACTED***"}
 Skenaario 5. Rakennetut lokitukset: JSON for ELK/Datadog Useiden rivien tekstipäiväkirjojen tarkistaminen (kuten stack traces) tai Regex-parsereita on helppo rikkoa. Kibana Datadog Voit tulostaa lokeja JSON-linjoina.Tämä mahdollistaa lokiaggregaattoreiden indeksoivan natiivisesti kenttiä kuten tai . context.order_id extra.req_id Konfigurointi config/packages/monolog.yaml Käyttöohjeet monolog:
    handlers:
        json_report:
            type: stream
            path: "%kernel.logs_dir%/app.json"
            level: info
            formatter: monolog.formatter.json
            channels: ["!payment", "!event"]
 avoinna Tuotteen pitäisi näyttää: var/log/app.json {"message":"Order created","context":{"id":123},"level":200,"channel":"app","datetime":"..."}
 Skenaario 6. Roskapostin estäminen: Deduplication Handler Tietokanta putoaa. hakemuksesi saa ”Email on Error” -toimittaja lähettää sinulle Saadaksesi sinun . 5,000 requests 5,000 emails SMTP server blacklisted and flooding your inbox Sillä Voit yhdistää samat lokitiedot ja lähettää yhden yhteenvedon. DeduplicationHandler Konfigurointi config/packages/monolog.yaml Käyttöohjeet monolog:
    handlers:
        deduplication:
            type: deduplication
            handler: nested_dedup
            buffer_size: 60
            time: 60
            level: error
            channels: ["!console"]
 Jos DB kaatuu, saat luettelo kaikista tapahtumista, eikä yksi sähköposti per pyyntö. one email every 60 seconds Skenaario 7. Dynaamiset lokitasot (Runtime Debugging) Tietty asiakas ilmoittaa ongelmasta tuotannossa. Et voi toistaa sitä, etkä voi vaihtaa koko tuotantopalvelinta DEBUG-tasolle suorituskyvyn vaikutuksen vuoksi. Käytä yksi vaihtaa lokin tasoa dynaamisesti pyynnön otsikon perusteella. ActivationStrategy toteuttaminen Suunnittele mukautettua strategiaa: 
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;
    }
}
 Skenaario 8. Messenger Logging: Työntekijän konteksti Päiväkirjat Näet viestin käsittelyn, mutta et tiedä, mikä viestin tunnus aiheutti virheen, koska työntekijät toimivat pitkäkestoisina prosesseina. messenger:consume Käytä Injektoida Viesti-ID monologin kontekstissa nimenomaan työntekijän prosessiin. Symfony’s EventListener toteuttaminen 
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,
        ]);
    }
}
 Skenaario 9. 404: n poissulkeminen virheilmoituksista Botit skannaavat sivustosi tai sukupolvi Nämä tukkevat virheiden seurantatyökalun (Sentry / Slack) väärillä positiivisilla. .env wp-login.php thousands of 404 NotFoundHttpException logs Käytä kanavien poissulkemista tai tiettyä kokoonpanoa hylätyjen lokien sivuuttamiseksi tai parempi - määritä Päävirheen käsittelijä jättää huomiotta. NotFoundHttpException Konfigurointi config/packages/monolog.yaml Käyttöohjeet monolog:
    handlers:
        fingers_crossed:
            type: fingers_crossed
            action_level: error
            handler: nested
            excluded_http_codes: [404, 405]
            buffer_size: 50
 Skenaario 10. Ilmoittajan silta: ChatOps Sähköposti-ilmoitukset ovat hitaita ja usein sivuutettuja. Haluat kriittisen infrastruktuurin epäonnistumisen ping Kanavat heti Slack Käytä Bridgetin kanssa . symfony/notifier Monolog Edellytykset composer require symfony/notifier symfony/slack-notifier
 Konfigurointi config/packages/monolog.yaml Käyttöohjeet monolog:
    handlers:
        slack_alerts:
            type: service
            id: Symfony\Bridge\Monolog\Handler\NotifierHandler
            level: critical
 Aseta sitten chatter-ilmoittajan ja DSN:n sisällä . 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 }
 kartat lokin tasot merkitykseen Notifier. Kriittinen loki muuttuu . NotifierHandler High Priority Slack notification automatically Johtopäätös Logging ei ole koodin sivutuote - se on infrastruktuurin ominaisuus. Nuorempien kehittäjien ajattelutavassa lokalisointi on turvaverkko – jotain, joka tarkistetaan vain, kun asiat häiriintyvät.Mutta kun laajennat Senior- ja Lead-rooleihin, näkökulmasi on muututtava. Siirtymällä Symfony 7.4:een ja hyödyntämällä Monolog 3:n täyttä voimaa siirtymme ”kirjailusta” ”katseltavuudelle”. muuttaa päiväkirjasi kyselylomakkeeksi. Structured JSON käsittelijät ratkaisevat ”signaali-melu-suhteen”, mikä säästää gigatavua tallennustilaa säilyttäen samalla kriittisen kontekstin. FingersCrossed varmistamalla, että jokaisella lokitiedostolla on pyynnön DNA (käyttäjätunnus, pyyntötunnus) kääntämällä debugging-tunnit todentamisminuutteiksi. Processors Suojaa postilaatikkosi ja terveytesi. Deduplication Näiden mallien täytäntöönpano erottaa hauraan sovelluksen vahvasta, yritystason järjestelmästä.Kun tuotantoympäristösi kohtaa liikenteen nousun tai hiljaisen tietojen vahingoittumisen ongelman, nämä kokoonpanot ovat ero stressaavan ja nopean, tarkan hotfixin välillä. Lähdekoodi: Voit löytää koko toteutuksen ja seurata projektin edistymistä Githubissa: [ ] https://github.com/mattleads/MonologPatterns https://github.com/mattleads/MonologPatterns Olkaamme siis yhteydessä! Jos olet löytänyt tämän hyödylliseksi tai sinulla on kysymyksiä toteutuksesta, haluaisin kuulla sinulta. 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] Yhteystiedot: [https://x.com/MattLeads] Sähköpostiosoite: [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

Tämä ääni on tuotettu tarinan alkuperäisellä kielellä!

Symfony 7.4: 10 edistyksellistä logging-mallia, jotka sinun pitäisi tietää

About Author

KOMMENTIT

RIPUTA TAGSIA

TÄMÄ ARTIKKELI ESITETTIIN

Related Stories

Meet Filestack: HackerNoon Company of the Week

Meet dRPC: HackerNoon Company of the Week

Noonies Interview with Stefano Pavone, the Retrogaming Reporter

Win Up to $2000 in the #blockchain Writing Contest by Aleph Cloud and HackerNoon

Meet Filestack: HackerNoon Company of the Week

Meet dRPC: HackerNoon Company of the Week

Noonies Interview with Stefano Pavone, the Retrogaming Reporter

Win Up to $2000 in the #blockchain Writing Contest by Aleph Cloud and HackerNoon

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps