Plánovanie kontrol

use RoundlyConsulting\Alerts\Facades\Health;

$team = Team::first();

Health::for($team)->monitor(DiskUsageCheck::class)
    ->everyFiveMinutes()
    ->throttle(maxAttempts: 2, decayMinutes: 60)
    ->meta(['server_id' => '2d4fcdff-9787-49b1-8b73-3d411f80ae1b'])
    ->save();

// The same builder through the model trait:
$team->monitorCheck(DiskUsageCheck::class)->everyFiveMinutes()->save();

$monitors = Health::for($team);

$monitors->monitor(DiskUsageCheck::class)->hourly()->save();
$monitors->monitor(DiskUsageCheck::class)->frequency('hourly')->save();           // preset by name
$monitors->monitor(DiskUsageCheck::class)->frequency('everyFiveMinutes')->save();
$monitors->monitor(DiskUsageCheck::class)->cron('15 3 * * *')->save();            // 03:15 every day
$monitors->monitor(DiskUsageCheck::class)->cron('0 9-17 * * 1-5')->save();        // hourly, office hours
$monitors->monitor(DiskUsageCheck::class)->cron('0 9 * * MON-FRI')->save();       // day and month names work too

use RoundlyConsulting\Alerts\Exceptions\InvalidCronExpression;

try {
    Health::for($team)->monitor(DiskUsageCheck::class)->cron($expression)->save();
} catch (InvalidCronExpression $e) {
    // The scheduler could not evaluate it — nothing was stored.
}

use RoundlyConsulting\Alerts\Checks\DatabaseCheck;

Health::for($team)->monitor(DatabaseCheck::class)
    ->everyFiveMinutes()
    ->failAfter(3)                                // open only after 3 consecutive failures
    ->recoverAfter(2)                             // close only after 2 consecutive OKs
    ->timeout(5)                                  // mark failed after 5 seconds
    ->tags(['critical', 'db'])                    // group + filter
    ->notifyVia(['database'])                     // channels for the default notification
    ->notifyVia(['mail', 'database'], level: 3)   // override channels at escalation level 3
    ->escalate([1 => 'owner', 3 => 'team', 5 => 'oncall'])
    ->throttle(maxAttempts: 3, decayMinutes: 10)
    ->save();

use RoundlyConsulting\Alerts\DataTransferObjects\ScheduleHealthCheckData;

Health::for($team)->schedule(new ScheduleHealthCheckData(
    check: DiskUsageCheck::class, frequency: 'hourly', maxAttempts: 2, decayMinutes: 60,
));

// Trait shortcuts for the same call:
$team->monitor(new ScheduleHealthCheckData(check: DiskUsageCheck::class, frequency: 'hourly'));
$team->createHealthCheck('disk_usage_check', '*/5 * * * *', maxAttempts: 2, decayMinutes: 60, tags: ['db']);

new ScheduleHealthCheckData(
    string $check,                   // Check class-string or registered key
    string $frequency = '* * * * *', // preset name or cron
    int $maxAttempts = 1,
    int $decayMinutes = 1,
    int $failAfter = 1,
    int $recoverAfter = 1,
    ?int $timeout = null,
    array $tags = [],
    ?array $notifyVia = null,
    array $notifyViaLevels = [],     // [level => channels]
    array $escalation = [],          // [threshold => group]
    array $meta = [],
);

Health::for($team)->monitors();                        // Collection<HealthCheck>, oldest first
Health::for($team)->unmonitor(DiskUsageCheck::class);  // soft-deletes the team's schedules; returns the count
Health::for($team)->unmonitor($healthCheck);           // one row — refused if it belongs to another owner

use RoundlyConsulting\Alerts\Enums\Frequency;

Frequency::toCron('everyFiveMinutes'); // '*/5 * * * *' (names match case-insensitively)
Frequency::toCron('yearly');           // '@yearly'
Frequency::toCron('15 3 * * *');       // anything else is returned unchanged
Frequency::Hourly->value;              // '@hourly'
Frequency::names();                    // Collection: EveryMinute, EveryFiveMinutes, …

$row = $team->healthChecks()->first();

$row->health_check;            // 'disk_usage_check'
$row->frequency;               // '*/5 * * * *'
$row->consecutive_failures;    // flap counter
$row->effectiveTags();         // row tags merged with the check's own tags()
$row->isScheduled();           // false for an on-demand (run-now) row
$row->isDue();                 // is the cron due this minute? (never for an on-demand row)
$row->options()->failAfter();  // declarative options read back from meta
$row->dispatchHealthCheckJob(); // queue a run right now, due or not

$row->delete();                // soft delete — the scheduler skips it
$row->restore();               // and picks it up again