Laravel Telescope este un instrument elegant de depanare și monitorizare pentru aplicațiile Laravel. Acesta oferă o perspectivă profundă asupra cererilor, excepțiilor, interogărilor, lucrărilor și multe altele. Acest ghid vă va ghida prin instalarea, configurarea și utilizarea Laravel Telescope pentru a îmbunătăți observabilitatea aplicației dvs. Îl puteți instala cu VPS-ul dvs.

Condiții prealabile

Înainte de a configura Telescope, asigurați-vă că aveți următoarele:

  • O aplicație Laravel (se recomandă versiunea 6.x sau superioară)
  • PHP 7.3 sau o versiune ulterioară
  • Composer instalat pe mașina dvs

Pasul 1: Instalarea Laravel Telescope

Pentru a instala Laravel Telescope, rulați următoarea comandă prin Composer:

composer require laravel/telescope

Odată ce instalarea este completă, publicați furnizorul de servicii Telescope și activele utilizând:

php artisan telescope:install

În cele din urmă, migrați tabelele necesare din baza de date:

php artisan migrate

Pasul 2: Configurarea Telescope

După instalare, Telescope oferă un fișier de configurare situat la config/telescope.php. Puteți personaliza setările după cum este necesar.

Autorizare

În mod implicit, Telescope este accesibil numai în mediul local. Dacă doriți să permiteți accesul în alte medii, modificați metoda gate în

App\Providers\TelescopeServiceProvider:

use Laravel\Telescope\Telescope;
use Laravel\Telescope\TelescopeApplicationServiceProvider;

class TelescopeServiceProvider extends TelescopeApplicationServiceProvider
{
protected function gate()
{
Gate::define('viewTelescope', function ($user) {
return in_array($user->email, [
'admin@example.com',
]);
});
}
}

Păstrarea datelor

În mod implicit, Telescope păstrează jurnalele timp de 24 de ore. Puteți ajusta acest lucru în fișierul config/telescope.php:

'retain_hours' => 48,

Configurarea rutei

Tabloul de bord al Telescope este accesibil prin /telescope. Dacă doriți să personalizați această cale, actualizați fișierul config/telescope.php:

'path' => 'monitoring',

Acum, Telescope va fi disponibil la /monitoring în loc de /telescope.

Pasul 3: Utilizarea Telescope

Odată configurat, porniți aplicația Laravel și vizitați yourdomain.com/telescope (sau calea dvs. personalizată). Veți vedea:

  • Solicitări: Monitorizează cererile primite și timpii lor de răspuns.
  • Excepții: Listează toate erorile și urmele de stivă.
  • Întrebări: Afișează interogările SQL executate.
  • Lucrări: Monitorizează lucrările aflate în coada de așteptare și starea acestora.
  • Evenimente: Consemnează evenimentele Laravel.

Pasul 4: Implementarea Telescope în producție

În timp ce Telescope este util în dezvoltare, nu este recomandat pentru producție din cauza supraîncărcării de performanță. Cu toate acestea, dacă trebuie să îl implementați în producție, puteți utiliza variabila de mediu TELESCOPE_ENABLED:

TELESCOPE_ENABLED=true

În plus, programați o comandă de ștergere periodică a jurnalelor pentru a preveni creșterea excesivă a bazei de date:

php artisan telescope:prune --hours=24

Puteți automatiza acest lucru prin adăugarea unei sarcini programate în app/Console/Kernel.php:

$schedule->command('telescope:prune --hours=24')->daily();

Concluzie

Laravel Telescope este un instrument puternic care îmbunătățește depanarea și monitorizarea în aplicațiile Laravel. Prin instalarea și configurarea sa corectă, obțineți informații valoroase despre performanța aplicației, interogările, excepțiile și lucrările în fundal.