Using Fieldhand

Alerts

Offline, disk full and overheating, by email, Slack, Teams, Discord, PagerDuty or webhook.

AlertFires when
OfflineThe device has been disconnected for more than 10 minutes.
DiskRoot filesystem above 90%.
TemperatureHottest thermal zone above 80 °C.
Back onlineA device that was reported offline connects again.

Email goes to the owner and admins of the workspace. Each problem alerts once, not every few minutes, and problems on several devices at the same time arrive in one message. Turn alerts off in Settings.

Slack, Teams, Discord, PagerDuty and webhooks

In Settings → Alerts, add channels that get the same alerts as the email. Each one gets a test message when you add it, and shows when it last delivered or why it failed. With a tag in Only tag (for example customer:acme), a channel gets only those devices' alerts. Up to 50 channels per workspace.

ChannelWhat you paste
SlackAn incoming webhook URL (Apps → Incoming Webhooks).
Microsoft TeamsA Workflows webhook URL (“Post to a channel when a webhook request is received”).
DiscordA channel webhook URL (Integrations → Webhooks).
PagerDutyAn Events API v2 integration key. Incidents open on a problem and resolve on recovery.
WebhookAny https:// URL. You get a signing secret once.

Webhook format

A POST with a JSON body. X-Fieldhand-Signature is sha256= followed by the hex HMAC-SHA256 of the exact body, keyed with your secret.

{
  "event": "alerts",
  "workspace": "Acme kiosks",
  "sent_at": "2026-10-23T14:02:00Z",
  "alerts": [
    {
      "device_id": "e4b4dc9d-…",
      "device": "kiosk-lobby-03",
      "kind": "offline",
      "state": "firing",
      "message": "kiosk-lobby-03 is offline (last seen 12m0s ago)",
      "url": "https://fieldhand.dev/app/devices/e4b4dc9d-…"
    }
  ]
}

kind is offline, disk or temp; state is firing or resolved. Answer with any 2xx status; anything else is retried on the next check, a minute later.

Short drops under 10 minutes never alert. They are still in the device's connection history.

Something wrong or missing on this page? Tell us.