PHPackages                             ahinest/laravel-log-viewer - 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 &amp; Monitoring](/categories/logging)
4. /
5. ahinest/laravel-log-viewer

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

ahinest/laravel-log-viewer
==========================

Laravel package to browse, filter and manage application log files.

v1.0.0(1mo ago)01MITPHPPHP &gt;=8.1CI passing

Since Jun 16Pushed 1mo agoCompare

[ Source](https://github.com/J-E-L-E-Dev/laravel-log-viewer)[ Packagist](https://packagist.org/packages/ahinest/laravel-log-viewer)[ RSS](/packages/ahinest-laravel-log-viewer/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Laravel Log Viewer
==================

[](#laravel-log-viewer)

[![Tests](https://github.com/J-E-L-E-Dev/laravel-log-viewer/actions/workflows/tests.yml/badge.svg)](https://github.com/J-E-L-E-Dev/laravel-log-viewer/actions/workflows/tests.yml/badge.svg)

Visualizador de logs para Laravel con soporte para Blade, Inertia y API.

Permite inspeccionar archivos de log, filtrar registros, visualizar excepciones y administrar múltiples archivos de log desde una interfaz sencilla.

 [![Laravel Log Viewer](screenshots/dark-filter.png)](screenshots/dark-filter.png)

---

Características
---------------

[](#características)

- Lectura de archivos `.log` dentro de `storage/logs`.
- Soporte para múltiples archivos de log.
- Selección dinámica de archivos.
- Filtros por:

    - Nivel.
    - Canal.
    - Fecha.
    - Registros con excepción.
- Soporte para:

    - Blade.
    - Inertia.
    - API JSON.
- Limpieza de archivos de log.
- Middleware configurables.
- Compatible con Spatie Laravel Permission.
- Detección de contexto JSON.
- Detección de excepciones.
- Soporte para logs multilinea.

---

Requisitos
----------

[](#requisitos)

- PHP 8.1+
- Laravel 10.x
- Laravel 11.x
- Laravel 12.x

---

Instalación
-----------

[](#instalación)

```
composer require edwinylil1/laravel-log-viewer
```

Publicar configuración:

```
php artisan vendor:publish --tag=logviewer-config
```

Publicar vistas Blade:

```
php artisan vendor:publish --tag=logviewer-views
```

Publicar componentes Vue:

```
php artisan vendor:publish --tag=logviewer-vue
```

 [![Laravel Log Viewer](screenshots/index.png)](screenshots/index.png)

 [![Laravel Log Viewer](screenshots/errores.png)](screenshots/errores.png)

 [![Laravel Log Viewer](screenshots/show-error.png)](screenshots/show-error.png)

--- La vista Inertia publicada es únicamente una referencia.

Debe adaptar:

- Layout principal.
- Componentes UI.
- Sistema de diseño.
- Tailwind/Shadcn.

a la estructura de su aplicación.

Configuración
-------------

[](#configuración)

Archivo:

```
config/logviewer.php
```

### Log por defecto

[](#log-por-defecto)

```
'default_log' => 'laravel.log',
```

Archivo mostrado al ingresar al visor.

---

### Middleware de acceso

[](#middleware-de-acceso)

```
'middleware' => [
    'web',
    'auth',
],
```

Ejemplos:

```
'middleware' => [
    'web',
    'auth',
    'permission:view logs',
],
```

```
'middleware' => [
    'web',
    'auth',
    'role:super-admin',
],
```

```
'middleware' => [
    'web',
    'auth',
    'can:view logs',
],
```

Compatible con Spatie Laravel Permission.

---

### Middleware para limpieza

[](#middleware-para-limpieza)

```
'middleware_clear' => [
    'web',
    'auth',
],
```

Ejemplo:

```
'middleware_clear' => [
    'web',
    'auth',
    'permission:clear logs',
],
```

Permite restringir la limpieza de logs independientemente del acceso de lectura.

---

### Habilitar limpieza

[](#habilitar-limpieza)

```
'allow_clear' => true,
```

Si está deshabilitado, la ruta responderá con error HTTP 403.

---

### Logs autorizados para limpieza

[](#logs-autorizados-para-limpieza)

```
'clearable_logs' => [
    'laravel.log',
],
```

Solo los archivos incluidos en esta lista podrán vaciarse.

---

### Prefijo de rutas

[](#prefijo-de-rutas)

```
'route' => 'logs',
```

Genera rutas como:

```
/logs/log-viewer
/logs/clear

```

---

### Tipo de interfaz

[](#tipo-de-interfaz)

```
'ui' => 'blade',
```

Opciones disponibles:

```
'blade'
'inertia'
'api'
```

---

### Vista Blade

[](#vista-blade)

```
'blade_view' => 'logviewer::index',
```

Vista utilizada cuando `ui = blade`.

---

### Página Inertia

[](#página-inertia)

```
'inertia_page' => 'LogViewer/Index',
```

Componente utilizado cuando `ui = inertia`.

---

### Canales permitidos

[](#canales-permitidos)

```
'allowed_channels' => [
    'local',
    'stack',
    'daily',
],
```

Si utilizas canales personalizados deberás agregarlos aquí.

---

### Niveles permitidos

[](#niveles-permitidos)

```
'allowed_levels' => [
    'debug',
    'info',
    'notice',
    'warning',
    'error',
    'critical',
    'alert',
    'emergency',
],
```

Basados en los niveles estándar de Monolog.

---

Rutas
-----

[](#rutas)

### Visor de logs

[](#visor-de-logs)

```
GET /logs/log-viewer
```

---

### Limpiar log

[](#limpiar-log)

```
DELETE /logs/clear
```

Parámetros:

```
{
    "log": "laravel.log"
}
```

---

Filtros disponibles
-------------------

[](#filtros-disponibles)

### Archivo

[](#archivo)

```
?log=laravel.log
```

### Nivel

[](#nivel)

```
?level=error
```

### Canal

[](#canal)

```
?channel=local
```

### Fecha

[](#fecha)

```
?date=2026-06-12
```

### Con excepción

[](#con-excepción)

```
?has_exception=1
```

---

Ejemplos
--------

[](#ejemplos)

### Mostrar errores

[](#mostrar-errores)

```
/logs/log-viewer?level=error
```

### Mostrar errores del canal local

[](#mostrar-errores-del-canal-local)

```
/logs/log-viewer?channel=local&level=error
```

### Mostrar registros de una fecha

[](#mostrar-registros-de-una-fecha)

```
/logs/log-viewer?date=2026-06-12
```

### Mostrar únicamente excepciones

[](#mostrar-únicamente-excepciones)

```
/logs/log-viewer?has_exception=1
```

### Leer otro archivo

[](#leer-otro-archivo)

```
/logs/log-viewer?log=test.log
```

---

Compatibilidad con Spatie Laravel Permission
--------------------------------------------

[](#compatibilidad-con-spatie-laravel-permission)

Configuración:

```
'middleware' => [
    'web',
    'auth',
    'permission:view logs',
],

'middleware_clear' => [
    'web',
    'auth',
    'permission:clear logs',
],
```

Crear permisos:

```
use Spatie\Permission\Models\Permission;

Permission::create([
    'name' => 'view logs',
]);

Permission::create([
    'name' => 'clear logs',
]);
```

---

Arquitectura
------------

[](#arquitectura)

El paquete está organizado utilizando:

- DTOs
- Actions
- Services
- Renderers
- Form Requests

### Componentes principales

[](#componentes-principales)

ComponenteResponsabilidadLogViewerControllerOrquesta las peticiones HTTPReadLogsActionLee y filtra registrosClearLogActionLimpia archivos de logLogParserServiceParsea el contenido de los logsLogFileServiceGestiona archivos de logRendererFactoryResuelve el renderer configuradoBladeRendererRenderiza vistas BladeInertiaRendererRenderiza páginas InertiaApiRendererRetorna respuestas JSONLogFiltersDTO de filtrosLogEntryDTO de registros---

Roadmap
-------

[](#roadmap)

Características previstas para futuras versiones:

- Paginación de registros.
- Búsqueda por texto.
- Descarga de archivos de log.
- Detección automática de canales.
- Soporte mejorado para logs rotados.
- Estadísticas por nivel.
- Visualización enriquecida de contexto JSON.
- Exportación de registros.

---

Licencia
--------

[](#licencia)

MIT

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance90

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

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

Unknown

Total

1

Last Release

45d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a0ec6bbe204480ccdd3dfe608b9343575ece5f1d8791ccadac0190c434d2fc9c?d=identicon)[edwinylil1](/maintainers/edwinylil1)

---

Top Contributors

[![J-E-L-E-Dev](https://avatars.githubusercontent.com/u/84980112?v=4)](https://github.com/J-E-L-E-Dev "J-E-L-E-Dev (1 commits)")

---

Tags

laravelmonitoringdebugginglogslog viewer

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ahinest-laravel-log-viewer/health.svg)

```
[![Health](https://phpackages.com/badges/ahinest-laravel-log-viewer/health.svg)](https://phpackages.com/packages/ahinest-laravel-log-viewer)
```

###  Alternatives

[kssadi/log-tracker

A powerful, intuitive, and efficient log viewer for Laravel applications.

286.3k](/packages/kssadi-log-tracker)[lucianotonet/laravel-telescope-mcp

MCP Server extension for Laravel Telescope

2027.2k](/packages/lucianotonet-laravel-telescope-mcp)[nightowl/agent

NightOwl monitoring agent — collects telemetry from laravel/nightwatch and writes to PostgreSQL

771.7k](/packages/nightowl-agent)[binarybuilds/laravel-mail-manager

A Laravel mail manager to record and re-send all outgoing emails.

2440.3k1](/packages/binarybuilds-laravel-mail-manager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
