A madeira é o corazón dunha aplicación de produción. Nos primeiros días dun proxecto, unha simple a cola é suficiente. pero como a súa aplicación Symfony escala para manexar , e , "escribir a un ficheiro" convértese nunha responsabilidade máis que nun activo. dev.log payments asynchronous workers high-concurrency traffic A súa Ofrece ferramentas sofisticadas para transformar os rexistros de fluxos de texto sinxelos en datos de observación estructurados e actuables. symfony/monolog-bundle Esta guía explora 10 patróns avanzados de rexistro que van máis alá dos estándares. usaremos tipografía estrita, atributos PHP e configuración moderna de YAML. Precondicións 
 
 
 
 
 
 Sinfonía: 7.4+ PHP: máis de 8.3 Sinfonía / Monólogo Monólogos / Monólogos sinfonía / notificador (para exemplos de alerta) O gravador da caixa negra: FingersCrossed Handler Queres rexistros detallados de arranxo cando ocorre un erro para comprender a secuencia de eventos que o conducen, pero non podes permitir que o disco I/O rexistre as mensaxes de arranxo para cada solicitude exitosa na produción. A súa buffer todos os rexistros de memoria durante a solicitude. Se a solicitude remata con éxito, o buffer é descartado. Se se alcanza un erro (ou un limiar específico), o buffer enteiro (incluídos os rexistros de debugamento anteriores) é lavado ao manipulador de persistencia. FingersCrossedHandler Configuración config/packages/prod/monolog.yaml Páxina oficial: 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
 Obterás o detalle forense do rexistro de nivel de depuración exactamente cando o necesites - durante un accidente - sen encher o teu disco con ruído durante as operacións normais. Escenario 2: Canles segregadas: o rexistro de "pagamentos" A túa é unha mestura de consultas de Doutrina, correspondencia de router e lóxica de negocio crítica. precisa dun ficheiro dedicado para transaccións financeiras que pode ser auditado por separado. app.log Crea unha canle de monólogos. Configuración config/packages/monolog.yaml Páxina oficial: 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
 Implementación Inxecta o logger especificamente para este canal usando o atributo Target (dispoñible desde 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;
    }
}
 Executa o comando. verás creado en que só inclúen estas entradas específicas. payment.log var/log/ Escenario 3: Enriquecemento de contexto: o atributo #[AsMonologProcesador] Os rexistros son inútiles se non pode correlacionalos a un usuario específico ou ID de solicitude. Vostede se atopa engadindo manualmente [‘user_id’ => $user->getId()] a cada declaración de rexistro. Un procesador global pode inxectar automaticamente contexto en cada rexistro de rexistro. Implementació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));
    }
}
 en , que usamos Devolve unha copia modificada. Monolog 3 LogRecord is immutable with() Escenario 4: Cumprimento do GDPR: Redacción de datos sensibles Un desenvolvedor rexistra accidentalmente un obxecto de usuario, dumping PII (Información de Identificación Persoal) ou números de tarxeta de crédito nos rexistros, violando o GDPR / PCI-DSS. Un procesador especializado pode escanear a matriz de contexto e ocultar as claves sensibles. Implementació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);
    }
}
 A verificación: $logger->info('User login', ['password' => 'secret123']);
