on this page

Get startedGlossary

Glossary

Every word Tissue Mast uses for something of its own, in one place. Where the API or a config file uses a different name, it's in the right-hand column, because the API kept the names it shipped with. If you're moving from another tool, Coming from PagerDuty, Coming from Opsgenie and Coming from Grafana OnCall match these words to the ones you know.


Levels

Every alert goes out at one of four levels. The level is about what the phone does, not how bad the problem is.

Level What the phone does
quiet No sound, shows in the list
normal Sound and banner, Do Not Disturb silences it
loud Breaks through Focus, Do Not Disturb still silences it
page Rings through silent mode and Do Not Disturb, and repeats until someone answers

"Page" means only that top level. A page on a phone needs Critical Alerts turned on, which is Apple's name for the permission, and only the phone can give it. A sender using another tool's words (critical, high, P1, Pushover's numbers) is translated: Priority names from other tools.

Words

Word What it means In the API
Alert source Somewhere alerts come from: a URL with its own key that you post to, with its default level, highest level, mute hours, grouping and escalation policy. Alert sources and levels channel (/v1/mast/channels, mc_ ids, channel_id in webhooks)
Send URL An alert source's address, https://mast.tissue.dev/mk_…. The URL is the credential, so anything holding it can send to that alert source and nothing else url
Send key The mk_… part of the send URL, for senders that take a key in a header mk_ key
Default level The level a send gets when it doesn't name one default_priority
Highest level The loudest level an alert source may deliver at. A send asking for more is lowered to it and the answer says "capped": true. Only the phone can allow page. The highest level max_priority
Mute hours A daily window on one alert source when it arrives without a sound. A page still rings quiet_start, quiet_end, quiet_tz
Mute Silencing one alert source for a while, 15 minutes to tomorrow morning. A page still rings muted_until
Off hours A person's own hours off, set in the app and shown on the On call screen
Dedupe An identical message, or one with the same key, inside the dedupe window merges into the card already there and counts up on it dedupe_window_secs, state deduped
Grouping When an alert source floods, the pushes past the grouping threshold collapse into one card with a count. A page is never grouped away storm_threshold, storm_window_secs, state suppressed
Incident One thing that went wrong, from the first alert to the recovery: a site down for twenty minutes is one incident. Incidents a message, /v1/mast/messages, mm_ ids
Timeline On an incident, the record of who was notified, at what level, on which device, who acknowledged and what closed it
Acknowledge Saying "I've got it". Stops the repeats and the escalation. It doesn't close the incident ack
Resolve Closing an incident, from the phone, the web app or the sender with resolve=1 resolve
Vital (heartbeat) A send URL that expects to hear from a job on a schedule, and pages when it doesn't. Vitals (heartbeats) kind vital
Beat One request to a vital's URL, saying the job ran
Grace How late a beat may be before anyone is told grace_secs
Waiting, Up, Late, Down, Paused A vital's states: no beat yet; beating on time; overdue but inside the grace, nobody told; past the grace, someone is being paged; paused by you vital_state: pending, alive, late, flatline, paused
Run limit The longest a run may take between its start and its end before it counts as failed. A run that takes too long
Probe (uptime check) A URL or port Tissue Mast checks for you from eight places. Probes
Check One run of a probe from every place at once. Two down checks in a row turn a probe down
Places Where the checks run from: eight places on six networks. Where the checks run from
Escalation policy Who gets a page, in what order, and how long to wait between steps. On call /v1/mast/policies
Rotation A list of people who take turns being on call, handing off daily, weekly or on a custom length
Override Someone covering another person's turn for a day or a few hours
Device A phone or watch running Mast Pager and linked to your login. Linking your phone /v1/mast/devices, md_ ids
Link code The eight-character code that links a phone to your login, from Get a link code under Devices
Status page A public page that shows your users what your probes and vitals see. Always "status page", never a bare "page". Status pages
Destination Somewhere Mast reports events to: a webhook, Slack, Discord, Teams or email. It never takes the place of the page. Destinations
Maintenance window A time when the alerts it covers arrive without a sound. Maintenance windows
Deploy marker One request at the end of a deploy that checks every probe on the alert source and names the deploy on any page within the hour. Deploys
Mast Pager The app for iPhone and Android that rings. Mast Pager

The words that changed

Older posts, screenshots and scripts may use the names these words replaced. They mean the same thing:

Older word Word used here
channel alert source
channel URL, channel key send URL, send key
ceiling highest level
storm, storm fold, folded grouping, grouped
route, on an incident Timeline
flatline, flatlined down
Phones Devices
quiet hours, on an alert source mute hours
quiet hours, for a person off hours
round, probe round check
locations, cities places