Laravel Telescope

Von der Installation über die reine Lokal-Installation bis zur Watcher-Konfiguration: Alles zu Laravel Telescope.

​

Was ist Laravel Telescope

Laravel Telescope ist das offizielle Debugging-Tool, das den internen Zustand Ihrer Laravel-Anwendung sichtbar macht. Es zeichnet Requests, Exceptions, Queries, Jobs, Logs, Mails, Notifications, Cache-Zugriffe, Scheduler-Aufrufe u. v. m. detailliert auf.

Es ist ausschließlich für die lokale Entwicklung gedacht. Zur Produktions-Überwachung nutzen Sie Laravel Pulse oder Laravel Nightwatch.

​

Beobachtete Ebenen

---

​

Installation

1. Telescope installieren

   composer require laravel/telescope
   
2. Assets und Migrationen veröffentlichen

   php artisan telescope:install
   
3. Migrationen ausführen

   php artisan migrate
   

Nach der Installation erreichen Sie das Dashboard unter /telescope.

​

Nur-lokale Installation (empfohlen)

Wenn Debugging in der lokalen Entwicklung Ihr Hauptziel ist, empfehlen wir die Installation mit --dev und die manuelle Registrierung des Service Providers ausschließlich in local.

composer require laravel/telescope --dev

php artisan telescope:install
php artisan migrate

Entfernen Sie nach telescope:install die Registrierung des TelescopeServiceProvider aus bootstrap/providers.php. Registrieren Sie ihn stattdessen manuell in App\Providers\AppServiceProvider::register.

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);
    }
}

Deaktivieren Sie zusätzlich die Auto-Discovery in composer.json:

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

---

​

Verfügbare Watcher

Watcher sammeln Telemetriedaten aus Requests und Konsolenbefehlen. Aktivierung und Feineinstellung erfolgen in config/telescope.php.

Request Watcher

Zeichnet Requests, Header, Session und Response auf.
Über size_limit begrenzen Sie den aufgezeichneten Response.

Query Watcher (besonders wichtig)

Zeichnet SQL, Bindings und Laufzeiten auf.
Standardmäßig erhalten Queries über 100 ms das Tag slow – ideal, um Performance-Engpässe zu erkennen.

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

Job Watcher

Zeichnet Queue-Job-Einträge und Ergebnisse auf.

Exception Watcher

Zeichnet report-fähige Exceptions und Stacktraces auf.

Log Watcher

Zeichnet Anwendungs-Logs auf.
Standardschwelle ist error; per Konfiguration lässt sich bis debug erweitern.

Command Watcher

Zeichnet Argumente, Optionen, Ausgabe und Exit-Codes von Artisan-Befehlen auf.

Event Watcher

Zeichnet Payloads und Listener von Events auf (interne Laravel-Events ausgenommen).

Cache Watcher

Zeichnet Hits, Misses, Aktualisierungen und Löschungen im Cache auf.

Redis Watcher

Zeichnet Redis-Befehle aus der Anwendung auf.

Model Watcher

Zeichnet Eloquent-Modell-Events und optional die Anzahl der Hydratationen auf.

Notification Watcher

Zeichnet versendete Notifications auf.

Mail Watcher

Zeigt versendete Mails im Browser als Vorschau und ermöglicht .eml-Download.

HTTP Client Watcher

Zeichnet ausgehende HTTP-Requests auf.

Gate Watcher

Zeichnet Ergebnisse von Gate-/Policy-Prüfungen auf.

Schedule Watcher

Zeichnet Scheduler-Aufrufe und deren Output auf.

View Watcher

Zeichnet gerenderte View-Namen, Pfade, Daten und Composer auf.

Batch Watcher

Zeichnet Batch-Informationen von Queue-Jobs auf.

Dump Watcher

Zeichnet dump()-Ausgaben auf, solange der Telescope-Dump-Tab geöffnet ist.

---

​

Zusammenfassung

Aufgabe	Empfehlung
Einrichtung	composer require laravel/telescope --dev
Zuverlässige Trennung von lokalen Umgebungen	Manuelle Provider-Registrierung + dont-discover
DB-Performance untersuchen	„slow”-Tag des Query Watchers (Default 100 ms)

​

Nächste Schritte

Laravel Pulse

Performance-Dashboard für Produktion einrichten.

Laravel Nightwatch

Für Echtzeit-Monitoring in Produktion nutzen Sie Nightwatch.