[Contents] [Prev] [Next] [Index] [Report an Error]

Monitoring Subscriber Information

Purpose

Display the active subscribers on the router. If you specify a username, the router displays only the users that match. When you issue the command in the default VR, all users are displayed. When you issue the command in a nondefault VR, only those users attached to that VR are displayed. The following list describes keywords that you can use with the show subscribers command:

You can use the domain, interface, port, slot, username, or virtual-router keywords on all routers to filter the results. If you do not use a keyword, all active users are displayed.
When you use the interface keyword to display detailed subscriber information by interface, you must also specify either the atm or ethernet keyword, an interface specifier, and optionally a subinterface specifier.
The output displayed in the interface field depends on the configuration of two commands at the time the subscriber logs in: aaa intf-desc-format include sub-intf and aaa intf-desc-format include adapter (for the E120 and E320 routers).
- When the aaa intf-desc-format include sub-intf disable command has been issued, the subinterface is stripped from the subscriber’s interface field at login and is not displayed in the output. In the default state, or when the aaa intf-desc-format include sub-intf enable command has been issued, the subinterface is included in the subscriber’s interface field at login, and is displayed in the output.
- When the aaa intf-desc-format include adapter disable command has been issued, the adapter is stripped from the subscriber’s interface field at login and is not displayed in the output. In the default state, or when the aaa intf-desc-format include adapter enable command has been issued, the adapter is included in the subscriber’s interface field at login and is displayed in the output.
- Even when the subinterface has been stripped from the subscriber’s interface field, you can still include the subinterface specifier in the show subscribers interface command. Even though the subinterface itself is not displayed, only subscribers on the specified subinterface are displayed.
- These considerations do not apply when you issue the summary keyword. The output displayed in the Interface field of summary versions is not affected by the state of either the aaa intf-desc-format include sub-intf command or the aaa intf-desc-format include adapter command when the subscriber logs in.
You can use the ipv6 keyword to display all IPv6 subscribers or include the IPv6 prefix to limit the display to only IPv6 subscribers on a specific network.
You can use the summary keyword to display only summary information about active subscribers.

Action

To display general subscriber information:

host1# show subscribers
                             Subscriber List
                             ----------------
                                                           Virtual
      User Name           Type         Addr|Endpt           Router
-----------------------   -----   --------------------   ------------
fred                      tst     10.10.65.86/radius     default  
bert                      tst     192.168.10.3/user      default
      User Name                      Interface                          
-----------------------   -------------------------------- 
fred                      atm 2/1.42:100.104                   
bert                      FastEthernet 5/2.4                   
      User Name               Login Time           Circuit Id      
-----------------------   -------------------   ---------------- 
fred                      06/05/12 10:58:42     atm 5/1.3
bert                      06/05/12 10:59:08      
     User Name               Remote Id      
-----------------------   ----------------
fred           
bert                      (800) 555-1212

To display detailed information for subscribers on the specified interface:

host1# show subscribers interface ethernet 5/2                             
                                Subscriber List
                                ---------------
                                                            Virtual
       User Name           Type         Addr|Endpt           Router
------------------------   -----   --------------------   ------------
bert                       tst     192.168.10.3/user      default
       User Name                      Interface
------------------------   --------------------------------
bert                       FastEthernet 5/2.4
       User Name               Login Time           Circuit Id     
------------------------   -------------------   ----------------
bert                       06/05/12 10:59:08
       User Name              Remote Id      
-----------------------    ----------------
bert                      (800) 555-0000

To display detailed information for subscribers on the specified slot:

host1# show subscribers slot 5
                             Subscriber List
                             ---------------
                                                            Virtual
       User Name           Type         Addr|Endpt           Router
------------------------   -----   --------------------   ------------
fred                       tst     10.10.65.86/radius     default 
       User Name                      Interface
------------------------   --------------------------------
fred                       atm 5/1.42:100.104 
       User Name               Login Time           Circuit Id     
------------------------   -------------------   ----------------
fred                       06/05/12 10:58:42     atm 5/1.3
       User Name              Remote Id      
-----------------------    ----------------   
fred

To display the number of subscribers on each virtual router, as well as the total and peak subscribers for the chassis:

host1#show subscribers summary 
  Virtual
   Router      Subscribers     Ppp       Ip      Tnl     Total
------------   ------------   ------   ------   ------   ------
default        1              1        0        0        1
Total Subscribers : 10 (chassis-wide total)
Peak  Subscribers : 15 (chassis-wide total)

To display the number of subscribers on each port:

host1#show subscribers summary port
Interface      Count
------------   ------
3/1            5
2/1            5
Total Subscribers : 10 (chassis-wide total)
Peak  Subscribers : 15 (chassis-wide total)

To display the number of subscribers by domain name:

host1#show subscribers summary domain
          Domain Name              Count
--------------------------------   ------
abc.com                            5
iii.com                            5
Total Subscribers : 10 (chassis-wide total)
Peak  Subscribers : 15 (chassis-wide total)

To display the number of subscribers by interface:

host1#show subscribers summary interface
     Interface         Count
--------------------   ------
ATM 3/2.1              1
ETHERNET 5/2.1         2
Total Subscribers : 3 (chassis-wide total)
Peak  Subscribers : 6 (chassis-wide total)

To display the number of subscribers by slot:

host1#show subscribers summary slot
  Slot     Count
--------   -----
3          1
5          4
Total Subscribers : 5 (chassis-wide total)
Peak  Subscribers : 8 (chassis-wide total)

Meaning

Table 32 lists the show subscribers command output fields.

Table 32: show subscribers Output Fields

Field Name	Field Description
User Name	Name of the subscriber
Type	Type of subscriber: atm, ip, ipsec, ppp, tnl (tunnel), tst (test)
Addr \| Endpt	IP or IPv6 address and source of the address: l2tp, local, dhcp, radius, user. For local, dhcp, radius, and user endpoints, the address is that of the user. When the endpoint is l2tp, the address is that of the LNS.
Virtual Router	Name of the virtual router context
Interface	Interface specifier over which the subscriber is connected
Login Time	Date, in YY/MM/DD format, and time the subscriber logged in
Circuit Id	User circuit ID value specified by PPPoE
Remote Id	User remote ID value specified by PPPoE
Total Subscribers	Number of active subscribers, chassis-wide
Peak Subscribers	Maximum value of the Total Subscriber field during the time the router has been active, chassis-wide
Subscribers	Number of subscribers; the sum of the Ppp and Ip fields
Ppp	Number of PPPoA and PPPoE users, combined
Ip	Number of DHCP and IP subscriber manager users, combined
Tnl	Number of users tunneled to an LNS
Total	Total number of users per virtual router; the sum of the Ppp, Ip, and Tnl fields
Domain Name	Domain name used by the subscriber
Count	Number of subscribers
Slot	Number of slot in the chassis

Monitoring Subscriber Information

Purpose

Action

Meaning

Related Topics