# Collecting Bulk Statistics

The router offers an efficient data collection and transfer facility for accounting applications. The E Series router SNMP MIBs extend the accounting data collection mechanism defined in the Accounting-Control-MIB (RFC 2513) to include support for connectionless networks.

Service providers need reasonably accurate data about customers’ use of networks. This data is used for billing customers and must be available at a customer’s request. Accounting applications based on SNMP polling models consume significant network bandwidth because they poll large volumes of data frequently.

Unfortunately, SNMP is not well suited for gathering large volumes of data, especially over short time intervals. It is inadequate for use by accounting applications because:

- The SNMP PDU layout has a low payload-to-overhead ratio.
- Processing SNMP PDUs is expensive because objects and tables need to be sorted in lexicographic order.

The router avoids the need for continuous polling of SNMP statistics by using applications known as collectors to retrieve data. You can configure up to six collectors. The router sends collected statistics through FTP to assigned hosts, known as receivers. You must assign a primary receiver to each collector, and you can assign a secondary receiver for redundancy.

| Note: The basic-encoding-rules (BER)–encoding choice is not supported.

You can collect interface bulk statistics based on sets of virtual router groups. If sets of virtual router groups generally correspond to ISPs, you can then forward the relevant data to a particular ISP.

To configure a collector to include data from a specific list of virtual routers, you must first configure a collector and then associate a router set with it. A collector can have up to 64 virtual routers associated with it.

To collect bulk statistics for a subset of all configured subinterfaces, you can define the subinterfaces using the following syntax:

Slot/Port[.subInterfaceId]

Per virtual router collection is supported on the if-stats and igmp schemas. It is supported on all interface types supported by BulkStats. Collectors modified to use per virtual router collection or configured after a collector has started have a time delay (up to the configured time in seconds) until an active collector starts again.

The maximum number of interfaces for each type of interface and line module can differ. Bulk statistics can collect these statistics when you configure the slots with their respective interfaces to the corresponding maximum values. For information about maximum values see JunosE Release Notes, Appendix A, System Maximums.

| Note: Define all interface types before you map a collector to the if-stats schema to ensure that you display statistics for all configured interfaces in the first interval.

The name of the bulk statistics file that is transferred to the host when there is a collectorSequence attribute in the remote name is as follows:

fileName - z - mmddHHMM - s. sts

where:

- fileName—Name of the file, which includes sysName, sysUpTime, depending on the attributes specified
- -z—Receiver index value
- mmddHHMM—Timestamp when the receiver is created in month/day/hour/minute format
- -s—Actual sequence number

## Interface Strings

Bulk statistics provides interface strings as described in Table 23.

Table 23: Interface Strings

Type of Interface | Common Description Format-Mode Disabled | Common Description Format-Mode Enabled
--- | --- | ---
IP interfaces | IP | Ip
PPP interfaces | PPP | Ppp
DS0 interfaces | Ds0 | Ds0
DS1 interfaces | SERIAL | Ds1
DS3 interfaces | SERIAL | Ds3
Frame Relay Major interfaces | FR | FrameRelayMajor
Ethernet interfaces | ENET | Ethernet
Sonet interfaces | SONET | Sonet
Sonet Path interfaces | SONET | SonetPath
ATM interfaces | ATM | Atm
ATM AAL5 interfaces | ATM | AtmAal5
ATM 1483 interfaces | ATM | Atm1483
Ft1 interfaces | SERIAL | Ft1
HDLC interfaces | HDLCIntf | HDLC
IpLoopback interfaces | Loopback | IpLoopback
IpVirtual interfaces | IpVirtual | IpVirtual
Frame Relay Sub interfaces | FR | FrameRelaySub
PppOE Major interfaces | PPPoE | PppoeMajor
PppOE Sub interfaces | PPPoE | PppoeSub
Bridged Ethernet | BRG-ET | BridgedEthernet
L2TP Tunnel | L2TP | L2tpTunnel
L2TP Session | L2TP | L2tpSession
PppLink interfaces | MLPPP | PppLink
HDLC interfaces | HDLCEncaps | Hdlc
L2TP Destinataion | L2TP | L2tpDestination
MPLS Major interfaces | MplsIfMajor | MplsMajor
MPLS Minor interfaces | MplsIfMinor | MplsMinor
Ppp Network interfaces | MLPPP | PppNetwork
Ethernet Sub interfaces | ENET | EthernetSub
MultiLink Frame Relay interfaces | MLFR | MultilinkFrameRelay
Ip Tunnel Interfaces | IP-TUNNEL | IpTunnel
Server Port Interfaces | ServerPort | ServerPort
Sonet VT interfaces | SONET | SonetVT
Vlan major interfaces | VLAN-MAJ | VlanMajor
Vlan sub interfaces | VLAN-SUB | VlanSub
Gtp interfaces | Gtp | Gtp
L2fTunnel interfaces | L2fTunnel | L2fTunnel
L2fSession interfaces | L2fSession | L2fSession
L2fDestination interfaces | L2fDestination | L2fDestination
IpSec Tunnel interfaces | IpSecTunnel | IpsecTunnel
Sg interfaces | SgInterface | SgInterface
MPLS L2 Shim interfaces | MplsL2Shim | MplsL2Shim
MPLS VC Sub interfaces | MplsL3Shim | MplsVcSub
LacGen interfaces | LacGen | LacGen
Bridge interfaces | BridgeIf | Bridge
IpSec Transport interfaces | IPSecTransportIf | IpsecTransport
IPv6 interfaces | IPv6If | Ipv6
IPv6 Tunnel interfaces | IPv6TunnelIf | Ipv6Tunnel
IPv6 loopback interfaces | IPv6LoopbackIf | Ipv6Loopback
OSI interfaces | Osi | Osi
LAG interfaces | Lag | Lag
Ip Tunnel MDT interfaces | IpTunnelMdt | IpTunnelMdt

## Understanding Counter Discontinuity

Interface counter discontinuity can occur when a counter wraps or after a line module is reloaded or reset. If one of these actions occurs, applications that utilize the counters in expressions or calculations generate erroneous values and misleading graphs.

Because counters are 64 bits long, the possibility of a counter’s wrapping naturally would occur so infrequently (for example, in many hundreds of years) that this scenario is not recognized as an issue.

Counter discontinuity does occur, however, when you reload or reset a line module. To indicate reloading or resetting, bulk statistics files contain a record similar to the following:

{Controller down slot 3, TUE OCT 29 2004 14:25:10.370 UTC}

This record provides a mechanism by which applications can detect discontinuity events. To take advantage of this detection capability, the bulk statistics parsing entity should use the record to terminate expression or formula calculations for the indicated slot and to establish a new baseline.

## Configuring Collectors and Receivers

To configure the router to collect statistics:

1. Add names to the FTP host table for the primary and secondary (optional) receivers.

   See Copying and Redirecting Files in Managing the System , for information about adding names to the host table.

2. Specify the type of interface on which you want to collect statistics.
   host1(config)#bulkstats interface-type ppp collector 2
3. Specify the parameters for the receivers.
   host1(config)#bulkstats receiver 1 remote-name js:/ftptest/bulk%s%s.sts sysName sysUpTime
4. Assign the data collector.
   host1(config)#bulkstats collector 2
5. Specify the method for data collection.
   host1(config)#bulkstats collector 2 collect-mode auto
6. Assign the primary receiver.
   host1(config)#bulkstats collector 2 primary-receiver 1
7. (Optional) Assign the secondary receiver.
   host1(config)#bulkstats collector 2 secondary-receiver 5
