Skip to content

Operations notifications

Operations notifications tell your telescope team when hardware needs attention: a device faults, an instrument starts producing unusable frames, a device drops offline, the shutter opens or closes, or a weather or safety constraint changes state. Your organization decides who hears about what with notification rules; each person then chooses their own channels. This page covers setting up and checking those rules. For the model behind them (which events exist, how scope and channels work), see Notifications.

Organization owners and device managers can manage notification rules (the notifications.manage permission; see Built-in organization roles). Other members, including telescope viewers, can see the rules that reach them and mute them, but cannot change them.

Every organization has a default rule: Device faults and Instrument & telescope faults anywhere in the organization go to its Owners. It shows a Default badge and “Added by Skynet”. You can edit, pause or delete it like any other rule; Skynet does not recreate it.

The default rule does not cover connectivity, the shutter, or weather and safety. If your team wants those, add rules for them.

Go to your organization, open Settings, and choose Notifications in the sidebar (/orgs/<organization>/settings/notifications). From a telescope’s Overview page, the Manage notifications button in the header opens the same page narrowed to the rules that cover that telescope, including the organization-wide and observatory rules it inherits; Show all rules clears the filter.

Rules are grouped by where they apply: Whole organization first, then each observatory, then each telescope. Each group has an Add rule here link.

Press New rule (or Add rule here on a group) and fill in the dialog’s three sections, then press Add rule.

Where the rule applies:

Choice Covers
Whole organization Every observatory and telescope, including ones added later.
One observatory Its own devices and every telescope in it.
One telescope The telescope, its devices and instruments, and its enclosure.

Weather and safety constraints set up on the observatory, rather than on one telescope, are reached by observatory and whole-organization rules only. If your weather sensors belong to the observatory, a telescope rule will not tell anyone about them.

What the rule is about: tick one or more of Device faults, Instrument & telescope faults, Device online / offline, Enclosure shutter and Weather & safety.

Who is told:

  • Everyone with a role: pick a role (Owners, Device managers, Telescope viewers, Observing managers, Membership managers, Group managers, or Every member). Membership is checked each time an event is delivered, so people who gain or lose the role later are included or dropped automatically, including people who hold it through a group.
  • A group: one of the organization’s groups; its members at the time of each event are told.
  • One person: a member of the organization.

A new rule’s dialog starts with both fault families and Device managers selected. Rules have no channel setting: each person receives the rule’s events on the channels they chose in their own notification settings.

Each rule shows its families, a Paused badge when paused, who added it, and when it last notified anyone (“Has not notified anyone yet” until then). Below that, a summary such as “Reaches all 3 people” or “Reaches 2 of 3 people” opens a per-person list of exactly how each family will reach them, given their own choices. A person is not told when they turned that family off, muted this rule, or paused all their notifications; SMS is dropped for anyone without a verified phone, and the list says so. A rule aimed at an empty group or a role nobody holds says it tells no one.

At the top of the page, a Nobody would be told about these faults box lists every telescope and observatory where no active rule delivers Device faults or Instrument & telescope faults to anyone on at least one channel, with an Add a rule link for each. (Observatories are only checked for device faults.) People who muted the rule, or turned the family off, do not count as covered.

Press Send test on a rule to send one test message to everyone it reaches, on every channel each of them gets for any of the rule’s families. Confirm the prompt, which reminds you that text messages are real SMS; the rule then reports “Test sent to N people”, and the messages arrive within a minute. The message names the organization, the families and where the rule applies, and links to the recipient’s notification settings, where they can mute the rule.

A test skips people who muted the rule and reaches nobody who paused all notifications. It works on a paused rule. You can test each rule once every 10 minutes, and a rule that reaches nobody cannot be tested.

  • Pause stops a rule notifying anyone without losing it; Resume turns it back on.
  • Edit reopens the dialog; press Save rule.
  • Delete removes the rule after a confirmation. Notifications it already sent stay in people’s inboxes.

Each telescope’s Overview page has a Notifications panel, with the number of rules in its header:

  • Owners and device managers see every rule that covers the telescope, with who each reaches (“Reaches all 3”, “Reaches 2 of 3”, “Reaches nobody”), a warning when nobody would be told about faults there, and Add rule and Manage links to the settings page.
  • Everyone else who can open the Overview sees the rules that tell them about this telescope, with what they receive from each and a Mute switch, or “No notification rules tell you about this telescope.”

Rules only reach members of the organization that owns the telescope. Observers who use the telescope through an access grant are not told about its faults, and a rule can only name people, groups and roles inside your organization.

A telescope owned by a personal account rather than an organization has no default rule, and the website has no rules page for personal accounts. Rules for it can be created through the API (POST /v1/entities/{slug}/notification-rules), and they can only notify that person.