# Container

## Overview

<figure><img src="https://25768351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68Wb63XzG9guH74bkPEb%2Fuploads%2FEvA3npEbco69UMdvQqRU%2FWhatisaContainer.png?alt=media&#x26;token=1046ee75-8566-4598-88cd-3e2be00bc2bc" alt=""><figcaption></figcaption></figure>

A container is a flexible grouping of watches. Any watches available under the container's position in the tree can be added. Once created, a container can be:

* Displayed as a service tile
* The basis of a report
* Set for recurring or one-off maintenance
* Displayed as a column on the Grid (showing the status of performance tests only)

{% hint style="info" %}
**Permission needed:** Edit watches (to show a container as a heat tile on the Status page) or Manage maintenance (to set a container as a maintenance window). If you have both permissions, you will see three tabs: Watches, Tile and Maintenance.
{% endhint %}

***

## Create and Edit a Container

Select the relevant folder from the Network Explorer panel.

From the Admin page,  **+** then **Create new Container**.

The three fields of Name, Description and Logo are available from both the Watches and Tile tabs.

<table data-header-hidden><thead><tr><th width="124"></th><th></th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>Enter the container name (a required field), which may be up to 100 characters and must be unique in the folder. The name will be displayed for a watch during a period of maintenance defined by this container.</td></tr><tr><td><strong>Description</strong></td><td>This is an optional field, displayed in Highlight in place of the container name and limited to 100 characters.</td></tr><tr><td><strong>Logo</strong></td><td>See the currently applied logo or click to change it. See the Logo Management section below for full details.</td></tr><tr><td><strong>Visibility</strong></td><td>This option (only shown if you are a service provider) determines if the container/service tile is visible to all users, or just to service provider internal staff. There are two options: <strong>Customer:</strong> anyone can see the container. <strong>Internal:</strong> only internal service provider users can see the container (this is the default).</td></tr><tr><td><strong>Audit comment</strong></td><td>Click this button to record a comment in the Audit log against updates for this container. An input box expands to the left and comments can be up to 200 characters. The button remains bright blue if a comment has been added but the container not yet saved.</td></tr><tr><td><strong>Save</strong></td><td>Stores details for all sections.</td></tr><tr><td><strong>Delete</strong></td><td>Only available from the Watches tab and deletes the container. <em>(Edit only)</em></td></tr><tr><td><strong>Duplicate</strong></td><td>Only available from the Watches tab and copies the container name ("Name - copy"), description and full list of watches. <em>(Edit only)</em></td></tr></tbody></table>

{% hint style="info" %}
The duplicate container does not include any settings from the Maintenance tab.
{% endhint %}

***

## Logo Management

A container can be customised to show a logo of your choice. If a container is also a service tile, this makes the tile instantly recognisable on the Status Heat Tiles page.

Click the **Logo Management** button to open the Logo Management dialog.

This dialog enables you to:

* Manage the logo library (upload new icons and replace existing icons)
* Apply a logo to a service tile

### Logo Requirements

* **Dimensions:** 300 pixels wide by 62 pixels high
* **Size:** 250 KB or less
* **Format:** PNG or JPG

