# Switches

### Overview

If your switches are recognised by Highlight, you can enable LAN switch monitoring to get a fast, detailed picture of how they are performing - traffic levels, health issues, and outages on every port, presented in a simple clear format. You can designate specific ports as 'critical' (for example, server connections) and Highlight will alert if these ports have problems.

### Collecting Data

Highlight collects two types of data from the switch:

1. #### At every poll on every port (typically every 5 minutes)
   * **Stability - State changes**

     Highlight detects any state change, essentially checking if a port is down
   * **Load - Traffic levels**

     In and out, calculated as a percentage of port speed with 80% as the threshold value
   * **Health - Error frequency**

     Reported as errors per 1000 packets. What constitutes an error varies by vendor but usually is a mix of low-level errors (framing, duplex, bad-sized packets etc.) and Layer 2 errors (CRC checks). For more information consult the individual vendor documentation. Errors are normally caused by faulty cabling or a faulty switch port.
2. #### Once an hour on every port

   Highlight collects the following every hour to update basic data on the switch:

   * Port Name: as configured on the switch as the description
   * Port State: up or down and the length of time it has been up or down
   * Port Speed: normally 10M / 100M / 1G bps

   This information is used on the Technical Details page and pop-up, see section below.

{% hint style="info" %}
**Update interval**\
This information is not real-time and so will only update in the UI at the same interval as data is collected, i.e. per hour.
{% endhint %}

{% hint style="info" %}
**Data Retention**\
By default, switch data for display on the Details page is retained for 3 months.
{% endhint %}

### Slot Summary

See [the Switch Slots page.](/details/other-watch-types/switch-slots.md)

### Port Summary