8. (Optional) Specify the time for which the system transfers data.
   host1(config)#bulkstats collector 2 interval 1000
9. (Optional) Set the maximum size of the bulk statistics file.
   host1(config)#bulkstats collector 2 max-size 20480
10. (Optional) Add descriptive information to the bulk statistics file.
    host1(config)#bulkstats collector 2 description customer xyz
11. (Optional) Set the encoding scheme of the ifDescr and ifName objects.
    host1(config)#bulkstats interfaces description-format common
12. (Optional) Set the system to retrieve bulk statistics once only.
    host1(config)#bulkstats collector 2 single-interval
13. (Optional) Configure bulk statistics traps.
    host1(config)#bulkstats traps nearly-full
14. (Optional) Collect bulk statistics per virtual router.
    host1(config)#bulkstats virtual-router-group collector 2 routerISP3

    | Note: The bulk statistics feature supports generating files on a per interface basis.

bulkstats collector

- Use to assign the data collector.
- Example
  host1(config)#bulkstats collector 2
- Use the no version to delete the collector.
- See bulkstats collector.

bulkstats collector collect-mode

- Use to specify the way the collector retrieves bulk statistics.
- Example
  host1(config)#bulkstats collector 2 collect-mode auto
- Use the no version to specify that either the user or the system will initiate transfers manually.
- See bulkstats collector.

bulkstats collector description

- Use to add descriptive information to the bulk statistics file.
- Example
  host1(config)#bulkstats collector 2 description customer xyz
- Use the no version to remove descriptive text from the bulk statistics file.
- See bulkstats collector.

bulkstats collector interval

- Use to specify the time interval in seconds for which the collector transfers data to the receivers.
- Example
  host1(config)#bulkstats collector 2 interval 1000
- Use the no version to set this time to the default, 360 seconds (6 minutes).
- See bulkstats collector.

bulkstats collector max-size

- Use to set the maximum size of the bulk statistics file for all collectors combined. Even when you configure more than one collector, the first maximum file size configured is the combined size of all collectors.
- The maximum file size that you can configure is 20971520 bytes. However, if you do not configure a maximum size, then the maximum file size defaults to 5767168 bytes.
- Although the CLI accepts the commands, you cannot unconfigure or modify the configuration of the maximum file size until the router is rebooted.
- Example
  host1(config)#bulkstats collector 2 max-size 20480
- Use the no version to set the size of the bulk statistics file to the default, 5767168 bytes.
- See bulkstats collector.

bulkstats collector primary-receiver

- Use to assign the primary receiver to which the system transfers data.
- The index for the receiver must match the index that you specified with the bulkstats receiver remote-name command.
- Example
  host1(config)#bulkstats collector 2 primary-receiver 7
- Use the no version to clear the primary receiver and disable the collector.
- See bulkstats collector.

bulkstats collector secondary-receiver

- Use to assign the secondary (that is, the backup) receiver to which the system transfers data.
- The index for the receiver must match the index you specified with the bulkstats receiver remote-name command.
- Example
  host1(config)#bulkstats collector 2 secondary-receiver 5
- Use the no version to clear the secondary receiver.
- See bulkstats collector.

bulkstats collector single-interval

- Use to set the system to retrieve bulk statistics once only, rather than periodically.
- Example
  host1(config)#bulkstats collector 2 single-interval
- Use the no version to set the system to retrieve bulk statistics periodically, the default situation.
- See bulkstats collector.

bulkstats interfaces description-format common

- Use to set the encoding scheme of the ifDescr object that the bulk statistics application reports to the conventional industry method.
- This command provides compatibility with software that uses the industry encoding scheme.
- For more information, see Configuring Encoding Method .
- Example
  host1(config)#bulkstats interfaces description-format common
- Use the no version to return to the proprietary method of encoding.
- See bulkstats interfaces description-format common.

bulkstats interface-type

- Use to configure the interface or subinterface type on which you want to collect statistics.
- You can provide an interface specifier (location) to identify a specific interface on which you want to collect statistics.
- If you define more than one collector, you must specify a unique collector index, in the range 1–65535.
- The supported interface types are:
  - atm—Collects statistics on ATM interfaces
  - atm1483—Collects statistics on ATM 1483 interfaces
  - ethernet—Collects statistics on Ethernet interfaces
  - frame-relay—Collects statistics on Frame Relay interfaces
  - frame-relay-sub—Collects statistics on Frame Relay subinterfaces
  - hdlc—Collects statistics on Cisco HDLC interfaces
  - ip—Collects statistics on IP interfaces
  - mplsMajor—Collects statistics on MPLS major interfaces
  - mplsMinor—Collects statistics on MPLS minor interfaces
  - mplsL2shim—Collects statistics on MPLS shim interfaces
  - ppp—Collects statistics on PPP
  - vlan—Collects statistics on VLAN subinterfaces

    | Note: You cannot collect statistics on the SRP Ethernet interface.

- Example 1
  host1(config)#bulkstats interface-type ppp 3/1 collector 2
- Example 2
  host1(config)#bulkstats interface-type vlan 2/3:1 collector 1
- Example 3
  host1(config)#bulkstats interface-type mplsMajor 2/3:1 collector 1
- Use the no version to delete the interface type from bulk statistics collection. Deletion of a particular interface type takes effect at the next collection interval.
- See bulkstats interface-type.

bulkstats receiver remote-name

- Use to configure the parameters for receivers.
- Bulk statistics transfers require the configuration of a remote FTP server.
- The receivers must appear in the FTP host table. The name of the host must match the name you specify with this command. The hostname is relative to the virtual router’s context when you issue this command.
- When specifying the remote filename for bulk statistics, you must precede the filename with the hostname followed by the :/ characters.
- Example
  host1(config)#bulkstats receiver 1 remote-name js:/ftptest/bulk%s%s.sts sysName sysUpTime

  | Note: The % variables in the remote name are replaced at runtime with the sysName and sysUpTime parameters to produce variable filenames on the remote host.

- Use the no version to delete the receiver.
- See bulkstats receiver remote-name.

bulkstats traps

- Use to configure bulk statistics traps.
- You must configure SNMP correctly and specify a valid trap source. Otherwise, the system will not send SNMP traps.
- Example
  host1(config)#bulkstats traps nearly-full
- Use the no version to disable the trap.
- See bulkstats traps.

bulkstats virtual-router-group

- Use to collect interface statistics for each virtual router.
- A collector can have a maximum of 64 virtual routers associated with it.
- Routers are identified by their assigned name or router index.
- Supported only on if-stats and igmp schemas.
- Supported on all interface types supported by the bulk statistics application.
- Collectors modified to use per virtual router collection or configured after a collector has started have a time delay until an active collector starts again.
- Example
  host1(config)#bulkstats virtual-router-group collector 2 routerISP3
- Use the no version to prevent bulkstats from being reported for virtual router groups.
- See bulkstats virtual-router-group.

## Deleting All Bulkstats Configurations

Although individual bulkstats commands allow you to disable or delete a specific bulkstats parameter, the CLI also allows you to remove all bulkstats configurations from the router at one time.

no bulkstats

- Use to remove all bulkstats configurations from the router at one time.
- Example
  host1(config)#no bulkstats
- See no bulkstats.

## Monitoring Collection Statistics

To view the parameters the router uses to collect statistics, use the following show bulkstats commands.

To include or exclude lines of output based on a text string that you specify, use the output filtering feature for show commands. For details, see Command-Line Interface.

show bulkstats

