Monitoring the EFH state

Subscribers with Diameter Gy sessions that have EFH enabled can be displayed with the following CLI command:

# show service active-subscribers credit-control extended-failure-handling [state] [summary]

where the EFH state can be set to:

Example output:

A:BNG-1# show service active-subscribers credit-control extended-failure-handling
===============================================================================
Active Subscribers
===============================================================================
-------------------------------------------------------------------------------
Subscriber ipoe-msap-002 (sub-profile-1)
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
(1) SLA Profile Instance sap:[1/1/4:1201.2] - sla:sla-profile-3
-------------------------------------------------------------------------------
Credit Control Policy: cc-policy-1
Category Map         : cat-map-1
Diameter Session Gy  : bng.domain.com;1464610029;840
CC Failure Handling  : continue
Extended Failure Handling (EFH)
  State              : active
  Attempts           : 1                      Maximum Attempts   : 10
  Active time        : 0d 00:00:10
  Total Active time  : 0d 00:00:10
  Total Active Count : 1
Category Name        : cat-1-time
Ingress Queues       : 1
Egress Queues        : 1
Ingress Policers     :
Egress Policers      :
Credit Volume Used   : 0                    Credit Time Used     : 11
Credit Volume Avail. : 0                    Credit Time Avail.   : 589
Credit Volume Thres. : 0                    Credit Time Thres.   : 0
Credit Expired       : False                Credit Negotiating   : False
Out Of Credit Action : None                 Quota Holding Time   : 0
Validity Time Used   : 0                    Validity Time Avail. : 0
EFH Unreported Credit
  Current Volume     : 0                      Current Time       : 601
  Total Volume       : 0                      Total Time         : 601
Category Name        : cat-2-volume
Ingress Queues       : 4
Egress Queues        : 4
Ingress Policers     :
Egress Policers      :
Credit Volume Used   : 38400                Credit Time Used     : 0
Credit Volume Avail. : 10447360             Credit Time Avail.   : 0
Credit Volume Thres. : 0                    Credit Time Thres.   : 0
Credit Expired       : False                Credit Negotiating   : False
Out Of Credit Action : None                 Quota Holding Time   : 0
Validity Time Used   : 13                   Validity Time Avail. : 587
EFH Unreported Credit
  Current Volume     : 1527600                Current Time       : 0
  Total Volume       : 1527600                Total Time         : 0
-------------------------------------------------------------------------------
IP Address
                MAC Address          Session        Origin       Svc        Fwd
-------------------------------------------------------------------------------
10.1.1.101
                00:51:00:00:00:02    IPoE           DHCP         1000       Y
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Number of active subscribers : 1
===============================================================================

The following information is displayed In the Extended Failure Handling (EFH) section of the example:

Extended Failure Handling (EFH)
  State              : active

State indicates that EFH is enabled and active. Another possible state is ‟inactive”. When EFH is disabled, no EFH information is included.

Attempts           : 1                      Maximum Attempts   : 10

Attempts indicates the number of times interim credit has been assigned to all categories followed by an attempt to establish a new Diameter Gy session with the OCS. When the attempt to establish a new Diameter Gy session with the OCS is still failing after the Maximum Attempts value is reached, then the user session is terminated (that is, the subscriber hosts are deleted from the system).

Active time        : 0d 00:00:10

Active time indicates the time because the EFH state became active for this subscriber session.

Total Active time  : 0d 00:00:10
  Total Active Count : 1

Total Active time indicates the accumulative time of all occurrences that EFH was active during the lifetime of this subscriber session.

Total Active Count indicates the number of times that EFH was active during the lifetime of this subscriber session.

For each category (rating group), the EFH Unreported Credit is displayed:

EFH Unreported Credit
  Current Volume     : 0                      Current Time       : 601
  Total Volume       : 0                      Total Time         : 601

The Current Volume and Current Time counters contain, respectively, the unreported volume and time credit for the current occurrence of the EFH in an active state. These counters include the unreported used credit for the initial Diameter Gy session that caused the EFH state to become active and the unreported interim credit from previous attempts. Used interim credit for the current attempt per category (rating group) is shown in the following counters:

Credit Volume Used   : 0                    Credit Time Used     : 11
Credit Volume Avail. : 0                    Credit Time Avail.   : 589

The Total Volume and Total Time counters contain respectively the accumulated total unreported volume and time credit for the previous occurrences of EFH active state. The total counters are updated when the EFH state toggles from active to inactive. When interim credit reporting is enabled, the counters are reset to zero when the actual usage reporting happens for that rating group. When interim credit reporting is disabled, the counters are accumulating the total unreported credit during the lifetime of the subscriber session.

Current and Total Volume EFH Unreported Credit counters are the sum of used ingress and egress octets.

For each category (rating group), the validity time is displayed:

Validity Time Used   : 13                   Validity Time Avail. : 587

The following fields are only displayed when the EFH state is active:

When EFH is disabled (shutdown), then the EFH information is not included in the credit control output.