AWS Migration Hub is no longer open to new customers as of November 7, 2025. For capabilities similar to AWS Migration Hub, explore [AWS Transform](https://aws.amazon.com/transform).

# Viewing network connections in AWS Migration Hub
Viewing network connections

Viewing network connections in AWS Migration Hub allows you to visualize a server's dependencies. The visualization of these dependencies helps you verify all of the resources required to successfully migrate each of your applications to Amazon Web Services.

You view network connections by using the network diagram. When using the network diagram, you can visually review large amounts of data to understand what server dependencies exist. Understanding these server dependencies helps you plan how to group together the needed resources to support an application for migration to AWS.

The following topics provide information about using the network diagram.

Using network connectivity data from Application Discovery Service, the network diagram in Migration Hub reduces the time it takes to plan your migration by helping you quickly determine which of your servers are included in an application. 

Server connections are visually mapped for you in the network diagram, which you can modify to organize your server inventory into groups for application migration.

The network diagram provides the following capabilities:
+ Viewing detailed server information discovered by Application Discovery Service. 
+ Viewing server dependency information. 
+ Viewing detailed network connection information between servers. 
+ Applying filters to narrow the search for specific servers.
+ Validating existing application groups.
+ Exporting application information for use in migration planning.

**Topics**
+ [

# Prerequisites for using the network diagram in AWS Migration Hub
](network-diagram-prerequisites.md)
+ [

# How to use the network diagram in AWS Migration Hub
](network-diagram-how-to.md)
+ [

# Troubleshooting the AWS Migration Hub network diagram
](network-diagram-troubleshooting.md)

# Prerequisites for using the network diagram in AWS Migration Hub
Prerequisites

The following are the prerequisites for using the network diagram in AWS Migration Hub:
+  AWS Application Discovery Service Discovery Agent must be running on all of the on-premises servers that you want mapped in the diagram. For more information, see [Setting up Agent Based Discovery](https://docs.aws.amazon.com/application-discovery/latest/userguide/setting-up-agents.html) in the *Application Discovery Service User Guide*.
+ AWS recommends that server and network connection data be collected for two to six weeks to capture important connection patterns, such as month-end or year-end business cycles.
+ To grant access to the network diagram when creating an identity-based policy that allows or denies access to AWS Application Discovery Service or Migration Hub, you might need to add the `discovery:GetNetworkConnectionGraph` action to the policy. For more information, see [Granting permissions to use the network diagram](https://docs.aws.amazon.com/application-discovery/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-network-connection-graph) in the *Application Discovery Service User Guide*.

The network diagram has the following limits:
+ Currently, data ingestion stops after 180 days.
+ The network diagram can visualize up to 1,500 server nodes.

# How to use the network diagram in AWS Migration Hub
How to use the network diagram

This section describes how to use the network diagram in Migration Hub.

**To use the network diagram**

1. In the navigation pane, under **Discover**, choose **Servers**. 

1. To view details about the server, choose the hostname of the server from the **Server info** column. The server's detail page displays information about the server, such as hostname, IP address, performance metrics, and so on.

1. Choose **Network**. The icon for the server you choose is centered in the network diagram. Connections fan out from the center server to servers that are directly connected to the server you choose.

The network diagram console is divided into three panes: toolbar, diagram, and the server detail/selected server list pane.

The following topics describe the network diagram console panes.

**Topics**
+ [

## Toolbar
](#network-diagram-toolbar)
+ [

## Diagram
](#network-diagram-pane)
+ [

## Server details and selected server list
](#network-diagram-server-details)

## Toolbar


Choosing an icon on the toolbar performs an action or opens a pane with more choices. Only one of these panes can be open at any one time. 

The toolbar icons are described in the following table.


| Icon | Name | Description | 
| --- | --- | --- | 
|  ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/settings.png)  |  Settings  |  To change your settings, choose ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/settings.png).  | 
|  ![\[Funnel icon representing a filter or narrowing down of information.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/filter.png)  |  Filters  |  To filter server connections, choose ![\[Funnel icon representing a filter or narrowing down of information.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/filter.png) and then clear the check box next to each port number that you do not want to display connections for.  | 
|  ![\[Magnifying glass icon with a plus sign, representing a search or zoom-in function.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/zoom_in.png)  |  Zoom in  |  To zoom in on the diagram, choose ![\[Magnifying glass icon with a plus sign, representing a search or zoom-in function.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/zoom_in.png).  | 
|  ![\[Magnifying glass icon with a plus sign, representing a search or zoom-in function.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/zoom_out.png)  |  Zoom out  |  To zoom out, choose ![\[Magnifying glass icon with a plus sign, representing a search or zoom-in function.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/zoom_out.png).  | 
|  ![\[Icon representing a full-screen or expand view option.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/zoom-to-fit-icon.png)  |  Zoom to fit  |  To zoom to fit the entire diagram in the current view, choose ![\[Icon representing a full-screen or expand view option.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/zoom-to-fit-icon.png).  | 
|  ![\[Icon with four arrows pointing outward from a central point, indicating expansion.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/full-view-icon.png)  |  View full screen  |  To view the diagram full screen, choose ![\[Icon with four arrows pointing outward from a central point, indicating expansion.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/full-view-icon.png).   | 

## Diagram


This section describes the icons used in the diagram to show network server nodes and how to interact with the diagram.
+ [Diagram Icons](#network-diagram-icons)
+ [Adding a server to a diagram](#network-diagram-add-server)
+ [Interacting with the diagram](#network-diagram-controls)

### Diagram Icons


The icons used in the diagram are shown in the following table.


| Icon | Name | Description | 
| --- | --- | --- | 
|  ![\[List icon with three horizontal lines representing a menu or navigation button.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-icon.png)  |  Server  |  Represents a server that is running a discovery agent that is part of your network. To view details about a server, right-click ![\[List icon with three horizontal lines representing a menu or navigation button.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-icon.png) and then choose **View server details**. To select a server for a group application, right-click ![\[List icon with three horizontal lines representing a menu or navigation button.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-icon.png) and then choose **Select Server**.  | 
|  ![\[Checkmark icon indicating confirmation or completion of a task or selection.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-selected-icon.png)  |  Selected Server  |  Represents a server that you selected for group application.  To deselect a server, choose ![\[Checkmark icon indicating confirmation or completion of a task or selection.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-selected-icon.png) and then choose **Unselect server** in the server details pane. To select a server for a group application, right-click ![\[Checkmark icon indicating confirmation or completion of a task or selection.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-selected-icon.png) and then choose **Select Server**.  | 
|  ![\[Server icon labeled "Server Hostname Application" representing a cloud service.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-app-label-icon.png)  |  Server with application label  |  Represents a server that belongs to a group application. The name of the application is displayed under the server icon. The names of all the applications the server belongs to are displayed.    | 
|  ![\[Circular diagram showing 12 AWS services with icons and names around a central AWS logo.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-no-agent-icon.png)  |  Server without agent  |  Represents a server in your network that doesn't have Discovery Agent installed. To view details about the server, choose ![\[Circular diagram showing 12 AWS services with icons and names around a central AWS logo.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/server-no-agent-icon.png).  | 
|  ![\[Plus sign icon inside a circle, indicating an add or create action.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/node-expand-icon.png) ![\[Minus sign icon in a dark blue circular background.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/node-contract-icon.png)  |  Plus sign on upper right corner of server icon Minus sign on upper right corner of server icon  |  Represents that the server has servers connected to it that aren't shown in the diagram. To expand the network from the server node, choose ![\[Plus sign icon inside a circle, indicating an add or create action.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/node-expand-icon.png) on the server icon. To collapse the network back to the server node, choose ![\[Minus sign icon in a dark blue circular background.\]](http://docs.aws.amazon.com/migrationhub/latest/ug/images/node-contract-icon.png) on the server icon.  | 

### Adding a server to a diagram


You can search for servers to add to the diagram by searching by hostname or by IP address. You'll get results after adding your search criteria and pressing **Enter**. 

**To search for servers to add to the network diagram**

1. Choose the search icon on the toolbar, and then choose **Hostname** or **IP address**.

1. Type the criteria for your search in the search box. 

   For example, to search for servers that contain **IAM** in their hostname, enter **IAM**. Or, enter **0.0.0.** to search for servers that contain **0.0.0. ** in their IP address.

1. From the result, select the servers to add to the diagram, and then choose **\$1** to add them to the diagram. 

### Interacting with the diagram


You can interact with the diagram in the following ways:
+ To pan around, choose and drag on empty areas in the diagram.
+ To zoom in and out, scroll up and down, respectively.
+ To highlight all the connections to and from a server on the diagram, hover over a server icon.
+ To see a server's details in the server detail pane, choose a server icon.
  + Inbound ports only shows ports that are being opened on the server.
  + Outbound ports aren't displayed.
  + Hovering over a port highlights all the connections that open that port on the diagram.
+ Hold shift and choose servers to select them for grouping applications or other actions.

## Server details and selected server list


Server details and the list of selected servers share the pane right of the diagram. You can toggle back and forth between the server details view and the selected server list view by choosing the server icon.

To see details about a server on the diagram, choose the server icon. Details about the server display in the pane to the right of the diagram.

You can use the following options to select servers from the network diagram:
+ On the network diagram, choose a server node icon. Details about the server show in the server details pane, where you choose **Select server**.
+ On the network diagram, open the context (right-click) menu on the server node icon, and then choose **Select server** from the dropdown list.
+ Choose **Select all** to select all the servers for grouping that are in your diagram. Only the servers with the Discovery Agent running on them are selected.
+ Hold **shift** to select multiple servers at the same time.

Selected servers are shown in a list in the same pane as the server details. You can toggle back and forth between the server details view and the selected server list view by choosing the server icon. 

After you select one or more servers, you can create an application, or add to an existing one, by choosing **Group as application**. You can add a descriptive tag to the selected servers by choosing **Add tag** from the **Actions ** menu. Doing so shows a dialog box where you can type a value for **Key**, and optionally a value for **Value**. For more information, see [Step 3: Group servers as applicationsStep 3: Group servers](gs-new-user-discovery.md#gs-discovery-group-as-applications).

# Troubleshooting the AWS Migration Hub network diagram
Troubleshooting

Use the information here to help you troubleshoot and fix issues that you might encounter when working with the network diagram in AWS Migration Hub.

**Topics**
+ [

## Message that you need to install Discovery Agent
](#troubleshooting-problem-need-agent)
+ [

## Problems when adding servers or expanding diagram
](#troubleshooting-problem-expand-diagram)

## Message that you need to install Discovery Agent


The following topics describe scenarios when you get a message that you need to install Discovery Agent.

### After choosing one or more servers on the server list page, and then choosing **Visualize network**, you get a message that you need to install a discovery agent on the server.


Add AWS Application Discovery Service Discovery Agent to the servers that you that want mapped in the network diagram. For more information, see [Setting up Agent Based Discovery](https://docs.aws.amazon.com/application-discovery/latest/userguide/setting-up-agents.html) the *Application Discovery Service User Guide*. 

### When trying add a server that doesn't have discovery agent installed to a group, you get a message that you need to install discovery agent on the server.


Add the Discovery Agent to the servers that you that want to be able to add to a group.

## Problems when adding servers or expanding diagram


The following topics describe scenarios when you get a message when adding new servers or expanding existing servers.

### When adding new servers or expanding existing servers on the network diagram, you get a message that your choices will cause the diagram to exceed its visual limit of 1,500 server nodes.


Retry adding fewer servers.

### When adding new servers or expanding existing servers on the network diagram, you experience high latency that leads to a time out.


Retry adding fewer servers.