Monitoring the Bulk Statistics Collection Configuration

This section describes the show command used to view the parameters the router uses to collect statistics and to display your configuration and monitor the data generated by schemas.

Monitoring the Bulks Statistics Data Collection Configuration

Purpose

Display the bulk statistics data collection configuration.

Action

To display the bulk statistics data collection configuration:

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

Meaning

Table 34 lists the show bulkstats command output fields.

Table 34: show bulkstats Output Fields

Field Name

Field Description

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

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)

Monitoring the Bulk Statistics Collector File Description

Purpose

Display information about the collector’s file description.

Action

To display information about the collector’s file description:

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

Meaning

Table 35 lists the show bulkstats collector description command output fields.

Table 35: show bulkstats collector description Output Fields

Field Name

Field Description

Index

Index number of the bulk statistics collector

FileDescription

Descriptive information added to the bulk statistics file with the bulkstats collector description command

Monitoring the Bulk Statistics Collector Transfer Interval

Purpose

Display information about the collector transfer interval configuration.

Action

To display information about the collector transfer interval configuration:

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

Meaning

Table 36 lists the show bulkstats collector interval command output fields.

Table 36: show bulkstats collector interval Output Fields

Field Name

Field Description

Index

Index number of the bulk statistics collector

Interval

Amount of time, in seconds, that the collector transfers data to the receiver

Monitoring the Bulk Statistics Collector Maximum File Size

Purpose

Display information about the bulk statistics maximum file size configuration.

Action

To display information about the bulk statistics maximum file size configuration:

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

Meaning

Table 37 lists the show bulkstats collector max-size command output fields.

Table 37: show bulkstats collector max-size Output Fields

Field Name

Field Description

Index

Index number of the bulk statistics collector

MaxSize

Maximum size of the bulk statistics file in bytes

Monitoring the Bulk Statistics Collector Transfer Mode Details

Purpose

Display information about the bulk statistics transfer mode configuration.

Action

To display information about the bulk statistics transfer mode configuration:

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

Meaning

Table 38 lists the show bulkstats collector transfer-mode command output fields.

Table 38: show bulkstats collector transfer-mode Output Fields

Field Name

Field Description

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

Monitoring the Bulk Statistics Interface Type Configuration

Purpose

Display information about the bulk statistics interface types configuration.

Action

To display information about the bulk statistics interface types configuration:

host1#show bulkstats interface-type
Interface Types:
  Index         Type             Collector  State
  -----  ----------------------  ---------  --------
  1      ppp                     1          active

Meaning

Table 39 lists the show bulkstats interface-type command output fields.

Table 39: show bulkstats interface-type Output Fields

Field Name

Field Description

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

Monitoring the Bulk Statistics Receiver Remote Files Configuration

Purpose

Display information about the remote file configuration of the bulk statistics receiver.

Action

To display information about the remote file configuration of the bulk statistics receiver:

host1#show bulkstats receiver
  Index  RemoteFileName
  -----  ----------------------------------------------
  1      f:/upload/bulkStas.sts
  Index  State     Status
  -----  --------  ---------------------------------------------
  1      notReady  Copy source does not exist or is unreachable

Meaning

Table 40 lists the show bulkstats receiver command output fields.

Table 40: show bulkstats receiver Output Fields

Field Name

Field Description

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/operational error

Status

  • Success
  • Copy source does not exist or is unreachable
  • Copy failed
  • File in use

Displaying the Bulk Statistics Counter Details

Purpose

Display bulk statistics counters.

Action

To display bulk statistics counters:

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

Meaning

Table 41 lists the show bulkstats statistics command output fields.

Table 41: show bulkstats statistics Output Fields

Field Name

Field Description

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)

Monitoring the Bulk Statistics Trap Configuration

Purpose

Display information about the bulk statistics traps configured to collect statistics.

Action

To display information about the bulk statistics traps configured to collect statistics:

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

Meaning

Table 42 lists the show bulkstats traps command output fields.

Table 42: show bulkstats traps Output Fields

Field Name

Field Description

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

Monitoring the Bulk Statistics Virtual Router Group Configuration

Purpose

Display information about the bulk virtual router group configuration.

Action

To display information about the bulk virtual router group configuration:

host1#show bulkstats virtual-routers
Collector  Virtual-Routers
---------  ---------------
33             serviceProviderABC
655             default

Meaning

Table 43 lists the show bulkstats virtual-routers command output fields.

Table 43: show bulkstats virtual-routers Output Fields

Field Name

Field Description

Collector

Number that identifies the particular data collector, in the range 1–65535

Virtual-Routers

Set of virtual router names (up to 64 names)

Related Documentation