ahmedmerza/logscope

LogScope

A log viewer for Laravel that stores your logs in your own database, so you can search, filter and triage them from the browser.

Search by field (level:error, user_id:42) or across everything. Repeated errors are grouped into one issue with a count, and when you mark an issue resolved it stays resolved, unless it happens again. LogScope is designed to be left on in production, and it works alongside Telescope in development or an exception tracker like Sentry.

Quick Start

composer require ahmedmerza/logscope
php artisan logscope:install
php artisan migrate

Visit /logscope in your browser. That's it!

What's New

v2.3.2: the grouped view applies the date range, every search row and exclude terms (and hands off to All entries for filters it can't apply), timings and sizes like 172ms no longer split one issue into many groups, and dialogs take keyboard focus.

Upgrading: no migration. Full notes are in the changelog.

✨ Features

• Captures everything, no setup. Every log from every channel, each with its trace ID, user ID, IP, URL and user agent.
• Search and filters. field:value search, regex and a NOT toggle. Include or exclude by level, channel, HTTP method and date range, with one-click quick filters.
• Issues and triage. Repeated entries are grouped into one issue with an occurrence count. Mark an issue open, investigating, resolved or ignored, and add notes. A resolved issue reopens if it happens again.
• Readable context. Collapsible, syntax-highlighted JSON. Request and model objects are expanded, and passwords, tokens and other sensitive keys are redacted.
• Keyboard-first. Vim-style navigation, and one key to change an issue's status and move to the next. Dark mode included.
• Shareable. Filters live in the URL, and every entry has its own link.
• Fast on big tables. Keyset pagination, writes batched until after the response, and indexes on the common filters.

📋 Requirements

• PHP 8.2+ (8.3+ for Laravel 13)
• Laravel 11, 12 or 13
• SQLite, MySQL, or PostgreSQL

🤔 When to Use LogScope

LogScope stores logs in your database - a deliberate choice that works great for most Laravel apps.

Great fit if you:

• Want log visibility without external services
• Have a typical Laravel app (up to ~100K requests/day)
• Need rich search and filtering
• Prefer simplicity over infrastructure complexity

Consider alternatives if you:

• Process millions of requests daily
• Need months/years of log retention
• Already use centralized logging (Datadog, CloudWatch, ELK)

How LogScope handles common concerns:

🔒 Authorization

Outside the local environment, /logscope is closed until you allow access. Checked in order:

1. Custom Callback:

LogScope::auth(fn ($request) => $request->user()?->isAdmin());

2. Gate:

Gate::define('viewLogScope', fn ($user) => $user->hasRole('admin'));

3. Default: Only accessible in local environment.

📚 Documentation

• Configuration — capture and write modes, writes during transactions, retention, noise filters, routes, theme, redaction of sensitive keys and headers, and every environment variable.
• Usage — search syntax, the status workflow and custom statuses, quick filters, keyboard shortcuts, custom context, and the Artisan commands.
• Production Deployment — recommended settings, scheduling logscope:prune, and high-traffic apps.
• JSON API — the opt-in, token-authenticated v1 API for native clients: setup with Sanctum, access, and every endpoint.
• Known Limitations — the few kinds of log that bypass Laravel's logger, and what to do about each.

🛡️ Extensions

Watchtower

Block malicious IPs and sync the blacklist across all your environments automatically. Blocking is done from Watchtower's own dashboard — LogScope shows you the traffic, Watchtower acts on it. (Previously named ahmedmerza/logscope-guard.)

composer require ahmedmerza/watchtower
php artisan watchtower:install

View Watchtower →

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

📄 License

MIT License. See LICENSE for details.