La madera es el corazón de una aplicación de producción.En los primeros días de un proyecto, una simple la cola es suficiente. pero como su aplicación Symfony escala para manejar , de y , “escribir a un archivo” se convierte en una responsabilidad en lugar de un activo. dev.log payments asynchronous workers high-concurrency traffic El Ofrece herramientas sofisticadas para transformar los registros de flujos de texto simples en datos de observabilidad estructurados y actuables. symfony/monolog-bundle Esta guía explora 10 patrones avanzados de logging que van más allá de los estándares. usaremos tipografía estricta, atributos PHP y configuración moderna de YAML. Precondiciones 
 
 
 
 
 
 Sinfonía: 7.4+ PHP: más de 8.3 Sinfonía / Monólogo Monólogos / Monólogos Sinfonía / Notificador (para ejemplos de alerta) Escenario 1: El grabador de la caja negra: FingersCrossed Handler Usted desea registros de depuración detallados cuando se produce un error para comprender la secuencia de eventos que lo conducen, pero no puede permitirse el disco I/O para registrar los mensajes de depuración para cada solicitud exitosa en la producción. El buffers todos los registros en la memoria durante la solicitud. Si la solicitud finaliza con éxito, el buffer se descarta. Si se alcanza un error (o un umbral específico), el buffer entero (incluidos los registros de depuración anteriores) se envuelve en el manipulador de persistencia. FingersCrossedHandler Configuración 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
 Obtendrá el detalle forense del registro de nivel de debug exactamente cuando lo necesite - durante un accidente - sin llenar su disco con ruido durante las operaciones normales. Escenario 2: Canales segregados: el registro de “pagos” tuya es una mezcla de consultas de doctrina, la combinación de router y la lógica de negocio crítica. Necesitas un archivo dedicado para las transacciones financieras que se pueden auditar por separado. app.log Crear un canal de monólogo. Configuración config/packages/monolog.yaml en la siguiente dirección: 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 Injecte el logger específicamente para este canal utilizando el atributo Target (disponible 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;
    }
}
 Corre el comando. verás Creado en Contiene sólo estas entradas específicas. payment.log var/log/ Escenario 3: Enriquecimiento de contexto: el atributo #[AsMonologProcesador] Los registros son inútiles si no se pueden correlacionar con un usuario específico o ID de solicitud. Se encuentra añadiendo manualmente [‘user_id’ => $user->getId()] a cada declaración de registro individual. Un procesador global puede inyectar automáticamente el contexto en cada registro de registro. 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 , de Nosotros usamos devolver una copia modificada. Monolog 3 LogRecord is immutable with() Escenario 4: Cumplimiento del GDPR: Redacción de datos sensibles Un desarrollador registra accidentalmente un objeto de usuario, dumping PII (Información de Identificación Personal) o números de tarjetas de crédito en los registros, violando el GDPR / PCI-DSS. Un procesador especializado puede escanear la matriz de contexto y mascarar las 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);
    }
}
 La verificación: $logger->info('User login', ['password' => 'secret123']);