[Contact us](https://help.highlight.net/getting-started/contact-us) for assistance with dimensions, size or format.

### Manage Logo Library

#### Upload a Logo

1. Click **Add new**
2. Navigate to the file on your network
3. Select the logo
4. Click **Open** to complete the upload

#### Replace a Logo

1. Select the logo to be replaced in the library (marked with a pale blue indicator)
2. Click **Replace**
3. Navigate to the replacement file on your network
4. Select the logo
5. Click **Open** to complete the replacement

Repeat these steps as necessary.

### Apply a Logo

If the logo you want to use is already in the library, select it (a pale blue indicator shows your selected logo) and click **Apply**.

If the logo you want to use is not in the logo library or needs to be updated, follow the steps above to upload or replace it first.

***

## Watches — Main Panel

The main panel is divided into three columns: Folder or location; Available watches; Included watches.

### Folder or Location (Left Panel)

To add watches to a container, first select a folder or location. All the watches beneath that folder or location will appear in the middle panel, so you can choose which ones to add.

### Available Watches (Middle Panel)

Click the add button to add a single watch, or click **Add X** to add the results of any filtering.

### Included Watches (Right Panel)

See a list of all watches currently included in this container. Use the remove button to remove one, or click **Remove X** to remove the results of any filtering. Changes are not stored until you click **Save**.

{% hint style="info" %}
A container used for maintenance will include subwatches by default (for example VLANs).
{% endhint %}

### Filtering (Middle and Right Panels)

You can filter the lists in the middle or right panel.

The chevron opens the filter panel. It turns bright blue to indicate settings have changed from the defaults and that filters are still active.

**Search watches:** Enter text to select watches whose name or description contain that string (case is ignored). You can also search on device address (IP address or hostname) and test name.

**X of Y results:** Y is the total watches available in the folder or location selected in the left panel. X is adjusted according to any filters which have been applied.

**Add X + / Remove X -:** Add or remove the filtered list of watches.

Watch type icons can be toggled — clicking a white icon turns it grey and excludes those watch types from the list:

* Bearers
* Classes, multilinks and VLANs
* SD-WAN tunnels
* Performance tests
* Wireless Access Points
* Switches

{% hint style="info" %}
**Notes:**

* The middle and right panels show a maximum of 200 watches, though it is possible to add more than 200. Add X + and Remove X - show what can be added or removed.
* To add a Meraki switch or a performance test under a SD-WAN tunnel, add the parent watch.
  {% endhint %}

***

## Tile

{% hint style="info" %}
**Permission needed:** Edit watches
{% endhint %}

Use this tab to enable a container to appear as a service tile on the Status Heat Tiles page, Services section.

Name, Description, Logo and Visibility are explained above in the [Create and Edit a Container](#create-and-edit-a-container) section.

**Show as tile:** Enable or disable this container to appear as a service tile.

**Tile preview:** A preview of the tile is shown using the description (if available) or name and logo (if available). The preview is greyed out if the tile is disabled.

### Colour Change Thresholds

Use either the sliding bar or the percentage input boxes to set the points at which this tile changes to amber and red. The number of watches which match each percentage are shown on the slider. Default values are 25.000% for amber and 75.000% for red. This means that 25% of all the watches linked to this container must be in a red state to turn the service tile amber.

{% hint style="info" %}
Watches in an amber state do not count towards this percentage — only those in a red state.
{% endhint %}

### Stability, Load and Health Metrics

The service tile shows stability, load and health indicators. These change colour using the same percentages as the overall tile. For example, if the amber setting is 25% and red is 75%, then the load icon remains green until there are 25% or more red load issues, at which point it turns amber. It reverts to green if the percentage drops below 25%, and turns red if the percentage of red load issues exceeds 75%.

Read more about [service tiles](https://help.highlight.net/status/network/heat-tiles#service-tiles).

***

## Grid

{% hint style="info" %}
**Permission needed:** Edit watches
{% endhint %}

**Show as App Test column:** Enable or disable this container to appear as a column in the Grid.

When enabled, this container appears as an App Test column in the Grid on the Status page. The live state of performance tests in the container is represented by a cell in the Grid, with each cell representing a different location or folder.

{% hint style="warning" %}
Only performance tests (with "Show Data" checked on the parent watch) are included in the column, even if the container includes other watches.
{% endhint %}

Visibilty (on the Main tab and only shown if you are a service provider) determines if the container as a grid column is visible to all users, or just to service provider internal staff.&#x20;

<table><thead><tr><th width="161">Visbility setting</th><th>If Show as App Test column is enabled then...</th></tr></thead><tbody><tr><td>Customer</td><td><p><strong>This column will be available to customers</strong>  </p><p>To hide the column change visibility setting on the Main tab to "Internal"</p></td></tr><tr><td>Internal</td><td><p><strong>This column will not be available to customers</strong></p><p>To make it visible, change visibility setting to on the Main tab "Customer"</p></td></tr></tbody></table>

Read more about [App Tests in Grid view](https://help.highlight.net/status/network/grid-view#app-tests-in-the-grid).

***

## Maintenance

{% hint style="info" %}
**Permission needed:** Manage maintenance
{% endhint %}

Use this tab to enable and schedule a maintenance window on a container. Watches in maintenance do not send alerts, change the colour of heat tiles, or decrement availability figures.

<table data-header-hidden><thead><tr><th width="141"></th><th></th></tr></thead><tbody><tr><td>Maintenance</td><td>Enable or disable a maintenance window on this container</td></tr><tr><td>Summary message</td><td><p></p><p>Top right, a message shows the current schedule, for example:</p><ul><li><code>One time only 18:00 on Fri 20 Dec 2019 - 21:00 on Sun 22 Dec 2019</code></li><li><code>Recurs 02:00 - 04:00 every day</code></li></ul></td></tr><tr><td>Repeat</td><td><p>Recurring maintenance windows start on save and continue indefinitely unless disabled or the container is deleted. Repeat options are:<br></p><ul><li><strong>One time only:</strong> Set start and end dates and times in UTC</li><li><strong>Daily:</strong> No other selections needed</li><li><strong>Weekly:</strong> Choose a day of the week</li><li><strong>Monthly:</strong> Choose either a day from 1–28, or a combination such as the third Sunday</li></ul></td></tr></tbody></table>

{% hint style="info" icon="calendar-check" %}
To avoid potentially skipping months, maintenance windows cannot be set to repeat on the 29th, 30th or 31st day of a month.
{% endhint %}

**Start/End:** Add times in UTC; add dates for one-time-only maintenance windows. To set recurring maintenance spanning midnight, add an end time for the next day. The summary will show the period, which cannot exceed 24 hours — for example: `Recurs 22:00 - 02:00 every Saturday`.

**Duration:** Shows in days (d), hours (h) and minutes (m). Recurring maintenance windows cannot exceed 24 hours.

**Subwatches:** Autodiscovered watches such as classes of service, VLANs and WAPs, or created watches such as performance tests, are all "subwatches." By default, these are automatically placed in maintenance when the parent bearer is in maintenance. Uncheck to exclude subwatches from maintenance. To exclude only some subwatches, uncheck here to exclude all, then return to the Watches tab and add back those subwatches that should be in maintenance.

**Auto-deletion:** Automatically delete this container 24 to 48 hours after the maintenance window finishes. This option is available for **one time only** maintenance windows which are not also service tiles, and is disabled for all other scenarios. When available, this is checked by default; uncheck to prevent deletion. Containers can be manually deleted at any time.