// Output in log: "User login" {"password": "***REDACTED***"}
 Escenario 5: Rexistro estruturado: JSON para ELK/Datadog Comprobación de rexistros de texto de varias liñas (como pistas de pistas) en ou Os parsers de Regex rompen con facilidade. Kibana Datadog Pode exportar rexistros como liñas JSON. Isto permite que os agregadores de rexistros indiquen nativamente campos como ou . context.order_id extra.req_id Configuración config/packages/monolog.yaml Páxina oficial: monolog:
    handlers:
        json_report:
            type: stream
            path: "%kernel.logs_dir%/app.json"
            level: info
            formatter: monolog.formatter.json
            channels: ["!payment", "!event"]
 aberta A saída debe parecer: var/log/app.json {"message":"Order created","context":{"id":123},"level":200,"channel":"app","datetime":"..."}
 Escenario 6: Prevención de Spam: O Xestor de Deduplicación A túa base de datos baixa.A túa aplicación recibe O seu "Email on Error" manipulador envía para obter a túa . 5,000 requests 5,000 emails SMTP server blacklisted and flooding your inbox A súa Pode agregar rexistros de rexistro idénticos e enviar un único resumo. DeduplicationHandler Configuración config/packages/monolog.yaml Páxina oficial: monolog:
    handlers:
        deduplication:
            type: deduplication
            handler: nested_dedup
            buffer_size: 60
            time: 60
            level: error
            channels: ["!console"]
 Se o DB cae, recibe listaxe de todas as ocorrencias, en vez de un correo electrónico por solicitude. one email every 60 seconds Escenario 7: Niveis dinámicos de rexistro (Debugging en tempo de execución) Un cliente específico está a informar dun problema na produción.Non pode reproducilo e non pode cambiar todo o servidor de produción ao nivel DEBUG debido ao impacto do rendemento. Utiliza unha Para cambiar o nivel de rexistro de forma dinámica baseado nun encabezado de solicitude. ActivationStrategy Implementación Crea unha estratexia de cociña: 
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;
    }
}
 Escenario 8: Logging Messenger: Contexto do traballador rexistros de Vostede ve "Manter a mensaxe", pero non sabe que ID de mensaxe causou o erro porque os traballadores executan como procesos de longa duración. messenger:consume Utilización Inxectar o ID de mensaxe no contexto Monólogo especificamente para o proceso do traballador. Symfony’s EventListener Implementació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,
        ]);
    }
}
 Exclúe 404s dos rexistros de erros Bot escaneando o seu sitio para ou xeracións Estes bloquean a túa ferramenta de seguimento de erros (Sentry / Slack) con falsos positivos. .env wp-login.php thousands of 404 NotFoundHttpException logs Use a exclusión de canles ou unha configuración específica para ignorar os rexistros rebozados, ou mellor - configure para ser ignorado polo principal manipulador de erros. NotFoundHttpException Configuración config/packages/monolog.yaml Páxina oficial: monolog:
    handlers:
        fingers_crossed:
            type: fingers_crossed
            action_level: error
            handler: nested
            excluded_http_codes: [404, 405]
            buffer_size: 50
 Escenario 10: Ponte de notificacións: ChatOps As alertas de correo electrónico son lentas e moitas veces ignoradas.Quere que fallos de infraestrutura críticos para ping Canle inmediata Slack Utilización bridado con . symfony/notifier Monolog Precondicións composer require symfony/notifier symfony/slack-notifier
 Configuración config/packages/monolog.yaml Páxina oficial: monolog:
    handlers:
        slack_alerts:
            type: service
            id: Symfony\Bridge\Monolog\Handler\NotifierHandler
            level: critical
 Despois configure o notifier chatter en e o teu DSN en . 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 }
 mapear os niveis de rexistro para a importancia de Notifier. Un rexistro crítico convértese nun . NotifierHandler High Priority Slack notification automatically Conclusión O rexistro non é un subproduto do código - é unha característica da súa infraestrutura. Na mentalidade dun desenvolvedor junior, o rexistro é unha rede de seguridade - algo que só se pode comprobar cando as cousas se rompen. Pero a medida que se amplía aos roles Senior e Lead, a súa perspectiva debe cambiar. Ao pasar a Sinfonía 7.4 e aproveitar todo o poder de Monolog 3, pasamos de "logging" a "observación". converte os seus rexistros nunha base de datos consultábel. Structured JSON Os operadores resolven a relación sinal-ruído, aforrando gigabytes de almacenamento ao tempo que preservan o contexto crítico. FingersCrossed asegurando que cada entrada de rexistro leve o ADN da solicitude (ID de usuario, ID de solicitude) converte horas de depuración en minutos de verificación. Processors Protexe a túa caixa de entrada e a túa sanidade. Deduplication A implementación destes patróns distingue unha aplicación fráxil dun sistema robusto de clase empresarial.Cando o seu entorno de produción se enfronta a un pico de tráfico ou a un problema de corrupción de datos silencioso, estas configuracións serán a diferenza entre un estrés todo-nighter e un rápido e preciso hotfix. Código fonte: Pode atopar a implementación completa e seguir o progreso do proxecto en GitHub: [ ] https://github.com/mattleads/MonologPatterns https://github.com/mattleads/MonologPatterns Imos conectar! Se vostede atopou isto útil ou ten preguntas sobre a implementación, gustaríame escoitar de vostede. 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] X (Twitter): [https://x.com/MattLeads] Telegram: [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

Este audio está producido na lingua orixinal da historia!

Sinfonía 7.4: 10 patróns avanzados de rexistro que debes saber

About Author

COMENTARIOS

Etiquetas colgantes

ESTE ARTIGO FOI PRESENTADO EN

Related Stories

HackerNoon Decoded 2024: Celebrating Our Product Management Community!

HackerNoon Decoded 2024: Celebrating Our Writing Community!

HackerNoon Decoded 2024: Celebrating Our Management Community!

R Systems BlogBook—Chapter 1: Round 2 is Now Open for Submissions🎉

HackerNoon Decoded 2024: Celebrating Our Product Management Community!

HackerNoon Decoded 2024: Celebrating Our Writing Community!

HackerNoon Decoded 2024: Celebrating Our Management Community!

R Systems BlogBook—Chapter 1: Round 2 is Now Open for Submissions🎉

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps