Laravel Telescope complements your local Laravel development environment.
With Telescope, get insight into the requests coming into your app, exceptions, log entries, database queries, queued jobs, mail, notifications, cache operations, scheduled tasks, variable dumps, and more.
To set up Laravel Telescope on your non-production environments,
follow these steps.
1. Create the APP_DEBUG variable
To add the APP_DEBUG & TELESCOPE_ENABLED variables on your project, run the following commands:
upsun variable:create --level environment --name env:APP_DEBUG --value false
upsun variable:create --level environment --name env:TELESCOPE_ENABLED --value false
false.
To override them on other non-production environments, run the following commands:
upsun variable:update -e <VariableBlock name="ENVIRONMENT" /> --value true env:APP_DEBUG
upsun variable:update -e <VariableBlock name="ENVIRONMENT" /> --value true env:TELESCOPE_ENABLED
2. Add Telescope to your project
-
Run the following Composer command:
composer require laravel/telescope && php artisan telescope:install
-
Add the
install command to your build hook in your app configuration,
so it’s run on every deploy.
applications:
myapp:
[...]
hooks:
build: |
set -eux
composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader --no-dev
php artisan telescope:install
For more options and information on how to manage authentication for the dashboard,
see the Laravel Telecope documentation.
3. Deploy the new release
To enable Telescope, push your changes to Upsun:
git add .
git commit -m "Enable Laravel Horizon"
upsun push
/telescope endpoint of your app.
Telescope uses a gate defined in TelescopeServiceProvider.php to authorize access to the dashboard.
Check that the logic here matches your needs.
