# Session map tab

The **Session map** tab gives you a visual representation of the connection between endpoint devices and VMs across all sessions.

Connection issues can occur across different devices, users and destinations. Session map accelerates troubleshooting and helps you identify the appropriate team to fix network-related issues by providing an interactive visualization of `session.vdi_events` data.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-06d8fa0565232f4fee3e43a6f8486bd08d91829f%2Fsessions-overview-session-map.png?alt=media" alt="Session map tab"><figcaption></figcaption></figure>

### Using Session map

Session map breaks down the selected metrics for `session.vdi_events` into multiple properties and uses connection paths to display the relationships between properties. Nodes and lines represent these relationships.

The Session map connection paths display four columns by default, allowing you to click on nodes or lines to [drill down](#networkview-drillingdowntospecificfieldsdrilldownclicking) to lower levels of breakdowns.

To switch from the displayed metrics and begin troubleshooting issues:

1. Select the **Display** drop-down above the Session map visualization.
2. Select one of the available metrics for the particular connection data set.

### Line thickness for visual comparison <a href="#networkview-linethicknessforvisualcomparison" id="networkview-linethicknessforvisualcomparison"></a>

The thickness of a line, which connects two nodes, is proportional to the metric value between those respective nodes when compared to the same metric values between different nodes in the same two columns.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-7b3f697dd9eeaac8f93657050b6f4626eadc645a%2Fsessions-overview-session-map-lines.png?alt=media" alt="Session map visualization line thickness"><figcaption></figcaption></figure>

{% hint style="info" %}
When viewing issue-related metrics, thick lines help you identify the most problematic areas.
{% endhint %}

### Nodes

The system sorts nodes in descending order within each column. This makes it likely that thicker lines appear towards the top, but this is not always true.

Session map shows the top eight nodes in each column. If a column has more than eight nodes, the values are aggregated into the **Others** node at the bottom of the column:

* Click on **More** to open another eight nodes in a column.
* Click **Less** to hide additional nodes.

{% hint style="info" %}
To facilitate data interpretation, each node is associated with all paths going through it.
{% endhint %}

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-c855792a8f665fb4157fe8c13ab14be5f10c27f1%2Fimage.png?alt=media" alt="Leaf count for nodes and columns"><figcaption></figcaption></figure>

{% hint style="info" %}
The leaf count is also shown for each column next to the column name.
{% endhint %}

### Hovering over a node or line <a href="#networkview-hoveringoveranodeorline" id="networkview-hoveringoveranodeorline"></a>

Hover over a node or a line to highlight the connection metric value that goes through that node or line.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-7b3f697dd9eeaac8f93657050b6f4626eadc645a%2Fsessions-overview-session-map-lines.png?alt=media" alt="Hovering over a line"><figcaption></figcaption></figure>

### Drilling down to specific fields <a href="#networkview-drillingdowntospecificfieldsdrilldownclicking" id="networkview-drillingdowntospecificfieldsdrilldownclicking"></a>

Session map displays four columns by default. Each column is associated with a hierarchy of fields to reduce the number of nodes shown on the screen.

The following table lists the hierarchy of fields for each column, which goes from general to specific:

<table data-full-width="true"><thead><tr><th>Column 1: Users</th><th>Column 2: Client devices</th><th>Column 3: Desktop pools</th><th>Column 4: Virtual machines</th></tr></thead><tbody><tr><td>AD -> Department</td><td>Country location</td><td>Virtualization -> Desktop broker</td><td>Virtualization -> Hypervisor name</td></tr><tr><td>Username</td><td>State location</td><td>Virtualization -> Environment name</td><td>Virtualization hostname</td></tr><tr><td></td><td>Client device name</td><td>VDI session -> Desktop pool</td><td>Device -> Name</td></tr></tbody></table>

To drill down on a Session map field, you have the following options:

* Click on a [node](#selecting-a-node) in the Session map visualization.
* Click on a [line](#selecting-a-line) between two nodes.

After clicking on a node or line, [navigate back up the hierarchy](#navigating-back-up-the-hierarchy) using the expandable drop-downs in each column heading in Session map.

#### Selecting a node

Select a node to:

* Apply a filter for the selected node.
* Drill down one level in the column hierarchy.

#### Selecting a line

Select a line to:

* Apply a filter for the selected line, which is equivalent to selecting the two nodes it connects.
* Drill down one level in the hierarchy of the connected columns.

{% hint style="warning" %}
Filters applied by clicking on nodes or lines within the Session map tab affect only the widgets on this tab.
{% endhint %}

#### **Navigating back up the hierarchy**

To navigate back up the hierarchy of the Session map fields after selecting nodes or lines:

1. Select the drop-down in the Session map column heading.
2. Select any field name above the current level in the hierarchy.

### **Connections** timeline <a href="#connections-timeline" id="connections-timeline"></a>

The **Connections timeline** displays the selected metric’s development over time. For example, if you select **Network RTT**, it shows the number of failed connections across the timeframe selected in the timeframe picker.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-8fdc82f12d07dbb4fc4114dd2d820d9b3da95bcb%2Fsessions-overview-timeline.png?alt=media" alt="Session map timeline"><figcaption></figcaption></figure>

The timeline is synchronized with the connection paths. When you drill down or up on nodes, the timeline chart updates accordingly.

#### **Zooming in on a time period using the timeline**

The **Connections timeline** is interactive. To focus on a specific period of interest, click and drag your cursor over that timeframe in the timeline.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-08fc8ed22fb3d6c8e7767a54f4159d1bc7b115f5%2Fsessions-overview-timeline-select.png?alt=media" alt="Selecting a period on the timeline"><figcaption></figcaption></figure>

This action loads both the Session map chart and the timeline for that period, allowing you to analyze connections data during that time.

{% hint style="info" %}
Currently, dragging to select a period on the timeline does NOT update the timeframe picker at the top of the page. To align the displayed data with the selection in the timeframe picker, click the **Reset timeframe** button located above the **Connections timeline**.
{% endhint %}