- Use to display the bulk statistics data collection configuration.
- Field descriptions
  - AdminStatus—Administrative status of the bulk statistics application
  - OperStatus—Operational status of the bulk statistics application, enabled or disabled
  - Interface Description Setting—Method used to encode the ifDescr object: common, proprietary, industry-common
  - File Format—End of the line format in bulkstats files, carriage return and line feed (CR+LF) or LF
  - Current Time—Current system time used to compare with the collection stop/start time
  - Intervals—Number of times the bulk statistics collector has cycled through a collection
  - PrimaryXfers—Number of times the bulk statistics collector has attempted a data file transfer to a primary server
  - PrimaryFails—Number of primary server transfer failures
  - SecondaryXfers—Number of times the bulk statistics collector has attempted a data file transfer to a secondary server
  - SecondaryFails—Number of secondary server transfer failures
  - BulkStats Collector Information:
    - Index—Bulk statistics collector index number
    - CurrSize—Current size of the bulk statistics file in bytes
    - MaxSize—Maximum size configured for the bulk statistics file in bytes
    - Intrvl—Time interval between bulk collections in seconds
    - Mode—How often the collector is set up to collect statistics:
      - periodic—Collects statistics periodically
      - single-interval—Collects statistics once only
    - XferMode—Collect mode configured for the collector:
      - auto—Agent transfers file when interval expires
      - manual—Network management system or the user initiates transfers
      - onFull—Agent transfers file when it reaches the maximum size
    - State
      - inProg—Collector is properly configured and currently active
      - notInSvc—Collector has been decommissioned by a management client
      - notReady—Collector does not have enough configuration information to go active
      - error—Configuration or operational error
    - Index—Bulk statistics collector index number
    - Primary-Receiver—Index number of the primary receiver to which the system transfers data, if defined
    - Second-Receiver—Index of the secondary receiver to which the system transfers data
    - Last Transfer Failure—Last time that the collector attempted to retrieve statistics and was unsuccessful
    - Interval Start Time—Start of current interval of bulk collections. The collector began collecting bulk statistics at this time.
    - Interval Stop Time—End of current interval of bulk collections.
  - Schema Information:
    - Index—Index number of the schema
    - Subtree—Type of bulk statistics schema configured on the collector: if-stack, if-stats, policy, QoS, or system
    - CollectorIndex—Bulk statistics collector index number
    - Create-Delete Time Stats—State of final statistics collection (enabled or disabled)
    - Create-Delete Interface Type—Interface type associated with final statistics collection (ATM 1483, IP, PPP)
    - State
      - active—Schema is properly configured and currently active
      - notInSvc—Schema has been decommissioned by a management client
      - notReady—Schema does not have enough configuration information to go active
      - error—Configuration or operational error
    - Subtree List—Types of statistics the schema is configured to receive
  - Interface Types:
    - Index—Index number of the interface type entry
    - Type—Interface type for which bulk statistics collection is configured
    - CollectorIndex—Index number of the collector to which the interface type applies
    - State
      - active—Interface type is properly configured and currently active
      - notInSvc—Interface type has been decommissioned by a management client
      - notReady—Interface type does not have enough configuration information to go active
      - error—Configuration or operational error
  - Receiver Information:
    - Index—Index number of the receiver
    - RemoteFileName—Hostname, path, and filename of the remote FTP server
    - State
      - active—Receiver is properly configured and currently active
      - notInSvc—Receiver has been decommissioned by a management client
      - notReady—Receiver does not have enough configuration information to go active
      - error—Configuration or operational error
    - Status
      - Success
      - Copy source does not exist or is unreachable
      - Copy failed
      - File in use
  - Virtual Router Groups:
    - Collector—Number that identifies the particular data collector, in the range 1–65535
    - Virtual-Routers—Set of virtual router names (up to 64 names)
- Example

      host1#show bulkstats

        AdminStatus:  enabled
        OperStatus:   enabled
        Interface Description Setting: industry-common
        File Format: CR+LF
      Current Time: TUE AUG 15 2002 15:54:20 UTC

        Intervals PrimaryXfers PrimaryFails SecondaryXfers SecondaryFails
        --------- ------------ ------------ -------------- --------------
        0         0            0            0              0

        BulkStats Collector Information:
        Index  CurrSize  MaxSize   Intrvl  Mode      XferMode  State
        -----  --------  --------  ------  --------- --------  -------
        1      490       3670016   600     periodic  manual    inProg
        2      0         3670016   360     periodic  manual    notReady

        Index  Primary-Receiver  Second-Receiver  Last Transfer Failure
        -----  ----------------  ---------------  --------------------
        1      1                 not defined
        2      not defined       not defined

        Index Interval Start Time          Interval Stop Time
        ----- ---------------------------- -------------------------
        1     TUE AUG 15 2000 15:52:33 UTC TUE AUG 15 2000 16:02:33 UTC
        2     Not started                  N/A

      Schema Information:
        Index  Subtree
        -----  -------------------------------------------------
        1      ifStats

        Index  CollectorIndex  State
        -----  --------------  --------
        1      1               active

        Index  Create-Delete Time Stats  Create-Delete Interface Types
        -----  ------------------------  -----------------------------
        1      enabled                   IP

        Index  Subtree List
        -----  -------------------------------------------------------------
        1      all

        Interface Types:
        Index         Type             CollectorIndex  State
        -----  ----------------------  --------------  --------
        1      Ppp                     1               active
        6      Ethernet                1               active
        11     Atm1483                 1               active

        Receiver Information:
        Index  RemoteFileName
        -----  -------------------------------------------------------
        1      host:/upload/bulkStas.sts

        Index  State     Status
        -----  --------  ---------------------------------------------
        1      notReady  Copy source does not exist or is unreachable

      Collector  Virtual-Routers
      ---------  ---------------
      33             serviceProviderABC
      655             default

- See show bulkstats.

show bulkstats collector description

- Use to display information about the collector’s file description.
- Field descriptions
  - Index—Index number of the bulk statistics collector
  - FileDescription—Descriptive information added to the bulk statistics file with the bulkstats collector description command
- Example

      host1#show bulkstats collector description
        Index  FileDescription
        -----  -----------------------
        1      Bulk SNMP Statistics Collection

- See show bulkstats collector description.

show bulkstats collector interval

- Use to display information about the collector transfer interval configuration.
- Field descriptions
  - Index—Index number of the bulk statistics collector
  - Interval—Amount of time, in seconds, that the collector transfers data to the receiver
- Example

      host1#show bulkstats collector interval
      Index  Interval
      -----  --------
      1      360

- See show bulkstats collector interval.

show bulkstats collector max-size

- Use to display information about the bulk statistics maximum file size configuration.
- Field descriptions
  - Index—Index number of the bulk statistics collector
  - MaxSize—Maximum size of the bulk statistics file in bytes
- Example

      host1#show bulkstats collector max-size
      Index  MaxSize
      -----  ------------
      1      2097152

- See show bulkstats collector max-size.

show bulkstats collector transfer-mode

- Use to display information about the bulk statistics transfer mode configuration.
- Field descriptions
  - Index—Index number of the bulk statistics collector
  - Transfer-Mode:
    - auto-xfer—Server automatically transfers the bulk statistics files to a remote FTP server
    - manual-xfer—Server expects the user to transfer bulk statistics files
    - on-file-full—Server transfers the bulk statistics file when the file reaches its maximum size
  - Primary-Receiver—Receives the bulk statistics sent by the collector
  - Secondary-Receiver—Serves as a backup to the primary receiver
