Skip to content

Configuring Alerts

Last updated: 2026-10-07

Alerts notify you when a host metric exceeds a threshold you define. VordFleet supports email and webhook notifications.

Creating an Alert Rule

Creating and customizing your own alert rules requires a Team plan. Alerting starts on Pro, which provisions the built-in default rules (listed below) with email and webhook delivery — you can enable or disable them but not create custom rules. The Free plan has no alert rules.

  1. Navigate to Settings > Alerts in the dashboard.
  2. Click Create Rule.
  3. Configure the rule:
    • Name — A descriptive name (e.g., “High CPU Warning”)
    • Metric — The metric to monitor (CPU, memory, disk, etc.)
    • Condition — The threshold (e.g., “CPU usage > 90%“)
    • Duration — How long the condition must persist before firing (e.g., “5 minutes”)
    • Scope — Assign the rule to one or more hosts
  4. Choose a notification method (email or webhook URL).
  5. Click Save.

Default Alert Rules

When you upgrade to Pro or Team, these ten built-in default rules are provisioned for your fleet:

RuleConditionSeverityDuration
Machine offlineHost stops reportingCritical10 min
Disk health issuesSMART reports a failing diskCritical1 min
Disk usage above 90%Disk usage > 90%Warning5 min
Failed services detectedOne or more services failedWarning5 min
CPU usage above 90%CPU usage > 90%Warning15 min
Memory usage above 90%Memory usage > 90%Warning15 min
Telemetry stoppedHost still answers but has stopped sending metricsWarning10 min
More than 5 failed SSH loginsFailed SSH logins on a host, more than 5Warning5 min
Security updates availableSecurity updates pendingInfo1 min
New SSH connectionA new SSH session is openedInfoImmediate

A host paused for being over your plan’s host limit raises no alerts, so none of these rules, including Machine offline, fire for it.

Built-in rules are provisioned unassigned — they watch no hosts, and fire for nothing, until you assign them. That is deliberate: VordFleet does not start paging you about hosts you never opted in. Open Settings > Alerts, pick a rule, and assign it to the hosts you want it to cover.

The failed-SSH-login rule counts failed authentication attempts against a host over a rolling five-minute window and fires when the count goes above five — six or more. The threshold sits above ordinary background noise (internet-facing SSH always sees a trickle, and a person mistyping a passphrase twice is not an incident), so what trips it looks like something working through a list. It resolves on its own once a five-minute window passes with no failures.

On the Pro plan these rules are read-only — you can enable or disable them and choose which hosts they cover, but not edit their thresholds. On the Team plan you can also create and customize your own rules and thresholds. The Free plan has no alert rules at all.

Alert Severities

SeverityUse Case
InfoInformational, no action needed
WarningInvestigate when convenient
CriticalRequires immediate attention

Webhook Notifications

To send alerts to Slack, PagerDuty, or another service, use a webhook URL as the notification target. VordFleet sends a JSON payload with the alert details.