Configuring SNMP > Collecting Bulk Statistics

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.

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.

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.

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 Using the copy Command in Chapter 5, 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.

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.

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.

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).

bulkstats collector max-size

• Use to set the maximum size of the bulk statistics file.
• 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, 3670016 bytes.

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.

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.

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.

bulkstats interfaces description-format common

• Use to set the encoding scheme of the ifDescr object that the bulkstats 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.

bulkstats interface-type

• Use to configure the interface 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
• ATM 1483
• Ethernet
• Frame Relay
• Frame Relay subinterface
• Cisco HDLC
• IP
• PPP
• VLAN subinterface
  

  NOTE: You cannot collect statistics on the SRP Ethernet interface.

  
  

• Example

host1(config)#bulkstats interface-type ppp 3/1 collector 2

• 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.

bulkstats receiver remote-name

• Use to configure the parameters for receivers.
• Bulk statistics transfers require the configuration of a remote FTP server.
• The FTP file transfer supports only anonymous transfers to remote servers. Other usernames and passwords are not supported.
• The receivers must appear in the FTP host table (see Using the copy Command in Chapter 5, Managing the System). 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 run time with the sysName and sysUpTime parameters to produce variable filenames on the remote host. 



 

• Use the no version to delete the receiver.

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.

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 BulkStats.
• 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.

Deleting All Bulkstats Configurations

Though 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

• There is no no version.

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 Chapter 2, 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 against 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—NMS 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
• Index—Bulk statistics collector index number
• 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, or system
• Index—Index number of the schema
• CollectorIndex—Bulk statistics collector index number
• Index—Index number of the schema
• 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

• Index—Index number of the schema
• 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
• 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 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

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

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                 

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 

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                      

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

show bulkstats receiver

• Use to display information about the bulk statistics receiver's remote file configuration.
• 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

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
• Index—Bulk statistics collector index
• 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

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 

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

Configuring Schemas

You can also 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 five schema configurations: igmp, if-stack, if-stats, policy, and system.

Table 23 shows the type of data each schema retrieves.

Table 23: Data Retrieved According to Schema  

Schema	Retrieves . . .
igmp	Statistics associated with various IGMP components.
if-stack	The interface and interface column configuration. It is a complete retrieval of the ifStackTable, and using it can dramatically reduce the time to discover 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. Note that the ifXTable supports 64-bit counters and the data written into the bulk statistics file supports the 64-bit counters.
policy	Statistics associated with a specified policy, a policy type, or traffic tagged by a policy with a color tag.
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.

igmp Objects

Table 24 presents igmp objects you can configure using the bulkstats schema subtree command.

Table 24: Schema igmp 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

if-stats Objects

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

Table 25: Schema ifStats Objects  

Object	Definition
usdAcctngifInBroadcastPkts	Broadcast packets received
usdAcctngIfInOctets	Octets received; support 64-bit counters
usdAcctngIfInUcastPkts	Unicast packets received
usdAcctngIfInDiscards	Packets received and discarded
usdAcctngIfInErrors	Packets received with errors
usdAcctngifInMulticastPkts	Multicast packets received
usdAcctngIfInUnknownProtos	Packets received with unknown protocols
usdAcctngifOutBroadcastPkts	Broadcast packets sent
usdAcctngIfOutOctets	Octets sent; support 64-bit counters
usdAcctngIfOutUcastPkts	Unicast packets sent
usdAcctngIfOutDiscards	Packets sent and discarded
usdAcctngIfOutErrors	Packets sent with errors
usdAcctngifOutMulticastPkts	Multicast packets sent
usdAcctngIfCorrelator	Customer correlation: FR = DLCI ATM = VPI, VCI IP = RouterName Everything else = not used
usdAcctngIfInPolicedOctets	Octets dropped due to ingress policy; support 64-bit counters.
usdAcctngIfInPolicedPkts	Packets dropped due to ingress policy
usdAcctngIfInSpoofedPkts	Packets dropped due to invalid source address
usdAcctngIfOutPolicedOctets	Octets dropped due to egress policy; support 64-bit counters
usdAcctngIfOutSpoofedPkts	Packets dropped due to invalid source address
usdAcctngIfOutSchedulerDropPks	Scheduler packets dropped
usdAcctngIfOutSchedulerOctets	Scheduler octets dropped
usdAcctngIfLowerInterface	The ifIndex of the lower interface
usdAcctngIfInMulticastOctets	Multicast octets received
usdAcctngIfOutMulticastOctets	Multicast octets sent

NOTE: 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.

NOTE: 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.

bulkstats schema

• Use to create the schema for collecting bulk statistics.
• Example

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.

  
  

bulkstats schema subtree

• Use to set the schema for collecting data. Specify one of the following keywords:

• if-stack—Retrieves the interface and interface column configuration
• if-stats—Retrieves interface usage data on sets of interface types; using the subtreelist keyword along with the if-stats keyword lets you specify specific counters and lets you set the time-offset parameter; using the if-create-delete-time-stats keyword retrieves interface final statistics (interface statistics that may be lost during higher create or delete frequency)
• igmp—Retrieves IGMP usage data; using the subtreelist keyword along with the igmplist keyword lets you obtain statistics for one or more specific IGMP lists.
• system—Retrieves global system and per-module statistics and information

• Example

host1(config)#bulkstats schema 1 subtree if-stats subtreelist lower-interface

• Use the no version to delete the specified schema.

bulkstats schema subtree policy

• Use to collect statistics on a specified policy, a policy type, or based on color-coded tags applied by a policy. Specify one of the following keywords:

• policy-name—Collects statistics for a specified policy
• policy-type—Collects data on input policies, local input policies, or output policies
• policy-subtreelist—Collects statistics based on color-coded tags applied by a policy

• You create policies using the policy-list command. See JUNOSe Policy Management Configuration Guide, Chapter 1, Policy Management Overview.
• Example

host1(config)#bulkstats schema 4 subtree policy policy-name XMYpolicy 

• Use the no version to delete the specified schema.

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, 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

• Index—Index number of the schema
• Subtree List—Type(s) of statistics the schema is configured to receive

• Example 1

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

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

Configuring Interface Numbering Mode

E-series routers support 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. Whereas, 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 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.