
Nadzor redova poslova uz Laravel Horizon i integraciju sa Redisom
Laravel Horizon omogućava praćenje redova zasnovanih na Redisu u realnom vremenu, automatsko skaliranje workera i upravljanje neuspelim poslovima. Vodič ide od instalacije do produkcije.
Ahmet Yılmaz
Viši inženjer infrastrukture
U Laravel aplikacijama se zadaci koji dugo traju, poput slanja emailova, obrade slika, API poziva i generisanja izveštaja, prebacuju na sistem redova. Laravel Horizon je kontrolna tabla i alat za konfiguraciju koji vam omogućava da u realnom vremenu pratite redove zasnovane na Redisu, automatski skalirate broj workera i upravljate neuspelim poslovima. Ovaj vodič obuhvata svaki korak, od instalacije Horizona do produkcionog puštanja u rad.
Šta je Laravel Horizon?
Horizon je zvanični Laravelov paket za upravljanje redovima. Dodaje kontrolnu tablu u realnom vremenu, automatsko balansiranje workera, metrike i sistem obaveštenja povrh komande php artisan queue:work. Horizon radi isključivo sa Redis drajverom za redove; drajveri za bazu podataka ili SQS nisu podržani.
| Funkcija | queue:work | Horizon |
|---|---|---|
| Kontrolna tabla | Nema | Veb interfejs u realnom vremenu |
| Upravljanje workerima | Ručno (Supervisor) | Automatsko balansiranje |
| Metrike | Nema | Propusnost, vreme čekanja, stopa uspešnosti |
| Neuspeli poslovi | Tabela failed_jobs | Ponovni pokušaj sa kontrolne table + obaveštenja |
Instalacija i konfiguracija Redisa
Horizon zahteva da Redis radi na vašem serveru. Podesite Redis kao drajver za redove u Laravelovom .env fajlu, a zatim instalirajte Horizon:
# Install Redis (Ubuntu/Debian)
sudo apt install redis-server
sudo systemctl enable redis-server
# Install Horizon
composer require laravel/horizon
php artisan horizon:install
# .env settings
QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
Komanda horizon:install kreira konfiguracioni fajl config/horizon.php i resurse Horizon kontrolne table. Kontrolnoj tabli pristupate na adresi /horizon.
Konfiguracija redova i workera
Snaga alata Horizon leži u definisanju različitog broja workera za različite redove. Na primer, slanje emailova može imati visok prioritet, a generisanje izveštaja nizak:
'environments' => [
'production' => [
'supervisor-1' => [
'maxProcesses' => 10,
'balanceMaxShift' => 1,
'balanceCooldown' => 3,
'balance' => 'auto',
'queue' => [
'high',
'default',
'low',
],
'tries' => 3,
'timeout' => 300,
'memory' => 128,
],
],
],
💡 Savet: Podešavanje balance: 'auto' omogućava Horizonu da automatski dodeli više workera zauzetim redovima. maxProcesses: 10 ograničava ukupan broj workera. Prilagodite ga količini RAM-a na svom serveru: svaki worker troši približno 50-100 MB memorije.
Kreiranje i slanje poslova
U Laravelu su poslovi klase koje implementiraju interfejs ShouldQueue . Horizon upravlja tim poslovima preko Redisa. Poslove možete slati u različite redove sa različitim prioritetima:
class ProcessOrder implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
public int $tries = 3;
public int $timeout = 120;
public int $maxExceptions = 2;
public function handle(): void
{
// Order processing logic
}
public function failed(Throwable $e): void
{
// Send notification on failure
Notification::route('slack', config('services.slack.webhook'))
->notify(new JobFailedNotification($e));
}
}
// Dispatch to high priority queue
ProcessOrder::dispatch($order)->onQueue('high');
// Delayed job (run after 5 minutes)
ProcessOrder::dispatch($order)->delay(now()->addMinutes(5));
Produkciono puštanje u rad
Pokretanje Horizona u produkciji zahteva menadžer procesa Supervisor. Supervisor nadgleda Horizon proces i automatski ga ponovo pokreće ako se sruši. Podešavanje Supervisora detaljno smo obradili u našem vodiču za Laravel hosting.
[program:horizon]
process_name=%(program_name)s
command=php /var/www/app/artisan horizon
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/var/log/horizon.log
stopwaitsecs=3600
⚠️ Važno: Podešavanje stopwaitsecs=3600 je ključno. Horizon čeka da se pokrenuti poslovi završe pre gašenja. Ova vrednost mora biti veća od vremenskog ograničenja (timeout) vašeg najdužeg posla. U suprotnom će poslovi biti prekinuti usred izvršavanja.
Ponovno pokretanje Horizona tokom deploymenta
Nakon ažuriranja koda Horizon mora da se ponovo pokrene kako bi učitao novi kod. Komanda horizon:terminate čeka da se trenutni poslovi završe, a zatim Supervisor pokreće Horizon sa novim kodom:
#!/bin/bash
php artisan down
git pull origin main
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan horizon:terminate # Graceful restart
php artisan up
Radi bezbednosti kontrolne table definišite autorizacioni gate u HorizonServiceProvider. U produkciji kontrolnoj tabli treba da pristupaju samo administratori. Pokrenite Redis i Horizon sa visokim performansama na Hosted Cloud serverima. Više o nadzoru redova potražite u zvaničnoj dokumentaciji Laravel Horizona.
Često postavljana pitanja
Da li Horizon radi sa drugim drajverima za redove osim Redisa?
Ne, Horizon radi isključivo sa Redis drajverom za redove. Ako koristite bazu podataka, SQS ili Beanstalkd, ne možete koristiti Horizon. Prelazak na Redis obično je jednostavan: podesite QUEUE_CONNECTION=redis u .env i instalirajte Redis.
Koliko RAM-a troši Horizon?
Sam Horizon koristi oko 50 MB. Svaki worker dodaje 50-100 MB. Sa 10 workera očekujte ukupnu potrošnju memorije od 550 MB do 1 GB. Za ograničenja po workeru koristite podešavanje memory u config/horizon.php.
Kako da ponovo pokrenem neuspele poslove?
Na kartici Failed Jobs na Horizon kontrolnoj tabli možete ponoviti pojedinačne ili sve poslove odjednom. Iz komandne linije koristite php artisan horizon:forget {id} za brisanje ili php artisan queue:retry {id} za ponovni pokušaj.
Da li je Horizon kontrolna tabla bezbedna u produkciji?
Podrazumevano je dostupna samo u lokalnim okruženjima. Za produkciju definišite autorizaciju u metodi gate() klase HorizonServiceProvider. Dodajte ograničenja po IP adresi ili provere administratorske uloge da biste obezbedili pristup.
Koja je razlika između Horizona i Supervisora?
Supervisor je menadžer procesa: nadgleda bilo koji proces i ponovo ga pokreće ako se sruši. Horizon je alat za upravljanje redovima specifičan za Laravel. U produkciji se koriste zajedno: Supervisor nadgleda Horizon proces.
Zaključak
Laravel Horizon unapređuje upravljanje redovima zasnovano na Redisu kontrolnom tablom u realnom vremenu, automatskim balansiranjem workera i detaljnim metrikama. U kombinaciji sa Supervisorom dobijate pouzdanu i skalabilnu infrastrukturu za obradu poslova u produkciji. Koristite horizon:terminate za graciozno restartovanje tokom deploymenta kako biste sprečili gubitak poslova.
Moćna infrastruktura za vašu Laravel aplikaciju
Pokrenite Laravel Horizon i Redis sa visokim performansama na NVMe SSD cloud serverima kompanije Hosted Cloud.
Istražite cloud server pakete →Ahmet Yılmaz
Viši inženjer infrastrukture
Sa više od 10 godina iskustva u cloud infrastrukturi i DevOps-u, Ahmet se specijalizovao za Kubernetes, Terraform i arhitekture visoke dostupnosti.
Komentari uskoro