Vigil's icon: a red buoy with a lit lamp, at night

Vigil pages you when something breaks, and keeps paging until someone answers.

Anything that can send a webhook can page your team: an alert rule, a cron job that did not finish, a dead-man switch. It is an iPhone app, a relay that is one Cloudflare Worker, and the sirens below. Open source, MIT.

Source on GitHubComing to the App Store.
An iPhone lock screen at night with a time-sensitive Vigil notification: Checkout is failing for 1 in 5 orders
The Vigil app: the same page paging, with an Acknowledge button, the on-call switch and two earlier pages

This is what a page sounds like.

Each one is a real disaster siren over a drop: impossible to sleep through, and still worth hearing at three in the morning. They are loud on purpose.

Siren

A rooftop motor siren over a four-on-the-floor kick.

0:000:24140 bpm

Red Alert

Switzerland’s general alarm, rising and falling.

0:000:26150 bpm

Air Raid

An American civil-defence attack wail over drum and bass.

0:000:28174 bpm

The sirens are real recordings from Wikimedia Commons, public domain, played straight through as they were recorded: a German motor siren sounding a fire alarm by Nallchen, Switzerland’s general alarm by the Swiss Federal Office for Civil Protection and an American civil-defence siren sounding the attack wail by Techtonic. The drums and chords under them are synthesised in code.

How a page travels

  1. 1

    You create a team on the relay. One request gives you a webhook URL and a join code.

  2. 2

    Each person types the join code into the app. Their phone is now on the team.

  3. 3

    Your alerting posts to the webhook URL. The relay opens an incident and pushes it to every phone on call, or to everyone if nobody is.

  4. 4

    The page goes out again every minute. Ten times, until someone taps Acknowledge. Your alerting can resolve it by webhook, or a person can from the app.

0:001:002:003:004:005:006:007:008:009:00 Ada acknowledged
A page that nobody answers goes out ten times, a minute apart. This one stopped after the third, when Ada acknowledged it.
A watchman on a stool, sighting a buoy through a telescope
The Vigil app's step that checks a page can reach you: notifications, through a Focus, through silence

How far a page reaches

A page that does not wake you is not a page. iOS decides three things, and the app shows each one as on or off, with what to do about the ones that are off.

Notifications
You allow them, and a page shows on the lock screen and sounds. Without this nothing arrives.
Through a Focus
Pages are sent as time-sensitive, so Sleep and Work let them in.
Through silence
A critical alert sounds at full volume with the phone muted or on Do Not Disturb. Apple grants this to each app on request, so it is not on yet for real phones. The app already asks for it, and the relay already sends pages as critical to phones that have it.

Point your alerting at it

Only a title is needed. A second alert with the same key updates the open incident without paging again, and a resolved one resolves it. The webhook also takes Prometheus Alertmanager’s payload as it is, so Vigil can be a receiver with no glue.

Any script or alert rule
curl -X POST "$HOOK_URL" \
  -H 'content-type: application/json' \
  -d '{
    "title": "Checkout is failing",
    "body": "5xx above 5% for 10 minutes.",
    "key": "checkout-5xx"
  }'
Alertmanager
receivers:
  - name: vigil
    webhook_configs:
      - url: https://your-relay.example/hook/<token>
        send_resolved: true

Read the source, or run it in the Simulator.

The app, the relay, the sounds and the art are all in one repository, under MIT. One command builds the app and opens it on a demo team with a page already paging.

Needs Xcode and XcodeGen
git clone https://github.com/veloccy/vigil.git
cd vigil
ios/run.sh -demo
Source on GitHubComing to the App Store.
A watchman kneeling to set his lantern down

Get early access

We take on a few teams at a time because we set each one up ourselves. Tell us about yours and one of the founders will reply personally, usually the same day.

Veloccy starts read-only, we do the setup, and if it isn’t worth it, you don’t pay.