{% hint style="info" icon="eyes" %}
Find out which slots are running low on available ports by running a [Switch Port Capacity report.](/reporting/network-reports/suggested-reports.md#switch-port-capacity-report)
{% endhint %}

The upper part of the Details page shows a summary of every port on the switch. For all time periods (day, week or month) the summary shows:

* any issues as stability, load or health
* the severity or frequency of any issues

<figure><picture><source srcset="/files/i9yeXKU8lyNLNqdZueYO" media="(prefers-color-scheme: dark)"><img src="/files/9rjQa4trD2uc7xxmHp2P" alt="Switch Port Summary"></picture><figcaption></figcaption></figure>

#### Today: Live Status

When **Today** is selected a live status is shown as a coloured square behind the port number. This status is obtained by the poller every 5 minutes. The colours mean:

Green: the port is live

Amber: the live status is unavailable due to issues obtaining details; all ports will show as amber

Red: critical port is down, red is only used for critical ports

Grey:  non-critical port is down, idle or unused, grey is only used for non-critical ports

White circle:  indicates a port that was idle, unused or down throughout the selected time period - a useful way to spot ‘free’ ports on a switch

Green circle:  indicates an active port; the marker will remain green for each metric (stability, load, health) unless certain conditions occur, further details below

***

#### Stability:

{% hint style="info" %}
Stability is only shown on critical ports. Non-critical ports may be inactive for long periods so stability is not a relevant metric.
{% endhint %}

Amber circle:  For each poll within the selected time period, Highlight detects any state change, essentially checking if a port is down.

Red circle:  indicates port was down for at least one sample in the time period indicates port was down for 10% or more of samples in the period

#### Load:

Amber circle:  For each poll within the selected time period, Highlight detects load greater than the threshold value and then counts how many instances of excessive load occur. The threshold is 80%.

Red circle:  indicates port load was > threshold on 5% - 50% of the samples in the time periodindicates port load was > threshold on 50% or more of the samples in the time period

#### Health:

Amber circle:  For each poll within the selected time period, Highlight detects any errors.

Red circle:  indicates port error rate was >0 for 0.5% - 5% of the samples in the time periodindicates port error rate was >0 for 5% or more of the samples in the time period

**Special case**

If all samples for a port return **Port down** for the period requested, then Stability, Load and Health all display as white

**Alias or interface name**

Hovering over an individual port will show a tooltip with that port’s alias or interface name, if one has been configured on the switch; otherwise the tooltip will show the interface name. If neither the alias nor the interface is available, the port number is shown.

**Critical ports**

Clicking on an individual critical port will scroll to and expand a chart for that port for the selected time period. Each chart is labelled with the slot and port number,and alias or interface name, if available.

### Port Summary Filter on All/Active/Critical

<figure><picture><source srcset="/files/trWldhVRRRIM6WU9EEJg" media="(prefers-color-scheme: dark)"><img src="/files/JL847IUIw2BiPqmquRNc" alt="Switch port filters: All, Active and Crticial GIF"></picture><figcaption><p>Switch port filters: All, Active and Crticial GIF</p></figcaption></figure>

**All:**  This is the default option. All ports are shown.

**Active:**  This includes active and critical ports.\
Active means the port had data within the selected time period (day, week or month).

**Critical:**  Only ports which have been designated as critical are shown.

{% hint style="info" %}
&#x20;The filter setting will be remembered when you next log in.
{% endhint %}

### Technical Details

Clicking the Tech info on the Details page shows the information Highlight has on this switch. As outlined in the collecting data from the switch section above, Highlight collects this information on an hourly basis to reduce management traffic overhead. The date / time of the last collection for this switch as **Last Checked** in the list.&#x20;

In [Admin, Edit Watch, on the Features tab for the switch,](https://support.highlight.net/help/admin/switches) use Set Critical Port&#x20;

#### Port information

For switches, a summary for each slot is shown with the total number of ports and how many are idle and unused. Then each port on the device is listed with the following information:

**Critical:**  whether this port is marked as critical in Highlight, meaning it will affect heat tiles and generate alerts

**Slot:**  a number

**Port:**  a number

**Interface:**  the name used on the device to reference that port

**Alias:**  the description configured on the interface, if any

**Speed:**  the current speed of this port; some switches return ‘Unknown’ if the port is not in use

**State:**  state of the port and the length of time it has been in this state. The description of port states are as follows:

**Up:**  port is active

**Down:**  changed state from Up in the last 48 hours

**Unused:**  most recent state changed within 10 minutes of system power up

**Idle:**  a previously used port that has been inactive for over 48 hours

### Critical Ports

<figure><picture><source srcset="/files/xem87mZQVrrvFamdMi5k" media="(prefers-color-scheme: dark)"><img src="/files/na8fCql85BTZBLPn70Ai" alt="Switch Critical Port Chart"></picture><figcaption></figcaption></figure>

For the switch, this panel shows a chart for each critical port designated in Highlight. Only critical ports can change the colour of a heat tile and generate an alert email or webhook. Charts are labelled with the slot and port number and that port’s alias or interface name, if one has been configured on the switch. Critical ports are also indicated by a blue background marker in the Port Summary panel.

{% hint style="danger" %}
A port that is disabled behaves the same as if the port is down (red blips etc.)
{% endhint %}

***

#### Stability

**Stability** blip line is shown as a grey line if unavailable or a thicker green line if up. Hover on the chart to see timestamp and precise values.

| Colour    | Grey line | Green line     | Red blip  |
| --------- | --------- | -------------- | --------- |
| Stability | No data   | Receiving data | Port down |

***

#### Load

**Load** has two blip lines for in and out. A grey line is shown if unavailable or a thicker green line up to 50%. Hover on the chart to see timestamp and precise values. Above 50% it's shown in coloured blips:

<table><thead><tr><th width="81">Colour</th><th width="91">Grey line</th><th width="111">Green line</th><th width="113">Green</th><th width="119">Amber</th><th width="116">Orange</th><th>Red</th></tr></thead><tbody><tr><td>Load</td><td>No data</td><td>0% to 50%</td><td>51% to 65%</td><td>66% to 80%</td><td>81% to 95%</td><td>96% to 100%</td></tr></tbody></table>

***

#### Health

**Health** blip line shows coloured blips according to the severity of the line drops and errors detected on the port. Hover on the chart to see timestamp and precise values. Coloured blips indicate approximate values:

<table><thead><tr><th width="87">Colour</th><th width="86">Grey line</th><th width="89">Green line</th><th width="72">Green</th><th width="108">Amber Green</th><th width="80">Amber</th><th width="88">Orange</th><th width="85">Red</th><th>Maroon</th></tr></thead><tbody><tr><td>Health</td><td>No data</td><td>0</td><td>1</td><td>2 - 11</td><td>12 - 23</td><td>24 - 52</td><td>53 - 74</td><td>75 - 100</td></tr></tbody></table>

#### Related information

With admin privileges see how you [enable critical ports](https://support.highlight.net/help/admin/switches)

See next section for how critical ports affect heat tiles and generate alerts.

### How critical ports affect heat tiles and generate alerts

Only switch ports selected as critical can change heat tiles and generate alerts. If you have admin privileges you can [enable a port as critical](https://support.highlight.net/help/admin/switches) by using Set Critical Port  [in Admin, Edit Watch, on the Features tab for the switch](https://support.highlight.net/help/admin/switches) or via the [Controllers Admin page, Edit watch, Critical Ports tab](https://support.highlight.net/help/admin/sdwan_items#edit_watch_critical_ports_tab).

#### Sensitivity settings

Heat tiles and alerts are controlled by sensitivity settings which are configurable by admin users with the permission **Manage folders/locations**. Find out more about [the sensitivity of heat tiles](https://support.highlight.net/help/admin/heat_tiles_sensitivity). For the example here, we assume the following settings:

<figure><picture><source srcset="/files/bmuZdGh9lmwqOAIr0wWR" media="(prefers-color-scheme: dark)"><img src="/files/Gl9nXgSMhbmkGgrmbe5s" alt="Ssensitivity settings"></picture><figcaption><p>Sensitivity settings for the example below</p></figcaption></figure>

#### Thresholds

The tables below show how each metric changes a heat tile and generates an alert (if one has been set up) based on the sensitivity settings in the previous image.

Table below shows turning from green to amber and eventually red:

<table><thead><tr><th width="96">Metric</th><th>Example condition for bad sample</th><th>Samples to turn from green to amber</th><th>Samples to red</th></tr></thead><tbody><tr><td>Stability</td><td>Port is down</td><td>2</td><td>2 more; 4 in total</td></tr><tr><td>Load</td><td>>60%</td><td>5</td><td>5 more; 10 in total</td></tr><tr><td>Health</td><td>Errors per 1000 frames rate >1;</td><td>10</td><td>10 more; 20 in total</td></tr></tbody></table>

Table below shows returning back from red to amber and eventually green:

<table><thead><tr><th width="98">Metric</th><th>Example condition for good sample</th><th>Samples to turn from red to amber</th><th>Samples to green</th></tr></thead><tbody><tr><td>Stability</td><td>Port is up</td><td>3</td><td>3 more; 6 in total</td></tr><tr><td>Load</td><td>≤60%</td><td>6</td><td>6 more; 12 in total</td></tr><tr><td>Health</td><td>Errors per 1000 frames rate ≤1</td><td>12</td><td>12 more; 24 in total</td></tr></tbody></table>

### Supported Manufacturers

Refer to our [Switch functionality page](https://support.highlight.net/help/functionality/switches) for details of manufacturers supported.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.highlight.net/details/other-watch-types/switches.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
