Telescope is a powerful debugging assistant that provides insight into requests, exceptions, logs, and database queries happening in your application.
Overview
Laravel Telescope provides an elegant dashboard to monitor your application's requests, database queries, cache operations, jobs, and more. It is essential for debugging and performance optimization.
How to Access
- Log in as an administrator
- Navigate to System Tools in the sidebar
- Click on Debug Tools (Telescope)
- The Telescope dashboard will open
Prerequisites
- Administrator role required
- Telescope must be installed and configured
Dashboard Sections
Requests
Shows all HTTP requests with method, URI, status code, duration, and response size.
Exceptions
Displays all exceptions that occurred, with stack traces and context.
Database Queries
Lists all database queries with execution time and bindings.
Jobs
Shows queued jobs and their status.
Cache
Monitors cache hits, misses, and operations.
Logs
Displays application log entries.
Step-by-Step Guide
Step 1: Explore the Dashboard
Upon opening Telescope, you will see the Requests section by default. Use the sidebar to navigate between different monitoring sections.
Step 2: Inspect a Request
Click on any request to see detailed information including:
- Request headers and body
- Response data
- Database queries performed
- Jobs dispatched
- Cache operations
Step 3: Analyze Exceptions
Navigate to the Exceptions section to see all errors. Click on an exception to view the full stack trace and identify the source of the problem.
Step 4: Monitor Database Queries
In the Database Queries section, you can see all queries executed. Look for slow queries (highlighted) that may need optimization.
Step 5: Use Watch Entries
Telescope watch entries let you monitor specific values in your application. Configure watch entries to track custom metrics.
Debugging Workflow
- Identify the issue from the relevant section
- Click on the entry to view detailed information
- Analyze the data (request data, query bindings, stack trace)
- Make the necessary fixes
- Clear the Telescope data if needed
Troubleshooting
Issue: Telescope not accessible
Solution: Check that Telescope is properly installed. Run php artisan telescope:install if not already installed.
Issue: Missing entries in dashboard
Solution: Telescope data is stored in the database. Ensure the database connection is working and the telescope_entries table exists.
Quick Reference
| Route | admin.telescope.index |
| Permission | Admin only |
| Category | Getting Started |