> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megaport.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Megaport Portal Dashboard
> This help topic describes how to use the Megaport Portal dashboard with the rotating globe feature.
export const Anchor = ({name}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Anchor -';
if (name === undefined || name === null || name === 'undefined') {
console.error(`${errorPrefix} \`name\` must have a value — rendering an empty string instead`);
return <>;
}
const raw = typeof name === 'string' ? name : JSON.stringify(name);
const id = raw.replace(/\s+/g, '-').replace(/[^A-Za-z0-9_-]/g, '').replace(/-+/g, '-').replace(/^-+|-+$/g, '');
if (!id) {
console.error(`${errorPrefix} \`name\` "${name}" sanitizes to an empty id — rendering an empty string instead`);
return <>;
}
return ;
};
export const Image = ({src, alt = '', caption, width, height, shadow}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
if (typeof src !== 'string') {
src = String(src);
}
if (!src || src === 'undefined') {
console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
return <>;
}
const img = ;
return caption ?
{img}
{caption} : img;
};
export const InlineImage = ({src, alt, height = 16, shadow, width}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: InlineImage -';
if (typeof src !== 'string') {
src = String(src);
}
if (!src || src === 'undefined') {
console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
return <>;
}
if (typeof alt !== 'string') {
alt = String(alt);
}
if (alt === 'undefined') {
console.error(`${errorPrefix} \`alt\` is required (use "" for decorative images) — rendering an empty string instead`);
return <>;
}
if (height) {
height = height.toString().replaceAll(/\D/g, '');
}
if (width) {
width = width.toString().replaceAll(/\D/g, '');
}
return ;
};
The Megaport Portal dashboard is an interactive experience that can show either a rotating globe or a flat projection. You can use the visualizations to see your Megaport defined network. You can also use it to add connections and services to your network.
## Dashboard views
By default, you will see the interactive globe view. To change to the flat projection, click the flat map image on the right:
For more information, see [Map controls on the right](#map-right).
## Maintenance and outage banner
At the top of the page, a banner will be displayed to inform you about any future or ongoing maintenance or outages. If there are no maintenance or outages, the banner will not be displayed.
The banner will only show events three days before the maintenance or outage is scheduled to occur.
Select **View All** to see details about the maintenance or outage.
Click **X** to close the banner.
## Map controls
There are control buttons on each side of the map, and a status bar along the bottom that summarizes your services. The buttons let you control what you see on the dashboard, and the status bar shows your service status at a glance.
Hover the mouse over each control on the map to see its purpose.
### Move the globe
To manipulate the globe view, click and drag on the globe.
* On a standard mouse, left-click and drag
* On an Apple magic mouse, click and drag
* On a tablet, touch and drag
### Advanced globe view manipulation
You can use commands to completely invert the globe. This is useful if you want to view your network in a certain way, or to take screenshots of parts of your network that can only be seen this way.
**To invert the globe view to north at the bottom**
* With a standard mouse, drag sideways while holding the right button or drag sideways while holding *ctrl* and left button
* On a keyboard, click *shift* + left or right arrows
**To restore the globe view to north at the top**
* With a standard mouse, drag sideways while holding the right button or drag sideways while holding *ctrl* and left button
* On the keyboard, click *shift* + up arrow.
### Map controls on the left
The controls on the left side of the map help you control how much information you see. Use the location filter buttons at the top of the left controls to choose which locations appear on the map.
| Control | Purpose |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| | Show all locations. Displays all location types, including installed locations (Active and Deployment), [extended locations](#extended-locations), and locations where you have services. This is the default view. |
| | Show installed locations. Displays only installed Megaport locations (Active and Deployment status) where you can order services directly. Occupied locations (locations where you have services) and extended locations are hidden. |
| | Show extended locations. Displays only [extended locations](#extended-locations). Installed locations and locations where you have services are hidden. |
| | Show locations where you have services. Displays only locations where you have deployed services, along with connection lines between them. Empty locations (where you have no services) are hidden. |
| | Filter empty locations. See [Locations](/dashboard#locations) for more information about empty locations. |
| | Map key. This explains what the icons, colors, and links mean on the map, including the distinction between installed and extended locations. |
| | Keyboard commands to control the map, including zoom and changing orientation. |
### Search
The search function allows you to search the map for:
* Any service type. For example, VXC.
* A service name
* A product ID
* Megaport enabled locations but only if you do not have this turned off in your map settings
* Any place name in the world
### Map controls on the right
The controls on the right side of the map set the screen mode (normal or full-screen), the view (globe or flat map), and the level of zoom.
| Control | Purpose |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| | Expand the map or globe to full screen. The Megaport Portal header and options are hidden. To return to normal view, click **Exit full screen**. |
| | Show the rotating globe view. |
| | Show the flat map view. |
| | Zoom in with large increments. |
| | Zoom in with small increments. |
| | Zoom out with small increments. |
| | Zoom out with large increments. |
### Service status bar
The service status bar is a full-width bar along the bottom of the map that summarizes the status of your configured services.
From left to right, the bar begins with an **All Services** tile that aggregates the up and down totals across all service types. This is followed by a tile for each service type you have. Service types with no services are not shown.
Each tile shows:
* A circular status indicator divided into segments that represent the proportion of services that are up or down.
* The total number of services for that service type.
* A status summary showing the number of services that are down (for example, *3 down*), or *all up* when none are down.
You can minimize the bar to a small pill that displays the total number of services. Click the pill to expand the bar again. Your browser remembers whether the bar was last minimized or expanded.
If you do not have any services yet, the bar shows a **No services yet** message instead of tiles.
## Locations
Each Megaport location is marked by a pin. The color of the pin indicates the location type and status:
| Pin | Status |
| :-------------------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| | Blue for occupied. An occupied location means that you have a Port or other network component at that location, or you have a connection that terminates on someone else's Port or network component at that location. |
| | Red for installed empty. An installed (empty) location means that Megaport hardware is available at that data center, but you do not currently have any services there. You can order services directly at these locations. |
| | Black for extended empty. An [extended location](#extended-locations) is a data center where Megaport hardware is not physically present, but services are available through a private connection from a nearby installed location. |
Use the location filter buttons on the left side of the map to show or hide specific location types. For more information, see [Map controls on the left](#map-left).
### Location clusters
When you click a cluster of either occupied or empty locations, it will zoom in to show the next level of services expanded to show each service or location. The color of the icon shows the status of the service:
* Green for up and running
* Red for provisioned but not running
* Black for ports or connections that you do not own
There is also a location icon, which you can click to create services and get location details.
When you zoom out and the occupied locations are clustered, the number in the circle indicates the number of connections present in the clustered locations. The circle drawn around it shows the proportion of them that are up or down. The colors represent:
* Green for up
* Red for down
### Location functions
When a location is expanded, you can click the location icon to see a pop-up with buttons that allow you to create available services or connections at that location.
For more information about creating services, see [Provision services](/getting-started#provision-services).
### Extended locations
Extended locations are data centers in the same campus or metro area as an installed Megaport location. Megaport hardware is not physically present at extended locations, but you can access services through a private cross connect from an installed location. You can order this cross connect to the Megaport installed location from your Data Center Operator at the extended location.
To view extended locations on the map, use the location filter buttons on the left side:
* Click the **white pin** button to show all locations, including extended locations alongside installed and occupied locations.
* Click the **black pin** button to show only extended locations and hide all other location types.
Extended locations appear with black pins on the map. When you click an extended location pin, the pop-up shows:
* The data center name, metro, and country
* A banner indicating that the location is extended via private connection from installed sites
* A list of installed (parent) sites that connect to the extended location
To order services at an extended location, contact your Account Manager for assistance. Services are created from the installed (parent) locations, not directly at extended locations.
For more information about location types, see [Understanding Locations](/enabled-locations).
## Component control
When you have focus on a location, you can keep clicking down to an individual service.
You can use the map interface to see details, create, and remove services or connections. Click a service or connection icon to expand it and see the details.
### See service details
Click an icon to see the details for that service.
### Add network connections
You can add network connections from the Megaport Portal dashboard.
**To add network connections**
1. Click the Port or connection icon.
You will see a pop-up window that allows you to add a service.
2. Click **+Connection** to open the New Connection page.
For more information about creating services, see [Connections Overview](/connections/overview).
The Megaport Portal saves where you were on the map if you head off to create or view services. When you finish that process, it takes you back to where you were. The Megaport Portal also saves your view of the map and will return you to the same zoom level so you see it as you last saw it.
### Update network connections
You can use the service pop-up to change settings or delete the service.
Click the button to copy the service identifier.
## Connections
Connection lines can represent one or more connections between two locations.
The color of the connection line indicates the status of the connection:
* Green for up
* Red for down
When you click a connection icon, the pop-up displays the ends according to their relative geographic location. This means that the button on the left will take you to the Port at the geographical left and the same for the right side.
Click the A-End or B-End ports to go directly to that Port.