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 |