12.2Choose what to show
You choose which monitors appear on the page. Each one gets a public name: the name visitors see for that monitor.
- Under monitors on the page, open the add a monitor… list and pick a monitor. A new row appears.
- In public name, enter the name visitors should see, such as
WebsiteorAPI. It starts as the monitor's own name. - Use up and down to set the order. The page shows monitors in this order.
- Use remove to take a monitor off the page.
- Select save. Changes take effect only after you save.
Under each public name you see monitor: <monitor name>, so you know which monitor the row is. When every monitor is already on the page, the list reads every monitor is on the page.
Rules#
- A page can show up to 50 monitors.
- Each monitor can appear once.
- A public name is required. It can be up to 80 characters, with no line breaks.
- You can add only your own team's monitors.
- If you pause a monitor, it stays on the page and shows Not monitored.
- If you delete a monitor, it is taken off the page.
- If you take a monitor off the page, its incidents no longer show there.
| Message | What to do |
|---|---|
invalid input: a status page can show at most 50 monitors | Remove monitors until 50 or fewer are left. |
invalid input: public_name required | Enter a public name for every row. |
invalid input: public_name must be at most 80 characters | Shorten the public name. |
invalid input: monitors must name each monitor once | Remove the repeated monitor. This can happen only through the API. |
invalid input: monitors names a monitor this team does not have | A row reads deleted monitor, or the API call used a wrong ID. Remove that monitor and save again. |
In the API, monitors is the whole list, in page order. Each item has a monitorId and a publicName (see the example in 12.1).