A statistics collection policy defines how frequently statistics are to
be collected (collection interval) and how frequently the statistics are to be
reported (reporting interval). Reporting intervals are longer than collection
intervals so that multiple statistical data points can be collected during the
reporting interval, which provides
Cisco UCS Manager
with sufficient data to calculate and report minimum, maximum, and average
values.
For NIC statistics, Cisco UCS Manager displays the average, minimum, and
maximum of the change since the last collection of statistics. If the values are
0, there has been no change since the last collection.
Statistics can be collected and reported for the following five
functional areas of the Cisco UCS system:
Adapter—statistics related to the adapters
Chassis—statistics related to the blade chassis
Host—this policy is a placeholder for future support
Port—statistics related to the ports, including server ports, uplink
Ethernet ports, and uplink Fibre Channel ports
Server—statistics related to servers
Note
Cisco UCS Manager
has one default statistics collection policy for each of the five functional
areas. You cannot create additional statistics collection policies and you
cannot delete the existing default policies. You can only modify the default
policies.
Commits the transaction to the system configuration.
The following example creates a statistics collection policy for
ports, sets the collection interval to one minute, the reporting interval to 30
minutes, and commits the transaction:
UCS-A# scope monitoring
UCS-A /monitoring # scope stats-collection-policy port
UCS-A /monitoring/stats-collection-policy* # set collection-interval 1minute
UCS-A /monitoring/stats-collection-policy* # set reporting-interval 30minutes
UCS-A /monitoring/stats-collection-policy* # commit-buffer
UCS-A /monitoring/stats-collection-policy #
Statistics Threshold Policies
Statistics Threshold Policy
A statistics threshold policy monitors statistics about certain aspects
of the system and generates an event if the threshold is crossed. You can set
both minimum and maximum thresholds. For example, you can configure the policy
to raise an alarm if the CPU temperature exceeds a certain value, or if a
server is overutilized or underutilized.
These threshold policies do not control the hardware or device-level
thresholds enforced by endpoints, such as the CIMC. Those thresholds are burned
in to the hardware components at manufacture.
Cisco UCS
enables you to configure statistics threshold policies for the following
components:
Servers and server components
Uplink Ethernet ports
Ethernet server ports, chassis, and fabric interconnects
Fibre Channel port
Note
You cannot create or delete a statistics threshold policy for
Ethernet server ports, uplink Ethernet ports, or uplink Fibre Channel ports.
You can only configure the existing default policy.
Server and Server Component Statistics Threshold Policy Configuration
Configuring a Server and Server Component Statistics Threshold
Policy
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope orgorg-name
Enters organization mode for the specified organization. To enter
the root organization mode, type
/ as the
org-name.
Creates the specified statistics threshold policy and enters
organization statistics threshold policy mode.
Step 3
UCS-A /org/stats-threshold-policy #
set descrdescription
(Optional)
Provides a description for the policy.
Note
If your description includes spaces, special characters, or
punctuation, you must begin and end your description with quotation marks. The
quotation marks will not appear in the description field of any
show command output.
Step 4
UCS-A /org/stats-threshold-policy #
commit-buffer
Commits the transaction to the system configuration.
The following example creates the server and server component
statistics threshold policy named ServStatsPolicy, provides a description for
the policy, and commits the transaction:
Creates the specified statistics threshold policy class and enters
organization statistics threshold policy class mode. The
class-name argument can be any of the class name
keywords available for the particular statistics threshold policy being
configured. To see a list of the available class name keywords, enter the
create class ? command in organization
statistics threshold policy mode.
Note
You can configure multiple classes for the statistics threshold
policy.
Creates the specified statistics threshold policy class property
and enters organization statistics threshold policy class property mode. The
property-name argument can be any of the
property name keywords available for the particular policy class being
configured. To see a list of the available property name keywords, enter the
create property ? command in organization
statistics threshold policy class mode.
Note
You can configure multiple properties for the policy class.
Step 5
UCS-A /org/stats-threshold-policy/class/property #
set normal-valuevalue
Specifies the normal value for the class property. The
value format can vary depending on the class property being
configured. To see the required format, enter the
set normal-value ? command in organization
statistics threshold policy class property mode.
Step 6
UCS-A /org/stats-threshold-policy /class/property #
create threshold-value{above-normal |
below-normal} {cleared |
condition |
critical |
info |
major |
minor |
warning}
Creates the specified threshold value for the class property and
enters organization statistics threshold policy class property threshold value
mode.
Note
You can configure multiple threshold values for the class
property.
Step 7
UCS-A
/org/stats-threshold-policy /class/property/threshold-value #
set{deescalating |
escalating}
value
Specifies the de-escalating or escalating class property threshold
value. The
value format can vary depending on the class property
threshold value being configured. To see the required format, enter the
set deescalating ? or
set escalating ? command in organization
statistics threshold policy class property threshold value mode.
Note
You can specify both de-escalating and escalating class property
threshold values.
Commits the transaction to the system configuration.
The following example creates the server and server component
statistics threshold policy class for CPU statistics, creates a CPU temperature
property, specifies that the normal CPU temperature is 48.5° C, creates an
above normal warning threshold of 50° C, and commits the transaction:
You cannot create (or delete) an uplink Ethernet port statistics
threshold policy. You can only enter (scope to) the existing default policy.
Step 3
UCS-A /eth-uplink/stats-threshold-policy #
set descrdescription
(Optional)
Provides a description for the policy.
Note
If your description includes spaces, special characters, or
punctuation, you must begin and end your description with quotation marks. The
quotation marks will not appear in the description field of any
show command output.
Creates the specified statistics threshold policy class and enters
Ethernet uplink statistics threshold policy class mode. The
class-name argument can be any of the class name
keywords available for the particular statistics threshold policy being
configured. To see a list of the available class name keywords, enter the
create class ? command in Ethernet uplink
statistics threshold policy mode.
Note
You can configure multiple classes for the statistics threshold
policy.
Creates the specified statistics threshold policy class property
and enters Ethernet uplink statistics threshold policy class property mode. The
property-name argument can be any of the
property name keywords available for the particular policy class being
configured. To see a list of the available property name keywords, enter the
create property ? command in Ethernet uplink
statistics threshold policy class mode.
Note
You can configure multiple properties for the policy class.
Step 5
UCS-A /eth-uplink/stats-threshold-policy /class/property #
set normal-valuevalue
Specifies the normal value for the class property. The
value format can vary depending on the class property being
configured. To see the required format, enter the
set normal-value ? command in Ethernet uplink
statistics threshold policy class property mode.
Step 6
UCS-A /eth-uplink/stats-threshold-policy /class/property #
create threshold-value{above-normal |
below-normal} {cleared |
condition |
critical |
info |
major |
minor |
warning}
Creates the specified threshold value for the class property and
enters Ethernet uplink statistics threshold policy class property threshold
value mode.
Note
You can configure multiple threshold values for the class
property.
Step 7
UCS-A
/eth-uplink/stats-threshold-policy /class/property/threshold-value #
set{deescalating |
escalating}
value
Specifies the de-escalating or escalating class property threshold
value. The
value format can vary depending on the class property
threshold value being configured. To see the required format, enter the
set deescalating ? or
set escalating ? command in Ethernet uplink
statistics threshold policy class property threshold value mode.
Note
You can specify both de-escalating and escalating class property
threshold values.
Commits the transaction to the system configuration.
The following example creates the uplink Ethernet port statistics
threshold policy class for Ethernet error statistics, creates a cyclic
redundancy check (CRC) error count property, specifies that the normal CRC
error count for each polling interval is 1000, creates an above normal warning
threshold of 1250, and commits the transaction:
Enters Ethernet server statistics threshold policy mode.
Note
You cannot create (or delete) a server port, chassis, and fabric
interconnect statistics threshold policy. You can only enter (scope to) the
existing default policy.
Step 3
UCS-A /eth-server/stats-threshold-policy #
set descrdescription
(Optional)
Provides a description for the policy.
Note
If your description includes spaces, special characters, or
punctuation, you must begin and end your description with quotation marks. The
quotation marks will not appear in the description field of any
show command output.
Commits the transaction to the system configuration.
The following example enters the default server port, chassis, and
fabric interconnect statistics threshold policy, provides a description for the
policy, and commits the transaction:
Creates the specified statistics threshold policy class and enters
Ethernet server statistics threshold policy class mode. The
class-name argument can be any of the class name
keywords available for the particular statistics threshold policy being
configured. To see a list of the available class name keywords, enter the
create class ? command in Ethernet server
statistics threshold policy mode.
Note
You can configure multiple classes for the statistics threshold
policy.
Creates the specified statistics threshold policy class property
and enters Ethernet server statistics threshold policy class property mode. The
property-name argument can be any of the
property name keywords available for the particular policy class being
configured. To see a list of the available property name keywords, enter the
create property ? command in Ethernet server
statistics threshold policy class mode.
Note
You can configure multiple properties for the policy class.
Step 5
UCS-A /eth-server/stats-threshold-policy /class/property #
set normal-valuevalue
Specifies the normal value for the class property. The
value format can vary depending on the class property being
configured. To see the required format, enter the
set normal-value ? command in Ethernet server
statistics threshold policy class property mode.
Step 6
UCS-A /eth-server/stats-threshold-policy /class/property #
create threshold-value{above-normal |
below-normal} {cleared |
condition |
critical |
info |
major |
minor |
warning}
Creates the specified threshold value for the class property and
enters Ethernet server statistics threshold policy class property threshold
value mode.
Note
You can configure multiple threshold values for the class
property.
Step 7
UCS-A
/eth-server/stats-threshold-policy /class/property/threshold-value #
set{deescalating |
escalating}
value
Specifies the de-escalating or escalating class property threshold
value. The
value format can vary depending on the class property
threshold value being configured. To see the required format, enter the
set deescalating ? or
set escalating ? command in Ethernet server
statistics threshold policy class property threshold value mode.
Note
You can specify both de-escalating and escalating class property
threshold values.
Commits the transaction to the system configuration.
The following example creates the server port, chassis, and fabric
interconnect statistics threshold policy class for chassis statistics, creates
an input power (Watts) property, specifies that the normal power is 8kW,
creates an above normal warning threshold of 11kW, and commits the transaction:
Commits the transaction to the system configuration.
The following example deletes the server port, chassis, and fabric
interconnect statistics threshold policy class for chassis statistics and
commits the transaction:
You cannot create (or delete) an uplink Fibre Channel port
statistics threshold policy. You can only enter (scope to) the existing default
policy.
Step 3
UCS-A /fc-uplink/stats-threshold-policy #
set descrdescription
(Optional)
Provides a description for the policy.
Note
If your description includes spaces, special characters, or
punctuation, you must begin and end your description with quotation marks. The
quotation marks will not appear in the description field of any
show command output.
Commits the transaction to the system configuration.
The following example enters the default uplink Fibre Channel port
statistics threshold policy, provides a description for the policy, and commits
the transaction:
Creates the specified statistics threshold policy class and enters
Fibre Channel uplink statistics threshold policy class mode. The
class-name argument can be any of the class name
keywords available for the particular statistics threshold policy being
configured. To see a list of the available class name keywords, enter the
create class ? command in Fibre Channel uplink
statistics threshold policy mode.
Note
You can configure multiple classes for the statistics threshold
policy.
Creates the specified statistics threshold policy class property
and enters Fibre Channel uplink statistics threshold policy class property
mode. The
property-name argument can be any of the
property name keywords available for the particular policy class being
configured. To see a list of the available property name keywords, enter the
create property ? command in Fibre Channel
uplink statistics threshold policy class mode.
Note
You can configure multiple properties for the policy class.
Step 5
UCS-A /fc-uplink/stats-threshold-policy /class/property #
set normal-valuevalue
Specifies the normal value for the class property. The
value format can vary depending on the class property being
configured. To see the required format, enter the
set normal-value ? command in Fibre Channel
uplink statistics threshold policy class property mode.
Step 6
UCS-A /fc-uplink/stats-threshold-policy /class/property #
create threshold-value{above-normal |
below-normal} {cleared |
condition |
critical |
info |
major |
minor |
warning}
Creates the specified threshold value for the class property and
enters Fibre Channel uplink statistics threshold policy class property
threshold value mode.
Note
You can configure multiple threshold values for the class
property.
Step 7
UCS-A
/fc-uplink/stats-threshold-policy /class/property/threshold-value #
set{deescalating |
escalating}
value
Specifies the de-escalating or escalating class property threshold
value. The
value format can vary depending on the class property
threshold value being configured. To see the required format, enter the
set deescalating ? or
set escalating ? command in Fibre Channel uplink
statistics threshold policy class property threshold value mode.
Note
You can specify both de-escalating and escalating class property
threshold values.
Commits the transaction to the system configuration.
The following example creates the uplink Fibre Channel port statistics
threshold policy class for Fibre Channel statistics, creates an average bytes
received property, specifies that the normal average number of bytes received
for each polling interval is 150MB, creates an above normal warning threshold of
200MB, and commits the transaction:
Commits the transaction to the system configuration.
The following example deletes the uplink Fibre Channel port statistics
threshold policy class for Fibre Channel statistics and commits the
transaction: