Using Fieldhand
Alerts
Offline, disk full and overheating, by email, Slack, Teams, Discord, PagerDuty or webhook.
| Alert | Fires when |
|---|---|
| Offline | The device has been disconnected for more than 10 minutes. |
| Disk | Root filesystem above 90%. |
| Temperature | Hottest thermal zone above 80 °C. |
| Back online | A 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.
| Channel | What you paste |
|---|---|
| Slack | An incoming webhook URL (Apps → Incoming Webhooks). |
| Microsoft Teams | A Workflows webhook URL (“Post to a channel when a webhook request is received”). |
| Discord | A channel webhook URL (Integrations → Webhooks). |
| PagerDuty | An Events API v2 integration key. Incidents open on a problem and resolve on recovery. |
| Webhook | Any 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.
Something wrong or missing on this page? Tell us.