# TB NAP Table

The TB NAP Table widget displays your NAP statistics in a table format — NAP names as rows and configurable metrics as columns. It supports color-coded thresholds, sparkline graphs, aggregation over time, and interactive sorting.

<figure><img src="https://1030294288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvb3mSIMfASX8vMnbtyli%2Fuploads%2Fgit-blob-d72dbce0270822a6688ef5d7366cfd378906356d%2Fnap-table-widget.png?alt=media" alt=""><figcaption><p>TB NAP Table showing NAP metrics at a glance</p></figcaption></figure>

***

## Adding the Widget

1. Edit a dashboard (or clone an existing one — see [cloning-a-dashboard](https://prosbcdocs.telcobridges.com/maas-documentation/customization/cloning-a-dashboard "mention"))
2. Click **Add widget**
3. Select **TB NAP Table** from the widget type list

***

## Widget Configuration

The configuration form is split into two areas: host/pattern filtering at the top and column configuration below.

### Host and Pattern Settings

<figure><img src="https://1030294288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvb3mSIMfASX8vMnbtyli%2Fuploads%2Fgit-blob-d2b5fb9e0b634d00ec3a623ed16732be0bca301f%2Fnap-table-config-a.jpg?alt=media" alt=""><figcaption><p>Host groups, tags, and NAP pattern configuration</p></figcaption></figure>

| Setting     | Description                                                    |
| ----------- | -------------------------------------------------------------- |
| Host groups | Select which host groups contain your NAP items                |
| Hosts       | Optionally narrow to specific hosts                            |
| Tags        | Filter items by tag                                            |
| NAP Pattern | Regex that extracts the NAP name and stat type from item names |
| Item Filter | Filter items by name pattern (default: `*` for all)            |

{% hint style="warning" %}
**NAP Pattern** is critical — it controls how the widget identifies NAP names from your monitored items. The default pattern `([a-zA-Z0-9_]+):\s*(.+)` expects item names in the format `NAPNAME: Stat Name`.

This means **the names you give your NAPs on your ProSBC or TMG matter**. Use clear, consistent naming (e.g., `TRUNK_CARRIER_A`, `SIP_PRIMARY`) that is easy to read and filter in the widget. Avoid spaces and special characters in NAP names.
{% endhint %}

### Column and Display Settings

<figure><img src="https://1030294288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvb3mSIMfASX8vMnbtyli%2Fuploads%2Fgit-blob-097d03ce9dbf4af1b83579aea9202049686a9bf6%2Fnap-table-config-b.jpg?alt=media" alt=""><figcaption><p>Column list, sort options, and row limit settings</p></figcaption></figure>

| Setting          | Description                                            | Default   |
| ---------------- | ------------------------------------------------------ | --------- |
| Columns          | List of stat columns to display (see below)            | —         |
| Sort column      | Which column to sort by on the backend                 | NAP Name  |
| Sort order       | Ascending or Descending                                | Ascending |
| Max rows         | Maximum number of NAP rows to display                  | 20        |
| Show host column | Show/hide a column identifying which host owns the NAP | Off       |

{% hint style="info" %}
You can click any column header in the live widget to sort interactively. This client-side sort resets when the widget auto-refreshes — use the **Sort column** setting for a persistent sort.
{% endhint %}

***

## Column Configuration

Click a column to edit it, or add a new one. Columns can be reordered by dragging.

<figure><img src="https://1030294288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvb3mSIMfASX8vMnbtyli%2Fuploads%2Fgit-blob-14da9cb44d1012ad6ef1e4fb4641a472ef6bc4e1%2Fnap-table-column-config.png?alt=media" alt=""><figcaption><p>Column edit popup with stat type, display mode, and threshold settings</p></figcaption></figure>

### Column Settings

| Setting        | Description                                                      |
| -------------- | ---------------------------------------------------------------- |
| Stat type      | Which NAP metric to display (see Available Stats below)          |
| Name           | Custom column header (auto-fills from stat type if left blank)   |
| Display mode   | **As Is** (raw value), **Bar**, **Indicators**, or **Sparkline** |
| Base color     | Default cell background color                                    |
| Thresholds     | Color thresholds for numeric values (e.g., green < 80, red > 95) |
| Regex patterns | Color patterns for text values (e.g., highlight "Down" in red)   |
| Decimal places | Number of decimal places for numeric display                     |
| Min / Max      | Range for Bar and Indicators display modes                       |

### Aggregation and Time Period

{% hint style="info" %}
**Aggregation** lets you display calculated values over a time window instead of the current real-time value. For example, you can show the **average** CPS over the **last 1 hour**, or the **maximum** call legs over the **last 24 hours**.

Each column can use either the **dashboard time period** (controlled by the time selector at the top of the dashboard) or a **custom time period** set per column. Use dashboard time when you want all columns to follow the same window. Use custom time when a specific column needs a fixed window regardless of the dashboard setting (e.g., always show last-hour max).
{% endhint %}

| Setting      | Options                                               |
| ------------ | ----------------------------------------------------- |
| Aggregation  | None, Min, Max, Avg, Sum, Count, First, Last          |
| Time period  | Dashboard time or Custom (with configurable duration) |
| History data | Auto, History, or Trends                              |

***

## Available Stats

The widget supports 27 stat types covering all NAP metrics:

| Category    | Stats                                                                   |
| ----------- | ----------------------------------------------------------------------- |
| Status      | Availability, Congestion, State, Usage, Registration State              |
| Call Legs   | Incoming Call Legs, Outgoing Call Legs, Total Call Legs                 |
| Call Counts | Incoming/Outgoing Call Count, Incoming/Outgoing Accepted/Answered Count |
| CPS         | Incoming/Outgoing CPS, Incoming/Outgoing Accepted/Answered CPS          |
| Quality     | Incoming MOS, Outgoing MOS                                              |
| Drops       | Local Drops, Remote Drops, System Drops                                 |
| Capacity    | Last Hour HWM, Last Hour Max Total Calls                                |

***

## Display Modes

| Mode       | Best for                                                           |
| ---------- | ------------------------------------------------------------------ |
| As Is      | Raw values — numeric or text. Use thresholds for color coding.     |
| Bar        | Visual capacity indicators (e.g., Availability, Usage)             |
| Indicators | Status dots with color thresholds                                  |
| Sparkline  | Mini trend graphs showing the metric over the column's time period |