# Individual NAP Statistics

Network Access Point (NAP) statistics provide per-trunk visibility into your voice traffic. MaaS auto-discovers all enabled NAPs and monitors each one individually.

***

## Supported NAP Types

MaaS monitors all NAP types:

| NAP Type | Protocol                     | Notes                            |
| -------- | ---------------------------- | -------------------------------- |
| SIP      | SIP over UDP/TCP/TLS         | Includes registration monitoring |
| H248 RTP | H.248/MEGACO (IP media)      | RTP port ranges                  |
| H248 TDM | H.248/MEGACO (TDM media)     | Line services                    |
| ISUP     | SS7 ISUP                     | CIC groups                       |
| ISDN     | Q.931 ISDN                   | PRI/BRI stacks                   |
| CAS      | Channel Associated Signaling | CAS stacks                       |

***

## NAP Status

| Statistic          | Type       | Description                                  |
| ------------------ | ---------- | -------------------------------------------- |
| **Availability**   | Percentage | Percentage of available resources (0-100%)   |
| **State**          | Status     | Overall NAP state (Up / Partially Up / Down) |
| **Usage**          | Percentage | Current resource utilization                 |
| **Congestion**     | Text       | Congestion status indicator                  |
| Registration State | Text       | SIP registration status (SIP NAPs only)      |

### NAP State Values

| Value                | Meaning                    |
| -------------------- | -------------------------- |
| Up (100%)            | All resources available    |
| Partially Up (1-99%) | Some resources unavailable |
| Down (0%)            | No resources available     |

***

## Call Metrics

Current real-time call counts for each NAP:

| Statistic              | Units     | Description                                  |
| ---------------------- | --------- | -------------------------------------------- |
| **Total Call Legs**    | Call Legs | Total active call legs on this NAP           |
| **Incoming Call Legs** | Call Legs | Current inbound call legs                    |
| **Outgoing Call Legs** | Call Legs | Current outbound call legs                   |
| **Incoming MOS**       | MOS       | Mean Opinion Score for inbound call quality  |
| **Outgoing MOS**       | MOS       | Mean Opinion Score for outbound call quality |

{% hint style="info" %}
MOS (Mean Opinion Score) ranges from 1.0 (poor) to 5.0 (excellent). A score below 3.5 typically indicates noticeable voice quality degradation.
{% endhint %}

***

## Call Counters (Per Interval)

These counters show call activity since the last polling interval.

### Call Attempts

| Statistic           | Direction | Description            |
| ------------------- | --------- | ---------------------- |
| Incoming Call Count | Incoming  | Inbound call attempts  |
| Outgoing Call Count | Outgoing  | Outbound call attempts |

### Accepted Calls

| Statistic         | Direction | Description             |
| ----------------- | --------- | ----------------------- |
| Incoming Accepted | Incoming  | Accepted inbound calls  |
| Outgoing Accepted | Outgoing  | Accepted outbound calls |

### Answered Calls

| Statistic         | Direction | Description             |
| ----------------- | --------- | ----------------------- |
| Incoming Answered | Incoming  | Answered inbound calls  |
| Outgoing Answered | Outgoing  | Answered outbound calls |

***

## CPS Metrics (Per NAP)

Calls per second calculated for each NAP:

| Statistic             | Direction | Description            |
| --------------------- | --------- | ---------------------- |
| Incoming CPS          | Incoming  | Inbound call rate      |
| Outgoing CPS          | Outgoing  | Outbound call rate     |
| Incoming Accepted CPS | Incoming  | Accepted inbound rate  |
| Outgoing Accepted CPS | Outgoing  | Accepted outbound rate |
| Incoming Answered CPS | Incoming  | Answered inbound rate  |
| Outgoing Answered CPS | Outgoing  | Answered outbound rate |

***

## Drop Statistics

Call drops categorized by cause:

| Statistic        | Description                        |
| ---------------- | ---------------------------------- |
| **Local Drops**  | Calls dropped by the local system  |
| **Remote Drops** | Calls dropped by the remote party  |
| **System Drops** | Calls dropped due to system issues |

Drop counters show the delta since the last interval and include a 10-minute heartbeat to reduce noise during idle periods.

***

## Calculated Statistics

MaaS calculates additional metrics for capacity planning:

| Statistic     | Description                               |
| ------------- | ----------------------------------------- |
| Last Hour Max | Maximum concurrent calls in the past hour |
| Last Hour HWM | Rolling high water mark                   |

***

## Alerts

### High Severity

| Alert                   | Condition            | Description                                 |
| ----------------------- | -------------------- | ------------------------------------------- |
| NAP Registration Failed | Registration ≠ "Yes" | SIP trunk lost registration (SIP NAPs only) |

### Warning Severity

| Alert          | Condition                  | Description                    |
| -------------- | -------------------------- | ------------------------------ |
| NAP Down       | Availability = 0%          | NAP has no available resources |
| NAP Congestion | Congestion status detected | NAP is experiencing congestion |

{% hint style="warning" %}
SIP Registration Monitoring: For SIP NAPs configured with outbound registration (`register_to_proxy` enabled), MaaS monitors the Registration State (Yes/No) and triggers a HIGH severity alert when registration fails. This is critical for detecting trunk failures with carriers that require registration.
{% endhint %}

***

## Understanding NAP Metrics

<details>

<summary>Call Legs vs Call Count</summary>

These two metric types measure different things:

* **Call Legs** (e.g. Incoming Call Legs, Total Call Legs): A **real-time snapshot** of active call legs right now. This value goes up when calls connect and down when calls end.
* **Call Count** (e.g. Incoming Call Count, Outgoing Call Count): A **cumulative counter** that increments with every call attempt. MaaS displays this as the delta per polling interval, showing how many new calls occurred since the last collection.

**Example:** If you have 50 active calls and 200 new call attempts in the last minute, Call Legs = 50 and Call Count (delta) = 200.

</details>

<details>

<summary>Availability vs Usage</summary>

* **Availability**: What percentage of resources *can* be used (health indicator)
* **Usage**: What percentage of resources *are* being used (load indicator)

A NAP can have 100% availability but low usage (healthy, light traffic) or high usage with declining availability (approaching capacity limits).

</details>

<details>

<summary>Drop Analysis</summary>

Comparing drop types helps identify issues:

* **High Local Drops**: May indicate configuration issues or resource exhaustion
* **High Remote Drops**: May indicate far-end issues or network problems
* **High System Drops**: May indicate system resource issues

</details>

<details>

<summary>Per-NAP CPS</summary>

Monitoring CPS per NAP helps identify:

* Which trunks are handling the most traffic
* Load imbalances between NAPs
* Traffic patterns for specific carriers or routes

</details>


---

# 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://prosbcdocs.telcobridges.com/maas-documentation/monitored-statistics/individual-nap-statistics.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.
