# Control Host Statistics

MaaS monitors the health and performance of your TMedia host servers and individual application processes. For 1+1 redundant deployments, each host is monitored separately with role identification.

***

## Host Status

| Statistic             | Type  | Description                                                                                          |
| --------------------- | ----- | ---------------------------------------------------------------------------------------------------- |
| **Host State**        | Text  | Operational state (Up/Down)                                                                          |
| **Host Name**         | Text  | Configured hostname                                                                                  |
| **Role**              | Text  | Primary or Secondary (for 1+1)                                                                       |
| **Serial Number**     | Text  | Hardware serial number                                                                               |
| **OAM State**         | Text  | Host OAM operational state                                                                           |
| Firewall Status       | Text  | Whether TBRouter firewall is enabled                                                                 |
| Reboot Required       | Text  | Whether a reboot is pending                                                                          |
| Scheduling Problem    | Count | Number of scheduling issues detected                                                                 |
| License Expired       | Text  | License expiration status                                                                            |
| License Expiring Soon | Text  | License approaching expiration                                                                       |
| Firmware Version      | Text  | Current software version                                                                             |
| Firmware Upgrade      | Text  | Firmware upgrade status (from [Upgrade Manager](/maas-documentation/maintenance/upgrade-manager.md)) |
| Dump Files            | Count | Core / crash dump files present on the host                                                          |

***

## Host Performance

| Statistic            | Units | Description                       |
| -------------------- | ----- | --------------------------------- |
| **CPU Usage**        | %     | Overall CPU utilization           |
| **RAM Usage**        | %     | Memory utilization                |
| **File System Used** | %     | Disk space utilization            |
| File System Free     | %     | Available disk space (calculated) |

***

## Ethernet Port Statistics

{% hint style="info" %}
Ethernet port monitoring is currently available for ProSBC deployments. TMG support is coming soon.
{% endhint %}

MaaS monitors the physical Ethernet ports on each host:

| Statistic            | Units  | Description                       |
| -------------------- | ------ | --------------------------------- |
| **Ethernet Port Up** | Binary | Port operational status (Up/Down) |
| Received Bytes       | Bytes  | Total bytes received on the port  |
| Received Errors      | Count  | Receive errors on the port        |
| Sent Bytes           | Bytes  | Total bytes sent on the port      |
| Sent Errors          | Count  | Transmit errors on the port       |

***

## IP Interface Statistics

{% hint style="info" %}
IP interface monitoring is currently available for ProSBC deployments. TMG support is coming soon.
{% endhint %}

MaaS monitors IP interfaces configured on each host:

| Statistic             | Units | Description                   |
| --------------------- | ----- | ----------------------------- |
| **Availability**      | Text  | Interface availability status |
| **Link Status**       | Text  | Physical link state           |
| Received Bytes/s      | Bps   | Incoming data rate            |
| Received Packets/s    | pps   | Incoming packet rate          |
| Transmitted Bytes/s   | Bps   | Outgoing data rate            |
| Transmitted Packets/s | pps   | Outgoing packet rate          |

***

## Application Statistics

MaaS monitors individual application processes running on each host, including **per-application HA state** for 1+1 deployments.

### Application Metrics

| Statistic       | Type | Description                                                                         |
| --------------- | ---- | ----------------------------------------------------------------------------------- |
| **App State**   | Text | Application operational state                                                       |
| **HA State**    | Text | Per-application high availability state                                             |
| **Core App HA** | Text | HA state of core applications (gateway, tbsip, tbrouter). Drives switchover alerts. |
| **App CPU**     | %    | Per-application CPU usage                                                           |

### Common Applications Monitored

