Laravel · Debugging

Laravel Telescope Debugging — A Field Guide

Telescope is a window into what your Laravel app is actually doing each request — every query, job, and exception. It turns guesswork debugging into looking at the evidence.

John Kihiu12 min read

Laravel Telescope is a debugging assistant that records what happens inside your application — the requests, database queries, jobs, exceptions, mails, and more — and presents them in a dashboard. Instead of guessing why something is slow or broken, you look at exactly what the app did. For local development and staging, it turns debugging from speculation into inspection, which is a large productivity difference.

What it captures

Telescope records a wide range of application activity, each type as its own watcher: incoming requests with their input and response, every database query with its time and bindings, queued jobs and their status, exceptions, sent mail and notifications, cache hits and misses, and more. This gives you a complete picture of a request's behaviour after the fact — you can open any request and see everything it did, which is invaluable when reproducing a problem in the moment is hard.

Finding N+1 queries and slow requests

Telescope's most valuable everyday use is spotting database problems. The query watcher shows every query a request ran, which makes the classic N+1 problem — one query per item in a loop, dozens where there should be two — immediately visible as a wall of near-identical queries. Seeing them is the first step to fixing them with eager loading. It similarly surfaces slow queries and requests, so you profile from real evidence rather than intuition about where the time goes.

Never run Telescope in production unguarded

Telescope records detailed application data — request input, query bindings, potentially sensitive information — and stores it. Left enabled and accessible in production, it is both a performance drain and a serious data-exposure risk. Keep it to local and staging, and if you must run it in production, gate access tightly with authorisation and prune its data aggressively. It is a development tool, not a production one.

Laravel Telescope makes your app's per-request behaviour visible — queries, jobs, exceptions, and more — turning debugging into inspection and making N+1 queries and slow requests obvious rather than mysterious. Use it heavily in development and staging to profile from real evidence, and keep it firmly out of unguarded production, because the same detail that makes it a great debugger makes it a liability if exposed.

John Kihiu
Acumatica ERP Developer · Laravel Engineer

Independent software engineer in Nairobi specialising in Acumatica customisations, Laravel backends, and tax fiscalisation integrations across East and Southern Africa.