Zum Hauptinhalt springen

​
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.
Zeichnet Requests, Header, Session und Response auf.
Über size_limit begrenzen Sie den aufgezeichneten Response.
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,
],
Zeichnet Queue-Job-Einträge und Ergebnisse auf.
Zeichnet report-fähige Exceptions und Stacktraces auf.
Zeichnet Anwendungs-Logs auf.
Standardschwelle ist error; per Konfiguration lässt sich bis debug erweitern.
Zeichnet Argumente, Optionen, Ausgabe und Exit-Codes von Artisan-Befehlen auf.
Zeichnet Payloads und Listener von Events auf (interne Laravel-Events ausgenommen).
Zeichnet Hits, Misses, Aktualisierungen und Löschungen im Cache auf.
Zeichnet Redis-Befehle aus der Anwendung auf.
Zeichnet Eloquent-Modell-Events und optional die Anzahl der Hydratationen auf.
Zeichnet versendete Notifications auf.
Zeigt versendete Mails im Browser als Vorschau und ermöglicht .eml-Download.
Zeichnet ausgehende HTTP-Requests auf.
Zeichnet Ergebnisse von Gate-/Policy-Prüfungen auf.
Zeichnet Scheduler-Aufrufe und deren Output auf.
Zeichnet gerenderte View-Namen, Pfade, Daten und Composer auf.
Zeichnet Batch-Informationen von Queue-Jobs auf.
Zeichnet dump()-Ausgaben auf, solange der Telescope-Dump-Tab geöffnet ist.

​
Zusammenfassung

AufgabeEmpfehlung
Einrichtungcomposer require laravel/telescope --dev
Zuverlässige Trennung von lokalen UmgebungenManuelle 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.
Zuletzt geändert am 13. Juli 2026

Verwandte Themen

Laravel Telescope – PraxistechnikenLaravel PulseEinen MCP-Server mit Laravel bauenVersionskompatibilität von Paketen verwaltenEinführung in Laravel Nightwatch