Laravel Telescope - Knowledge of Laravel

Cos’è Laravel Telescope

Laravel Telescope è uno strumento di debug ufficiale che rende visibile lo stato interno di un’applicazione Laravel. Registra in dettaglio richieste, eccezioni, query, job, log, email, notifiche, operazioni di cache, esecuzioni pianificate e altro. È uno strumento di debug esclusivo per l’ambiente di sviluppo locale. Per il monitoraggio in produzione usa Laravel Pulse o Laravel Nightwatch.

Livelli monitorati

Installazione

Installa Telescope

composer require laravel/telescope

Pubblica gli asset e le migration

php artisan telescope:install

Esegui le migration

php artisan migrate

Dopo l’installazione, puoi accedere alla dashboard su /telescope.

Installazione dedicata all’ambiente locale (consigliata)

Se il tuo obiettivo principale è il debug in sviluppo locale, si consiglia una configurazione con installazione tramite --dev e registrazione manuale del service provider limitata al solo ambiente local.

composer require laravel/telescope --dev

php artisan telescope:install
php artisan migrate

Dopo aver eseguito telescope:install, rimuovi la registrazione di TelescopeServiceProvider da bootstrap/providers.php. Poi registralo manualmente nel metodo register di 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);
    }
}

Inoltre, disattiva l’auto-discovery in composer.json.

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

Watcher disponibili

I watcher raccolgono telemetria durante l’esecuzione delle richieste e dei comandi. Gestisci abilitazione e configurazione in config/telescope.php.

Request Watcher

Registra richieste, header, sessione e risposte.
Puoi limitare la dimensione della risposta registrata con size_limit.

Query Watcher (particolarmente importante)

Registra SQL, binding e tempo di esecuzione.
Di default, le query che superano i 100ms vengono registrate con il tag slow, rendendolo molto utile per individuare i colli di bottiglia prestazionali.

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

Job Watcher

Registra l’invio e il risultato dell’esecuzione dei job in coda.

Exception Watcher

Registra le eccezioni segnalate a report e lo stack trace.

Log Watcher

Registra i log dell’applicazione.
Di default vengono registrati i log di livello error o superiore; puoi abbassare la soglia fino a debug tramite configurazione.

Command Watcher

Registra argomenti, opzioni, output e codice di uscita dei comandi Artisan.

Event Watcher

Registra il payload degli eventi emessi e le informazioni sui listener (gli eventi interni di Laravel sono esclusi).

Cache Watcher

Registra hit, miss, aggiornamenti ed eliminazioni della cache.

Redis Watcher

Registra i comandi Redis eseguiti dall’applicazione.

Model Watcher

Registra gli eventi dei modelli Eloquent e, se necessario, raccoglie anche il conteggio delle hydration.

Notification Watcher

Registra le notifiche inviate.

Mail Watcher

Consente l’anteprima delle email inviate nel browser e il download come .eml.

HTTP Client Watcher

Registra le richieste HTTP client in uscita.

Gate Watcher

Registra il risultato dei controlli di autorizzazione di Gate / Policy.

Schedule Watcher

Registra i comandi eseguiti dallo scheduler e il loro output.

View Watcher

Registra nome, path, dati e composer delle viste renderizzate.

Batch Watcher

Registra le informazioni dei batch di code (job e informazioni sulla connessione).

Dump Watcher

Registra le uscite di dump mentre la tab Dump di Telescope è aperta.

Riepilogo

Attività	Configurazione consigliata
Installazione	`composer require laravel/telescope --dev`
Isolamento sicuro al solo locale	Registrazione manuale del provider + `dont-discover`
Analisi delle prestazioni del DB	Sfrutta il tag delle slow query del Query Watcher (100ms di default)

Prossimi passi

Laravel Pulse

Introduci la dashboard di aggregazione delle prestazioni per l’ambiente di produzione.

Laravel Nightwatch

Per il monitoraggio in tempo reale in produzione usa Nightwatch.

​Cos’è Laravel Telescope

​Livelli monitorati

​Installazione

​Installazione dedicata all’ambiente locale (consigliata)

​Watcher disponibili

​Riepilogo

​Prossimi passi

Laravel Pulse

Laravel Nightwatch

Cos’è Laravel Telescope

Livelli monitorati

Installazione

Installazione dedicata all’ambiente locale (consigliata)

Watcher disponibili

Riepilogo

Prossimi passi