- Example

      host1#show bulkstats collector transfer-mode
      Index  Transfer-Mode  Primary-Receiver  Secondary-Receiver
      -----  -------------  ----------------  ------------------
      1      auto-xfer      1                 2

- See show bulkstats collector transfer-mode.

show bulkstats interface-type

- Use to display information about the bulk statistics interface types configuration.
- Field descriptions
  - Interface Types:
  - Index—Index number of the interface type entry
  - Type—Interface type for which bulk statistics collection is configured
  - CollectorIndex—Index of the collector to which the interface type applies
  - State
    - active—Interface type is properly configured and currently active
    - notInSvc—Interface type has been decommissioned by a management client
    - notReady—Interface type does not have enough configuration information to go active
    - error—Configuration/operational error
- Example

      host1#show bulkstats interface-type

      Interface Types:
        Index         Type             Collector  State
        -----  ----------------------  ---------  --------
        1      ppp                     1          active

- See show bulkstats interface-type.

show bulkstats receiver

- Use to display information about the remote file configuration of the bulk statistics receiver.
- Field descriptions
  - Index—Index number of the receiver
  - RemoteFileName—Hostname, path, and filename of the remote FTP server
  - Index—Index number of the receiver
  - State
    - active—Receiver is properly configured and currently active
    - notInSvc—Receiver has been decommissioned by a management client
    - notReady—Receiver does not have enough configuration information to go active
    - error—Configuration/operational error
  - Status
    - Success
    - Copy source does not exist or is unreachable
    - Copy failed
    - File in use
- Example

      host1#show bulkstats receiver

        Index  RemoteFileName
        -----  ----------------------------------------------
        1      f:/upload/bulkStas.sts

        Index  State     Status
        -----  --------  ---------------------------------------------
        1      notReady  Copy source does not exist or is unreachable

- See show bulkstats receiver.

show bulkstats statistics

- Use to display bulk statistics counters.
- Field descriptions
  - AdminStatus—Administrative status of the bulk statistics application
  - OperStatus—Operational status of the bulk statistics application
  - HdwDetects—Number of times the bulk statistics application detected a line module bulkstat collector’s presence
  - HdwCollectorCreates—Number of line module collectors created
  - CollectorCreateReqs—Number of times the bulk statistics application requested the creation of a line module collector
  - CollectorStopReqs—Number of times the bulk statistics application requested the line module collectors to stop
  - CollectorDeleteReqs—Number of times the bulk statistics application requested the deletion of a line module collector
  - CollectorStarts—Number of times the bulk statistics collector has started
  - CollectorIncompleteCfgs—Number of times the bulk statistics collector attempted to start a collector, but failed because the collector’s configuration was incomplete
  - CollectorStopFailures—Number of times the bulk statistics collector failed during a collector stop request
  - DriverErrors—Number of bulk statistics driver errors
  - FileSizeFulls—Number of times the bulk statistics application ran out of storage space
  - CollectorFileNearlyFullTraps—Number of nearly full events posted to the SNMP agent on this router
  - CollectorFileFullTraps—Number of file full events posted to the SNMP agent on this router
  - Intervals—Number of times the bulk statistics collector has cycled through a collection
  - PrimaryXfers—Number of times the bulk statistics collector has attempted a data file transfer to a primary server
  - PrimaryFails—Number of primary server transfer failures
  - SecondaryXfers—Number of times the bulk statistics collector has attempted a data file transfer to a secondary server
  - SecondaryFails—Number of secondary server transfer failures
  - BulkStats Collector Statistics:
    - Index—Bulk statistics collector index
    - CurrSize—Current size of the bulk statistics storage file in bytes
    - CreateErrs—Number of bulk statistics collector create errors
    - Last Transfer Failure—Last time that the collector attempted to retrieve statistics and was unsuccessful
    - Interval Start Time—Start of current interval or bulk collections. The collector began collecting bulk statistics at this time.
    - Interval Stop Time—End of current interval of bulk collections
  - Dynamic Interface Collector statistics:
    - Collector Index—Bulk statistics collector index
    - Slot#—Slot number from which the statistics were obtained
    - Received—Number of records for dynamic interfaces that were reported by the specified interface
    - Transferred—Number of record for dynamic interface that were written to the bulk statistics (.sts) file.
    - Dropped—Number of records for dynamic interfaces that were dropped (that is, not written to the bulk statistics [.sts] file)
- Example

      host1#show bulkstats statistics

      AdminStatus:                  enabled
      OperStatus:                   enabled
      HdwDetects:                   4
      HdwCollectorCreates:          8
      CollectorCreateReqs:          2
      CollectorStopReqs:            0
      CollectorDeleteReqs:          0
      CollectorStarts:              25
      CollectorIncompleteCfgs:      3
      CollectorStopFailures:        0
      DriverErrors:                 0
      FileSizeFulls:                0
      CollectorFileNearlyFullTraps: 0
      CollectorFileFullTraps:       0

        Intervals PrimaryXfers PrimaryFails SecondaryXfers  SecondaryFails
        --------- ------------ ------------ --------------  --------------
        24         18            5             0               0

        BulkStats Collector Statistics:
        Index  CurrSize  CreateErrs  Last Transfer Failure
        -----  --------  ----------  ----------------------------
        1      331       0           MON JAN 24 2001 17:21:33 UTC
        2      0         0

        Index Interval Start Time          Interval Stop Time
        ----- ---------------------------- -------------------------
        1     MON JAN 24 2001 19:09:33 UTC MON JAN 24 2001 19:15:33 UTC
        2     Not started                  N/A

      Dynamic Interface Collector statistics:
        CollectorIndex  Slot#  Received    Transferred  Dropped
        --------------  -----  ----------  -----------  ----------
        1               1      0           0            0

- See show bulkstats statistics.

show bulkstats traps

- Use to display information about the bulk statistics traps configured to collect statistics.
- Field descriptions
  - Trap Type
    - nearly-full—Trap will be posted to the SNMP entity on this system when the threshold is reached
    - file-full—Trap will be posted to the SNMP entity on this system when the trap reaches 100%
  - State—Configuration setting: enabled, disabled
  - Threshold—Nearly full trap will be posted to the SNMP entity on this system when this percentage is reached
  - Traps Sent—Number of times this event was posted to the SNMP entity on this system
- Example

      host1#show bulkstats traps
      Trap Type    State   Threshold    Traps Sent
      -----------  -------  ----------  ----------
      file-full    enabled  N/A         0
      nearly-full  enabled  5           0

- See show bulkstats traps.

show bulkstats virtual-routers

- Use to display information about the bulk virtual router group configuration.
- Field descriptions
  - Collector—Number that identifies the particular data collector, in the range 1–65535
  - Virtual-Routers—Set of virtual router names (up to 64 names)
- Example

      host1#show bulkstats virtual-routers

      Collector  Virtual-Routers
      ---------  ---------------
      33             serviceProviderABC
      655             default

- See show bulkstats virtual-routers.

## Understanding Schemas

You can set a management schema for bulk statistics. A schema is a group of attributes or counters that provide an efficient way to retrieve specific types of information about the router. The bulk statistics application supports schemas listed in Table 24.

| Note: There are no explicit schema objects for the if-stack and system schemas.

Table 24 shows the type of data each schema retrieves.

Table 24: Data Retrieved According to Schema

