# IP Pool Schema Statistics

The IP Pool schema provides operational statistics that can be used for monitoring and troubleshooting the following products: GGSN, HSGW, P-GW
This schema provides the following types of statistics:

- Counter: A counter records incremental data cumulatively and rolls over when the counter limit is reached. All counter statistics are cumulative and reset only by one of the following methods: roll-over when limit is reached, after a system restart, or after a clear command is performed. The limit depends upon the data type.
- Gauge: A gauge statistic indicates a single value; a snapshot representation of a single point in time within a defined time frame. The gauge changes to a new value with each snapshot though a value may repeat from one period to the next. The limit depends upon the data type.
- Information: This type of statistic provides information, often intended to differentiate sets of statistics; for example, a VPN name or IP address. The type of information provided depends upon the data type.

The data type defines the format of the data for the value provided by the statistic. The following data types are used in statistics for this schema:

- Int32/Int64: An integer, either 32-bit or 64-bit: For statistics with the Int32 data type, the roll-over to zero limit is 4,294,967,295. For statistics with the Int64 data type, the roll-over to zero limit is 18,446,744,073,709,551,615.
- Float: A numeric value that can be represented fractionally; for example, 1.345.
- String: A series of ASCII alphanumeric characters in a single grouping, usually pre-configured.

IMPORTANT:

Unless otherwise indicated, all statistics are counters and all statistics are standards-based.

Key Variables: Every schema has some variables which are typically referred to as 'key variables'. These key variables provide index markers to identify which object the statistics apply to. For example, in the card schema, the card number (variable %card%) uniquely identifies a card. For an HA service, the keys would be "%vpnname%" plus "%servname%", as the combination uniquely identifies an HA service. So, in a given measurement interval, one row of statistics will be generated per unique key. The schema keys are identified in the Description section of the table.
Table 1. Bulk Statistic Variables in the IP Pool Schema

Variables | Description | Data Type
--- | --- | ---
vpnid | The identification number of the context configured on the system where the IP pool is configured. This is a key variable. Type: Information | Int32
vpnname | The name of the context configured on the system where the IP pool is configured. This is a key variable. Type: Information | String
addr-type | The IPV6 pool address type. Type: Information | String
type | The type of IP pool. Output for this variable is one of three characters; P, R, or S: P = Public R = Private S = Static Type: Information | String
state | The IP pool state. Output for this variable is one of three characters; G, D, or R: G = Good D = Pending Delete R = Resizing Type: Information | String
priority | The priority setting for the IP pool. Type: Information | Int32
name | The name of the IP pool. Type: Information | String
used | The number of IP addresses that have been assigned from the IP pool. Type: Gauge | Int32
hold | The number of IP addresses in the IP pool that are in a hold state. Type: Gauge | Int32
release | The number of IP addresses in the IP pool that are in a release state. Type: Gauge | Int32
free | The number of IP addresses in the IP pool that are available for use. Type: Gauge | Int32
startaddr | The starting address of the IP pool. Type: Information | String
groupname | The name of the pool group to which the IP pool belongs. Type: Information | String
IMPORTANT: For information on statistics that are common to all schema see the Statistics and Counters Overview chapter.