studiowizjo / tools-monitor-laravel

v1.2.0 2026-09-05 12:47 UTC

Requires

• php: ^8.2
• illuminate/cache: ^11.0|^12.0|^13.0
• illuminate/database: ^11.0|^12.0|^13.0
• illuminate/filesystem: ^11.0|^12.0|^13.0
• illuminate/http: ^11.0|^12.0|^13.0
• illuminate/routing: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^9.0|^10.0|^11.0
• phpunit/phpunit: ^10.5|^11.0|^12.0

MIT

• Wizjo

• monitoring
• health
• laravel
• wizjo

Published on Packagist.org on 2026-09-05 12:55 UTC

README

Endpoint diagnostyczny dla monitoringu Wizjo Tools.

Pokazuje to, czego z zewnątrz nie widać: stojącą kolejkę, zapełniony dysk, niewykonane migracje, cache, który przestał odpowiadać. Aplikacja z każdą z tych awarii nadal zwraca kod 200 na stronie głównej - i właśnie dlatego zwykłe pytanie o adres nie wystarcza.

Instalacja

composer require studiowizjo/tools-monitor-laravel

W .env:

WIZJO_MONITOR_TOKEN=token-z-panelu-wizjo-tools

Trasa rejestruje się sama pod /_wizjo/health. Token bierze się z kontroli w panelu - tam też jest pokazany.

Sprawdzenie

curl -H "X-Wizjo-Token: $WIZJO_MONITOR_TOKEN" https://twojadomena.pl/_wizjo/health

Co sprawdza

Pozycja	Kiedy czerwona	Kiedy żółta
Baza danych	zapytanie kontrolne nie przechodzi	-
Migracje	są niewykonane migracje	nie da się sprawdzić
Cache	zapis albo odczyt nie działa	-
Kolejka	ponad 1000 zadań w kolejce	ponad 100
Nieudane zadania	-	choć jedno w ciągu doby
Zapis plików	dysk domyślny nie przyjmuje pliku	-
Miejsce na dysku	poniżej 256 MB wolnego	poniżej 15%
Tryb debugowania	-	APP_DEBUG=true na produkcji

Progi zmienia się w opublikowanej konfiguracji:

php artisan vendor:publish --tag=wizjo-monitor-config

Czego ten pakiet nie robi

• Nie dzwoni nigdzie sam. Odpowiada wyłącznie na zapytanie z tokenem, więc aplikacja za firewallem nie musi mieć wyjścia na świat.
• Nie wysyła danych z bazy poza liczbą zadań w kolejce i rozmiarem katalogu.
• Nie zapisuje niczego poza plikiem próbnym, który natychmiast kasuje.
• Nie wywraca się na zepsutym elemencie. Awaria Redisa daje czerwoną pozycję "cache", a nie błąd 500 - inaczej monitoring zgłaszałby "cała aplikacja leży" i budził kogoś z niewłaściwym powodem.

Bezpieczeństwo

Token porównujemy hash_equals, a treść wyjątków skracamy i czyścimy z haseł, zanim trafi do odpowiedzi. Endpoint stoi celowo bez middleware'ów z grupy web: diagnostyka, która przestaje działać razem z sesjami albo cache'em, odpowiada wyłącznie na pytania, które i tak już znamy.

Licencja MIT.

Aktualizacje

Pakiet jest wersjonowany semantycznie i publikowany w Packagist. Aktualizację wykonuje standardowe polecenie composer update studiowizjo/tools-monitor-laravel.