Schema | Retrieves
--- | ---
if-stack | The interface and interface column configuration. It is a complete retrieval of the ifStackTable, which stores the configured interfaces and their stacking relationship on a router.
if-stats | Usage data on sets of interface types. The interface usage data is the ifTable/ifXTable counters. The ifXTable supports 64-bit counters and the data written into the bulk statistics file supports the 64-bit counters.
igmp | Statistics associated with various IGMP components.
policy | Statistics associated with a specified policy, a policy type, or traffic tagged by a policy with a color tag.
qos | QoS statistics on egress queues for various interface types. The QoS schema enables service providers to keep track of network congestion and monitor oversubscription on the egress queues of the router.
system | Global system and per-module statistics and information. The global system statistics retrieved are the sysUpTime and nvsUtilPct. The per-module statistics and information retrieved include the intPhysicalDesc, the cpuUtilPct, and the memUtilPct.

### If-Stats Schema Objects

Table 25 describes the if-stats objects that you can configure using the bulkstats schema subtree if-stats command.

Table 25: if-stats Schema Objects

Object | Definition
--- | ---
all | Configure If-stats schema for all stats
correlator | Configure If-stats schema for correlator
in-bcast-pkts | Configure If-stats schema for in-bcast-pkts
in-discards | Configure If-stats schema for in-discards
in-errors | Configure If-stats schema for in-errors
in-mcast-octets | Configure If-stats schema for in-mcast-octets
in-mcast-pkts | Configure If-stats schema for in-mcast-pkts
in-octets | Configure If-stats schema for in-octets
in-policed-octets | Configure If-stats schema for in-policed-octets
in-policed-pkts | Configure If-stats schema for in-policed-pkts
in-spoofed-pkts | Configure If-stats schema for in-spoofed-pkts
in-ucast-pkts | Configure If-stats schema for in-ucast-pkts
in-unknown-protos | Configure If-stats schema for in-unknown-protos
lower-interface | Configure If-stats schema for lower-interface
out-bcast-pkts | Configure If-stats schema for out-bcast-pkts
out-discards | Configure If-stats schema for out-discards
out-errors | Configure If-stats schema for out-errors
out-mcast-octets | Configure If-stats schema for out-mcast-octets
out-mcast-pkts | Configure If-stats schema for out-mcast-pkts
out-octets | Configure If-stats schema for out-octets
out-policed-octets | Configure If-stats schema for out-policed-octets
out-policed-pkts | Configure If-stats schema for out-policed-pkts
out-sched-octets | Configure If-stats schema for out-sched-octets
out-sched-pkts | Configure If-stats schema for out-sched-pkts
out-ucast-pkts | Configure If-stats schema for out-ucast-pkts
time-offset | Configure If-stats schema for time-offset

All the schema if-stats objects in Table 25 apply to both layer 2 and layer 3 interfaces, except usdAcctngSpoofedPkts, which is specific to layer 3.

Defining all interface types before you map a collector to the if-stats schema ensures that you display statistics for all configured interfaces in the first interval.

You can get more accurate rate statistics by using the time-offset parameter. To use this parameter you must navigate to the if-stats subtreelist. The time-offset parameter is included in each bulk statistics interface record and is the offset from the master interval at which the record was collected.

### IGMP Schema Objects

Table 26 describes the IGMP objects that you can configure using the bulkstats schema subtree igmp command.

Table 26: IGMP Schema Objects

Object | Definition
--- | ---
all | Configure IGMP schema for all attributes
dest-address | Configure IGMP schema for destination address
igmp-cmd | Configure IGMP schema for IGMP command
lower-interface | Configure IGMP schema for lower interface
multicast-group | Configure IGMP schema for multicast group
router-index | Configure IGMP schema for router index
source-address | Configure IGMP schema for source address
time-stamp | Configure igmp schema for time stamp

### Policy Schema Objects

Table 27 describes the policy objects that you can configure using the bulkstats schema subtree policy command.

Table 27: Policy Schema Objects

Object | Definition
--- | ---
all | Configure policy schema for all statistics
green-bytes | Configure policy schema for green bytes
green-packets | Configure policy schema for green packets
red-bytes | Configure policy schema for red bytes
red-packets | Configure policy schema for red packets
upper-green-bytes | Configure policy schema for upper green bytes
upper-green-packets | Configure policy schema for upper green packets
upper-red-bytes | Configure policy schema for upper red bytes
upper-red-packets | Configure policy schema for upper red packets
upper-yellow-bytes | Configure policy schema for upper yellow bytes
upper-yellow-packets | Configure policy schema for upper yellow packets
yellow-bytes | Configure policy schema for yellow bytes
yellow-packets | Configure policy schema for yellow packets

### QoS Schema Objects

Table 28 describes QoS objects that you can configure using the bulkstats schema subtree qos command. For more information about QoS objects, see the JunosE Quality of Service Configuration Guide.

Table 28: QoS Schema Objects

Object | Definition
--- | ---
aggregate-drop-rate | Configure QoS schema to export the average drop rate within the rate period specified in the statistics profile of the egress queue
all | Configure QoS schema to export all statistics; this is the default option
assured-rate | Configure QoS schema to export the assured rate attribute
burst | Configure QoS schema to export the burst attribute
byte-adjustment-bytes | Configure QoS schema to export the number of bytes configured for the byte-adjustment application, if the byte-adjustment application is enabled on the queue
byte-adjustment-rate | Configure QoS schema to export the type of byte-adjustment, if byte-adjustment is enabled on the queue
drop-profile | Configure QoS schema to export the drop profile name associated with the queue
forwarded-bytes | Configure QoS schema to export the number of bytes forwarded from the queue
forwarded-packets | Configure QoS schema to export the number of forwarded packets from the queue
forwarded-rate | Configure QoS schema to export the average forwarded rate within the rate period specified on the statistics profile of the queue
green-dropped-bytes | Configure QoS schema to export the number of bytes of green traffic that were dropped on this queue
green-dropped-packets | Configure QoS schema to export the number of packets of green traffic that were dropped on this queue
parent-shaping-rate | Configure QoS schema to export the shaping rate enabled on the parent interface in the scheduling hierarchy
parent-shared-shaping-rate | Configure QoS schema to export the shared shaping rate enabled on the parent interface in the scheduling hierarchy
parent-weight | Configure QoS schema to export the aggregate weight of the parent interface
queue-length | Configure QoS schema to export the queue length attribute
queue-profile | Configure QoS schema to export the queue profile name
red-dropped-bytes | Configure QoS schema to export the number of bytes of red traffic that were dropped on the queue
red-dropped-packets | Configure QoS schema to export the number of red packets that were dropped on the queue
RED-enabled | Configure QoS schema to verify whether the Random Early Detect (RED) option is enabled on the queue
scheduler-profile | Configure QoS schema to export the scheduler profile name
shaping-mode | Configure QoS schema to export the shaping mode enabled on the queue
shaping-rate | Configure QoS schema to export the shaping rate enabled on the queue
shared-shaping-mode | Configure QoS schema to export the shared shaping mode enabled on the queue
shared-shaping-rate | Configure QoS schema to export the shared shaping rate enabled on the queue
statistics-profile | Configure QoS schema to export the statistics profile name
weight | Configure QoS schema to export the weight assigned to the queue
yellow-dropped-bytes | Configure QoS schema to export the number of bytes of yellow traffic that were dropped on the queue
yellow-dropped-packets | Configures QoS schema to export the number of yellow packets that were dropped on the queue

By default, a collector exports all queue attributes to its receiver. However, by choosing one or more QoS schema objects listed in Table 28, you can configure the QoS schema to export specific queue attributes.

You can associate an interface type with the QoS schema to enable the queue statistics collection on all line modules for every queue belonging to each instance of the specified interface type.

