Statistics and Counters Overview

This document organizes and provides descriptive information for the various non-MIB forms of statistics, often called counters, generated by the ASR 5000. For this document, these statistics are divided into two categories: bulk statistics and statistics output by CLI show commands.

Bulk statistics are typically collected within configured time frames and then the data is put into files or moved to remote systems where the data is processed. The 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 for the system. The schema chapters in this document contain the bulk statistic variables for each schema.

The output statistics 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 output statistic represents a single element, where the bulk statistic value is often a combination of values for multiple elements,
  • the statistical display can be finetuned based on the keywords included in the show command when it is entered.

The output statistics are organized by the CLI show command that generates 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 do not present statistics but display configuration information for reference purposes; for example, show gs-service full name <service_name> will display the configuration for the named Gs service.

IMPORTANT:

The variables listed below are common to (used by) all bulk statistic schema.


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

Provides all the schemas.

Type: Information

String

schema-delta

Provides schemas if they have changed since last output.

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 local offset from GMT in the form "-0400"

Type: Information

String

swbuild

The software build number of the operating system.

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.

Schema Format String Syntax

The schema format string is used to define 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, e.g., “%var%”. The actual variables supported are command-dependent and are described with each command.