These setup instructions will cover all three varieties of Status Page. This document will sometimes refer to a “Status Page”, which should be taken as a generic term to apply to all types of status pages unless otherwise noted. You can find specific use cases and information for each Status Page type at the following links:
To skip to a specific section of the "Uptime.com Status Page Solution: Basic Setup" video, click the links with the !
- Creating a Status Page
- Global Settings
- Look & Feel
- Subscription Management
- Components
- Component-Specific Subscriptions
- System Metrics
- Incidents & Maintenance
- Sharing a Status Page
- API Allowlist and Blocklist on the Status Page
Creating a Status Page
The following sections will walk through Page features and the creation of your first Page (including components, groups, metrics, adding your first incident, and scheduling maintenance).
To create your first page, click Status Pages, select the Status Page type, and then click New Status Page. There are three Status Page types you can choose from:
Using the Public Status Page screen as an example, you can see and manage your status pages through the Actions buttons Edit, Add Incident, and Schedule Maintenance.
For additional settings like Duplicate or Delete, click the "three dots" button at the far right.
Duplicate Status Page
Click the "three dots" found on the main Status Page display to view the option to Duplicate the Status Page.
Duplicating a Status Page carries over most settings to the duplicated Status Page:
- All settings under the Global tab, with the exception of the Status Page Name (it will be necessary to give the duplicated Status Page a unique name)
- All settings under the Current Status tab
- All settings under the History & Incidents tab
- All components and component groups
- All system metrics
- All settings for Customization of Look & Feel
Please Note: This ability is currently only available on next-gen Status Pages, which can be activated by opting in to next-gen from the banner on the main Status Page list.
Viewing Your Page
Once a Page is created, with or without components, it is viewable if you click the at the top right-hand side. You will notice both Current Status and History tabs are enabled by default for the Public Status Page and Internal Status Page, but not for Public SLA (where only History is enabled by default).
Managing your Page
To edit or change your Page, click the Status Page type and locate the Page you wish to manage. Click Actions > Manage, and you will have access to the Page settings below.
Status Page Settings
Use these settings to determine what your visitors will see, what they can click, and the detail level of reporting on your page. Click and then select your option:
Please use the included links to learn more about the forms available for each setting.
Global Settings
Determine whether your Page will be displayed publicly, set your URL slug, Custom Subdomain, or configure Basic Auth.
Your Status Page is required to have a name, but the description is optional. The text placed inside these fields will appear in the default header of your Status Page. If you use inline HTML and CSS, it is possible to replace or override this text.
Timezone
You are able to set the timezone for the Status Page to control the information that is presented on the external status page from the timezone set. You can also set the time format to be 12H or 24H. This setting will be reflected when viewing any created Status Page events.
Please Note: The maintenance and incidents data you will see are not affected by the timezone change, on the Status Page setup.
However, the change will be visible once you view the status page live and also your external users will also be able to see the change.
Creating a Custom Subdomain for Your Status Page
Any account tier can create a Custom Subdomain for your Status Page, allowing users to access your Status Page using the custom subdomain URL instead of the default address that is generated based on the URL Slug.
To configure the Custom Subdomain:
Navigate to Status Pages, then the list of Status Pages based on the type that will be managed (Public Status, Public SLA, or Internal Status). Click the Edit Public Page icon for the desired Status Page:
Manage the Status Page’s settings using the cog wheel and selecting Settings from the drop-down menu:
In the Custom Subdomain field, enter the desired custom domain that will point to your Status Page (for example, a subdomain such as status.mysite.com or customerstatuspage.com):
In your DNS configuration, create a CNAME record for the subdomain entered in the Custom Subdomain field. Set the CNAME Label/Host to the custom domain or subdomain, and point the CNAME Destination/Target to the following address:
cname.uptime.com
If the Custom Subdomain does not appear to be resolving properly to the Status Page, please allow some time as CNAME record changes can take up to 72 hours to propagate. If it still does not appear to be resolving, please send an email to support@uptime.com and we will assist in verifying that the record is setup correctly.
Configuring CAA (Certification Authority Authorization) Records for Status Pages
For information about configuring CAA records in conjunction with Uptime.com Status Pages, please see the dedicated document located here.
Current Status
The Current Status tab tells visitors what is happening in real time. Current Status includes multiple sections such as Active Incidents, Components (and status), and Scheduled Maintenance. You can control visibility of these sections when you manage your Status Page.
History & Incidents
The History & Incidents tab sums up past outages, scheduled maintenance windows, and allows visitors to browse these events with date selection. You can set a default date range, or determine the method to calculate uptime; the duration of incidents or the uptime percent of check-based components.
As an account owner or admin, you have the option to enforce the date/time range by using the Maximum Selectable Time Range (days) option.
This option defines the widest range of time users can select or view on the date picker on the Status Page.If the range is empty, all data is shown.
Please Note: This option is only available when switching the Status Page view to the NewGen UI.
Look & Feel
Use Look & Feel to add a logo to your Page, or customize the Inline CSS/HTML placed in your header and footer. Users can also add their Google Property/Measurement ID here, and set a contact email address where visitors can report a problem not listed on the page.
Please Note: The CSS and HTML feature is dependent on the plan you are on.
Customizing Emails
You can customize the look and feel of the notification emails sent to subscribers of your Page, including the Send From email address used.
Note: Customizing the Send From email address will require DNS changes for your domain. Please see the changing your SPF record document for more information on how to accomplish this.
Subscription Management
View List Of Subscribers
From the status page header panel, there is an option to view the current Subscribers of the status page.
On the page, the list of subscribers will be present and shown in an alphabetic list by the email. There is an option to either select each subscriber individually, or bulk select them.
If you do not have any current subscribers on the page you will see the message: You don’t have any subscribers for your status page yet.
Import/Export
From the same page, you are able to Import your subscribers list from the chosen file format specified and Export the subscribers list in the form of an Excel file.
When selecting Import, a pop up screen will appear, where it will show the amount of current subscribers, an option to download the current subscriber list, and the option of importing the subscribers file.
Selecting the Export option will download the list of subscribers, similar to the functionality of downloading the subscribers list, found in the Import section.
Search & Delete
Under the Subscribers tab, there will also be an option to search for current subscribers to your status page from the search box. You can also delete specific subscribers by selecting the bin icon.
You also have the option to bulk delete the subscribers by checking the box next to each subscriber to be deleted.
Subscribing with a Custom Webhook
Uptime Custom Webhooks offer the option to send notifications to a URL of your choice when an event occurs, allowing for seamless status tracking.
By implementing Uptime Custom Webhooks, real-time alerts can be sent to systems via HTTP POST in a JSON serialized string. These notifications will help subscribers stay informed of any changes in the check status, such as UP to DOWN or vice versa, and take timely action accordingly..
To review an example of the POST request, please click here.
Components
Components represent the core of your page. You can add up to 200 components, each with an optional description.
If you wish to add a component to an existing page, click + Add Component or + Add Group to add a Component Group.
If you Add or Edit a Component, you can associate it with a check. Type the check name or URL, and select it from the dropdown menu. You can then set the state of this check to change automatically when failure conditions are met.
Component Status
To change a component’s status manually, select the status from the dropdown menu within the Components tab of your page.
To automate a change in status, you must do at least one of the following:
- Link a component to a check (Requires setting a status on check failure)
- Add an incident that affects a component or group linked to a check
- Schedule a maintenance window that affects a component or group linked to a check
A change in status, whether manual or automated, is reflected simultaneously live on your page for a given component.
Components always inherit the most severe status, therefore it is possible to manually override an automated change in status if the manual status is more severe. For more information on how this works, see this section on Component Status.
Component-Specific Subscriptions
Your users have control over the components they receive incident or maintenance update notifications for. Once subscribing to your status page, the user can choose which specific components interest them and select them accordingly.
By default, all components are selected, but users can fully customize the notifications they receive based on their preferences.
Once submitted, users will receive an email confirmation, as shown below. From that email, users can unsubscribe or manage their subscriptions at will.
System Metrics
You may add up to 10 system metrics, and customize their names.
Select + Add System Metrics to display a selected component’s metrics on your Status Page. System metrics are visible if you have enabled Display "Current Status" tab on your Status Page (in Settings > “Current Status” tab).
Note: If the System Metrics linked to a Status Page are deleted, the System Metrics field will no longer be displayed on the Status Overview section of the Status Page.
Incidents & Maintenance
Incidents and maintenance windows help inform users of scheduled maintenance windows and downtime events (whether standalone incidents or as a byproduct of maintenance operations).
Add incidents and notify visitors of scheduled maintenance windows by clicking + Add Incident or + Add Scheduled Maintenance under their respective navigation tabs. Follow the links for more information on setting up and managing Incidents and Scheduled Maintenance.
Sharing a Status Page
It is possible to share your Page through a variety of methods. Firstly, by making your Page public and sharing the URL. You can also enable subscriptions and search indexing.
Users can:
- Make a publicly accessible Page that is or is not search engine indexable
- Create a custom URL Slug and/or Custom CNAME
- Use Basic Auth to restrict access to users without the username and password
- Allow external users to access via Single Sign-on (SSO) or a status-page specific login.
Basic Auth
To keep your Page visible only to a select group, utilize the Basic Authentication feature and set a username and password to be used for access to your Page. Set all accessibility parameters by clicking >Settings.
Single Sign-On (SSO) and External Users
For accounts with SSO enabled, Status Pages can be secured via SSO and an external Identity Provider (IdP) or via external user logins with the Uptime.com portal.
For detailed instructions, see our article Securing Your Uptime.com Status Page.
Configuring CAA (Certification Authority Authorization) Records for Status Pages
For information about configuring CAA records in conjunction with Uptime.com Status Pages, please see the dedicated document located here.
API Allowlist and Blocklist on the Status Page
There are currently API methods that will allow Status Page admins to configure what email domains are permitted to subscribe to your status page.
Simply navigate to the Settings>API, and by selecting Documentation, under the status page option, you will see the following endpoints:
-
GET /api/v1/statuspages/{statuspage_id}/subscription-domain-allow-list/
-
POST /api/v1/statuspages/{statuspage_id}/subscription-domain-allow-list/
-
GET /api/v1/statuspages/{statuspage_id}/subscription-domain-allow-list/{pk}/
-
PATCH /api/v1/statuspages/{statuspage_id}/subscription-domain-allow-list/{pk}/
-
DELETE /api/v1/statuspages/{statuspage_id}/subscription-domain-allow-list/{pk}/
-
GET /api/v1/statuspages/{statuspage_id}/subscription-domain-block-list/
-
POST /api/v1/statuspages/{statuspage_id}/subscription-domain-block-list/
-
GET /api/v1/statuspages/{statuspage_id}/subscription-domain-block-list/{pk}/
-
PATCH /api/v1/statuspages/{statuspage_id}/subscription-domain-block-list/{pk}/
- DELETE /api/v1/statuspages/{statuspage_id}/subscription-domain-block-list/{pk}/
Please Note: This ability will also be soon available within the UI
FAQ
I received a notification from the Status Page via SMS/email. Which timezone is used for the "Time Posted" field?
The timezone in the notification matches the one chosen for that Status Page, as opposed to the timezone set in the user's account. Here's an example of a notification:
Want to see our checks in action? Check out our YouTube Library for more!
Comments
0 comments