Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Configuring Collectors and Receivers

    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 bulk statistics feature supports generating files on a per interface basis.

    To configure the router to collect statistics:

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

      See Overview of Copying and Redirecting Files for information about adding names to the host table.

    2. Specify the type of interface 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.

      host1(config)#bulkstats interface-type ppp 3/1 collector 2
    3. Specify the parameters for the 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. For more information about usage of special characters, see Usage of Special Characters in Remote Filenames.

      Note: When specifying the remote filename for bulk statistics, you must precede the filename with the hostname followed by the :/ characters.

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

      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 to which the system transfers data.

      Note: The index for the receiver must match the index that you specified with the bulkstats receiver remote-name command.

      host1(config)#bulkstats collector 2 primary-receiver 1
    7. (Optional) Assign the secondary (that is, the backup) receiver to which the system transfers data.

      Note: The index for the receiver must match the index you specified with the bulkstats receiver remote-name command.

      host1(config)#bulkstats collector 2 secondary-receiver 5
    8. (Optional) Specify the time interval in seconds for which the collector transfers data to the receivers.
      host1(config)#bulkstats collector 2 interval 1000
    9. (Optional) 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.

      Note: Although the CLI accepts the commands, you cannot unconfigure or modify the configuration of the maximum file size until the router is rebooted.

      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. The bulkstats interfaces description-format command provides compatibility with software that uses the industry encoding scheme. For more information about SNMP server encoding scheme, see Configuring the SNMP Server 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, rather than periodically.
      host1(config)#bulkstats collector 2 single-interval
    13. (Optional) Configure bulk statistics traps.

      Note: You must configure SNMP correctly and specify a valid trap source. Otherwise, the system will not send SNMP traps.

      host1(config)#bulkstats traps nearly-full
    14. (Optional) Collect bulk statistics per 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.


      • The bulkstats virtual-router-group command is supported only on if-stats and igmp schemas.
      • The bulkstats virtual-router-group command is 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.
      host1(config)#bulkstats virtual-router-group collector 2 routerISP3

    Published: 2014-08-12