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.