PHPackages alexandresafarpaim/penta-logger - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. alexandresafarpaim/penta-logger ActiveLibrary[Logging & Monitoring](/categories/logging) alexandresafarpaim/penta-logger =============================== Real-time log streaming dashboard for Laravel. Monitor requests, errors, external APIs, jobs, and scheduled tasks with zero configuration. 1.0.3(3mo ago)125↓100%MITPHPPHP ^8.1 Since Jan 30Pushed 3mo agoCompare [ Source](https://github.com/alexandreSafarPaim/penta-logger)[ Packagist](https://packagist.org/packages/alexandresafarpaim/penta-logger)[ Docs](https://github.com/alexandreSafarPaim/penta-logger)[ RSS](/packages/alexandresafarpaim-penta-logger/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (3)Versions (24)Used By (0) Penta Logger ============ [](#penta-logger) [![Latest Version on Packagist](https://camo.githubusercontent.com/bc65c1a3c8521f4babb621a91590297af4dab97c80e9b639f3c22f013261ca60/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c6578616e64726573616661727061696d2f70656e74612d6c6f676765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alexandresafarpaim/penta-logger)[![Total Downloads](https://camo.githubusercontent.com/7c3e82e17f6cb7291509eabe15c065a74c3f1ba25f5b424288fdac18a1d108c1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c6578616e64726573616661727061696d2f70656e74612d6c6f676765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alexandresafarpaim/penta-logger)[![License](https://camo.githubusercontent.com/a5aeb6e1f0a6f99a2f25778185b1daea8b0f4e06db0a4f642f91590d04f0a103/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616c6578616e64726573616661727061696d2f70656e74612d6c6f676765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alexandresafarpaim/penta-logger)[![PHP Version](https://camo.githubusercontent.com/3f7deeab19ffd7faabc4d8f84783763e9ea6b836d83c3463bf95dc65e342de57/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f616c6578616e64726573616661727061696d2f70656e74612d6c6f676765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alexandresafarpaim/penta-logger) > **[Read in English](intl/README_EN.md)** Dashboard de streaming de logs em tempo real para aplicações Laravel. Monitore requisições, erros, APIs externas, jobs e tarefas agendadas - tudo em um só lugar, sem configuração. Funcionalidades --------------- [](#funcionalidades) - **Logs de Requisições**: Método HTTP, endpoint, headers, corpo da requisição/resposta, status, duração - **Logs de Erros**: Detalhes de exceções com stack trace otimizado (apenas seu código) - **Logs de APIs Externas**: Rastreie todas as chamadas HTTP client com dados completos - **Logs de Jobs**: Monitore jobs da fila - status, duração, tentativas, payload e exceções - **Logs de Schedules**: Acompanhe tarefas agendadas - comando, expressão cron, duração, output - **Dashboard em Tempo Real**: Server-Sent Events (SSE) para atualizações instantâneas - **Filtros Avançados**: Filtre por método, status, endpoint, IP, body, nome do job, comando do schedule e intervalo de datas - **Zero Configuração**: Funciona imediatamente, sem banco de dados ou setup - **Seguro**: Desabilitado em produção por padrão, mascaramento automático de dados sensíveis Requisitos ---------- [](#requisitos) - PHP 8.1+ - Laravel 10, 11 ou 12 > **Laravel 8 ou 9?** Use a versão legacy: `composer require alexandresafarpaim/penta-logger:^0.2` Instalação ---------- [](#instalação) ``` composer require alexandresafarpaim/penta-logger ``` > **Dica**: Use `--dev` se quiser instalar apenas em desenvolvimento. Para uso em HML/produção, instale sem a flag. ### Versões [](#versões) VersãoLaravelPHP`^1.0`10, 11, 12^8.1`^0.2` (legacy)8.65+, 9^8.0Pronto! Acesse `http://sua-app.test/_penta-logger` para ver o dashboard. O Que é Registrado ------------------ [](#o-que-é-registrado) ### Requisições [](#requisições) Todas as requisições HTTP para sua aplicação com: - Endereço IP, método HTTP, URL e path - Headers e corpo da requisição - Headers e corpo da resposta - Código de status e duração ### Erros [](#erros) Todas as exceções com: - Classe e mensagem da exceção - Arquivo e número da linha - Stack trace filtrado (apenas seu código, não vendor) - Contexto da requisição ### APIs Externas [](#apis-externas) Todas as chamadas HTTP client (`Http::get()`, etc.) com: - URL e método - Headers e corpo da requisição - Status, headers e corpo da resposta - Duração ### Jobs [](#jobs) Todos os jobs da fila com: - Nome da classe e ID do job - Nome da fila e conexão - Número da tentativa e máximo de tentativas - Payload/dados do job - Duração e status (completed/failed) - Detalhes da exceção se falhou ### Tarefas Agendadas [](#tarefas-agendadas) Todos os comandos agendados com: - Comando ou closure - Expressão cron - Duração e status - Output (se disponível) - Detalhes da exceção se falhou Configuração (Opcional) ----------------------- [](#configuração-opcional) Publique o arquivo de configuração para personalizar: ``` php artisan vendor:publish --tag=penta-logger-config ``` ### Variáveis de Ambiente [](#variáveis-de-ambiente) ``` # Configurações gerais PENTA_LOGGER_ENABLED=true PENTA_LOGGER_ROUTE_PREFIX=_penta-logger PENTA_LOGGER_ALLOW_PRODUCTION=false # Autenticação (opcional) PENTA_LOGGER_USER=admin PENTA_LOGGER_PASSWORD=secret # Limite de logs por tipo (opcional, padrão: 500) PENTA_LOGGER_MAX_REQUESTS=500 PENTA_LOGGER_MAX_ERRORS=500 PENTA_LOGGER_MAX_EXTERNAL_API=500 PENTA_LOGGER_MAX_JOBS=500 PENTA_LOGGER_MAX_SCHEDULES=500 ``` ### Opções de Configuração [](#opções-de-configuração) ``` // config/penta-logger.php return [ // Habilitar/desabilitar o pacote 'enabled' => env('PENTA_LOGGER_ENABLED', true), // Autenticação do dashboard 'auth' => [ 'user' => env('PENTA_LOGGER_USER'), 'password' => env('PENTA_LOGGER_PASSWORD'), ], // Prefixo da URL do dashboard 'route_prefix' => '_penta-logger', // Middleware das rotas 'middleware' => ['web'], // Máximo de logs por tipo (use 0 para desabilitar um tipo) 'max_logs' => [ 'request' => env('PENTA_LOGGER_MAX_REQUESTS', 500), 'error' => env('PENTA_LOGGER_MAX_ERRORS', 500), 'external_api' => env('PENTA_LOGGER_MAX_EXTERNAL_API', 500), 'job' => env('PENTA_LOGGER_MAX_JOBS', 500), 'schedule' => env('PENTA_LOGGER_MAX_SCHEDULES', 500), ], // Habilitar em produção (requer autenticação) 'allow_production' => false, // Paths a ignorar (suporta wildcards) 'ignore_paths' => [ '_penta-logger/*', 'telescope/*', 'horizon/*', ], // Headers a mascarar 'mask_headers' => [ 'Authorization', 'Cookie', 'X-API-Key', ], // Campos a mascarar (correspondência parcial) 'mask_fields' => [ 'password', 'credit_card', 'cvv', 'token', 'secret', ], ]; ``` Uso em Produção --------------- [](#uso-em-produção) Por padrão, o Penta Logger está **desabilitado em produção**. Para habilitá-lo com segurança: 1. Configure as credenciais de autenticação: ``` PENTA_LOGGER_USER=admin PENTA_LOGGER_PASSWORD=sua-senha-segura ``` 2. Habilite o modo de produção: ``` PENTA_LOGGER_ALLOW_PRODUCTION=true ``` Segurança --------- [](#segurança) - Desabilitado em produção por padrão - Autenticação básica opcional para o dashboard - Headers sensíveis (Authorization, Cookie, etc.) são mascarados - Campos sensíveis (password, credit\_card, token, etc.) são mascarados - Stack traces mostram apenas arquivos da sua aplicação (não vendor) - Corpos de resposta grandes são truncados Arquitetura ----------- [](#arquitetura) ``` ┌─────────────────────────────────────────────────────────────┐ │ Sua Aplicação Laravel │ ├─────────────────────────────────────────────────────────────┤ │ Middleware │ Exception Handler │ Event Listeners│ │ (Requisições) │ (Erros) │ (APIs/Jobs) │ └──────────┬───────────┴─────────┬───────────┴────────┬────────┘ │ │ │ └─────────────────────┼────────────────────┘ ▼ ┌────────────────────────┐ │ LogCollector │ │ (Arquivo JSON Lines) │ └───────────┬────────────┘ │ ┌───────────┴────────────┐ │ │ ┌─────▼─────┐ ┌───────▼───────┐ │ Dashboard │◄────SSE──│ StreamController│ │ (HTML) │ │ (Tempo Real) │ └───────────┘ └────────────────┘ ``` Licença ------- [](#licença) MIT ### Health Score 40 — FairBetter than 88% of packages Maintenance81 Actively maintained with recent releases Popularity10 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 22 Last Release 99d ago PHP version history (3 changes)v1.0.0PHP ^8.1 0.1.0PHP ^8.0.2 0.2.0PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/fb1f807234a823b9a11c4151cd7caadec5087339888264fc868632aa3b57f98f?d=identicon)[alexandreSafarPaim](/maintainers/alexandreSafarPaim) --- Top Contributors [![alexandreSafarPaim](https://avatars.githubusercontent.com/u/76395975?v=4)](https://github.com/alexandreSafarPaim "alexandreSafarPaim (9 commits)") --- Tags schedulerlaravelloggingdebuggingreal-timequeuedashboardjobsdeveloper-tools ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/alexandresafarpaim-penta-logger/health.svg) ``` [![Health](https://phpackages.com/badges/alexandresafarpaim-penta-logger/health.svg)](https://phpackages.com/packages/alexandresafarpaim-penta-logger) ``` ### Alternatives [aryeo/monitored-jobs Monitor for your Laravel jobs. 1325.8k1](/packages/aryeo-monitored-jobs)[shaffe/laravel-mail-log-channel A package to support logging via email in Laravel 1286.2k](/packages/shaffe-laravel-mail-log-channel)[moesif/moesif-laravel Moesif Collection/Data Ingestion Middleware for Laravel 1065.8k](/packages/moesif-moesif-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)