Observium_CE/mibs/cisco/CISCO-MEDIA-METRICS-MIB

614 lines
22 KiB
Plaintext

-- *****************************************************************
-- CISCO-MEDIA-METRICS-MIB
-- Definitions of managed objects describing Media flow metrics.
--
-- March 2011, Ganesan Rajam
--
-- Copyright (c) 2011 by Cisco Systems Inc.
-- All rights reserved.
-- *****************************************************************
CISCO-MEDIA-METRICS-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
Counter64,
Gauge32
FROM SNMPv2-SMI
MODULE-COMPLIANCE,
OBJECT-GROUP
FROM SNMPv2-CONF
TimeStamp
FROM SNMPv2-TC
cfmFlowMonitorId,
cfmFlowId,
cfmFlowMetricsIntNumber
FROM CISCO-FLOW-MONITOR-MIB
ReportIntervalCount
FROM CISCO-REPORT-INTERVAL-TC-MIB
FlowBitRateUnits
FROM CISCO-FLOW-MONITOR-TC-MIB
ciscoMgmt
FROM CISCO-SMI;
ciscoMediaMetricsMIB MODULE-IDENTITY
LAST-UPDATED "201103230000Z"
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 Media 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 "201103230000Z"
DESCRIPTION
"Latest version of this MIB module."
::= { ciscoMgmt 771 }
-- Textual Conventions definition will be defined before this line
ciscoMediaMetricsMIBNotifs OBJECT IDENTIFIER
::= { ciscoMediaMetricsMIB 0 }
ciscoMediaMetricsMIBObjects OBJECT IDENTIFIER
::= { ciscoMediaMetricsMIB 1 }
ciscoMediaMetricsMIBConform OBJECT IDENTIFIER
::= { ciscoMediaMetricsMIB 2 }
ciscoMediaMetricsMIBIds OBJECT IDENTIFIER
::= { ciscoMediaMetricsMIB 3 }
ciscoMediaMetricsMIBCompliances OBJECT IDENTIFIER
::= { ciscoMediaMetricsMIBConform 1 }
cfmMediaMetrics OBJECT IDENTIFIER
::= { ciscoMediaMetricsMIBObjects 1 }
cfmMediaMetricsTable OBJECT-TYPE
SYNTAX SEQUENCE OF CfmMediaMetricsEntry
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 Media 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
'media' bit set to one."
::= { cfmMediaMetrics 1 }
cfmMediaMetricsEntry OBJECT-TYPE
SYNTAX CfmMediaMetricsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry describes cumulative and aggregate Media metrics for a
single traffic flow.
The devices creates a row in the cfmMediaMetricsTable when a flow
monitor starts monitoring a traffic flow and has been configured
to compute Media metrics for the same traffic flow. Likewise, the
device destroys a row in the cfmMediaMetricsTable when the
corresponding flow monitor has ceased monitoring the traffic
flow (e.g., when a traffic flow has timed out)."
INDEX {
cfmFlowMonitorId,
cfmFlowId
}
::= { cfmMediaMetricsTable 1 }
CfmMediaMetricsEntry ::= SEQUENCE {
cfmMediaMetricsValid BITS,
cfmMediaMetricsPkts Counter64,
cfmMediaMetricsOctets Counter64,
cfmMediaMetricsBitRateUnits FlowBitRateUnits,
cfmMediaMetricsBitRate Gauge32,
cfmMediaMetricsPktRate Gauge32,
cfmMediaMetricsStreamBitRateUnits FlowBitRateUnits,
cfmMediaMetricsStreamBitRate Gauge32,
cfmMediaMetricsStreamBitRateMaxUnits FlowBitRateUnits,
cfmMediaMetricsStreamBitRateMax Gauge32,
cfmMediaMetricsStreamBitRateMinUnits FlowBitRateUnits,
cfmMediaMetricsStreamBitRateMin Gauge32
}
cfmMediaMetricsValid OBJECT-TYPE
SYNTAX BITS {
pkts(0),
octets(1),
bitRate(2),
pktRate(3),
streamBitRate(4),
streamBitRateMax(5),
streamBitRateMin(6)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates which metrics are valid for the traffic
flow:
'pkts'
If this bit is set to '1', then the corresponding
instance of cfmMediaMetricsPkts is valid.
'octets'
If this bit is set to '1', then the corresponding
instance of cfmMediaMetricsOctets is valid.
'bitRate'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsBitRateUnits and
cfmMediaMetricsBitRate are valid.
'pktRate'
If this bit is set to '1', then the corresponding
instance of cfmMediaMetricsPktRate is valid.
'streamBitRate'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsStreamBitRateUnits and
cfmMediaMetricsStreamBitRate are valid.
'streamBitRateMax'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsStreamBitRateMaxUnits
and cfmMediaMetricsStreamBitRateMax are valid.
'streamBitRateMin'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsStreamBitRateMinUnits
and cfmMediaMetricsStreamBitRateMin are valid."
::= { cfmMediaMetricsEntry 1 }
cfmMediaMetricsPkts OBJECT-TYPE
SYNTAX Counter64
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the total number of packets, containing
media payload, processed by the corresponding flow monitor for
the corresponding traffic flow."
::= { cfmMediaMetricsEntry 2 }
cfmMediaMetricsOctets OBJECT-TYPE
SYNTAX Counter64
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the total number of octets representing
media payload, processed by the corresponding flow monitor for
the corresponding traffic flow."
::= { cfmMediaMetricsEntry 3 }
cfmMediaMetricsBitRateUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsBitRate."
::= { cfmMediaMetricsEntry 4 }
cfmMediaMetricsBitRate OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the average bit rate at which the
corresponding flow monitor is processing data, containing media
payload, for the corresponding traffic flow. This value is
cumulative over the lifetime of the traffic flow."
::= { cfmMediaMetricsEntry 5 }
cfmMediaMetricsPktRate OBJECT-TYPE
SYNTAX Gauge32
UNITS "packets per second"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the average packet rate at which the
corresponding flow monitor is processing data, containing media
payload, for the corresponding traffic flow. This value is
cumulative over the lifetime of the traffic flow."
::= { cfmMediaMetricsEntry 6 }
cfmMediaMetricsStreamBitRateUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsStreamBitRate."
::= { cfmMediaMetricsEntry 7 }
cfmMediaMetricsStreamBitRate OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the average of media bit rates of all the
individual streams contributing to the traffic flow. This
object is computed by dividing the average media bit rate,
indicated by 'cfmMediaMetricsBitRate', by the number of streams
which have contributed to the metrics over the lifetime of the
traffic flow."
::= { cfmMediaMetricsEntry 8 }
cfmMediaMetricsStreamBitRateMaxUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsStreamBitRateMax."
::= { cfmMediaMetricsEntry 9 }
cfmMediaMetricsStreamBitRateMax OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the maximum media bit rate observed,
among the individual streams, that have contributed to the
metrics over the lifetime of the traffic flow."
::= { cfmMediaMetricsEntry 10 }
cfmMediaMetricsStreamBitRateMinUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsStreamBitRateMin."
::= { cfmMediaMetricsEntry 11 }
cfmMediaMetricsStreamBitRateMin OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the minimum media bit rate observed,
among the individual streams, that have contributed to the
metrics over the lifetime of the traffic flow."
::= { cfmMediaMetricsEntry 12 }
cfmMediaMetricsTableChanged 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 cfmMediaMetricsTable."
::= { cfmMediaMetrics 2 }
cfmMediaMetricsIntTable OBJECT-TYPE
SYNTAX SEQUENCE OF CfmMediaMetricsIntEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains historic Media 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 'media' bit set to one."
::= { cfmMediaMetrics 3 }
cfmMediaMetricsIntEntry OBJECT-TYPE
SYNTAX CfmMediaMetricsIntEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry describes Media metrics collected for a previous
measurement interval for a corresponding traffic flow."
INDEX {
cfmFlowMonitorId,
cfmFlowId,
cfmFlowMetricsIntNumber
}
::= { cfmMediaMetricsIntTable 1 }
CfmMediaMetricsIntEntry ::= SEQUENCE {
cfmMediaMetricsIntValid BITS,
cfmMediaMetricsIntPkts ReportIntervalCount,
cfmMediaMetricsIntOctets ReportIntervalCount,
cfmMediaMetricsIntBitRateUnits FlowBitRateUnits,
cfmMediaMetricsIntBitRate ReportIntervalCount,
cfmMediaMetricsIntPktRate ReportIntervalCount,
cfmMediaMetricsIntStreamBitRateUnits FlowBitRateUnits,
cfmMediaMetricsIntStreamBitRate ReportIntervalCount,
cfmMediaMetricsIntStreamBitRateMaxUnits FlowBitRateUnits,
cfmMediaMetricsIntStreamBitRateMax Gauge32,
cfmMediaMetricsIntStreamBitRateMinUnits FlowBitRateUnits,
cfmMediaMetricsIntStreamBitRateMin Gauge32
}
cfmMediaMetricsIntValid OBJECT-TYPE
SYNTAX BITS {
pkts(0),
octets(1),
bitRate(2),
pktRate(3),
streamBitRate(4),
streamBitRateMax(5),
streamBitRateMin(6)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates which metrics are valid for the
measurement interval:
'pkts'
If this bit is set to '1', then the corresponding
instance of cfmMediaMetricsIntPkts is valid.
'octets'
If this bit is set to '1', then the corresponding
instance of cfmMediaMetricsIntOctets is valid.
'bitRate'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsIntBitRateUnits and
cfmMediaMetricsIntBitRate are valid.
'pktRate'
If this bit is set to '1', then the corresponding
instance of cfmMediaMetricsIntPktRate is valid.
'streamBitRate'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsIntStreamBitRateUnits
and cfmMediaMetricsIntStreamBitRate are valid.
'streamBitRateMax'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsIntStreamBitRateMaxUnits
and cfmMediaMetricsIntStreamBitRateMax are valid.
'streamBitRateMin'
If this bit is set to '1', then the corresponding
instances of cfmMediaMetricsIntStreamBitRateMinUnits
and cfmMediaMetricsIntStreamBitRateMin are valid."
::= { cfmMediaMetricsIntEntry 1 }
cfmMediaMetricsIntPkts OBJECT-TYPE
SYNTAX ReportIntervalCount
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the total number of packets, containing
media payload, processed by the corresponding flow monitor for
the corresponding traffic flow during the measurement interval."
::= { cfmMediaMetricsIntEntry 2 }
cfmMediaMetricsIntOctets OBJECT-TYPE
SYNTAX ReportIntervalCount
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the total number of octets contained by
the packets, representing media payload, processed by the
corresponding flow monitor for the corresponding traffic flow
during the measurement interval."
::= { cfmMediaMetricsIntEntry 3 }
cfmMediaMetricsIntBitRateUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsIntBitRate."
::= { cfmMediaMetricsIntEntry 4 }
cfmMediaMetricsIntBitRate OBJECT-TYPE
SYNTAX ReportIntervalCount
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the average bit rate at which the
corresponding flow monitor processed data, containing media
payload, for the corresponding traffic flow during the
measurement interval."
::= { cfmMediaMetricsIntEntry 5 }
cfmMediaMetricsIntPktRate OBJECT-TYPE
SYNTAX ReportIntervalCount
UNITS "packets per second"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the average packet rate at which the
corresponding flow monitor processed data, containing media
payload, for the corresponding traffic flow during the
measurement interval."
::= { cfmMediaMetricsIntEntry 6 }
cfmMediaMetricsIntStreamBitRateUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsIntStreamBitRate."
::= { cfmMediaMetricsIntEntry 7 }
cfmMediaMetricsIntStreamBitRate OBJECT-TYPE
SYNTAX ReportIntervalCount
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the average of media bit rates of all the
individual streams which contributed to the traffic flow during
measurement interval."
::= { cfmMediaMetricsIntEntry 8 }
cfmMediaMetricsIntStreamBitRateMaxUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsIntStreamBitRateMax."
::= { cfmMediaMetricsIntEntry 9 }
cfmMediaMetricsIntStreamBitRateMax OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the maximum media bit rate observed,
among the individual streams, which contributed to the traffic
flow during the measurement interval."
::= { cfmMediaMetricsIntEntry 10 }
cfmMediaMetricsIntStreamBitRateMinUnits OBJECT-TYPE
SYNTAX FlowBitRateUnits
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the units for the corresponding instance
of cfmMediaMetricsIntStreamBitRateMin."
::= { cfmMediaMetricsIntEntry 11 }
cfmMediaMetricsIntStreamBitRateMin OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the minimum media bit rate observed,
among the individual streams, which contributed to the traffic
flow during the measurement interval."
::= { cfmMediaMetricsIntEntry 12 }
ciscoMediaMetricsMIBGroups OBJECT IDENTIFIER
::= { ciscoMediaMetricsMIBConform 2 }
ciscoMediaMetricsMIBCompliance01 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-MEDIA-METRICS-MIB."
MODULE -- this module
MANDATORY-GROUPS { ciscoMediaMetricsGroup }
::= { ciscoMediaMetricsMIBCompliances 1 }
-- Units of Conformance
ciscoMediaMetricsGroup OBJECT-GROUP
OBJECTS {
cfmMediaMetricsValid,
cfmMediaMetricsPkts,
cfmMediaMetricsOctets,
cfmMediaMetricsBitRateUnits,
cfmMediaMetricsBitRate,
cfmMediaMetricsPktRate,
cfmMediaMetricsStreamBitRateUnits,
cfmMediaMetricsStreamBitRate,
cfmMediaMetricsStreamBitRateMaxUnits,
cfmMediaMetricsStreamBitRateMax,
cfmMediaMetricsStreamBitRateMinUnits,
cfmMediaMetricsStreamBitRateMin,
cfmMediaMetricsTableChanged,
cfmMediaMetricsIntValid,
cfmMediaMetricsIntPkts,
cfmMediaMetricsIntOctets,
cfmMediaMetricsIntBitRateUnits,
cfmMediaMetricsIntBitRate,
cfmMediaMetricsIntPktRate,
cfmMediaMetricsIntStreamBitRateUnits,
cfmMediaMetricsIntStreamBitRate,
cfmMediaMetricsIntStreamBitRateMaxUnits,
cfmMediaMetricsIntStreamBitRateMax,
cfmMediaMetricsIntStreamBitRateMinUnits,
cfmMediaMetricsIntStreamBitRateMin
}
STATUS current
DESCRIPTION
"This group contains objects that describe Media metrics."
::= { ciscoMediaMetricsMIBGroups 1 }
END