メインコンテンツへスキップ

​
Laravel Telescopeとは

Laravel Telescope は、Laravelアプリケーションの内部状態を可視化する公式デバッグツールです。 リクエスト、例外、クエリ、ジョブ、ログ、メール、通知、キャッシュ操作、スケジュール実行などを詳細に記録できます。 ローカル開発環境専用のデバッグツールです。本番環境の監視には Laravel Pulse や Laravel Nightwatch を使ってください。

​
モニタリング対象レイヤー

​
インストール

1

Telescopeをインストールする

composer require laravel/telescope
2

アセットとマイグレーションを公開する

php artisan telescope:install
3

マイグレーションを実行する

php artisan migrate
インストール後、/telescope でダッシュボードにアクセスできます。

​
ローカル専用インストール（推奨）

ローカル開発でのデバッグが主目的なら、--dev でインストールし、サービスプロバイダーを local 環境だけで手動登録する構成を推奨します。
composer require laravel/telescope --dev

php artisan telescope:install
php artisan migrate
telescope:install 実行後、bootstrap/providers.php から TelescopeServiceProvider の登録を削除してください。 そのうえで、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);
    }
}
さらに composer.json で auto-discovery を無効化してください。 
{
  "extra": {
    "laravel": {
      "dont-discover": [
        "laravel/telescope"
      ]
    }
  }
}

​
利用可能なウォッチャー

ウォッチャーはリクエストやコマンド実行時のテレメトリを収集します。 config/telescope.php で有効化・設定を管理します。
リクエスト、ヘッダー、セッション、レスポンスを記録します。
size_limit でレスポンス記録サイズを制限できます。
SQL、バインディング、実行時間を記録します。
デフォルトでは 100ms 超のクエリが slow タグで記録されるため、性能ボトルネック検知に非常に有効です。
Watchers\QueryWatcher::class => [
    'enabled' => env('TELESCOPE_QUERY_WATCHER', true),
    'slow' => 100,
],
キュージョブの投入と実行結果を記録します。
report対象の例外とスタックトレースを記録します。
アプリケーションログを記録します。
デフォルトは error 以上で、設定で debug まで下げられます。
Artisanコマンドの引数、オプション、出力、終了コードを記録します。
dispatchされたイベントのペイロードとリスナー情報を記録します（Laravel内部イベントは除外）。
キャッシュのヒット、ミス、更新、削除を記録します。
アプリケーションから実行されたRedisコマンドを記録します。
Eloquentモデルイベントを記録し、必要に応じてhydration件数も収集できます。
送信された通知を記録します。
送信メールをブラウザでプレビューし、.eml としてダウンロードできます。
外向きHTTPクライアントリクエストを記録します。
Gate / Policy の認可チェック結果を記録します。
スケジュール実行されたコマンドと出力を記録します。
レンダリングされたビュー名、パス、データ、composerを記録します。
キューバッチ情報（ジョブやコネクション情報）を記録します。
TelescopeのDumpタブが開いている間の dump 出力を記録します。

​
まとめ

タスク推奨設定
導入composer require laravel/telescope --dev
ローカル限定の確実な分離手動プロバイダー登録 + dont-discover
DB性能調査Query Watcher の slowクエリタグ（デフォルト100ms）を活用

​
次のステップ

Laravel Pulse

本番環境のパフォーマンス集計ダッシュボードを導入します。

Laravel Nightwatch

本番環境のリアルタイム監視にはNightwatchを使います。
最終更新日 2026年5月28日