// Output in log: "User login" {"password": "***REDACTED***"}
 Escenario 5: Logging estructurado: JSON para ELK/Datadog El análisis de registros de texto de varias líneas (como trazas de pilas) en o Los parsers Regex se rompen fácilmente. Kibana Datadog Puede exportar los registros como líneas JSON. Esto permite que los agregadores de registros indexen nativamente campos como o . context.order_id extra.req_id Configuración config/packages/monolog.yaml en la siguiente dirección: monolog:
    handlers:
        json_report:
            type: stream
            path: "%kernel.logs_dir%/app.json"
            level: info
            formatter: monolog.formatter.json
            channels: ["!payment", "!event"]
 abierta La salida debe parecer: var/log/app.json {"message":"Order created","context":{"id":123},"level":200,"channel":"app","datetime":"..."}
 Escenario 6: Prevención del spam: El manipulador de la deduplicación Su base de datos se baja. Su solicitud recibe En un minuto, el manipulador de “Email on Error” te envía Obtener su . 5,000 requests 5,000 emails SMTP server blacklisted and flooding your inbox El Puede agregar registros de registro idénticos y enviar un único resumen. DeduplicationHandler Configuración config/packages/monolog.yaml en la siguiente dirección: monolog:
    handlers:
        deduplication:
            type: deduplication
            handler: nested_dedup
            buffer_size: 60
            time: 60
            level: error
            channels: ["!console"]
 Si el DB se colapsa, usted recibe listando todas las ocurrencias, en lugar de un correo electrónico por solicitud. one email every 60 seconds Escenario 7: Niveles dinámicos de registro (Debugging en tiempo de ejecución) Un cliente específico está reportando un problema en la producción.No se puede reproducir, y no se puede cambiar todo el servidor de producción al nivel DEBUG debido al impacto del rendimiento. Utilice un cambiar el nivel de registro de forma dinámica en función de un encabezado de solicitud. ActivationStrategy Implementación Creación de una estrategia personalizada: 
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 de los trabajadores Los logos de Usted ve "Manejar mensaje", pero no sabe qué ID de mensaje causó el error porque los trabajadores se ejecutan como procesos de larga duración. messenger:consume Uso para inyectar el ID de mensaje en el contexto Monólogo específicamente para el proceso de trabajador. 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,
        ]);
    }
}
 Exclusión de 404s de los registros de errores Bot escaneando su sitio para o Generaciones Estos bloquean su herramienta de seguimiento de errores (Sentry / Slack) con falsos positivos. .env wp-login.php thousands of 404 NotFoundHttpException logs Utilice la exclusión de canales o una configuración específica para ignorar los registros rebajados, o mejor, configure el Ser ignorado por el principal manipulador de errores. NotFoundHttpException Configuración config/packages/monolog.yaml en la siguiente dirección: monolog:
    handlers:
        fingers_crossed:
            type: fingers_crossed
            action_level: error
            handler: nested
            excluded_http_codes: [404, 405]
            buffer_size: 50
 Escenario 10: Puente de Notificaciones: ChatOps Las alertas de correo electrónico son lentas y a menudo ignoradas.Quieres que las fallas de infraestructura críticas canal de inmediato. Slack Uso Bridgett con . symfony/notifier Monolog Precondiciones composer require symfony/notifier symfony/slack-notifier
 Configuración config/packages/monolog.yaml en la siguiente dirección: monolog:
    handlers:
        slack_alerts:
            type: service
            id: Symfony\Bridge\Monolog\Handler\NotifierHandler
            level: critical
 Después, configure el notifier chatter en y su 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 }
 los niveles de registro de los mapas a la importancia de Notifier. Un registro crítico se convierte en un . NotifierHandler High Priority Slack notification automatically Conclusión El logging no es un subproducto de código, es una característica de tu infraestructura. En la mentalidad de un desarrollador junior, el logging es una red de seguridad - algo que solo se debe comprobar cuando las cosas se rompen. Pero a medida que se escalan a roles Senior y Lead, su perspectiva debe cambiar. Al pasar a la Sinfonía 7.4 y aprovechar el pleno poder de Monolog 3, pasamos de “logging” a “observabilidad”. Transforma tus registros en una base de datos consultable. Structured JSON Los procesadores resuelven la relación “signo-ruido”, ahorrando gigabytes de almacenamiento al tiempo que preservan el contexto crítico. FingersCrossed asegurarse de que cada entrada de registro lleva el ADN de la solicitud (ID de usuario, ID de solicitud) convierte las horas de depuración en minutos de verificación. Processors Protege tu caja de entrada y tu salud. Deduplication La implementación de estos patrones distingue una aplicación frágil de un sistema robusto y de nivel empresarial.Cuando su entorno de producción se enfrenta a un pico de tráfico o a un problema de corrupción de datos silencioso, estas configuraciones serán la diferencia entre un estrés y una corrección rápida y precisa. Código fuente: Puede encontrar la implementación completa y seguir el progreso del proyecto en GitHub: [ ] https://github.com/mattleads/MonologPatterns https://github.com/mattleads/MonologPatterns ¡Vamos a conectar! Si ha encontrado esto útil o tiene preguntas sobre la implementación, me encantaría escuchar de usted. 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] X (Twitter): [https://x.com/MattLeads] Telegrama: [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 es producido en el idioma original de la historia!

Symfony 7.4: 10 patrones avanzados de logging que debes saber sobre

About Author

COMENTARIOS

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN

Related Stories

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

De los foros a los feeds: cómo los algoritmos de las redes sociales influyen en la interacción digital

Navegando por las aguas: desarrollo de aplicaciones RAG de nivel de producción con lagos de datos

State of the Noonion: A New Era For Brands and Writers

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

De los foros a los feeds: cómo los algoritmos de las redes sociales influyen en la interacción digital

Navegando por las aguas: desarrollo de aplicaciones RAG de nivel de producción con lagos de datos

State of the Noonion: A New Era For Brands and Writers

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps