> For the complete documentation index, see [llms.txt](https://help.highlight.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.highlight.net/admin/pending-snmp/create-watch-snmp.md).

# Create Watch SNMP

## Overview

This page explains how to add individual watches into Highlight.

For service providers with a requirement to add multiple watches (10 or more) there is an alternative process which is explained on the [bulkloading watches page](/functionality/bulkloading.md).

Find out more about [pending watches](/admin/pending-snmp.md).

## Create a watch

Select the point in the Network Explorer tree (or using Admin) where the new watch will be created. This must be a location or a folder which contains one or more locations.

To create a new watch from Admin Pending, click "**+ Create Watch"**

The Edit Pending Watch dialog is used to edit a watch before it is made live. The path to the folder is shown along with the group (if applicable). There are 5 areas:

1. Main
2. Technical
3. Test Results (visible immediately after a test only)
4. Watch Status (visible after a test and the watch has been saved and reopened)
5. Progress Log (visible after a test and the watch has been saved and reopened)

**Save** — It's possible to save the details at any point. You can return to this dialog at any time to complete the process.

## 1. Main

<figure><picture><source srcset="/files/3bJSS07pt5guYhwJ6Clh" media="(prefers-color-scheme: dark)"><img src="https://25768351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68Wb63XzG9guH74bkPEb%2Fuploads%2FCGSHIyzN92lS36R62aH9%2FCreateWatchMainTechnical%20-%20light.png?alt=media&amp;token=b31f56d9-eee2-4285-99ee-d22e13b8241e" alt="Create Watch Main Technical"></picture><figcaption></figcaption></figure>

<table><thead><tr><th width="134">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Watch Name</strong></td><td>Required. Uniquely identifies the watch. Maximum 100 characters. Valid characters: <code>A-z 0-9 . - _ + ! $ # @ =</code>.</td></tr><tr><td><strong>Location</strong></td><td>Select the required location from the drop-down list if it is not already displayed.</td></tr><tr><td><strong>Description</strong></td><td>Optional. Displays in Highlight instead of the watch name.</td></tr><tr><td><strong>Watch Type</strong></td><td>Available bandwidth options change with the selected type. See the table below.</td></tr><tr><td><strong>Product Type</strong></td><td>Optional text field, limited to 20 characters. Service providers can display a service name instead of the Highlight default, such as FTTC instead of ADSL.</td></tr><tr><td><strong>Bandwidth</strong></td><td>See the table below.</td></tr><tr><td><strong>Reference</strong></td><td>Optional. Use for customer-specific information, such as a purchase order.</td></tr></tbody></table>

### Allow any bandwidth

*Choose bandwidth from drop-down list or enter any value*

Both bandwidth fields are required. Start typing and select a bandwidth from the displayed list. Alternatively enter any whole number with one of the following units:

* **b/B**: bits per second
* **k/K**: kilobits per second
* **m/M**: megabits per second
* **g/G**: gigabits per second
* **t/T**: terabits per second

<table><thead><tr><th>Watch Type</th><th width="168">Bandwidth 1</th><th width="162">Bandwidth 2</th></tr></thead><tbody><tr><td>Leased Line (Dedicated Access, Ethernet)</td><td>Bandwidth</td><td>On bearer of</td></tr><tr><td>Leased Line + Class of Service (MPLS)</td><td>Bandwidth</td><td>On bearer of</td></tr><tr><td>Multilink/Bonded</td><td>Bandwidth</td><td>On bearer of</td></tr><tr><td>Asymmetric Line</td><td>Downstream</td><td>Upstream</td></tr><tr><td>ADSL Max</td><td>Downstream</td><td>Upstream</td></tr><tr><td>SDSL</td><td>Downstream</td><td>Upstream</td></tr><tr><td>Broadband Clarity</td><td>Downstream</td><td>Upstream</td></tr></tbody></table>

## 2. Technical

The options available in this section will change based on which protocol (SNMPv2 or SNMPv3) is selected. It's possible to save the watch without completing this section but it will not be possible to test nor activate it.

These fields are common between all protocols:

* **Device IP** — the device IP address
* **Selected Interface** — if an interface has previously been selected, it will be shown

### SNMP v1

If your device only supports SNMPv1, select SNMPv2 and Highlight will fall back to using the older protocol when it finds that SNMPv2 doesn't work.

### SNMP v2

*Create Watch Technical SNMPv2c*

* **Community String** — can contain any characters except spaces

### SNMP v3

*Create Watch Technical SNMPv3*

* **Username** — must be between 8 and 32 characters and may not contain `,` `'` or `"`
* **Auth protocol** — MD5 (default) or SHA1
* **Auth key** — must be between 8 and 32 characters and may not contain `,` `'` or `"`
* **Priv protocol** — DES (default) or AES 128
* **Priv key** — must be between 8 and 32 characters and may not contain `,` `'` or `"`

**Test** — After all options are completed, the watch can be tested.

## 3. Test Results

After clicking **Test** you may briefly see the message *Testing...*

<figure><picture><source srcset="/files/nIkovlODGOuKkp90u6DA" media="(prefers-color-scheme: dark)"><img src="https://25768351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68Wb63XzG9guH74bkPEb%2Fuploads%2FQdm6xSRebC5Dqniw8mmm%2FCreateWatchChooseInterface%20-%20light.png?alt=media&amp;token=fc3b45df-20e9-498e-af42-db81187a0bb1" alt="Create Watch Choose Interface"></picture><figcaption><p>Create Watch Choose Interface</p></figcaption></figure>

After a successful test, you will be prompted to choose an interface (it's also possible to save the watch without choosing an interface). Immediately after interface selection, you will see *Test successful*.

Clicking on **Details** will show additional details related to the test. Example Details:

```
// System Information
Cisco IOS Software, 3700 Software (C3725-ADVENTERPRISEK9-M), Version 12.4(15)T14, 
RELEASE SOFTWARE (fc2) Technical Support: http://www.cisco.com/techsupport 
Copyright (c) 1986-2010 by Cisco Systems, Inc. Compiled Tue 17-Aug-10 12:08 by prod_rel_team
SAA version : 2.2.0 Round Trip Time MIB. SAA capacity 22949. Write is Disabled.
```

After clicking **Save**, if you then edit the watch, Watch Status and Progress Log will now be visible.

{% hint style="info" %}
The interface list for Draytek devices may contain duplicate names. The interface number will be displayed as a suffix to distinguish between them, for example: WAN2 \[5]. Select the lowest interface number.
{% endhint %}

## 4. Watch Status

<figure><picture><source srcset="/files/9SD4CLHuoV8LWxuKfNOb" media="(prefers-color-scheme: dark)"><img src="https://25768351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68Wb63XzG9guH74bkPEb%2Fuploads%2FuxZbMDbxazD9MZ5N6tnG%2FCreateWatchStatusProgressLog%20-%20light.png?alt=media&amp;token=a987514b-6892-4426-9be1-ba6b4ea15ff8" alt="Create Watch Status Progress Log"></picture><figcaption></figcaption></figure>

**Order Management** has two possible states which can be changed by those who have the security privilege Approve New Watches checked in the Add/Edit User dialog:

* Approved
* Not Approved

**Technical Test** has three possible states in this dialog:

* Test successful
* Test failed
* Interface not selected — meaning no interface was selected following a successful test or no interfaces were listed for selection

Test in progress, meaning the test has started but not yet completed, is only seen when testing more than one watch so will not appear in this dialog.

## 5. Progress Log

This is a list of automatically added events such as:

* Circuit added
* Circuit details changed
* Approved by order management
* Technical test succeeded/failed
* Interface selected

**Add Entry** — Use to add your own comment.

Times are in UTC.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.highlight.net/admin/pending-snmp/create-watch-snmp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.