Domain Alias
Dashboard Location / Domain Alias

A domain alias allows you to create a record in your company's DNS zone (a CNAME) for your dashboard page (for example, status.acme.com).  This allows you to host your dashboard page over a domain that you own, and that is familiar to your customers and users - it is highly recommended that you create a domain alias for your dashboard.  A domain alias may contain any alphanumeric character as well as '-' and '.', may be up to 75 characters long, and may have up to 4 subdomains (e.g. status.sf.na.acme.com).  The domain alias may be modified at any time by navigating to Dashboard Location > Domain Alias.

Setup

Once you set your domain alias in the StatusDashboard administrative portal, create a CNAME record in your organization's DNS zone and point it at one of the following hostnames:

Option

Description

Your subdomain (e.g. acme.statusdashboard.com)

As long as you do not change your subdomain URL, this is acceptable.

dbs.statusdashboard.com

This hostname will never change and is the best way to map your domain alias to the StatusDashboard network.


Please do not create an A record that points to the IP address of your subdomain URL or dbs.statusdashboard.com - you must create a CNAME.  Our IP addresses are subject to change periodically and your dashboard page could become unavailable if you create an A record instead of a CNAME record.  If you have any questions about the proper setup of your domain alias, please contact our support team.

Example Setup

The following dig DNS query shows the domain alias status.acme.com mapped to the statusdashboard subdomain acme.statusdashboard.com (which is automatically mapped to dbs.statusdashboard.com).


[jon@localhost /]# dig status.acme.com

; <<>> DiG 9.9.4-RedHat-9.9.4-18.el7_1.1 <<>> status.acme.com
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 27529
;; flags: qr rd ra; QUERY: 1, ANSWER: 11, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4000
;; QUESTION SECTION:
;status.acme.com.		IN	A

;; ANSWER SECTION:
status.acme.com.	43121	 IN	CNAME	acme.statusdashboard.com.
acme.statusdashboard.com. 3521   IN	CNAME	dbs.statusdashboard.com.
dbs.statusdashboard.com. 3521	 IN	CNAME	d33ge7nifrjjkv.cloudfront.net.
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.121
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.157
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.160
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.203
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.12
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.56
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.64
d33ge7nifrjjkv.cloudfront.net. 2 IN	A	54.230.87.70

;; Query time: 2 msec
;; MSG SIZE  rcvd: 281

[jon@localhost /]#


SSL

If you would like to serve your domain alias over SSL, this setup requires the addition of your domain alias to one of the StatusDashboard SSL SAN certificates. If you are interested in serving your domain alias over SSL, please contact our customer support team for assistance.

If you choose not to setup a domain alias, or your domain alias is set to a statusdashboard.com subdomain, then any time you modify the subdomain, the domain alias will automatically update to match the subdomain.

Please note that when changing your domain alias, it can take up to 15 minutes for changes to propagate throughout our network.  While domain alias changes are propagating, your domain alias may not be functional from all locations on the Internet.

Still have questions?  Contact our support team.  We're always happy to help with any questions you might have.