Statistics Service Commands - Cisco XR 1200 series Command Reference Manual

Statistics Service Commands

This module describes the Cisco IOS XR software commands related to the collection of interface statistics
(StatsD) for system monitoring on the router. Interface statistics on the router are found in hardware (most
of the time) and software (exception packets). The counters are always local (relative to the CPU) to the
node on which the interface is homed. The Cisco IOS XR software provides an efficient mechanism to collect
these counters from various application-specific integrated circuits (ASICs) or NetIO and assemble an
accurate set of statistics for an interface. After the statistics are produced, they can be exported to interested
parties (command-line interface [CLI], Simple Network Management Protocol [SNMP], and so forth).
The Cisco IOS XR software statistics collection system provides a common framework to be used by all
interface owners to export the statistics for interfaces they own. The system also defines a common set of
statistics that are relevant to all interfaces and thereby provides a consistent and constant set of counters that
are always associated and maintained with any interface on the router.
The statistics collection system includes the statistics manager, the statistics server, one or more statistics
collectors, and the necessary libraries. Each node on a router houses one statistics server.
In addition to the statistics server, each node (that has interfaces) has one or more statistics collectors. Statistics
collectors are platform specific and can obtain various hardware and software counters to satisfy requests
from the statistics server.
The statistics manager does not attempt to produce statistics for interfaces for which no statistics collector
has registered. Requests for statistics on interfaces for which no statistics collector has registered results in
an error returned to the requestor by the statistics manager.
• clear counters, page 414
• load-interval, page 416
OL-24735-01
Cisco IOS XR System Monitoring Command Reference for the Cisco XR 12000 Series Router, Release 4.1
413