You can restrict or limit the statistics collection to a particular location or virtual router group by specifying the location of a particular slot, port, or virtual router group.

You can view the QoS rate statistics over each S-VLAN or ATM virtual path by including the export-summarized-stats keyword in the bulkstats schema subtree qos command. This keyword enables the export of the aggregate traffic rate to the receivers.

## Configuring Schemas

To configure a schema for collecting bulk statistics on an interface:

1. Configure a bulk statistics schema.
   host 1(config)#bulkstats schema 11
2. Assign a collector to the schema. The collector determines when the queue information is exported for the schema.
   host1(config)#bulkstats schema 11 collector 11

   See Configuring Collectors and Receivers for information about configuring collectors.

3. Specify the management schema to collect bulk statistics. In this particular example, the QoS schema is configured to collect bulk statistics.
   host1(config)#bulkstats schema 11 subtree qos
4. Specify the type of interface on which you want to collect the statistics.
   host1(config)#bulkstats interface-type atm1483 collector 11
5. Configure a receiver to receive the collected statistics.
   host1(config)#bulkstats receiver 11 remote-name qos.sts

   See Configuring Collectors and Receivers for information about configuring collectors.

bulkstats schema

- Use to create the schema for collecting bulk statistics.
- Example—Creates schema with schema index 4
  host1(config)#bulkstats schema 4
- Use the no version to delete the specified schema.

  | Note: If you create a collector but there is no schema for that collector, the collector will not be active, and a schema will be created automatically for that collector to collect if-stats for all subtree attributes.

- See bulkstats schema.

bulkstats schema subtree if-stack

- Use to retrieve interface and interface column configuration information.
- Retrieves statistics from ifStackTable, which stores the configured interfaces and their stacking relationship on a router.
- Example—Configures the if-stack schema
  host1(config)#bulkstats schema 4 subtree if-stack
- Use the no version to delete the specified schema.
- See bulkstats schema subtree.

bulkstats schema subtree if-stats

- Use to retrieve interface usage data on sets of interface types.
- To collect statistics for the specified counter type, use the subtreelist keyword.
- To retrieve the offset from the master interval at which the record was created for the bulk statistics interface record, use the time-offset keyword.
- To collect the final statistics that may have been lost, use the if-create-delete-time-stats keyword.
- Example 1—Configures the schema to collect interface usage statistics for lower interface
  host1(config)#bulkstats schema 1 subtree if-stats subtreelist lower-interface
- Example 2—Configures the schema to retrieve final statistics that may have been lost during a higher create or delete frequency, for the specified interface
  host1(config)#bulkstats schema 5 subtree if-stats if-create-delete-time-stats interfaceType ?

        atm1483     Configure bulkstats for ATM 1483 sub-interfaces
        ip          Configure bulkstats for IP interfaces
        mplsL2Shim  Configure bulkstats for MPLS shim Interfaces
        mplsMajor   Configure bulkstats for MPLS major Interfaces
        mplsMinor   Configure bulkstats for MPLS minor Interfaces
        ppp         Configure bulkstats for PPP interfaces
        vlan        Configure bulkstats for VLAN Sub-Interfaces

- Use the no version to delete the specified schema.
- See bulkstats schema subtree.

bulkstats schema subtree igmp

- Use to collect IGMP usage data.
- To collect IGMP statistics for one or more IGMP attributes, use the subtreelist keyword.
- To retrieve the offset from the master interval at which the record was created for the bulk statistics interface record, use the time-offset keyword.
- Example—Configures the schema to collect the destination address and time-offset attributes for IGMP.
  host1(config)#bulkstats schema 4 subtree igmp dest-address time-offset
- Use the no version to delete the specified schema.
- See bulkstats schema subtree.

bulkstats schema subtree policy

- Use to collect statistics about a specified policy or a policy type, or based on color-coded tags applied by a policy.
- To collect statistics for a specified policy, use the policy-name keyword.
- To collect data on input policies, local input policies, output policies, or secondary output policies, use the policy-type keyword.
- To collect statistics based on color-coded tags applied by a policy, use the policy-subtreelist keyword.
- You create policies using the policy-list command. For information, see the JunosE Policy Management Configuration Guide.
- Example—Configures the schema to collect statistics for a policy named XMYpolicy
  host1(config)#bulkstats schema 4 subtree policy policy-name XMYpolicy
- Use the no version to delete the specified schema.
- See bulkstats schema subtree policy.

bulkstats schema subtree qos

- Use to configure the bulk statistics schema to collect QoS statistics and configuration information on egress queues belonging to different interface types.
- To export egress queue statistics based on the queue attributes specified for the QoS schema, use the subtreelist keyword.
- To export the summarized QoS rate statistics over each S-VLAN or ATM virtual path, use the export-summarized-stats keyword.
- Specifying the export-summarized-stats keyword enables the export of the summarized statistics over each S-VLAN or ATM virtual path. To ensure that you successfully receive the summarized statistics, do not filter out the forward-rate and aggregate-dropped-rate attributes from the egress queue data. To accomplish this, use either the bulkstats schema subtree qos all command or the bulkstats schema subtree qos forwarded-rate aggregate-dropped-rate command.
- Example 1—Configures the QoS schema to export all egress queue attributes
  host1(config)#bulkstats schema 4 subtree qos subtreelist all
- Example 2—Configures the QoS schema to export summarized QoS rate statistics
  host1(config)#bulkstats schema 4 subtree qos export-summarized-stats
- Use the no version to remove the QoS schema.
- See bulkstats schema subtree qos.

bulkstats schema subtree system

- Use to retrieve global system and per-module statistics and information.
- The schema retrieves global statistics sysUpTime and nvsUtilPct.
- The schema retrieves per-slot statistics and information such as the slotDescr, the cpuUtilPct, and the memUtilPct.
- Example—Configures the schema to collect the system statistics.
  host1(config)#bulkstats schema 4 subtree system
- Use the no version to delete the specified schema.
- See bulkstats schema subtree.

## Mapping Bulkstats Output to MIB Flies and CLI Configurations for Bulk Statistics Schema

Bulk statistics organizes data in the form of schema definitions. You can configure the schemas to retrieve specific accounting information by using the CLI or the SNMP MIB objects. The schemas support attributes that point to specific MIB objects. To retrieve specific network accounting information you must configure the CLI to query the corresponding MIB object.

Table 29 shows the mapping between the bulkstats output and the CLI and MIBs for policy schema.

Table 29: Mapping Bulkstats Output to MIB Flies and CLI Configurations for Policy Schema

