Using Laravel Telescope to Debug Your Tests | Owen Conti

Using Laravel Telescope to Debug Your Tests

Published on Dec 10, 2018 in category Laravel.

Love using Laravel Telescope to debug your application, but frustrated that you can't use it to debug your tests?

๐Ÿ‘ฟ Yeah, I was too.

The main problem has to do with running migrations using Laravel's RefreshDatabase trait. If you configure Telescope to use a separate, persistent, database for Telescope entries, Laravel attempts to migrate that database during each test run. However, this doesn't work because once the Telescope database has been migrated, any attempt to migrate again fails since the tables already exist.

I submitted a pull request to the Telescope repository to update the migrations, so that they only run if the tables do not yet exist. Unfortunately, the pull request was declined.

๐Ÿ’ก I'll show you how you can use Telescope to help debug your tests.

Install the forked version of the repository

In your composer.json file, add a new repository that points to the fork on GitHub:

    "repositories": [
            "type": "vcs",
            "url": ""

Then set your Telescope dependency:

"laravel/telescope": "dev-upstream-1.0",

Now you should be able to run composer install and have the forked version installed. If this is your first time installing Telescope, make sure you publish Telescope's assets with: php artisan telescope:install.

Create a new database connection

This step is optional. I choose to use a completely separate database to store Telescope's entries in my local development environment.

The reason for this is because I do not want the RefreshDatabase trait to wipe the Telescope entries on every test.

Add a new database connection in config/database.php:

'telescope' => [
    'driver' => 'sqlite',
    'database' => database_path('telescope.sqlite'),
    'prefix' => '',

Update the configuration variable for Telescope's database

Update the storage.database.connection configuration value inside the telescope.php config file to reference a new environment variable TELESCOPE_DB_CONNECTION:

    'storage' => [
        'database' => [
            'connection' => env('TELESCOPE_DB_CONNECTION', 'mysql'),

Then update your .env file to set the new TELESCOPE_DB_CONNECTION variable:


Now, all of Telescope's entries will be stored in the .sqlite persistent database, even during tests.

๐Ÿ”ฅ๐Ÿ”ฅ That's it! While running tests, or using your application as normal, Telescope will be storing the entires for you to view later to debug.

My fork of Telescope also contains a couple new features. You can read about them later in my next post.

Thanks for reading!

๐Ÿ‘‹ Hi there! I hope you enjoyed this post. If you did, follow me on Twitter, @owenconti, for updates on new posts.

If you prefer to receive updates via email, subscribe to my newsletter where I send a weekly summary of the content I've released.

Feel free to check out other posts in the Laravel category.