| Application             | Internal Name           | Description                   |
| ----------------------- | ----------------------- | ----------------------------- |
| Toolpack System Manager | toolpack\_sys\_mgr      | Core system management        |
| TBOAM App               | tboam\_app              | OAM application               |
| SNMP Agent              | tbsnmpagent             | SNMP interface                |
| Stream Server           | stream\_server          | Media streaming               |
| TB Router               | tbrouter                | Firewall/routing (if enabled) |
| MySQL                   | mysqld                  | Database server               |
| Ruby                    | ruby                    | Web interface                 |
| SNMP Daemon             | snmpd                   | SNMP service                  |
| Sig Trace               | tbsigtrace              | Signaling trace               |
| CLI Tools               | tbx\_cli\_tools\_remote | Remote CLI                    |
| IP Watchdog             | ipwatchd                | IP monitoring                 |
| KNI Single              | kni\_single             | Kernel network interface      |

***

## Alerts

### High Severity

| Alert              | Condition          | Description                       |
| ------------------ | ------------------ | --------------------------------- |
| Host Down          | State ≠ "Up"       | Host is not operational           |
| File System 95%    | Disk > 95%         | Critical disk space               |
| App CPU 95%        | 5-min avg > 94%    | Critical application CPU usage    |
| RAM Usage 95%      | RAM > 95%          | Critical memory usage             |
| Ethernet Port Down | Port status = Down | Physical Ethernet port is offline |

### Average Severity

| Alert                       | Condition             | Description                             |
| --------------------------- | --------------------- | --------------------------------------- |
| File System 80%             | Disk > 80%            | Elevated disk usage                     |
| App CPU 80%                 | 15-min avg > 79%      | Elevated application CPU usage          |
| Scheduling Problem          | Scheduling issues > 0 | Host has scheduling problems            |
| Firewall Scheduling Problem | Firewall issues > 0   | Firewall has scheduling problems        |
| Dump File Detected          | Dump files > 0        | A core or crash dump is present on disk |

### Information Severity

| Alert                       | Condition                 | Description                                     |
| --------------------------- | ------------------------- | ----------------------------------------------- |
| RAM Usage 80%               | RAM > 80%                 | Elevated memory usage                           |
| Reboot Required             | Reboot pending = True     | Host requires a reboot                          |
| Core Application Switchover | Core App HA state changed | A core application switched Active/Standby role |

***

## Understanding HA States

For 1+1 redundant deployments, application HA states indicate:

| State       | Meaning                                                   |
| ----------- | --------------------------------------------------------- |
| Active      | Application is handling traffic                           |
| Standby     | Application is ready for failover                         |
| Initialized | Application has started and is coming online              |
| Ready       | Application is operational but not yet carrying traffic   |
| Not Present | Application is not installed or not expected on this host |
| Not Ready   | Application is not in a ready state                       |

<details>

<summary>Core Application HA Tracking</summary>

MaaS tracks **Core Application HA** — the HA state of the applications that actually carry your traffic (gateway, tbsip, tbrouter, and others). When any of these flips between Active and Standby, a Core Application Switchover notification fires so your team knows traffic has moved units.

This is distinct from generic App State — a process can be running (App State = Up) while still being Standby. Core App HA tells you which unit is actually handling calls.

</details>

<details>

<summary>HA Failover Behavior</summary>

In a 1+1 deployment, MaaS monitors both hosts independently. During a failover:

* The previously Active host transitions applications to Standby or Not Ready
* The previously Standby host transitions applications to Active
* MaaS continues monitoring both hosts throughout the transition
* A Core Application Switchover notification is sent

Monitor the standby host — issues there will become problems during failover.

</details>

***

## Troubleshooting

{% stepper %}
{% step %}

#### High Host CPU

Check per-application CPU to identify the culprit. Common causes include high call volume, media transcoding, and logging overhead.
{% endstep %}

{% step %}

#### High RAM Usage

Memory issues may indicate memory leaks (check application states), insufficient resources for call volume, or logging/caching issues.
{% endstep %}

{% step %}

#### Disk Space Issues

Common causes of disk space consumption: CDR/log accumulation, core dumps, and signaling traces.
{% endstep %}
{% endstepper %}


---

# 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/control-host-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.
