Laravel Telescope - Knowledge of Laravel

¿Qué es Laravel Telescope?

Laravel Telescope es la herramienta oficial de depuración que permite visualizar el estado interno de una aplicación Laravel. Puede registrar en detalle solicitudes, excepciones, consultas, jobs, logs, correos, notificaciones, operaciones de caché, ejecuciones programadas y más. Es una herramienta de depuración exclusiva para el entorno de desarrollo local. Para monitoreo en producción, usa Laravel Pulse o Laravel Nightwatch.

Capas monitorizadas

Instalación

Instalar Telescope

composer require laravel/telescope

Publicar assets y migraciones

php artisan telescope:install

Ejecutar las migraciones

php artisan migrate

Tras la instalación, puedes acceder al dashboard en /telescope.

Instalación solo para entorno local (recomendado)

Si el objetivo principal es depurar en desarrollo local, se recomienda instalarlo con --dev y registrar el service provider manualmente solo en el entorno local.

composer require laravel/telescope --dev

php artisan telescope:install
php artisan migrate

Tras ejecutar telescope:install, elimina el registro de TelescopeServiceProvider en bootstrap/providers.php. Después, regístralo manualmente en el método register de App\Providers\AppServiceProvider.

public function register(): void
{
    if ($this->app->environment('local') && class_exists(\Laravel\Telescope\TelescopeServiceProvider::class)) {
        $this->app->register(\Laravel\Telescope\TelescopeServiceProvider::class);
        $this->app->register(TelescopeServiceProvider::class);
    }
}

Además, desactiva el auto-discovery en composer.json.

{
  "extra": {
    "laravel": {
      "dont-discover": [
        "laravel/telescope"
      ]
    }
  }
}

Watchers disponibles

Los watchers recogen telemetría al procesar solicitudes o al ejecutar comandos. Se activan y configuran en config/telescope.php.

Request Watcher

Registra la solicitud, cabeceras, sesión y respuesta.
Con size_limit puedes limitar el tamaño registrado de la respuesta.

Query Watcher (especialmente importante)

Registra el SQL, bindings y tiempo de ejecución.
Por defecto, las consultas de más de 100 ms se etiquetan con slow, lo que es muy útil para detectar cuellos de botella de rendimiento.

Watchers\QueryWatcher::class => [
    'enabled' => env('TELESCOPE_QUERY_WATCHER', true),
    'slow' => 100,
],

Job Watcher

Registra la puesta en cola de jobs y el resultado de su ejecución.

Exception Watcher

Registra las excepciones reportables y sus trazas.

Log Watcher

Registra los logs de la aplicación.
Por defecto captura a partir de error, y puedes bajarlo hasta debug con la configuración.

Command Watcher

Registra los argumentos, opciones, salida y código de salida de los comandos Artisan.

Event Watcher

Registra el payload y los listeners de los eventos despachados (se excluyen los eventos internos de Laravel).

Cache Watcher

Registra hits, misses, actualizaciones y eliminaciones de caché.

Redis Watcher

Registra los comandos de Redis ejecutados desde la aplicación.

Model Watcher

Registra eventos de modelos Eloquent y, si se desea, también el número de hidrataciones.

Notification Watcher

Registra las notificaciones enviadas.

Mail Watcher

Permite previsualizar en el navegador los correos enviados y descargarlos como .eml.

HTTP Client Watcher

Registra las solicitudes salientes del cliente HTTP.

Gate Watcher

Registra el resultado de las verificaciones de autorización con Gate / Policy.

Schedule Watcher

Registra los comandos ejecutados por el scheduler y su salida.

View Watcher

Registra el nombre, la ruta, los datos y los composers de las vistas renderizadas.

Batch Watcher

Registra la información de los batches de cola (jobs y datos de conexión).

Dump Watcher

Registra la salida de dump mientras la pestaña Dump de Telescope está abierta.

Resumen

Tarea	Configuración recomendada
Instalación	`composer require laravel/telescope --dev`
Aislamiento fiable solo en local	Registro manual del provider + `dont-discover`
Análisis de rendimiento de la BD	Aprovechar la etiqueta de consulta lenta del Query Watcher (100 ms por defecto)

​¿Qué es Laravel Telescope?

​Capas monitorizadas

​Instalación

​Instalación solo para entorno local (recomendado)

​Watchers disponibles

​Resumen

​Próximos pasos

Laravel Pulse

Laravel Nightwatch

¿Qué es Laravel Telescope?

Capas monitorizadas

Instalación

Instalación solo para entorno local (recomendado)

Watchers disponibles

Resumen

Próximos pasos