327 lines
11 KiB
Plaintext
327 lines
11 KiB
Plaintext
-- *****************************************************************
|
|
-- CISCO-TCP-METRICS-MIB
|
|
-- Definitions of managed objects describing TCP flow metrics.
|
|
--
|
|
-- March 2011, Ganesan Rajam
|
|
--
|
|
-- Copyright (c) 2011 by Cisco Systems Inc.
|
|
-- All rights reserved.
|
|
-- *****************************************************************
|
|
|
|
CISCO-TCP-METRICS-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-TYPE
|
|
FROM SNMPv2-SMI
|
|
MODULE-COMPLIANCE,
|
|
OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
TimeStamp
|
|
FROM SNMPv2-TC
|
|
cfmFlowMonitorId,
|
|
cfmFlowId,
|
|
cfmFlowMetricsIntNumber
|
|
FROM CISCO-FLOW-MONITOR-MIB
|
|
FlowMetricScale,
|
|
FlowMetricPrecision,
|
|
FlowMetricValue
|
|
FROM CISCO-FLOW-MONITOR-TC-MIB
|
|
ciscoMgmt
|
|
FROM CISCO-SMI;
|
|
|
|
|
|
ciscoTcpMetricsMIB MODULE-IDENTITY
|
|
LAST-UPDATED "201103060000Z"
|
|
ORGANIZATION "Cisco Systems, Inc."
|
|
CONTACT-INFO
|
|
"Cisco Systems
|
|
Customer Service
|
|
Postal: 170 W Tasman Drive
|
|
San Jose, CA 95134
|
|
USA
|
|
|
|
Tel: +1 800 553-NETS
|
|
E-mail: cs-snmp@cisco.com"
|
|
DESCRIPTION
|
|
"This MIB module defines objects that describe the quality
|
|
metrics of TCP streams.
|
|
|
|
GLOSSARY
|
|
============
|
|
|
|
Flow Monitor - a hardware or software entity that classifies
|
|
traffic flows, collects flow data, and periodically
|
|
computes flow metrics.
|
|
|
|
Flow Metric - a measurement that reflects the quality of a
|
|
traffic flow.
|
|
|
|
Measurement Interval - the length of time over which a flow
|
|
monitor collects data related to a traffic flow, after
|
|
which
|
|
the flow monitor computes flow metrics using the collected
|
|
data.
|
|
|
|
Traffic Flow - a unidirectional stream of packets conforming to
|
|
a classifier. For example, packets having a particular
|
|
source IP address, destination IP address, protocol type,
|
|
source port number, and destination port number.
|
|
|
|
Traffic Flow Stream - when the monitor identifies multiple
|
|
individual traffic flows based on the flow classificiation,
|
|
the monitor aggregates the flows and represents them as a
|
|
single entry in the cfmFlowTable. The individual traffic
|
|
flows contributing to the metrics are called as individual
|
|
traffic flow stream. The metrics for the traffic flow with
|
|
multiple streams contributing, are determined either by
|
|
aggregating metrics of all individual streams, for example,
|
|
cumulative bit rate is computed by cumulative bits of all
|
|
streams divided by total duration, or by selecting the
|
|
metric for one of the individual stream, for example,
|
|
maximum bit rate of an individual stream."
|
|
REVISION "201103060000Z"
|
|
DESCRIPTION
|
|
"Latest version of this MIB module."
|
|
::= { ciscoMgmt 770 }
|
|
|
|
|
|
-- Textual Conventions definition will be defined before this line
|
|
|
|
ciscoTcpMetricsMIBNotifs OBJECT IDENTIFIER
|
|
::= { ciscoTcpMetricsMIB 0 }
|
|
|
|
ciscoTcpMetricsMIBObjects OBJECT IDENTIFIER
|
|
::= { ciscoTcpMetricsMIB 1 }
|
|
|
|
ciscoTcpMetricsMIBConform OBJECT IDENTIFIER
|
|
::= { ciscoTcpMetricsMIB 2 }
|
|
|
|
ciscoTcpMetricsMIBIds OBJECT IDENTIFIER
|
|
::= { ciscoTcpMetricsMIB 3 }
|
|
|
|
ciscoTcpMetricsMIBCompliances OBJECT IDENTIFIER
|
|
::= { ciscoTcpMetricsMIBConform 1 }
|
|
|
|
cfmTcpMetrics OBJECT IDENTIFIER
|
|
::= { ciscoTcpMetricsMIBObjects 1 }
|
|
|
|
|
|
cfmTcpMetricsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CfmTcpMetricsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains aggregate data maintained by a flow monitor
|
|
for traffic flows for which it is computing TCP metrics.
|
|
|
|
This table has an sparse dependent relationship on the
|
|
cfmFlowMetricsTable (defined by the CISCO-FLOW-MONITOR-MIB),
|
|
containing a row for each row in the cfmFlowMetricsTable having
|
|
a corresponding instance of cfmFlowMetricsCollected with the
|
|
'tcp' bit set to one."
|
|
::= { cfmTcpMetrics 1 }
|
|
|
|
cfmTcpMetricsEntry OBJECT-TYPE
|
|
SYNTAX CfmTcpMetricsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describes cumulative and aggregate TCP metrics for a
|
|
single traffic flow.
|
|
|
|
The devices creates a row in the cfmTcpMetricsTable when a flow
|
|
monitor starts monitoring a traffic flow and has been configured
|
|
to compute TCP metrics for the same traffic flow. Likewise, the
|
|
device destroys a row in the cfmTcpMetricsTable when the
|
|
corresponding flow monitor has ceased monitoring the traffic
|
|
flow (e.g., when a traffic flow has timed out)."
|
|
INDEX {
|
|
cfmFlowMonitorId,
|
|
cfmFlowId
|
|
}
|
|
::= { cfmTcpMetricsTable 1 }
|
|
|
|
CfmTcpMetricsEntry ::= SEQUENCE {
|
|
cfmTcpMetricsValid BITS,
|
|
cfmTcpMetricsRoundTripTimeScale FlowMetricScale,
|
|
cfmTcpMetricsRoundTripTimePrecision FlowMetricPrecision,
|
|
cfmTcpMetricsRoundTripTime FlowMetricValue
|
|
}
|
|
|
|
cfmTcpMetricsValid OBJECT-TYPE
|
|
SYNTAX BITS {
|
|
roundTripTime(0)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates which metrics are valid for the traffic
|
|
flow:
|
|
|
|
'roundTripTime'
|
|
If this bit is set to '1', then the corresponding
|
|
instances of cfmTcpMetricsRoundTripTimeScale,
|
|
cfmTcpMetricsRoundTripTimePrecision, and
|
|
cfmTcpMetricsRoundTripTime are valid."
|
|
::= { cfmTcpMetricsEntry 1 }
|
|
|
|
cfmTcpMetricsRoundTripTimeScale OBJECT-TYPE
|
|
SYNTAX FlowMetricScale
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the scaling factor for the corresponding
|
|
instance of cfmTcpMetricsRoundTripTime."
|
|
::= { cfmTcpMetricsEntry 2 }
|
|
|
|
cfmTcpMetricsRoundTripTimePrecision OBJECT-TYPE
|
|
SYNTAX FlowMetricPrecision
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the precision for the corresponding
|
|
instance of cfmFlowMetricsRoundTripTime."
|
|
::= { cfmTcpMetricsEntry 3 }
|
|
|
|
cfmTcpMetricsRoundTripTime OBJECT-TYPE
|
|
SYNTAX FlowMetricValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the round trip time for the packet
|
|
observed by the flow monitor for the corresponding flow. The
|
|
round trip time is defined as the length of time it takes for a
|
|
TCP segment transmission and receipt of acknowledgement."
|
|
::= { cfmTcpMetricsEntry 4 }
|
|
|
|
|
|
|
|
cfmTcpMetricsTableChanged OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the value of sysUpTime the last time the
|
|
device created/destroyed a row in the cfmTcpMetricsTable."
|
|
::= { cfmTcpMetrics 2 }
|
|
|
|
cfmTcpMetricsIntTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CfmTcpMetricsIntEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains historic TCP metrics for the traffic flows
|
|
monitored by each of the flow monitors supported by the device.
|
|
|
|
This table has an sparse dependent relationship on the
|
|
cfmFlowMetricsIntTable (defined by the CISCO-FLOW-MONITOR-MIB),
|
|
containing a row for each row in the cfmFlowMetricsIntTable
|
|
having a corresponding instance of cfmFlowMetricsCollected with
|
|
the 'tcp' bit set to one."
|
|
::= { cfmTcpMetrics 3 }
|
|
|
|
cfmTcpMetricsIntEntry OBJECT-TYPE
|
|
SYNTAX CfmTcpMetricsIntEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describes TCP metrics collected for a previous
|
|
measurement interval for a corresponding traffic flow."
|
|
INDEX {
|
|
cfmFlowMonitorId,
|
|
cfmFlowId,
|
|
cfmFlowMetricsIntNumber
|
|
}
|
|
::= { cfmTcpMetricsIntTable 1 }
|
|
|
|
CfmTcpMetricsIntEntry ::= SEQUENCE {
|
|
cfmTcpMetricsIntValid BITS,
|
|
cfmTcpMetricsIntRoundTripTimeScale FlowMetricScale,
|
|
cfmTcpMetricsIntRoundTripTimePrecision FlowMetricPrecision,
|
|
cfmTcpMetricsIntRoundTripTime FlowMetricValue
|
|
}
|
|
|
|
cfmTcpMetricsIntValid OBJECT-TYPE
|
|
SYNTAX BITS {
|
|
roundTripTime(0)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates which metrics are valid for the
|
|
measurement interval:
|
|
|
|
'roundTripTime'
|
|
If this bit is set to '1', then the corresponding
|
|
instances of cfmTcpMetricsIntRoundTripTimeScale,
|
|
cfmTcpMetricsIntRoundTripTimePrecision, and
|
|
cfmTcpMetricsIntRoundTripTime are valid."
|
|
::= { cfmTcpMetricsIntEntry 1 }
|
|
|
|
cfmTcpMetricsIntRoundTripTimeScale OBJECT-TYPE
|
|
SYNTAX FlowMetricScale
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the scaling factor for the corresponding
|
|
instance of cfmTcpMetricsIntRoundTripTime."
|
|
::= { cfmTcpMetricsIntEntry 2 }
|
|
|
|
cfmTcpMetricsIntRoundTripTimePrecision OBJECT-TYPE
|
|
SYNTAX FlowMetricPrecision
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the precision for the corresponding
|
|
instance of cfmFlowMetricsIntRoundTripTime."
|
|
::= { cfmTcpMetricsIntEntry 3 }
|
|
|
|
cfmTcpMetricsIntRoundTripTime OBJECT-TYPE
|
|
SYNTAX FlowMetricValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the round trip time for traffic flow
|
|
during the measurement interval."
|
|
::= { cfmTcpMetricsIntEntry 4 }
|
|
|
|
|
|
ciscoTcpMetricsMIBGroups OBJECT IDENTIFIER
|
|
::= { ciscoTcpMetricsMIBConform 2 }
|
|
|
|
|
|
ciscoTcpMetricsMIBCompliance01 MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This compliance statement specifies the minimal requirements an
|
|
implementation must meet in order to claim full compliance with
|
|
the definition of the CISCO-TCP-METRICS-MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS { ciscoTcpMetricsGroup }
|
|
::= { ciscoTcpMetricsMIBCompliances 1 }
|
|
|
|
-- Units of Conformance
|
|
|
|
ciscoTcpMetricsGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
cfmTcpMetricsValid,
|
|
cfmTcpMetricsRoundTripTimeScale,
|
|
cfmTcpMetricsRoundTripTimePrecision,
|
|
cfmTcpMetricsRoundTripTime,
|
|
cfmTcpMetricsTableChanged,
|
|
cfmTcpMetricsIntValid,
|
|
cfmTcpMetricsIntRoundTripTimeScale,
|
|
cfmTcpMetricsIntRoundTripTimePrecision,
|
|
cfmTcpMetricsIntRoundTripTime
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This group contains objects that describe TCP metrics."
|
|
::= { ciscoTcpMetricsMIBGroups 1 }
|
|
|
|
END
|
|
|
|
|
|
|