Bulkstats Output Column Name | MIB File | MIB Object Name | CLI Configuration | Description
--- | --- | --- | --- | ---
|  |  | all | Configure IfStats schema for all stats
ifDescr | RFC1213 | ifDescr | – | A textual string containing information about the interface. This string should include the name of the manufacturer, the product name and the version of the interface hardware/software
ifType | RFC1213 | ifType | - | The type of interface. Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA), through updating the syntax of the IANAifType textual convention
usdIfType | juniIf | juniIfType | - | Identifies the type of this interface
ifIndex | RFC1213 | ifIndex | - | A unique value, greater than zero, for each interface. It is recommended that values are assigned contiguously starting from 1. The value for each interface sub-layer must remain constant at least from one re-initialization of the entity's network management system to the next re- initialization
IfStatsReportState | - | - | - | Report State: IfStatsReportInterim = Interim Accounting data
ifHCInOctets | RFC2863 | ifHCInOctets | in-octets | The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets 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 ifCounterDiscontinuityTime
ifHCInUcastPkts | RFC2863 | ifHCInUcastPkts | in-ucast-pkts | The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were not addressed to a multicast or broadcast address at this sub-layer. This object is a 64-bit version of ifInUcastPkts 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 ifCounterDiscontinuityTime
ifInDiscards | RFC1213 | ifInDiscards | in-discards | The number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space 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 ifCounterDiscontinuityTime
ifInErrors | RFC1213 | ifInErrors | in-errors | For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character- oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol 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 ifCounterDiscontinuityTime
ifInUnknownProtos | RFC1213 | ifInUnknownProtos | in-unknown-protos | For packet-oriented interfaces, the number of packets received via the interface which were discarded because of an unknown or unsupported protocol. For character-oriented or fixed-length interfaces that support protocol multiplexing the number of transmission units received via the interface which were discarded because of an unknown or unsupported protocol. For any interface that does not support protocol multiplexing, this counter will always be 0 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 ifCounterDiscontinuityTime
ifHCOutOctets | RFC2863 | ifHCOutOctets | out-octets | The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets 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 ifCounterDiscontinuityTime
ifHCOutUcastPkts | RFC2863 | ifHCOutUcastPkts | out-ucast-pkts | The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent. This object is a 64-bit version of ifOutUcastPkts 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 ifCounterDiscontinuityTime
ifOutDiscards | RFC1213 | ifOutDiscards | out-discards | The number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space 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 jjifCounterDiscontinuityTime
ifOutErrors | RFC1213 | ifOutErrors | out-errors | For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors. For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors 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 ifCounterDiscontinuityTime
ifCorrelato | juniAcctng | juniAcctngIfCorrelator | correlator | Customer correlation: FR = DLCI ATM = VPI, VCI IP = RouterName Everything else = not used
ifInPolicedOctets | juniAcctng | juniAcctngIfInPolicedOctets | in-policied-octets | Octets dropped due to ingress policy; support 64-bit counters
ifInPolicedPkt | juniAcctng | juniAcctngIfInPolicedPkts | in-policied-octets | Packets dropped due to ingress policy
ifInSpoofedPkts | juniAcctng | juniAcctngIfInSpoofedPkts | in-spoofed-pkts | Packets dropped due to invalid source address
ifOutPolicedOctets | juniAcctng | juniAcctngIfOutPolicedOctets | out-policied-octets | Octets dropped due to egress policy; support 64-bit counters
ifOutPolicedPkts | juniAcctng | juniAcctngIfOutPolicedPkts | out-policied-pkts | Packets dropped due to ingress policy
ifOutSchedOctets | juniAcctng | juniIpIfStatsOutSchedDropOctets | out-sched-octets | Scheduler octets dropped
ifOutSchedPkts | juniAcctng | juniIpIfStatsOutSchedDropPackets | out-sched-pkts | Scheduler packets dropped
ifLowerInterface | juniAcctng | juniAcctngIfLowerInterface | lower-interface | The ifIndex of the lower interface
ifTimeOffse | juniAcctng | juniAcctngIfTimeOffset | time-offset | -
ifHCInMulticastPkts | RFC2863 | ifHCInMulticastPkts | in-mcast-pkts | The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were addressed to a multicast address at this sub-layer. For a MAC layer protocol, this includes both Group and Functional addresses. This object is a 64-bit version of ifInMulticastPkts 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 ifCounterDiscontinuityTime
ifHCInBroadcastPkts | RFC2863 | ifHCInBroadcastPkts | in-bcast-pkts | The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were addressed to a broadcast address at this sub-layer. This object is a 64-bit version of ifInBroadcastPkts 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 ifCounterDiscontinuityTime
ifHCOutMulticastPkts | RFC2863 | ifHCOutMulticastPkts | out-mcast-pkts | The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast address at this sub-layer, including those that were discarded or not sent. For a MAC layer protocol, this includes both Group and Functional addresses. This object is a 64-bit version of ifOutMulticastPkts 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 ifCounterDiscontinuityTime
ifHCOutBroadcastPkts | RFC2863 | ifHCOutBroadcastPkts | out-bcast-pkts | The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a broadcast address at this sub-layer, including those that were discarded or not sent. This object is a 64-bit version of ifOutBroadcastPkts 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 ifCounterDiscontinuityTime
ifHCInMulticastOctets | - | - | in-mcast-octets | Multicast octets received
ifHCOutMulticastOctets | - | - | out-mcast-octets | Multicast octets sent

Table 30 shows the mapping between the bulkstats output and the CLI and MIBs for QoS schema.

Table 30: Mapping Bulkstats Output to MIB Flies and CLI Configurations for QoS schema

