CsubAggStatsEntry¶

Enum Classes

CsubAggStatsPointType

class CISCOSUBSCRIBERSESSIONMIB::CsubAggStatsTable::CsubAggStatsEntry¶

Bases: Entity

Class Hierarchy : CISCOSUBSCRIBERSESSIONMIB CsubAggStatsTable CsubAggStatsEntry

This class represents state data.

An entry contains a set of aggregated statistics relating to

those subscriber sessions that fall into a ‘scope of

aggregation’.

A ‘scope of aggregation’ is the set of subscriber sessions

that meet specified criteria. For example, a ‘scope of

aggregation’ may be the set of all PPPoE subscriber sessions

maintained by the system. The following criteria define the

‘scope of aggregation’:

Aggregation Point type

Aggregation point type identifies the format of the

csubAggStatsPoint for this entry.
Aggregation Point

‘Physical’ Aggregation Point type case:

In a distributed system, a ‘node’ represents a physical

entity capable of maintaining the context representing

a subscriber session.

If the ‘scope of aggregation’ specifies a physical

entity having an entPhysicalClass of ‘chassis’, then

the set of subscriber sessions in the ‘scope of

aggregation’ may contain the subscriber sessions maintained by all

the nodes contained in the system.

If the ‘scope of aggregation’ specifies a physical

entity having an entPhysicalClass of ‘module’ (e.g., a

line card), then the set of subscriber sessions in the

‘scope of aggregation’ may contain the subscriber

sessions maintained by the nodes contained by the

module.

If the ‘scope of aggregation’ specifies a physical

entity having an entPhysicalClass of ‘cpu’, then the

set of subscriber sessions in the ‘scope of aggregation’

may contain the subscriber sessions maintained by the node

running on that processor.

Observe that a centralized system (i.e., a system

that essentially contains a single node) can only

support a ‘scope of aggregation’ that specifies a

physical entity classified as a ‘chassis’.

If the scope of aggregation specifies ‘interface’,

then the scope is the set of subscriber sessions carried

by the interface identified the ifIndex value

represented in the csubAggStatsPoint value.

Subscriber Session Type

If the ‘scope of aggregation’ specifies the value ‘all’

for the subscriber session type, then the set of

subscriber sessions in the ‘scope of aggregation’ may

contain all subscriber sessions, regardless of type.

If the ‘scope of aggregation’ specifies a value other

than ‘all’ for the subscriber session type, then the

set of subscriber sessions in the ‘scope of aggregation may

contain only those subscriber sessions of the specified

type.

Implementation Guidance

A system MUST maintain a set of statistics with a ‘scope of

aggregation’ that contains all subscriber sessions maintained

by the system. The system creates this entry during the

initialization of the SNMP entity.

A system SHOULD maintain a set of statistics for each ‘scope of

aggregation’ containing subscriber sessions of each subscriber

session type the system is capable of providing access. If the

system supports these sets of statistics, then it creates these

entries during the initialization of the SNMP entity.

A system MAY maintain sets of node-specific statistics. if the

system supports sets of node-specific statistics, then it

creates the appropriate entries upon detection of a physical

entity (resulting from system restart or insertion) containing

those nodes. Likewise, the system destroys these entries

upon removal of the physical entity.

csubaggstatspointtype(key)¶

This object indicates format of the csubAggStatsPoint for this entry. The format for the csubAggStatsPoint is as follows: csubAggStatsPointType csubAggStatsPoint ———————- —————— ‘physical’ PhysicalIndex ‘interface’ InterfaceIndex

type: CsubAggStatsPointType

config: False

csubaggstatspoint(key)¶

