> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Telescope

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

## Was ist Laravel Telescope

[Laravel Telescope](https://github.com/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](/de/pulse) oder [Laravel Nightwatch](/de/blog/nightwatch-introduction).

### Beobachtete Ebenen

```mermaid theme={null}
flowchart LR
    A["HTTP-Layer<br>Request / Response"] --> T["Telescope-Einträge"]
    B["Anwendungs-Layer<br>Events / Logs / Exceptions"] --> T
    C["Daten-Layer<br>DB-Queries / Redis / Cache"] --> T
    D["Asynchron-Layer<br>Queue-Jobs / Scheduler / Notifications"] --> T
    T --> E["Dashboard<br>/telescope"]
```

***

## Installation

<Steps>
  <Step title="Telescope installieren">
    ```shell theme={null}
    composer require laravel/telescope
    ```
  </Step>

  <Step title="Assets und Migrationen veröffentlichen">
    ```shell theme={null}
    php artisan telescope:install
    ```
  </Step>

  <Step title="Migrationen ausführen">
    ```shell theme={null}
    php artisan migrate
    ```
  </Step>
</Steps>

Nach der Installation erreichen Sie das Dashboard unter `/telescope`.

## Nur-lokale Installation (empfohlen)

<Info>
  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`.
</Info>

```shell theme={null}
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`.

```php theme={null}
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`:

```json theme={null}
{
  "extra": {
    "laravel": {
      "dont-discover": [
        "laravel/telescope"
      ]
    }
  }
}
```

***

## Verfügbare Watcher

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

<AccordionGroup>
  <Accordion title="Request Watcher">
    Zeichnet Requests, Header, Session und Response auf.\
    Über `size_limit` begrenzen Sie den aufgezeichneten Response.
  </Accordion>

  <Accordion title="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.

    ```php theme={null}
    Watchers\QueryWatcher::class => [
        'enabled' => env('TELESCOPE_QUERY_WATCHER', true),
        'slow' => 100,
    ],
    ```
  </Accordion>

  <Accordion title="Job Watcher">
    Zeichnet Queue-Job-Einträge und Ergebnisse auf.
  </Accordion>

  <Accordion title="Exception Watcher">
    Zeichnet report-fähige Exceptions und Stacktraces auf.
  </Accordion>

  <Accordion title="Log Watcher">
    Zeichnet Anwendungs-Logs auf.\
    Standardschwelle ist `error`; per Konfiguration lässt sich bis `debug` erweitern.
  </Accordion>

  <Accordion title="Command Watcher">
    Zeichnet Argumente, Optionen, Ausgabe und Exit-Codes von Artisan-Befehlen auf.
  </Accordion>

  <Accordion title="Event Watcher">
    Zeichnet Payloads und Listener von Events auf (interne Laravel-Events ausgenommen).
  </Accordion>

  <Accordion title="Cache Watcher">
    Zeichnet Hits, Misses, Aktualisierungen und Löschungen im Cache auf.
  </Accordion>

  <Accordion title="Redis Watcher">
    Zeichnet Redis-Befehle aus der Anwendung auf.
  </Accordion>

  <Accordion title="Model Watcher">
    Zeichnet Eloquent-Modell-Events und optional die Anzahl der Hydratationen auf.
  </Accordion>

  <Accordion title="Notification Watcher">
    Zeichnet versendete Notifications auf.
  </Accordion>

  <Accordion title="Mail Watcher">
    Zeigt versendete Mails im Browser als Vorschau und ermöglicht `.eml`-Download.
  </Accordion>

  <Accordion title="HTTP Client Watcher">
    Zeichnet ausgehende HTTP-Requests auf.
  </Accordion>

  <Accordion title="Gate Watcher">
    Zeichnet Ergebnisse von Gate-/Policy-Prüfungen auf.
  </Accordion>

  <Accordion title="Schedule Watcher">
    Zeichnet Scheduler-Aufrufe und deren Output auf.
  </Accordion>

  <Accordion title="View Watcher">
    Zeichnet gerenderte View-Namen, Pfade, Daten und Composer auf.
  </Accordion>

  <Accordion title="Batch Watcher">
    Zeichnet Batch-Informationen von Queue-Jobs auf.
  </Accordion>

  <Accordion title="Dump Watcher">
    Zeichnet `dump()`-Ausgaben auf, solange der Telescope-Dump-Tab geöffnet ist.
  </Accordion>
</AccordionGroup>

***

## 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

<Columns cols={2}>
  <Card title="Laravel Pulse" icon="chart-line" href="/de/pulse">
    Performance-Dashboard für Produktion einrichten.
  </Card>

  <Card title="Laravel Nightwatch" icon="moon" href="/de/blog/nightwatch-introduction">
    Für Echtzeit-Monitoring in Produktion nutzen Sie Nightwatch.
  </Card>
</Columns>


## Related topics

- [Laravel Telescope – Praxistechniken](/de/blog/telescope-introduction.md)
- [Laravel Pulse](/de/pulse.md)
- [Einen MCP-Server mit Laravel bauen](/de/advanced/mcp-server.md)
- [Versionskompatibilität von Paketen verwalten](/de/advanced/package-versioning.md)
- [Einführung in Laravel Nightwatch](/de/blog/nightwatch-introduction.md)