Bulkstats Output Column Name | MIB File | MIB Object Name | CLI Configuration | Description
--- | --- | --- | --- | ---
|  |  | all | Configure QoS schema for all queue attributes
ifDescr | RFC1213 | ifDescr | – | A textual string containing information about the interface. This string should include the name of the manufacturer, the product name and the version of the interface hardware/software
ifIndex | RFC1213 | ifIndex | - | A unique value, greater than zero, for each interface. It is recommended that values are assigned contiguously starting from 1. The value for each interface sub-layer must remain constant at least from one re-initialization of the entity's network management system to the next re- initialization
SVLAN/VP ID | - | - | - | The SVLAN or ATM virtual path ID over which the interfaces of the specified queue are stacked.
Traffic-Class-Name | - | - | - | The unique traffic class name within the traffic policy configured for the queue.
ParentNodeShapRate | rsacctng | rsAcctngParentShapingRate | shaping-rate | The shaping rate associated with the parent interface in the scheduling hierarchy of the queue. The attribute is a 32–bit integer.
ParentNodeSharedShapRate | rsacctng | rsAcctngParentSharedShapRate | shared-shaping-rate | The shared shaping rate associated with the parent interface in the scheduling hierarchy of the queue. The attribute is a 32–bit integer.
ParentNodeChildrenWeight | rsacctng | rsAcctngParentChildWeight | parent-weight | The total weight of the child queues for a parent node in the scheduling hierarchy. The attribute is a 32–bit integer.
QDropProfile | rsacctng | rsAcctngDropProfile | drop-profile | The drop profile name associated with the egress queue. The attribute is a 32–bit character string.
QQueueProfile | rsacctng | rsAcctngQueueProfile | queue-profile | The queue profile name associated with the egress queue. This attribute can be 32 characters long. The attribute is a 32–bit character string.
QSchedulerProfile | rsacctng | rsAcctngSchedulerProfile | scheduler-profile | The scheduler profile name associated with the egress queue. The attribute is a 32–bit character string.
QStatsProfile | rsacctng | rsAcctngStatisticsProfile | statistics-profile | The statistics profile name associated with the egress queue. The attribute is a 32–bit character string.
QShapMode | rsacctng | rsAcctngShapingMode | shaping-mode | The shaping mode associated with the egress queue. In the shape mode, is used to control the downstream rate for different media.
QShapRate | rsacctng | rsAcctngShapingRate | shaping-rate | The shaping rate attribute of the egress queue. In the shape mode, when queue is guaranteed a certain percentage of bandwidth, the queue cannot use more than the allocated bandwidth even if the link is idle. For egress queues, the QShapRate attribute returns the bit rate at which the traffic for the queue is shaped. The attribute is a 32–bit integer.
QLength | rsacctng | rsAcctngQueueLength | queue-length | The length of the egress queue. The attribute is a 32–bit integer.
QBurst | rsacctng | rsAcctngBurst | burst | The burst attribute of the egress queue. The attribute is a 16–bit integer.
QWeight | rsacctng | rsAcctngWeight | weight | The weight attribute of the queue. The weight of the queue determines the bandwidth that will be allocated to the queue during congestion. The attribute is a 16–bit integer.
QAssuredRate | rsacctng | rsAcctngAssuredRate | assured-rate | The assured rate for the queue. The attribute is a 32–bit integer.
QREDEnabled | rsacctng | rsAcctngRedEnabled | RED-enabled | Indicates if the Random Early Detect (RED) is enabled for the queue.
QSharShapType | rsacctng | rsAcctngSharedShapingMode | shared-shaping-mode | Indicates the type of shared-shaping enabled on the queue.
QSharShapRate | rsacctng | rsAcctngSharedShapingRate | shared-shaping-rate | Indicates the rate of shared-shaping enabled on the queue. The attribute is a 32–bit integer.
QByteAdjType | rsacctng | rsAcctngByteAdjType | byte-adjustment-type | The type of byte adjustment application configured on the queue.
QByteAdjBytes | rsacctng | rsAcctngByteAdjBytes | byte-adjustment-bytes | The number of bytes for the byte adjustment application configured on the queue.
QFwdedRate | rsacctng | rsAcctngForwardedRate | forwarded-rate | The average forward rate of the queue. It is averaged over the rate period of the statistics-profile associated with the queue. The attribute is a 64–bit integer.
QAggDropRate | rsacctng | rsAcctngAggDropRate | aggregate-drop-rate | The average drop rate of the queue, including red, green and yellow packets. It is calculated over the rate period of the queue’s statistics profile. The attribute is a 64–bit integer.
QFwdedPkts | rsacctng | rsAcctngForwardedPackets | forwarded-packets | The number of packets that were forwarded on the queue. The attribute is a 64–bit integer.
QFwdedOctets | rsacctng | rsAcctngForwardedBytes | forwarded-bytes | The number of octets that were forwarded on the queue. The attribute is a 64–bit integer.
QGreenDiscardPkts | rsacctng | rsAcctngGreenDropPackets | green-drop-packets | The number of green packets which were chosen to be discarded even though no errors had been detected to prevent their being received. The attribute is a 64–bit integer.
QGreenDiscardOctets | rsacctng | rsAcctngGreenDropBytes | green-drop-bytes | The number of green octets which were chosen to be discarded even though no errors had been detected to prevent their being received. The attribute is a 64–bit integer.
QYellowDiscardPkts | rsacctng | rsAcctngYellowDropPackets | yellow-drop-packets | The number of yellow packets which were chosen to be discarded even though no errors had been detected to prevent their being received. The attribute is a 64–bit integer.
QYellowDiscardOctets | rsacctng | rsAcctngYellowDropBytes | yellow-drop-bytes | The number of yellow octets which were chosen to be discarded even though no errors had been detected to prevent their being received. The attribute is a 64–bit integer.
QRedDiscardPkts | rsacctng | rsAcctngRedDropPackets | red-drop-packets | The number of red packets which were chosen to be discarded even though no errors had been detected to prevent their being received. The attribute is a 64–bit integer.
QRedDiscardOctets | rsacctng | rsAcctngRedDropBytes | red-drop-bytes | The number of red octets which were chosen to be discarded even though no errors had been detected to prevent their being received. The attribute is a 64–bit integer.

## Monitoring Schema Statistics

You are able to display your configuration and monitor the data generated by schemas.

show bulkstats schema

- Use to display data on the bulk statistics schema.
- Field descriptions
  - Schema Information:
  - Index—Index number of the schema
  - Subtree—Type of bulk statistics schema configured on the collector: igmp, if-stack, if-stats, policy, QoS, or system
  - CollectorIndex—Bulk statistics collector index (same as the SNMP table index)
  - State
    - active—Schema is properly configured and currently active
    - notInService—Schema has been decommissioned by a management client
    - notReady—Schema does not have enough configuration information to go active
    - error—Configuration/operational error
  - Subtree List—Types of statistics the schema is configured to receive
- Example 1—Displays bulk statistics information for a schema that is configured to retrieve the if-stack and system information.

      host1#show bulkstats schema

        Schema Information:
        Index  Subtree            CollectorIndex  State
        -----  -----------------  --------------  --------
        1      ifStack            1               active
        2      system             2               active

        Index  Subtree List
        -----  -------------------------------------------------
        1      N/A
        2      N/A

- Example 2—Displays bulk statistics configuration information for a schema that is configured to retrieve interface usage information (specified by the ifstats keyword) for the out-errors, lower-interface, and time-offset counters. The schema is also configured for retrieving the global system and per-module statistics information (specified by the system keyword).

      host1#show bulkstats schema

        Schema Information:
        Index  Subtree            CollectorIndex  State
        -----  -----------------  --------------  --------
        1      ifStats            1               active
        2      system             2               active

        Index  Subtree List
        -----  --------------------------------------------------
        1      ifOutErrors; ifLowerInterface; ifTimeOffset
        2      N/A

- Example 3—Displays bulk statistics configuration information for a schema that is configured to collect QoS statistics for egress queue level attributes, filtering out queue-length and queue profile name attributes

      host1#show bulkstats schema

        Schema Information:
        Index  Subtree            CollectorIndex  State
        -----  -----------------  --------------  --------
        1      qos                1               active
        2      system             2               active

        Index  Subtree List
        -----  --------------------------------------------------
        1      QLength; QQueueProfile
        2      N/A

- See show bulkstats schema.

## Configuring Interface Numbering Mode

E Series routers support the RFC 1213 interface numbering mode on bulkstats. This mode is contrasted with the default interface numbering mode.

The RFC 1213 numbering mode is based on a 32-bit contiguous integer value starting from 1 and ranging to ifNumber. This mode differs from the default interface numbering mode, which encodes a type field in the upper 8 bits of a 32-bit integer. The use of the upper 8 bits creates large gaps in the ifIndex numbering scheme.

There is no re-use of ifIndex values in RFC 1213 mode, whereas in the default interface numbering mode, ifIndex values can be re-used. In the default interface numbering mode, re-use of ifIndex values across reboots is permitted and is basically known as ifIndex re-numbering.

In RFC 1213 mode, however, the interface numbers are not re-used during a single initialization of the device and renumbering of ifIndexes occurs after a system reboot. In the default interface numbering mode, ifIndexes are persistent across system reboots and can be reused without resetting the value of sysUpTime.

In RFC 1213 mode, two parameters control the size of the ifIndex range and the total number of interfaces in the standard interface tables—maxIfIndex and maxIfNumber. There is no such control in the default interface numbering mode.

In RFC 1213 mode, interface creations should not result in gaps in the ifIndex range. A gap that results from the deletion of an interface is acceptable because it is handled by older network management applications. The gaps are eliminated after the router is rebooted. However, in the default interface numbering mode, large gaps occur from the creation of interfaces due to the use of the upper 8 bits of the ifIndex for interface type encoding. Gaps are not eliminated after a system reboot.

In RFC 1213 mode, small gaps can occur in the creation of IP interfaces when virtual routers are used. These gaps are minimized but not eliminated when the router is rebooted.

Rather than seeing an ifIndex value of 1 and 10066329, for example, a management client would see ifIndex values of 1 and 2.

bulkstats interfaces rfc1213

- Use to enable the RFC 1213 interface numbering mode on bulkstats.
- Example
  host1(config)#bulkstats interfaces rfc 1213
- Use the no version to disable the RFC 1213 interface numbering mode on bulkstats.
- See bulkstats interfaces rfc1213.