This object should be read with csubAggStatsPointType always. This object indicates one of the determining factors affecting the ‘scope of aggregation’ for the set of statistics contained by the row. The value indicated by this object should be interpreted as the identifier for the point type specific base table. For point types of ‘physical’, the type specific base table is the entPhysicalTable and this value is a PhysicalIndex. For point types of ‘interface’, the type specific base table is the ifTable and this value is an InterfaceIndex. If this column indicates a physical entity which has an entPhysicalClass of ‘chassis’, then the ‘scope of aggregation’ may includes those subscriber sessions maintained by all nodes contained by the system. If this column indicates a physical entity which has an entPhysicalClass of ‘module’ (e.g., a line card), then the ‘scope of aggregation’ may include those subscriber sessions maintained by the nodes contained by the module. If this column indicates a physical entity which has an entPhysicalClass of ‘cpu’, then the ‘scope of aggregation’ may include those subscriber sessions maintained by the node running on the processor. Aggregation points with entPhysicalTable / ifTable overlap: For interfaces which map directly to physical ‘port’ class entities in the entPhysicalTable, the preferred representation as aggregation points is the ‘physical’ point type and PhysicalIndex identifier

type: int

range: 1..4294967295

config: False

csubaggstatssessiontype(key)¶

This object indicates one of the determining factors affecting the ‘scope of aggregation’ for the statistics contained by the row. If the value of this column is ‘all’, then the ‘scope of aggregation’ may include all subscriber sessions, regardless of type. If the value of this column is not ‘all’, then the ‘scope of aggregation’ may include subscriber sessions of the indicated subscriber session type

type: SubSessionType

config: False

csubaggstatspendingsessions¶

This object indicates the current number of subscriber sessions within the ‘scope of aggregation’ that are in the PENDING state

type: int

range: 0..4294967295

config: False

units: sessions

csubaggstatsupsessions¶

This object indicates the current number of subscriber sessions within the ‘scope of aggregation’ that are in the UP state

type: int

range: 0..4294967295

config: False

units: sessions

csubaggstatsauthsessions¶

This object indicates the current number of subscriber session within the ‘scope of aggregation’ that have been authenticated

type: int

range: 0..4294967295

config: False

units: sessions

csubaggstatsunauthsessions¶

This object indicates the current number of subscriber session within the ‘scope of aggregation’ that have not been authenticated

type: int

range: 0..4294967295

config: False

units: sessions

csubaggstatslightweightsessions¶

This object indicates the current number of subscriber sessions within the ‘scope of aggregation’ that are less resource intensive

type: int

range: 0..4294967295

config: False

units: sessions

csubaggstatsredsessions¶

This object indicates the current number of subscriber sessions within the ‘scope of aggregation’ that are redundant (i.e., sessions with a csubSessionRedundancyMode of ‘standby’)

type: int

range: 0..4294967295

config: False

units: sessions

csubaggstatshighupsessions¶

This object indicates the highest number of subscriber sessions within the ‘scope of aggregation’ observed simultaneously in the UP state since the last discontinuity time

type: int

range: 0..4294967295

config: False

units: sessions

csubaggstatsavgsessionuptime¶

This object indicates the average time subscriber sessions within the ‘scope of aggregation’ spent in the UP state. The system calculates this average over all subscriber sessions maintained by all nodes contained by the ‘scope of aggregation’ since the last discontinuity time

type: int

range: 0..4294967295

config: False

units: seconds

csubaggstatsavgsessionrpm¶

This object indicates the average rate (per minute) at which the nodes contained by the ‘scope of aggregation’ have established new subscriber sessions

type: int

range: 0..4294967295

config: False

units: sessions per minute

csubaggstatsavgsessionrph¶

This object indicates the average rate (per hour) at which the nodes contained by the ‘scope of aggregation’ have established new subscriber sessions

type: int

range: 0..4294967295

config: False

units: sessions per hour

csubaggstatsthrottleengagements¶

This object indicates the number of times that nodes contained within the ‘scope of aggregation’ have engaged the subscriber session throttle since the last discontinuity time. The mechanics of a subscriber session throttle vary with subscriber session type and implementation. However, the general concept of the throttle prevents a node from having to deal with more than a configured number of requests to establish subscriber sessions from the same CPE within the a configured interval of time. When the number of requests exceeds the configured threshold within the configured interval, then the node processing the requests engages the throttle. Typically, when a node engages a throttle, it drops requests from the CPE for some period of time, after which the node disengages the throttle. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of csubAggStatsDiscontinuityTime

type: int