Statistics and Counters Overview

This document organizes and describes various non-SNMP-MIB forms of statistics, often called counters, generated by the ASR 5x00. For this document, these statistics are divided into two categories: bulk statistics and dynamic statistics output by CLI show commands.

Bulk statistics are typically collected within configured time frames. The data is written to files or transported to remote systems where it is processed. Bulk statistic variables are organized by shared concepts (such as service or interface) into schema. For example, the system schema includes all the statistics collected at the system level. The schema chapters in this document describe the bulk statistic variables for each schema.

The statistics output by show commands usually provide a greater degree of granularity than the bulk statistics because:
  • the dynamic content is captured at the time the CLI command is entered,
  • the command output represents a single element, whereas bulk statistics are often a combination of values for multiple elements,
  • the command output can be fine-tuned using keywords included in the show command when it is entered.

The types of output statistics are governed by the CLI show commands that generate their display. For example, show power all cards displays the current power status for each card in every slot of the chassis.

Some of the show command outputs display configuration information for reference purposes. For example, show gs-service full name <service_name> displays the configuration for the named Gs service.

Variables Common to all Bulkstats

Variables that are common to (used by) all bulk statistic schema are listed in the table below.

Table 1. Common Bulk Statistic Variables
Variables Description Data Type

uptime

The total uptime (in seconds) of the system that created the file.

Type: Counter

Int32

host

The system hostname that created the file

Type: Information

String

ipaddr

The default management (local context) IP address in dotted decimal format. An empty string is inserted if no address is available.

Type: Information

String

date

The UTC date that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day.

Type: Information

String

date3

The UTC date that the collection file was created in YYMMDD format where YY represents the year, MM represents the month and DD represents the day.

Type: Information

String

time

The UTC time that the collection file was created in HHMMSS format where HH represents the hours, MM represents the minutes, and SS represents the seconds.

Type: Information

String

time2

The UTC time that the collection file was created in HH:MM:SS format where HH represents the hours, MM represents the minutes, and SS represents the seconds.

Type: Information

String

time3

The UTC time that the collection file was created in HH:MM format where HH represents the hours, MM represents the minutes.

Type: Information

String

epochtime

The number of seconds since Jan 1, 1970, 00:00:00 GMT.

Type: Counter

Int32

schemas

Lists all bulkstat schemas available on this platform.

Type: Information

String

schema-delta

Lists all bulkstats schemas that have changed the schema list was last displayed.

Type: Information

String

localdate

The date (adjusted for the local timezone) that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day.

Type: Information

String

localdate3

The date that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day. The date displays in local time, not UTC.

Type: Information

String

localtime

The time (adjusted for the local timezone) that the collection file was created in HHMMSS format where HH represents the hours, MM represents the minutes, and SS represents the seconds.

Type: Information

String

localtime2

The time (adjusted for the local timezone) that the collection file was created in HH:MM:SS format where HH represents the hours, MM represents the minutes, and SS represents the seconds.

Type: Information

String

localtime3

The time that the collection file was created in HH:MM:SS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. The time displays in local time, not UTC.

Type: Information

String

localtz

The name of the local time zone.

Type: Information

String

localtzoffset

The offset from UTC/GMT for the local timezone. Format = “+” or “-” HHMM.

Type: Information

String

swbuild

The build number of the StarOS version.

Type: Information

String



Common Syntax Options

The following defines common syntax block options. These options appear in similar commands and are detailed here for easy reference.

A schema format string defines the structure of generated bulk statistics data. The string may contain static text, dynamic content, and bulk statistic variables, or any combination.

Static text includes any ASCII characters which are of a fixed value. Static text may also include control characters by using escaped character sequences.

Escaped character short cuts are supported such as ‘\n’ for new line and ‘\t’ for tab.

Variables within the format string must be enclosed in double ampersands, for example, “%var%”. The actual variables supported are command-dependent and are described with each command.