Inštalácia

Pridajte balík. Service provider aj alias fasády Health sa objavia automaticky — nič neregistrujete ručne:

composer require roundly-consulting/alerts-for-laravel

Ak modely, ktoré budú vlastniť kontroly, používajú kľúče UUID alebo ULID, najprv nastavte ALERTS_KEY_TYPE — stĺpce vlastníka sa typujú pri behu migrácií (pozri Databázová schéma a typy kľúčov). Potom publikujte a spustite migrácie:

php artisan vendor:publish --tag="alerts-migrations"
php artisan migrate

Migrácie len na publikovanie

Balík svoje migrácie nikdy neregistruje, takže php artisan migrate spustí presne tie súbory, ktoré ste publikovali, v poradí publikovania: najprv health_checks, potom alerts, alert_silences a health_check_runs. Opakované publikovanie je idempotentné — súbory prepíše na mieste, nevytvorí druhú kópiu.

Voliteľne: konfigurácia a preklady

php artisan vendor:publish --tag="alerts-config"
php artisan vendor:publish --tag="alerts-translations"

Konfigurácia sa zlučuje z balíka, takže kľúče napojené na env fungujú aj bez publikovania. Preklady sa publikujú do lang/vendor/alerts.

Rýchly štart

Zaregistrujte kontrolu, pripojte ju k modelu vlastníka a zvyšok nechajte na plánovač:

// app/Providers/AppServiceProvider.php — boot()
use RoundlyConsulting\Alerts\Checks\DatabaseCheck;
use RoundlyConsulting\Alerts\Facades\Health;

Health::check(DatabaseCheck::make('mysql'));

// Anywhere — attach the check to an owner model (see Owner models)
Health::for($team)->monitor(DatabaseCheck::class)
    ->everyFiveMinutes()
    ->throttle(maxAttempts: 1, decayMinutes: 60)
    ->save();

Balík stojí na troch stavebných prvkoch:

• Check — trieda, ktorú napíšete (alebo vstavaná, prípadne inline closure); vykoná kontrolu a vráti CheckResult.
• HealthCheck — riadok v databáze, ktorý plánuje Check podľa cronu pre jedného vlastníka.
• Alert — riadok, ktorý vznikne pri zlyhaní kontroly, s časmi triggered_at a recovered_at a so správou a meta výsledku.

Jediný príkaz Artisan, automaticky zaregistrovaný v plánovači na každú minútu, odošle do fronty job pre každú splatnú kontrolu. Plánovač Laravelu a queue worker preto musia bežať (pozri Spúšťanie kontrol).