Network Working Group T. Dietz, Ed.
Internet-Draft NEC Europte Ltd.
Expires: April 27, 2006 B. Claise
Cisco Systems
October 24, 2005
Definitions of Managed Objects for Packet Sampling
draft-ietf-psamp-mib-05.txt
Status of this Memo
By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on April 27, 2006.
Copyright Notice
Copyright (C) The Internet Society (2005).
Abstract
This memo defines managed objects for sampling and filtering
techniques for IP packet selection. These objects provide
information about managed nodes supporting packet sampling, including
packet sampling capabilities, configuration and statistics. They
also allow to configure packet sampling concerning the IP interface
at which packets are sampled, the packet selections methods used for
sampling, and the collector to which packet samples are exported.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 1]
Internet-Draft PSAMP MIB October 2005
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1. Points of Discussion . . . . . . . . . . . . . . . . . . . 3
2. PSAMP Documents Overview . . . . . . . . . . . . . . . . . . . 6
3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.1. Base Association . . . . . . . . . . . . . . . . . . . . . 6
4. The Internet-Standard Management Framework . . . . . . . . . . 6
5. Structure of the PSAMP MIB module . . . . . . . . . . . . . . 7
5.1. TEXTUAL CONVENTIONS . . . . . . . . . . . . . . . . . . . 7
5.2. The Selection Methods . . . . . . . . . . . . . . . . . . 8
5.2.1. Selecting All Packets . . . . . . . . . . . . . . . . 8
5.2.2. Systematic Count-based Sampling . . . . . . . . . . . 8
5.2.3. Systematic Time-based Sampling . . . . . . . . . . . . 9
5.2.4. Random n-out-of-N Sampling . . . . . . . . . . . . . . 9
5.2.5. Uniform Probabilistic Sampling . . . . . . . . . . . . 9
5.2.6. Non-Uniform Probabilistic Sampling . . . . . . . . . . 9
5.2.7. Flow State Sampling . . . . . . . . . . . . . . . . . 10
5.2.8. Match Filtering . . . . . . . . . . . . . . . . . . . 10
5.2.9. Hash Filtering . . . . . . . . . . . . . . . . . . . . 10
5.2.10. Router State Filtering . . . . . . . . . . . . . . . . 11
5.3. The Hash Functions . . . . . . . . . . . . . . . . . . . . 12
5.4. The Reporting . . . . . . . . . . . . . . . . . . . . . . 12
5.5. The Base Associations . . . . . . . . . . . . . . . . . . 12
6. Definition . . . . . . . . . . . . . . . . . . . . . . . . . . 14
7. Security Considerations . . . . . . . . . . . . . . . . . . . 60
8. Acknowledgment . . . . . . . . . . . . . . . . . . . . . . . . 60
9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 60
9.1. Normative References . . . . . . . . . . . . . . . . . . . 60
9.2. Informative References . . . . . . . . . . . . . . . . . . 61
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 62
Intellectual Property and Copyright Statements . . . . . . . . . . 63
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 2]
Internet-Draft PSAMP MIB October 2005
1. Introduction
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [8].
This document is a product of the Packet Sampling (PSAMP) working
group. Its purpose is to define standards-based MIB modules for
monitoring and configuring PSAMP devices performing packet selection
by sampling, filtering and hashing.
It is assumed that packet sampling is performed according to the
framework defined in [1]. Packet selection methods considered in the
MIB module are specified in [2]. Configuration of the export of
packet samples to a collector is modeled according to [3].
1.1. Points of Discussion
This section covers the open issues, still to be resolved/updated in
this draft.
MIB-1: Title should include sampling and filtering not only sampling.
The titles of all documents not only the MIB document should
reflect that.
MIB-2: We are missing some examples, such as slide 8 of PSAMP-MIB-
IETF60.ppt. It is planned to integrate a entity relationship
diagram plus some examples in the next version. Examples should
always display named OIDs otherwise they are difficult to
understand.
MIB-3: Do we want to be consistent with the upper cases in the
terminology? Do we want to say a note about it in the terminology
section. Something such as: "all terms in upper cases are defined
in..." or "all referenced terminology are written with an upper
case"
MIB-4: The following caese definitively requires some more
explanation, with some examples.
* When you refers to an OID for the interface, you don't specify
if we need the OID for the ifIndex, for the ifDescr, for
something else
* When you refer to an OID for a function, an example is needed
* When you refer to an OID for set of input parameters, which OID
do we need? What if there are multiple indexes in the table?
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 3]
Internet-Draft PSAMP MIB October 2005
Thus a new section about undefined function, parameters and
observation point is really needed.
MIB-5: The section on hash filtering is difficult to understand. We
have some terms defined. And we don't use them. Hence if I would
have to implement this MIB, I would not be sure at all what to put
in there.
I would like to have a structure with:
IN;
Parameter1
Parameter2
...
OUT
Parameter1
Parameter2
MIB-6: Question: as far as I recall (but I could be wrong), when
using the RowStatus, we have to speficy the minimum set of MIB
variables in that table that need to be set in order for the
status to go to "create", i.e. the states information. That's one
of biggest missing things.
MIB-7: psampSampNonUniProbFuncParam OBJECT-TYPE: here we must explain
how to do when several input parameters references are needed!
See also MIB-2 and MIB-4.
MIB-8: psampFilterHashPayloadBytes OBJECT-TYPE: What does Payload
mean? Above layer 4? It is not specified in [2].
MIB-9: psampFilterRState OBJECT IDENTIFIER: Try to rename to
RouterState if maximum OID name length of 32 chars is not
exceeded.
MIB-10: psampFilterRStateAvail OBJECT-TYPE: It should be specified
when this object is "available". It should be available when one
of the given functions is available."
MIB-11: PsampFilterRStateParamSetEntry: Specifically in this case, we
need to define which minimum set of MIB variable should be set up
for the entry to go "createandgo". For example, is
psampFilterRStateVendorFunc enough? See aslo MIB-6.
MIB-12: We are missing the observation domain in both the PSAMP-MIB
PsampBaseAssocEntry and PSAMP-TECH document.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 4]
Internet-Draft PSAMP MIB October 2005
MIB-13: psampBaseAssoceObservationPoint OBJECT-TYPE: Where should the
OID point to? ifIndex, ifDescr?
MIB-14: Capitalization should be consistent throughout the document.
Maybe the solution is to list all reference terms from PSAMP and
IPFIX drafts (the ones used in the draft). So just a list, with
no definition, in the terminology section. Feedback?
MIB-15: Consistent usage of data types (especially Unsigned32 and
Integer32 with ranges) must be checked! Not sure if especially an
index can be Unsigned32, if he must have a limited range, etc.
Can some experts speak up?
MIB-16: Hash filtering again (see also MIB-5). The hash filtering
group is confusing because it was specified before the hash
function group. We mainly care about the hash function defined in
the appendix of PSAMP-TECH, so why do we have this group before
the hash function group and do we have this group at all. If
someone would like to specify a new hash function, he will
potentially have a new RFC and part of it, the new MIB OID for
this specific hash function could be specified.
So we could just introduce two hash filtering method (IPSX and
Bob) specified in the PSAMP-TECH document and leave other hash
functions to extended drafts. But what about vendor specific hash
functions?? How do we know they exist??
Potentially because a vendor would produce a new private MIB?
Maybe a question for the mailing list! We mainly need the hash
function in hardware, where it can not be changed so easily as
changing a mib.
MIB-17: Hash filtering again (see also MIB-5 and MIB-16). Question
of security! Do we want to be able to read all of the values in
PsampFilterHashParamSetEntry. Including the output of the hash
function? Could an attacker with SNMP read access deduce what
type of traffic to send to manipulate the NMS application? Do we
want to export all the 10 parameters in PSAMP export? Does
PSAMP-FW requires it? See "6.2.2 Guarding Against Pitfalls and
Vulnerabilities". So the best thing to do is to ask Nick and
Tanja.
MIB-18: Router State Filtering (see also MIB-10). It might be easier
with subtables for each router state function. That would also
clarify the point of psampFilterRStateAvail: one capability per
function -> that make more sense. That would also solve MIB-10.
We can extend with new methods easily.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 5]
Internet-Draft PSAMP MIB October 2005
2. PSAMP Documents Overview
[PSAMP-FW]: "A Framework for Packet Selection and Reporting" The
document describes the PSAMP framework for network elements to
select subsets of packets by statistical and other methods, and to
export a stream of reports on the selected packets to a collector.
Definitions of terminology and the use of the terms "must",
"should" and "may" in this document are informational only.
[PSAMP-TECH]: "Sampling and Filtering Techniques for IP Packet
Selection", describes the set of packet selection techniques
supported by PSAMP.
PSAMP-MIB: "Definitions of Managed Objects for Packet Sampling" (this
document) describes the PSAMP Management Information Base.
[PSAMP-PROTO]: "Packet Sampling (PSAMP) Protocol Specifications"
specifies the export of packet information from a PSAMP Exporting
Process to a PSAMP Colleting Process.
[PSAMP-INFO]: "Information Model for Packet Sampling Exports" defines
an information and data model for PSAMP.
3. Terminology
The PSAMP terminology defined here includes (and is consistent with)
all terms listed in [2]. We here define additional terms required
for the definition of managed objects. An architecture overview and
possible configurations of PSAMP elements can be found in [1].
Detailed definitions of selectors can be found in [2]. PSAMP
terminology also aims to be consistent with terms used in [9]. The
relationship between some PSAMP and IPFIX terms is described in [1].
3.1. Base Association
The Base Association combines several values defined at a PSAMP
device. It is derived from the ASSOCIATION defined in [2] section 7.
It contains references to an Observation Point, a template record, a
list of Collectors, a list of Selectors and process ids of the
metering and the reporting process. It associates these values to
specify one Measurement Process on the PSAMP device. Several
Measurement Processes can be defined on the PSAMP device and every
Measurement Process will be described by a Base Association.
4. The Internet-Standard Management Framework
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 6]
Internet-Draft PSAMP MIB October 2005
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [10].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [4], STD 58, RFC 2579 [5] and STD 58, RFC 2580 [6].
5. Structure of the PSAMP MIB module
The PSAMP MIB module follows the structures given in [1] and [2].
The psampBaseAssociations subtree builds the heart of the PSAMP MIB.
This subtree models the values described by the Base Association.
The psampBaseAssocTable contains one entry per Base Association. The
list of Selectors is modelled by a second table the
psampSelectorListTable. This table is linked to the
psampBaseAssocTable by the first index which is the
psampBaseAssocIndex. A psampBaseAssocEntry also references an entry
in the psampTemplateRecordTable and the psampCollectorGroupTable to
link the metering process with the reporting process.
Every selection method described in [2] gets its own subtree in the
PSAMP MIB. The subtree always contains a capability section and a
parameter set table. So several parameter sets can be defined for
each selection method. The parameter set is linked to the Base
Association by an entry in the psampSelectorListTable. The
psampSelectorListMethod point to the first object id of a parameter
set entry. The hash functions proposed in [2] are modelled in a
similar way as the selection methods and are referenced by a
psampFilterHashParamSetEntry.
The reporting and exporting processes are modeled by the
psampCollectorTable, the psampCollectorGroupTable and the
psampTemplateRecordTable. The psampTemplateRecordTable contains
Template Records as defined by the IPFIX protocol. They are used to
export the selected packets to the collectors. The collectors itself
are modelled in the psampCollectorTable and the
psampCollectorGroupTable combines several Collectors to which the
packet reports are sent simultaniously.
5.1. TEXTUAL CONVENTIONS
The PSAMP MIB defines one new textual convention, the
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 7]
Internet-Draft PSAMP MIB October 2005
PsampMethodAvailability. It is used as SYNTAX of all those objects
that indicate if a selection method or hash function is available in
a specific implementation of a PSAMP device.
5.2. The Selection Methods
The first group of objects contains information about sampling
methods and filtering methods. Each method is covered by an
individual subtree. Expect for the first method that corresponds to
the exceptional selection of all packets, the following objects are
defined for each method: a subtree of objects indicating specific
capabilities and limits of the method that may be empty if no
capabilities or limits are available, and a subtree specifying sets
of parameters in a table. Each row in the parameter set table
uniquely specifies all parameters of a packet selection process of
the method. Also all parameters sets contain a row status.
The PSAMP MIB covers all methods and their parameters specified in
[2]. If the given methods could be extended by some implementation
dependent functionality the MIB contains objects that reference an
OBJECT IDENTIFIER. These objects are used as pointers to functions
or parameters that are out of the scope of this document. These
functions or parameters can be either vendor specific or may be
documented in an additional standard document or an updated version
of this document. An implementer may specify e.g., one or more
functions used for non-uniform probabilistic sampling, additional
router state matches or additional hash functions for hash filtering.
5.2.1. Selecting All Packets
This is the most trivial packet selection method. If it is applied,
all packets will be selected.
5.2.2. Systematic Count-based Sampling
Count-based sampling means, that all packets that arrive in this
packet interval are selected. The spacing parameter defines the
spacing in number of packets between the end of one sampling interval
and the start of the next succeeding interval. The systematic count-
based sampling method has two capability objects: The
psampSampCountBasedMaxInterval object indicates the maximum sampling
interval supported by the implementation, whereas
psampSampCountBasedMinSpacing indicates the minimum spacing supported
by the implementation.
Finally the psampSampCountBasedParamSetTable contains two parameters:
the sampling interval length and the spacing specified in number of
packets.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 8]
Internet-Draft PSAMP MIB October 2005
5.2.3. Systematic Time-based Sampling
Time-based sampling means, that all packets that arrive in this time
interval are selected. The spacing parameter defines the spacing in
time between the end of one sampling interval and the start of the
next succeeding interval. The systematic time-based sampling methods
have two capability objects: The psampSampTimeBasedMaxInterval object
indicates the maximum sampling interval supported by the
implementation, whereas psampSampTimeBasedMinSpacing indicates the
minimum spacing supported by the implementation: both MIB objects
units are specified in microseconds.
Finally the psampSampTimeBasedParamSetTable contains two parameters:
the sampling interval length and the spacing specified in number of
microseconds.
5.2.4. Random n-out-of-N Sampling
The random n-out-of-N sampling method has one capability object:
psampSampRandOutOfNMaxPopulation specifying the maximum population N.
The random n-out-of-N sampling method has also two parameter objects
in the psampSampRandOutOfNParamSetTable. The first one is
psampSampRandOutOfNPopulation and gives the number of elements N in
the parent population. The second psampSampRandOutOfNSample gives
the number of elements n taken from the parent population N. With
these two parameters you sample n packets out of N.
5.2.5. Uniform Probabilistic Sampling
Capability objects are not specified for the uniform probabilistic
sampling method. It has only one parameter in the
psampSampUniProbParamSetTable, the psampSampUniProbProbability. This
object gives the probability that a packet is sampled. The
probability is equal for every packet. The given value must be
divided by 4294967295 (=2^32-1), so a value of 0 means no packet is
sampled (probability is 0) and a value of 4294967295 means every
packet is sampled (probability is 1).
5.2.6. Non-Uniform Probabilistic Sampling
Capability objects are not specified for the non-uniform
probabilistic sampling method. The psampSampNonUniProbParamSetTable
contains two parameters, the psampSampNonUniProbFunction and the
psampSampNonUniProbFuncParam. Those two objects point to the
function that computes the probability that a packet is sampled and
the parameters used for that function. The definition of the
function and its parameters is implementation dependent and beyond
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 9]
Internet-Draft PSAMP MIB October 2005
the scope of this document.
5.2.7. Flow State Sampling
Capability objects are not specified for the flow state sampling
method. The psampSampFlowStateParamSetTable holds two parameters
pointing to the flow state function and the parameters used by the
flow state function (psampSampFlowStateFunction and
psampSampFlowStateFuncParam). Again the function and its parameters
are implementation dependent and beyond the scope of this document.
5.2.8. Match Filtering
Capability objects are not specified for the match filtering method.
It contains four parameters in the psampFilterMatchParamSetTable: The
psampFilterMatchFieldId contain the PSAMP or IPFIX information
element id defined in the information model [7], [11]. The
psampFilterMatchStartValue and psampFilterMatchStopValue contain the
start and stop value to match the content against. In this way you
can match e.g., a range x-z of transport protocol ports by specifying
the field id that represents the transport protocol port and giving x
as start value and y as stop value. If a single value should be
matched than start and stop value must be equal. A mask
psampFilterMatchMask can be applied if it is applicable for the field
id. The encoding of the values is dependent on the field id and has
to be done according to the PSAMP protocol document.
5.2.9. Hash Filtering
Capability objects are not specified for the hash filtering method.
But according to the sample tech document [2] ten parameters are
defined in the psampFilterHashParamSetTable. The
psampFilterHashAddrType specifies the address type to hash - either
IPv4 or IPv6. Then psampFilterHashHeaderBits specifies a bit mask
applied to the packet header selecting the bits to hash from the
packet header. Then psampFilterHashPayloadBytes gives the number of
payload bytes that should be included in the hashing. The final bits
that are selected from the payload bytes are masked with the
psampFilterHashPayloadBits.
The above parameters specified what gets feed into the hash function.
The following parameters specify the hash function itself. The
psampFilterHashFunction points to a hash function and
psampFilterHashFuncParam point to a function specific parameter set
for the hashing function. The number of input and output bits for
the hash function is specified with psampFilterHashInputBits and
psampFilterHashOutputBits. Finally the output may be masked with the
psampFilterHashOutputMask. The results gained by applying all those
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 10]
Internet-Draft PSAMP MIB October 2005
parameters are then compared with the psampFilterHashSelection. The
psampFilterHashSelection contains the hash value ranges or single
hash values that get selected. The psampFilterHashSelection is a
human readable string containing only the ASCII characters 0-9, a-f,
comma(,) and dash(-).
The two hash functions given in the sample tech document can be
referenced within this parameter set table and are also contained in
this PSAMP MIB document.
5.2.10. Router State Filtering
Capability objects are not specified for the router state filtering
method. The parameter table psampFilterRStateParamSetTable contains
six parameters to specify the router state to filter against. The
first object psampFilterRStateFunction defines one of nine functions
that may be used as router state.
other: an other router state function that is not defined here. Then
psampFilterRStateVendorFunc points to the implementation specific
function that is used.
ingressIf: packets that enter the PSAMP device at the interface
specified by psampFilterRStateIfIndex are matched.
egressIf: packets that leave the PSAMP device at the interface
specified by psampFilterRStateIfIndex are matched.
aclViolation: packets that violate the access control list are
matched.
rpfFailure: packets for which the reverse path forwarding fails are
matched.
noResources: packets for which not enough resources are allocated
will be matched.
noRoute: packets that could not be routed further are matched.
originAS: packets that originate in an autonomous system specified by
the range of psampFilterRStateStartAS and psampFilterRStateStopAS
are matched.
destAS: packets whose destination is in an autonomous system
specified by the range of psampFilterRStateStartAS and
psampFilterRStateStopAS are matched.
The parameter psampFilterRStateIfIndex defaults to 0 if not used.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 11]
Internet-Draft PSAMP MIB October 2005
The parameters psampFilterRStateStartAS and psampFilterRStateStopAS
default to 0 if they are not used. If a single autonomous system
number should be matched psampFilterRStateStopAS remains 0.
5.3. The Hash Functions
The hash function subtree specifies the two hash functions defined in
the sample tech document [2]. The hash functions are defined here so
that they can be referenced by the hash filter above. The design of
the hash function part of the MIB SHOULD be taken as a guideline for
vendor specific hash function definitions.
The two hash functions IPSX and Bob have both an empty parameter set
table since they both take now additional parameters than those
specified in the hash filter method. Other hash functions of course
could specify additional parameters.
5.4. The Reporting
The reporting subtree of managed objects provides information on
collectors to which selected packets (sampled, filtered, or hashed)
are exported and they allow to configure collectors. The group
contains two tables, the psampCollectorTable and the
psampCollectorGroupTable.
Each entry in the psampCollectorTable specifies a collector by its IP
address, used transport protocol and port number. Also it contains
the number of reports sent to this collector. The default transport
protocol is SCTP.
The psampCollectorGroupTable groups one or more collectors to a set
of collectors where sampled packets are sent to simultaneously. Thus
reporting to more than one collector at the same time is possible.
5.5. The Base Associations
The objects in the Base Asssociations subtree combine all the objects
needed to model the measurement processes on the PSAMP device. It
contains three tables, the psampBaseAssocTable, the
psampSelectorListTable and the psampTemplateRecordTable. Each entry
of the psampBaseAssocTable describes one measurement process on the
PSAMP device. The observation point is given as a pointer to another
object in psampBaseAssoceObservationPoint. This other object could
be an entry in the mib-II interface table or any other interface
point where you can observe packets. The
psampBaseAssocTemplateRecordId gives the template record id used to
link the data gathered in the metering process to an export format
described in the information model of the PSAMP framework. The
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 12]
Internet-Draft PSAMP MIB October 2005
collectors where the data packets should be sent are specified by
their index in the psampCollectorGroupTable. In addition the process
id of the metering process and the process id of the exporting
process used for this instance is saved in the instance table. Last
but not least statistical values about the packets observed at the
observation point, packets dropped during the metering process and
the reports sent to the collectors are maintained.
The psampSelectorListTable describes the concatenation of methods for
a given Base Association. If concatenation of methods is not
supported on the PSAMP device the table will hold exactly one entry
per Base Association.
The methods used for the metering process of an Base Association can
be retrieved through the index given in the psampBaseAssocTable. The
index of the Base Association table is also the first index in the
psampSelectorListTable. So each method entry with the same (first)
index as the Base Association is used to produce the data record for
the reporting process. The second index is the running index for the
method. The method itself is represented by a pointer (OID) to a
parameter set. The methods are applied in the order given by this
second index psampSelectorListIndex. Assume the following table:
1.4.4.1.2.5.1 = 1 (second index)
1.4.4.1.2.5.2 = 2 (second index)
1.4.4.1.3.5.1 = 1.3.6.1.2.1.XXX.1.1.2.3.1.10
(pointer to a parameter set psampSampTimeBasedParamSetTableEntry.10)
1.4.4.1.3.5.2 = 1.3.6.1.2.1.XXX.1.1.1.3.1.4
(pointer to a parameter set psampSampCountBasedParamSetTableEntry.4)
1.4.4.1.4.5.1 = xxx (status of the row)
1.4.4.1.4.5.2 = xxx (status of the row)
This would mean that the method psampSampTimeBased with parameter set
psampSampTimeBasedParamSetTableEntry.10 is applied prior to the
method psampSampCountBased with parameter set
psampSampCountBasedParamSetTableEntry.4 for the instance with index
5.
In addition every entry in the selector list table contains two
statistical values: the packets observed at the entry point of the
method and the packets dropped by the method.
The psampTemplateRecordTable lists all data template records that are
used by the PSAMP exporter. It has two indexes. The first one is
the template record id and the second one is just a running index for
the information element ids listed in the table. So the
psampTemplateRecordEntry.4.x will list all information element ids
used for template record id 4 in the order given by x.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 13]
Internet-Draft PSAMP MIB October 2005
6. Definition
PSAMP-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Integer32, Unsigned32, mib-2
FROM SNMPv2-SMI -- RFC2578
TEXTUAL-CONVENTION, DisplayString, RowStatus, TruthValue
FROM SNMPv2-TC -- RFC2579
MODULE-COMPLIANCE, OBJECT-GROUP
FROM SNMPv2-CONF -- RFC2580
InterfaceIndexOrZero
FROM IF-MIB -- RFC2863
InetAddressType, InetAddress, InetAutonomousSystemNumber
FROM INET-ADDRESS-MIB; -- RFC3291
psampMIB MODULE-IDENTITY
LAST-UPDATED "200502181600Z" -- 18 February 2005
ORGANIZATION "IETF Packet Sampling Working Group"
CONTACT-INFO
"WG charter:
http://www.ietf.org/html.charters/psamp-charter.html
Mailing Lists:
General Discussion: psamp@ops.ietf.org
To Subscribe: psamp-request@ops.ietf.org
In Body: subscribe
Archive: https://ops.ietf.org/lists/psamp/
Editor:
Thomas Dietz
NEC Europe Ltd.
Network Laboratories
Kurfuersten-Anlage 36
69115 Heidelberg
Germany
Phone: +49 6221 90511-28
Email: dietz@netlab.nec.de"
DESCRIPTION
"The PSAMP MIB defines managed objects for packet sampling
and filtering techniques for IP packet selection. These
objects provide information about managed nodes supporting
packet sampling, including packet sampling capabilities,
configuration and statistics. They also allow to configure
packet sampling and filtering concerning the observation
point at which packets are sampled, the packet selections
methods used for sampling and filtering, and the collector
to which packet samples are exported.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 14]
Internet-Draft PSAMP MIB October 2005
Copyright (C) The Internet Society (2005). This version
of this MIB module is part of RFC yyyy; see the RFC
itself for full legal notices."
-- RFC Ed.: replace yyyy with actual RFC number & remove this notice
-- Revision history
REVISION "200502181600Z" -- 18 February 2005
DESCRIPTION
"Initial version, published as RFC yyyy."
-- RFC Ed.: replace yyyy with actual RFC number & remove this notice
::= { mib-2 4937 }
-- XXX to be assigned by IANA.
-- Textual Conventions
PsampMethodAvailability ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"Used to report the availability of a packet selection
method:
available (1) - the method is available on the PSAMP
device
notAvailable (2) - the method is not available on the
PSAMP device"
SYNTAX INTEGER {
available(1),
notAvailable(2)
}
-- Top level structure of the MIB
psampObjects OBJECT IDENTIFIER ::= { psampMIB 1 }
psampConformance OBJECT IDENTIFIER ::= { psampMIB 2 }
--==================================================================
-- Packet selection sampling methods group of objects
--==================================================================
psampSamplingMethods OBJECT IDENTIFIER ::= { psampObjects 1 }
--==================================================================
--* Method 0: Selecting All Packets
--==================================================================
psampSelectAll OBJECT IDENTIFIER ::= { psampSamplingMethods 0 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 15]
Internet-Draft PSAMP MIB October 2005
psampSelectAllAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of the trivial
method of selecting all packets."
DEFVAL { notAvailable }
::= { psampSelectAll 1 }
--==================================================================
--* Method 1: Systematic Count-based Sampling
--==================================================================
psampSampCountBased OBJECT IDENTIFIER ::= { psampSamplingMethods 1 }
psampSampCountBasedAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of systematic
count-based sampling at the managed node."
DEFVAL { notAvailable }
::= { psampSampCountBased 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
psampSampCountBasedCap OBJECT IDENTIFIER
::= { psampSampCountBased 2 }
psampSampCountBasedMaxInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "number of packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the maximum number that can be
specified for the sampling interval. Sampling means, that
all packets that arrive in this interval are selected.
The interval is given in number of packets."
::= { psampSampCountBasedCap 1 }
psampSampCountBasedMinSpacing OBJECT-TYPE
SYNTAX Unsigned32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 16]
Internet-Draft PSAMP MIB October 2005
DESCRIPTION
"This object indicates the minimum number that can be
specified for the sampling spacing. The spacing parameter
defines the spacing number of packets between the end of
one sampling interval and the start of the next
succeeding interval."
::= { psampSampCountBasedCap 2 }
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampCountBasedParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampSampCountBasedParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of systematic count-based
packet sampling. A parameter set describing a
configuration contains two parameters: the sampling
interval length and the spacing."
::= { psampSampCountBased 3 }
psampSampCountBasedParamSetEntry OBJECT-TYPE
SYNTAX PsampSampCountBasedParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampSampCountBasedParamSetTable."
INDEX { psampSampCountBasedIndex }
::= { psampSampCountBasedParamSetTable 1 }
PsampSampCountBasedParamSetEntry ::=
SEQUENCE {
psampSampCountBasedIndex Integer32,
psampSampCountBasedInterval Unsigned32,
psampSampCountBasedSpacing Unsigned32,
psampSampCountBasedRowStatus RowStatus
}
psampSampCountBasedIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 17]
Internet-Draft PSAMP MIB October 2005
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampSampCountBasedParamSetEntry 1 }
psampSampCountBasedInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "packets"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the sampling interval for systematic
count-based sampling. Sampling means, that all packets that
arrive in this interval are selected. The interval is
given in number of packets."
REFERENCE
"PSAMP-SAMPLE-TECH, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampCountBasedParamSetEntry 2 }
psampSampCountBasedSpacing OBJECT-TYPE
SYNTAX Unsigned32
UNITS "packets"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the sampling spacing for systematic
count-based sampling. The spacing parameter defines the
spacing number of packets between the end of one sampling
interval and the start of the next succeeding interval."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampCountBasedParamSetEntry 3 }
psampSampCountBasedRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampSampCountBasedParamSetEntry 4 }
--==================================================================
--* Method 2: Systematic Time-based Sampling
--==================================================================
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 18]
Internet-Draft PSAMP MIB October 2005
psampSampTimeBased OBJECT IDENTIFIER ::= { psampSamplingMethods 2 }
psampSampTimeBasedAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of systematic
time-based sampling at the managed node."
DEFVAL { notAvailable }
::= { psampSampTimeBased 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
psampSampTimeBasedCap OBJECT IDENTIFIER
::= { psampSampTimeBased 2 }
psampSampTimeBasedMaxInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "micro-seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the maximum number that can be
specified for the sampling interval. Sampling means, that
all packets that arrive in an interval are selected. The
interval is given in micro-seconds."
::= { psampSampTimeBasedCap 1 }
psampSampTimeBasedMinSpacing OBJECT-TYPE
SYNTAX Unsigned32
UNITS "micro-seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the minimum number that can be
specified for the sampling spacing. The spacing parameter
defines the spacing in micro-seconds between the end of
one sampling interval and the start of the next
succeeding interval."
::= { psampSampTimeBasedCap 2 }
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampTimeBasedParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampSampTimeBasedParamSetEntry
MAX-ACCESS not-accessible
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 19]
Internet-Draft PSAMP MIB October 2005
STATUS current
DESCRIPTION
"This table lists configurations of systematic time-based
packet sampling. A parameter set describing a configuration
contains two parameters: the sampling interval length and
the spacing."
::= { psampSampTimeBased 3 }
psampSampTimeBasedParamSetEntry OBJECT-TYPE
SYNTAX PsampSampTimeBasedParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampSampTimeBasedParamSetTable."
INDEX { psampSampTimeBasedIndex }
::= { psampSampTimeBasedParamSetTable 1 }
PsampSampTimeBasedParamSetEntry ::=
SEQUENCE {
psampSampTimeBasedIndex Integer32,
psampSampTimeBasedInterval Unsigned32,
psampSampTimeBasedSpacing Unsigned32,
psampSampTimeBasedRowStatus RowStatus
}
psampSampTimeBasedIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampSampTimeBasedParamSetEntry 1 }
psampSampTimeBasedInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "micro-seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies a sampling interval for systematic
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 20]
Internet-Draft PSAMP MIB October 2005
time-based sampling. Sampling means, that all packets that
arrive in this interval are selected. The interval is
given in micro-seconds."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampTimeBasedParamSetEntry 2 }
psampSampTimeBasedSpacing OBJECT-TYPE
SYNTAX Unsigned32
UNITS "micro-seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies a sampling spacing for systematic
time-based sampling. The spacing parameter defines the
spacing in micro-seconds between the end of one sampling
interval and the start of the next succeeding interval."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampTimeBasedParamSetEntry 3 }
psampSampTimeBasedRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampSampTimeBasedParamSetEntry 4 }
--==================================================================
--* Method 3: Random n-out-of-N Sampling
--==================================================================
psampSampRandOutOfN OBJECT IDENTIFIER ::= { psampSamplingMethods 3 }
psampSampRandOutOfNAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of random
n-out-of-N sampling at the managed node."
DEFVAL { notAvailable }
::= { psampSampRandOutOfN 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 21]
Internet-Draft PSAMP MIB October 2005
psampSampRandOutOfNCap OBJECT IDENTIFIER
::= { psampSampRandOutOfN 2 }
psampSampRandOutOfNMaxPopulation OBJECT-TYPE
SYNTAX Unsigned32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the maximum number of packets that
can be specified for the population size."
::= { psampSampRandOutOfNCap 1 }
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampRandOutOfNParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampSampRandOutOfNParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of random n-out-of-N
sampling. A parameter set describing a configuration
contains a two parameters: the population size and the
sample size."
::= { psampSampRandOutOfN 3 }
psampSampRandOutOfNParamSetEntry OBJECT-TYPE
SYNTAX PsampSampRandOutOfNParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampSampRandOutOfNParamSetTable."
INDEX { psampSampRandOutOfNIndex }
::= { psampSampRandOutOfNParamSetTable 1 }
PsampSampRandOutOfNParamSetEntry ::=
SEQUENCE {
psampSampRandOutOfNIndex Integer32,
psampSampRandOutOfNPopulation Unsigned32,
psampSampRandOutOfNSample Unsigned32,
psampSampRandOutOfNRowStatus RowStatus
}
psampSampRandOutOfNIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 22]
Internet-Draft PSAMP MIB October 2005
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampSampRandOutOfNParamSetEntry 1 }
psampSampRandOutOfNPopulation OBJECT-TYPE
SYNTAX Unsigned32
UNITS "packets"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the number of packets in the parent
population of the sampling algorithm."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampRandOutOfNParamSetEntry 2 }
psampSampRandOutOfNSample OBJECT-TYPE
SYNTAX Unsigned32
UNITS "packets"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the number of packets that are
sampled from the parent population of the sampling
algorithm."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampRandOutOfNParamSetEntry 3 }
psampSampRandOutOfNRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampSampRandOutOfNParamSetEntry 4 }
--==================================================================
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 23]
Internet-Draft PSAMP MIB October 2005
--* Method 4: Uniform Probabilistic Sampling
--==================================================================
psampSampUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 4 }
psampSampUniProbAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of uniform
probabilistic sampling at the managed node."
DEFVAL { notAvailable }
::= { psampSampUniProb 1 }
psampSampUniProbCap OBJECT IDENTIFIER
::= { psampSampUniProb 2 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampUniProbParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampSampUniProbParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of uniform probabilistic
sampling. A parameter set describing a configuration
contains a single parameter only: the sampling
probability."
::= { psampSampUniProb 3 }
psampSampUniProbParamSetEntry OBJECT-TYPE
SYNTAX PsampSampUniProbParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampSampUniProbParamSetTable."
INDEX { psampSampUniProbIndex }
::= { psampSampUniProbParamSetTable 1 }
PsampSampUniProbParamSetEntry ::=
SEQUENCE {
psampSampUniProbIndex Integer32,
psampSampUniProbProbability Unsigned32,
psampSampUniProbRowStatus RowStatus
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 24]
Internet-Draft PSAMP MIB October 2005
}
psampSampUniProbIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampSampUniProbParamSetEntry 1 }
psampSampUniProbProbability OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object gives the probability that a packet is sampled.
The probability is equal for every packet. The given value
must be divided by 4294967295 (=2^32-1), so a value of 0
means no packet is sampled (probability is 0) and a value of
4294967295 means every packet is sampled (probability is
1)."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampUniProbParamSetEntry 2 }
psampSampUniProbRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampSampUniProbParamSetEntry 3 }
--==================================================================
--* Method 5: Non-Uniform Probabilistic Sampling
--==================================================================
psampSampNonUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 5 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 25]
Internet-Draft PSAMP MIB October 2005
psampSampNonUniProbAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of non-uniform
probabilistic sampling at the managed node."
DEFVAL { notAvailable }
::= { psampSampNonUniProb 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampNonUniProbParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampSampNonUniProbParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of non-uniform
probabilistic sampling. A parameter set describing a
configuration contains two parameter: a pointer to a
probability function and a pointer to an associated
parameter set."
::= { psampSampNonUniProb 3 }
psampSampNonUniProbParamSetEntry OBJECT-TYPE
SYNTAX PsampSampNonUniProbParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampSampNonUniProbParamSetTable."
INDEX { psampSampNonUniProbIndex }
::= { psampSampNonUniProbParamSetTable 1 }
PsampSampNonUniProbParamSetEntry ::=
SEQUENCE {
psampSampNonUniProbIndex Integer32,
psampSampNonUniProbFunction OBJECT IDENTIFIER,
psampSampNonUniProbFuncParam OBJECT IDENTIFIER,
psampSampNonUniProbRowStatus RowStatus
}
psampSampNonUniProbIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 26]
Internet-Draft PSAMP MIB October 2005
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampSampNonUniProbParamSetEntry 1 }
psampSampNonUniProbFunction OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the function that is used to compute
the probability for sampling."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampNonUniProbParamSetEntry 2 }
psampSampNonUniProbFuncParam OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the parameters set for the function
specified with psampSampNonUniProbFunction that is used to
compute the probability for sampling."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampNonUniProbParamSetEntry 3 }
psampSampNonUniProbRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampSampNonUniProbParamSetEntry 4 }
--==================================================================
--* Method 6: Flow State Sampling
--==================================================================
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 27]
Internet-Draft PSAMP MIB October 2005
psampSampFlowState OBJECT IDENTIFIER ::= { psampSamplingMethods 6 }
psampSampFlowStateAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of flow state
sampling at the managed node."
DEFVAL { notAvailable }
::= { psampSampFlowState 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampFlowStateParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampSampFlowStateParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of flow state sampling. A
parameter set describing a configuration contains two
parameter: a pointer to a flow state function and a pointer
to an associated parameter set."
::= { psampSampFlowState 3 }
psampSampFlowStateParamSetEntry OBJECT-TYPE
SYNTAX PsampSampFlowStateParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampSampFlowStateParamSetTable."
INDEX { psampSampFlowStateIndex }
::= { psampSampFlowStateParamSetTable 1 }
PsampSampFlowStateParamSetEntry ::=
SEQUENCE {
psampSampFlowStateIndex Integer32,
psampSampFlowStateFunction OBJECT IDENTIFIER,
psampSampFlowStateFuncParam OBJECT IDENTIFIER,
psampSampFlowStateRowStatus RowStatus
}
psampSampFlowStateIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 28]
Internet-Draft PSAMP MIB October 2005
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampSampFlowStateParamSetEntry 1 }
psampSampFlowStateFunction OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the function that is used to check
the flow state for sampling."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampFlowStateParamSetEntry 2 }
psampSampFlowStateFuncParam OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the parameter set for the function
specified with psampSampFlowStateFunction that is used to
determine the packet that is to be sampled."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampFlowStateParamSetEntry 3 }
psampSampFlowStateRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampSampFlowStateParamSetEntry 4 }
--==================================================================
-- Packet selection filtering methods group of objects
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 29]
Internet-Draft PSAMP MIB October 2005
--==================================================================
psampFilteringMethods OBJECT IDENTIFIER ::= { psampObjects 2 }
--==================================================================
--* Method 0: Match filtering
--==================================================================
psampFilterMatch OBJECT IDENTIFIER ::= { psampFilteringMethods 0 }
psampFilterMatchAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of match filtering
at the managed node."
DEFVAL { notAvailable }
::= { psampFilterMatch 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampFilterMatchParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampFilterMatchParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of match filtering. The
match filtering is based on the IPFIX/PSAMP Information
Elements. The parameter set contains the Information
Element Id, a value or value range and a mask."
::= { psampFilterMatch 3 }
psampFilterMatchParamSetEntry OBJECT-TYPE
SYNTAX PsampFilterMatchParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampFilterMatchParamSetTable."
INDEX { psampFilterMatchIndex }
::= { psampFilterMatchParamSetTable 1 }
PsampFilterMatchParamSetEntry ::=
SEQUENCE {
psampFilterMatchIndex Integer32,
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 30]
Internet-Draft PSAMP MIB October 2005
psampFilterMatchInfoElementId Integer32,
psampFilterMatchStartValue OCTET STRING,
psampFilterMatchEndValue OCTET STRING,
psampFilterMatchMask OCTET STRING,
psampFilterMatchRowStatus RowStatus
}
psampFilterMatchIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampFilterMatchParamSetEntry 1 }
psampFilterMatchInfoElementId OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The id of the information element that is encoded as the
InfoElementId defined in the IPFIX/PSAMP Information
Models."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1, ipfix and
psamp info model!!"
-- Editor Note: get reference right!
::= { psampFilterMatchParamSetEntry 2 }
psampFilterMatchStartValue OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The value of the information element or the start of the
value range. If psampFilterMatchEndValue is defined then
this value is the start value of a value range. If
psampFilterMatchMask is defined then
psampFilterMatchEndValue is ignored. In this case the
packet is selected if the masked value exactly matches the
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 31]
Internet-Draft PSAMP MIB October 2005
start value psampFilterMatchStartValue. The data type and
its encoding is the same as in PSAMP-PROTO."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1, PROTO!!"
-- Editor Note: get reference right!
::= { psampFilterMatchParamSetEntry 3 }
psampFilterMatchEndValue OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The final value of a value range. It should be equal to
it's default value (''H) if a single value should be
encoded. It is ignored if psampFilterMatchMask is defined.
The data type and its encoding is the same as in
PSAMP-PROTO."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1, PROTO!!"
-- Editor Note: get reference right!
DEFVAL { ''H }
::= { psampFilterMatchParamSetEntry 4 }
psampFilterMatchMask OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The selected value of the given information element is
masked with this value. The resulting value is compared to
psampFilterMatchStartValue and the packet is selected if
they match. If psampFilterMatchEndValue and
psampFilterMatchMask are defined at the same time
psampFilterMatchEndValue is ignored. Note that a mask does
not make sense for all information elements and if it is
specified the mask has the same data type and encoding as
the information element referenced by the
psampFilterMatchInfoElementId."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1, PROTO!!"
-- Editor Note: get reference right!
DEFVAL { ''H }
::= { psampFilterMatchParamSetEntry 5 }
psampFilterMatchRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 32]
Internet-Draft PSAMP MIB October 2005
DESCRIPTION
"The status of this row of the table."
::= { psampFilterMatchParamSetEntry 6 }
--==================================================================
--* Method 1: Hash filtering
--==================================================================
psampFilterHash OBJECT IDENTIFIER ::= { psampFilteringMethods 1 }
psampFilterHashAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of hash filtering
at the managed node."
DEFVAL { notAvailable }
::= { psampFilterHash 1 }
psampFilterHashCapabilities OBJECT IDENTIFIER
::= { psampFilterHash 2 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampFilterHashParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampFilterHashParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of hash filtering. A
parameter set describing a configuration contains ten
parameter describing the hash function, the input bits feed
into the hash function and the output of the function."
::= { psampFilterHash 3 }
psampFilterHashParamSetEntry OBJECT-TYPE
SYNTAX PsampFilterHashParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampFilterHashParamSetTable."
INDEX { psampFilterHashIndex }
::= { psampFilterHashParamSetTable 1 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 33]
Internet-Draft PSAMP MIB October 2005
PsampFilterHashParamSetEntry ::=
SEQUENCE {
psampFilterHashIndex Integer32,
psampFilterHashAddrType InetAddressType,
psampFilterHashHeaderBits OCTET STRING,
psampFilterHashPayloadBytes Integer32,
psampFilterHashPayloadBits OCTET STRING,
psampFilterHashFunction OBJECT IDENTIFIER,
psampFilterHashFuncParam OBJECT IDENTIFIER,
psampFilterHashInputBits Integer32,
psampFilterHashOutputBits Integer32,
psampFilterHashOutputMask OCTET STRING,
psampFilterHashSelection DisplayString,
psampFilterHashRowStatus RowStatus
}
psampFilterHashIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampFilterHashParamSetEntry 1 }
psampFilterHashAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The address type the hash function is applied to (either
IPv4 or IPv6 packets). If a hash function applies to both
IPv4 and IPv6 addresses two entries in this table are
needed."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 2 }
psampFilterHashHeaderBits OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (40))
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 34]
Internet-Draft PSAMP MIB October 2005
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The object specifies the header bits of the layer 3 header
used for hashing. The size is 40 bytes but when
psampFilterHashAddrType is IPv4 then only the first 20
bytes are used."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 3 }
psampFilterHashPayloadBytes OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of bytes of payload used as input to the hash
function."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 4 }
psampFilterHashPayloadBits OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The object specifies the payload bits used for hashing. The
size depends on the value of psampFilterHashPayloadBytes."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 5 }
psampFilterHashFunction OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the hash function executed by the
current filtering method."
::= { psampFilterHashParamSetEntry 6 }
psampFilterHashFuncParam OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 35]
Internet-Draft PSAMP MIB October 2005
STATUS current
DESCRIPTION
"This object specifies the parameters used in addition to
those specified in this table."
::= { psampFilterHashParamSetEntry 7 }
psampFilterHashInputBits OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of bits used as input key to the hash function.
Usually this should be in the form of 2^x."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 8 }
psampFilterHashOutputBits OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of bits that form the output value of the hash
function."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 9 }
psampFilterHashOutputMask OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The mask applied to the output bits of the hash function.
If less hash values are needed the number of hashes can be
reduced by masking the output value. The size is dependent
on the number of output bits. If the output mask is empty
then no mask is applied."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
DEFVAL { ''H }
::= { psampFilterHashParamSetEntry 10 }
psampFilterHashSelection OBJECT-TYPE
SYNTAX DisplayString
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 36]
Internet-Draft PSAMP MIB October 2005
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object represents the hash values that select a
packet. It is represented in a human readable form. The
only allowed characters are [0-9a-f,-x]. A single hash
value is represented by its decimal ASCII notation or if
prefixed with 0x by its hexadecimal ASCII notation. A range
can be given by hash_value - hash_value and several single
values or ranges are separated by , (comma). The ASCII
string is defined as follows:
selections := selection | selections,selection
selection := range | value
range := value-value
value := 0x[0-9,a-f]* | [1-9][0-9]*
So, if you with to select hash values 0, 5 - 10 and 250-255
you could specify: 0,5-10,0xfa-0xff"
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 11 }
psampFilterHashRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampFilterHashParamSetEntry 12 }
--==================================================================
--* Method 2: Router State filtering
--==================================================================
psampFilterRState OBJECT IDENTIFIER ::= { psampFilteringMethods 2 }
psampFilterRStateAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of router state
filtering at the managed node."
DEFVAL { notAvailable }
::= { psampFilterRState 1 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 37]
Internet-Draft PSAMP MIB October 2005
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampFilterRStateParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampFilterRStateParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations of router state filtering.
A parameter set describing a configuration contains six
parameters: the router state function executed, and then
some parameters that are used dependent on the router state
function, like interface index or autonomous system number
range."
::= { psampFilterRState 3 }
psampFilterRStateParamSetEntry OBJECT-TYPE
SYNTAX PsampFilterRStateParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampFilterRStateParamSetTable."
INDEX { psampFilterRStateIndex }
::= { psampFilterRStateParamSetTable 1 }
PsampFilterRStateParamSetEntry ::=
SEQUENCE {
psampFilterRStateIndex Integer32,
psampFilterRStateFunction INTEGER,
psampFilterRStateNegate TruthValue,
psampFilterRStateIfIndex InterfaceIndexOrZero,
psampFilterRStateStartAS InetAutonomousSystemNumber,
psampFilterRStateEndAS InetAutonomousSystemNumber,
psampFilterRStateVendorFunc OBJECT IDENTIFIER,
psampFilterRStateRowStatus RowStatus
}
psampFilterRStateIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 38]
Internet-Draft PSAMP MIB October 2005
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampSelectorListTable as
reference to this method and its associated parameter set."
::= { psampFilterRStateParamSetEntry 1 }
psampFilterRStateFunction OBJECT-TYPE
SYNTAX INTEGER {
other (1),
ingressIf (2),
egressIf (3),
aclViolation (4),
rpfFailure (5),
noResources (6),
noRoute (7),
originAS (8),
destAS (9)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object indicates which function is applied to the
router state. The validity of the following objects depends
on the function selected here. The psampFilterRStateIfIndex
is only valid if the function is ingressIf or egressIf. The
psampFilterRstateStartAS/StopAS objects are only valid if
the function is originAS or destAS. The
psampFilterRStateVendor object is only valid if the function
other is chosen; in that case it points to a vendor specific
function."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterRStateParamSetEntry 2 }
psampFilterRStateNegate OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"If set to true this object will negate the output of the
psampFilterRStateFunction."
DEFVAL { false }
::= { psampFilterRStateParamSetEntry 3 }
psampFilterRStateIfIndex OBJECT-TYPE
SYNTAX InterfaceIndexOrZero
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 39]
Internet-Draft PSAMP MIB October 2005
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Used if the function is egressIf or ingressIf. Selects
the packet if the egressIf/ingressIf is the same as the
interface indicated by this object. If the object is not
used it contains a value of 0."
DEFVAL { 0 }
::= { psampFilterRStateParamSetEntry 4 }
psampFilterRStateStartAS OBJECT-TYPE
SYNTAX InetAutonomousSystemNumber
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Used if the function is originAS or destAS. Selects the
packet if the AS Number lies in the range of
psampFilterRStateStartAS and psampFilterRStateEndAS. If
the object is not used it default to 0."
DEFVAL { 0 }
::= { psampFilterRStateParamSetEntry 5 }
psampFilterRStateEndAS OBJECT-TYPE
SYNTAX InetAutonomousSystemNumber
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Used if the function is originAS or destAS. Selects the
packet if the AS Number lies in the range of
psampFilterRStateStartAS and psampFilterRStateStopAS. If
psampFilterRStateStartAS is not 0 and this object is 0 then
the range is single value, the value given in
psampFilterRStateStartAS."
DEFVAL { 0 }
::= { psampFilterRStateParamSetEntry 6 }
psampFilterRStateVendorFunc OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Used if the function is any other than those defined here.
In this case a vendor specific router state function is
used. If the object is not used it defaults to
psampFilterRState."
DEFVAL { psampFilterRState }
::= { psampFilterRStateParamSetEntry 7 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 40]
Internet-Draft PSAMP MIB October 2005
psampFilterRStateRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampFilterRStateParamSetEntry 8 }
--==================================================================
-- Hash Function Group
--==================================================================
psampHashFunctions OBJECT IDENTIFIER ::= { psampObjects 3 }
--==================================================================
--* Hash Function 0: IPSX
--==================================================================
psampHashIPSX OBJECT IDENTIFIER ::= { psampHashFunctions 0 }
psampHashIPSXAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the availability of the IPSX hash
function at the managed node."
DEFVAL { notAvailable }
::= { psampHashIPSX 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampHashIPSXParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampHashIPSXParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations the IPSX hash function.
Since this hash function takes no additional parameters the
table if available contains only one entry indicating that
the functions exists and can be referenced by the
psampFilterHashParamSetTable."
::= { psampHashIPSX 3 }
psampHashIPSXParamSetEntry OBJECT-TYPE
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 41]
Internet-Draft PSAMP MIB October 2005
SYNTAX PsampHashIPSXParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampHashIPSXParamSetTable."
INDEX { psampHashIPSXIndex }
::= { psampHashIPSXParamSetTable 1 }
PsampHashIPSXParamSetEntry ::=
SEQUENCE {
psampHashIPSXIndex Integer32,
psampHashIPSXRowStatus RowStatus
}
psampHashIPSXIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampFilterHashParamSetTable
as reference to this method and its associated parameter
set."
::= { psampHashIPSXParamSetEntry 1 }
psampHashIPSXRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampHashIPSXParamSetEntry 2 }
--==================================================================
--* Hash Function 1: Bob
--==================================================================
psampHashBob OBJECT IDENTIFIER ::= { psampHashFunctions 1 }
psampHashBobAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability
MAX-ACCESS read-only
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 42]
Internet-Draft PSAMP MIB October 2005
STATUS current
DESCRIPTION
"This object indicates the availability of the Bob hash
function at the managed node."
DEFVAL { notAvailable }
::= { psampHashBob 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampHashBobParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF
PsampHashBobParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists configurations the Bob hash function.
Since this hash function takes no additional parameters the
table if available contains only one entry indicating that
the functions exists and can be referenced by the
psampFilterHashParamSetTable."
::= { psampHashBob 3 }
psampHashBobParamSetEntry OBJECT-TYPE
SYNTAX PsampHashBobParamSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampHashBobParamSetTable."
INDEX { psampHashBobIndex }
::= { psampHashBobParamSetTable 1 }
PsampHashBobParamSetEntry ::=
SEQUENCE {
psampHashBobIndex Integer32,
psampHashBobRowStatus RowStatus
}
psampHashBobIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 43]
Internet-Draft PSAMP MIB October 2005
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampFilterHashParamSetTable
as reference to this method and its associated parameter
set."
::= { psampHashBobParamSetEntry 1 }
psampHashBobRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampHashBobParamSetEntry 2 }
--==================================================================
-- Reporting Group
--==================================================================
psampReporting OBJECT IDENTIFIER ::= { psampObjects 4 }
-- Collector Table +++++++++++++++++++++++++++++++++++++++++++++++++
psampCollectorTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampCollectorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists collectors to which PSAMP selected
packets are exported."
::= { psampReporting 1 }
psampCollectorEntry OBJECT-TYPE
SYNTAX PsampCollectorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampCollectorTable."
INDEX { psampCollectorIndex }
::= { psampCollectorTable 1 }
PsampCollectorEntry ::= SEQUENCE {
psampCollectorIndex Integer32,
psampCollectorDstIpAddressType InetAddressType,
psampCollectorDstIpAddress InetAddress,
psampCollectorDstProtocol Integer32,
psampCollectorDstPort Integer32,
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 44]
Internet-Draft PSAMP MIB October 2005
psampCollectorReportsSent Integer32,
psampCollectorRowStatus RowStatus
}
psampCollectorIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this collector table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampCollectorGroupTable as
reference to this collector and its associated parameters."
::= { psampCollectorEntry 1 }
psampCollectorDstIpAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The IP address type of the collector. The value for IPv4
is ipv4(1). The value for IPv6 is ipv6(2)."
::= { psampCollectorEntry 2 }
psampCollectorDstIpAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The IP address of the collector."
::= { psampCollectorEntry 3 }
psampCollectorDstProtocol OBJECT-TYPE
SYNTAX Integer32 (0..256)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The transport protocol used for exporting sampled packets
to the collector. The recommended protocols are TCP (6),
UDP (17) and SCTP (132). The default is SCTP."
DEFVAL { 132 }
::= { psampCollectorEntry 4 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 45]
Internet-Draft PSAMP MIB October 2005
psampCollectorDstPort OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The transport protocol port number of the collector."
::= { psampCollectorEntry 5 }
psampCollectorReportsSent OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packet reports sent to the collector."
::= { psampCollectorEntry 6 }
psampCollectorRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampCollectorEntry 7 }
-- Collector Group Table +++++++++++++++++++++++++++++++++++++++++++
psampCollectorGroupTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampCollectorGroupEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists groups of collectors to which PSAMP
selected packets are exported simultaneously. If PSAMP
selected packets are exported to only one collector the
group consists of exactly one collector."
::= { psampReporting 2 }
psampCollectorGroupEntry OBJECT-TYPE
SYNTAX PsampCollectorGroupEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampCollectorGroupTable."
INDEX { psampCollectorGroupIndex, psampCollectorIndex }
::= { psampCollectorGroupTable 1 }
PsampCollectorGroupEntry ::= SEQUENCE {
psampCollectorGroupIndex Integer32,
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 46]
Internet-Draft PSAMP MIB October 2005
psampCollectorGroupRowStatus RowStatus
}
psampCollectorGroupIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this parameter set table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampBaseAssocTable as
reference to this collector group and its associated
parameters."
::= { psampCollectorGroupEntry 1 }
psampCollectorGroupRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampCollectorGroupEntry 3 }
-- (Data) Template Record Table
psampTemplateRecordTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampTemplateRecordEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists templates used by the exporter."
::= { psampReporting 3 }
psampTemplateRecordEntry OBJECT-TYPE
SYNTAX PsampTemplateRecordEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampTemplateTable."
INDEX { psampTemplateRecordId, psampTemplateRecordIndex }
::= { psampTemplateRecordTable 1 }
PsampTemplateRecordEntry ::= SEQUENCE {
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 47]
Internet-Draft PSAMP MIB October 2005
psampTemplateRecordId Integer32,
psampTemplateRecordIndex Integer32,
psampTemplateRecordInfoElementId Integer32,
psampTemplateRecordRowStatus RowStatus
}
psampTemplateRecordId OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this template record table.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampBaseAssocTable as
reference to this template record and its associated
parameters. It groups the information element ids in a
template record."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampTemplateRecordEntry 1 }
psampTemplateRecordIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of a
information element id in the template record identified by
psampTemplateRecordId.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
The psampTemplateRecordIndex specifies the order in which
the informatation element ids are used in the template
record."
::= { psampTemplateRecordEntry 2 }
psampTemplateRecordInfoElementId OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 48]
Internet-Draft PSAMP MIB October 2005
STATUS current
DESCRIPTION
"The Information Element Id at position
psampTemplateRecordIndex in the template
psampTemplateRecordId. This implicitly gives the data type
and state values that are exported."
REFERENCE
"draft-ietf-psamp-sample-tech-07.txt, IPFIX/PSAMP INFO MODEL"
-- Editor Note: get reference right!
::= { psampTemplateRecordEntry 3 }
psampTemplateRecordRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampTemplateRecordEntry 4 }
--==================================================================
-- Base Associations Group
--==================================================================
psampBaseAssociations OBJECT IDENTIFIER ::= { psampObjects 5 }
psampBaseAssociationTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampBaseAssociationEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists all base associations at the managed
node."
::= { psampBaseAssociations 1 }
psampBaseAssociationEntry OBJECT-TYPE
SYNTAX PsampBaseAssociationEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampInstanceTable."
INDEX { psampBaseAssocIndex }
::= { psampBaseAssociationTable 1 }
PsampBaseAssociationEntry ::= SEQUENCE {
psampBaseAssocIndex Integer32,
psampBaseAssocObservationPoint OBJECT IDENTIFIER,
psampBaseAssocTemplateRecordId Integer32,
psampBaseAssocCollectorGrpIndex Integer32,
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 49]
Internet-Draft PSAMP MIB October 2005
psampBaseAssocPacketsObserved Integer32,
psampBaseAssocPacketsDropped Integer32,
psampBaseAssocMeteringProcessId Integer32,
psampBaseAssocReportingProcessId Integer32,
psampBaseAssocReportsSent Integer32,
psampBaseAssocRowStatus RowStatus
}
psampBaseAssocIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of the base
associations.
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization."
::= { psampBaseAssociationEntry 1 }
psampBaseAssocObservationPoint OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The point where the packet is observed. If it is e.g, an
interface it points to the mib-II object of the interface."
::= { psampBaseAssociationEntry 2 }
psampBaseAssocTemplateRecordId OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The Id of a template in the template table. This implies
the knowledge about the method chain from the method chain
table. Furthermore it links the instance, method chain
(selector) and template together.
The identified template is applied to the stream of
filtered/sampled packets observed after applying the method
chain at the observation point."
::= { psampBaseAssociationEntry 3 }
psampBaseAssocCollectorGrpIndex OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-create
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 50]
Internet-Draft PSAMP MIB October 2005
STATUS current
DESCRIPTION
"The index of the collector group to which packet reports
are sent."
::= { psampBaseAssociationEntry 4 }
psampBaseAssocPacketsObserved OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets passing at the observation point."
::= { psampBaseAssociationEntry 5 }
psampBaseAssocPacketsDropped OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets dropped while filtering/sampling
packets due to lack of resources."
::= { psampBaseAssociationEntry 6 }
psampBaseAssocMeteringProcessId OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The process id of the metering process used by this
Base Association."
::= { psampBaseAssociationEntry 7 }
psampBaseAssocReportingProcessId OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The process id of the reporting process used by this
Base Association."
::= { psampBaseAssociationEntry 8 }
psampBaseAssocReportsSent OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packet reports on sampled packets sent to
the collector."
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 51]
Internet-Draft PSAMP MIB October 2005
::= { psampBaseAssociationEntry 9 }
psampBaseAssocRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampBaseAssociationEntry 10 }
-- Selector List Table ++++++++++++++++++++++++++++++++++++++++++++++
psampSelectorListTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampSelectorListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains lists of selectors and connects them
to the base associations where they are applied to
different observation points. The packets that are selected
by the last selection method are then exported."
::= { psampBaseAssociations 4 }
psampSelectorListEntry OBJECT-TYPE
SYNTAX PsampSelectorListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Defines an entry in the psampSelectorListTable."
INDEX { psampBaseAssocIndex, psampSelectorListIndex }
::= { psampSelectorListTable 1 }
PsampSelectorListEntry ::= SEQUENCE {
psampSelectorListIndex Integer32,
psampSelectorListMethod OBJECT IDENTIFIER,
psampSelectorListPacketsObserved Integer32,
psampSelectorListPacketsDropped Integer32,
psampSelectorListRowStatus RowStatus
}
psampSelectorListIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The locally arbitrary, but unique identifier of an entry
in this selector list table.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 52]
Internet-Draft PSAMP MIB October 2005
The value is expected to remain constant at least from one
re-initialization of the entity's network management system
to the next re-initialization.
It is used in entries of the psampBaseAssocTable as
reference to this selector list and its associated
parameters."
::= { psampSelectorListEntry 2 }
psampSelectorListMethod OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The selector used at a certain position in the selector
list."
::= { psampSelectorListEntry 3 }
psampSelectorListPacketsObserved OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets observed at the method entry point."
::= { psampSelectorListEntry 4 }
psampSelectorListPacketsDropped OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets dropped due to lack of resources by
this selection method."
::= { psampSelectorListEntry 5 }
psampSelectorListRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row of the table."
::= { psampSelectorListEntry 6 }
--==================================================================
-- Conformance information
--==================================================================
psampCompliances OBJECT IDENTIFIER ::= { psampConformance 1 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 53]
Internet-Draft PSAMP MIB October 2005
psampGroups OBJECT IDENTIFIER ::= { psampConformance 2 }
--==================================================================
-- Compliance statements
--==================================================================
psampCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"An implementation that complies to this module must
implement the objects defined in the mandatory groups
psampGroupMetering and psampGroupReporting. The
implementation of all other objects depends on the
implementation of the corresponding functionality in the
equipment."
MODULE -- this module
MANDATORY-GROUPS {
psampGroupMetering,
psampGroupReporting
}
GROUP psampGroupSampCountBased
DESCRIPTION
"These objects must be implemented if the corresponding
sampling function is implemented in the equipment."
GROUP psampGroupSampTimeBased
DESCRIPTION
"These objects must be implemented if the corresponding
sampling function is implemented in the equipment."
GROUP psampGroupSampRandOutOfN
DESCRIPTION
"These objects must be implemented if the corresponding
sampling function is implemented in the equipment."
GROUP psampGroupSampUniProb
DESCRIPTION
"These objects must be implemented if the corresponding
sampling function is implemented in the equipment."
GROUP psampGroupSampNonUniProb
DESCRIPTION
"These objects must be implemented if the corresponding
sampling function is implemented in the equipment."
GROUP psampGroupSampFlowState
DESCRIPTION
"These objects must be implemented if the corresponding
sampling function is implemented in the equipment."
GROUP psampGroupFilterMatch
DESCRIPTION
"These objects must be implemented if the corresponding
filter function is implemented in the equipment."
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 54]
Internet-Draft PSAMP MIB October 2005
GROUP psampGroupFilterHash
DESCRIPTION
"These objects must be implemented if the corresponding
filter function is implemented in the equipment."
GROUP psampGroupFilterRState
DESCRIPTION
"These objects must be implemented if the corresponding
filter function is implemented in the equipment."
GROUP psampGroupHashIPSX
DESCRIPTION
"These objects must be implemented if the corresponding
hash function is implemented in the equipment."
GROUP psampGroupHashBob
DESCRIPTION
"These objects must be implemented if the corresponding
hash function is implemented in the equipment."
GROUP psampGroupStatistics
DESCRIPTION
"These objects must be implemented if statistics are
implemented on the equipment."
::= { psampCompliances 1 }
--==================================================================
-- MIB groupings
--==================================================================
psampGroupMetering OBJECT-GROUP
OBJECTS {
psampSelectAllAvail,
psampSampCountBasedAvail,
psampSampTimeBasedAvail,
psampSampRandOutOfNAvail,
psampSampUniProbAvail,
psampSampNonUniProbAvail,
psampSampFlowStateAvail,
psampFilterMatchAvail,
psampFilterHashAvail,
psampFilterRStateAvail,
psampHashIPSXAvail,
psampHashBobAvail,
psampTemplateRecordInfoElementId,
psampTemplateRecordRowStatus,
psampSelectorListMethod,
psampSelectorListRowStatus,
psampBaseAssocObservationPoint,
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 55]
Internet-Draft PSAMP MIB October 2005
psampBaseAssocTemplateRecordId,
psampBaseAssocCollectorGrpIndex,
psampBaseAssocMeteringProcessId,
psampBaseAssocReportingProcessId,
psampBaseAssocRowStatus
}
STATUS current
DESCRIPTION
"All objects that are basic for the metering process. It
contains a basic metering function (psampSelectAll), The
template definitions needed for the export of data, the
method chain that fixes the metering functions applied to
the observation point and several parameters concering
the export process and the collectors."
::= { psampGroups 1 }
psampGroupSampCountBased OBJECT-GROUP
OBJECTS {
psampSampCountBasedMaxInterval,
psampSampCountBasedMinSpacing,
psampSampCountBasedInterval,
psampSampCountBasedSpacing,
psampSampCountBasedRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if count based sampling is
implemented."
::= { psampGroups 2 }
psampGroupSampTimeBased OBJECT-GROUP
OBJECTS {
psampSampTimeBasedMaxInterval,
psampSampTimeBasedMinSpacing,
psampSampTimeBasedInterval,
psampSampTimeBasedSpacing,
psampSampTimeBasedRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if time based sampling is
implemented."
::= { psampGroups 3 }
psampGroupSampRandOutOfN OBJECT-GROUP
OBJECTS {
psampSampRandOutOfNMaxPopulation,
psampSampRandOutOfNPopulation,
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 56]
Internet-Draft PSAMP MIB October 2005
psampSampRandOutOfNSample,
psampSampRandOutOfNRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if random n-out-of-N sampling is
implemented."
::= { psampGroups 4 }
psampGroupSampUniProb OBJECT-GROUP
OBJECTS {
psampSampUniProbProbability,
psampSampUniProbRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if uniform probabilistic sampling
is implemented."
::= { psampGroups 5 }
psampGroupSampNonUniProb OBJECT-GROUP
OBJECTS {
psampSampNonUniProbFunction,
psampSampNonUniProbFuncParam,
psampSampNonUniProbRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if non-uniform probabilistic
sampling is implemented."
::= { psampGroups 6 }
psampGroupSampFlowState OBJECT-GROUP
OBJECTS {
psampSampFlowStateFunction,
psampSampFlowStateFuncParam,
psampSampFlowStateRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if flow state sampling is
implemented."
::= { psampGroups 7 }
psampGroupFilterMatch OBJECT-GROUP
OBJECTS {
psampFilterMatchInfoElementId,
psampFilterMatchStartValue,
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 57]
Internet-Draft PSAMP MIB October 2005
psampFilterMatchEndValue,
psampFilterMatchMask,
psampFilterMatchRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if match filtering is implemented."
::= { psampGroups 8 }
psampGroupFilterHash OBJECT-GROUP
OBJECTS {
psampFilterHashAddrType,
psampFilterHashHeaderBits,
psampFilterHashPayloadBytes,
psampFilterHashPayloadBits,
psampFilterHashFunction,
psampFilterHashFuncParam,
psampFilterHashInputBits,
psampFilterHashOutputBits,
psampFilterHashOutputMask,
psampFilterHashSelection,
psampFilterHashRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if hash filtering is implemented."
::= { psampGroups 9 }
psampGroupFilterRState OBJECT-GROUP
OBJECTS {
psampFilterRStateFunction,
psampFilterRStateNegate,
psampFilterRStateIfIndex,
psampFilterRStateStartAS,
psampFilterRStateEndAS,
psampFilterRStateVendorFunc,
psampFilterRStateRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if router state filtering is
implemented."
::= { psampGroups 10 }
psampGroupHashIPSX OBJECT-GROUP
OBJECTS {
psampHashIPSXRowStatus
}
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 58]
Internet-Draft PSAMP MIB October 2005
STATUS current
DESCRIPTION
"These objects are needed if the IPSX hash function is
implemented."
::= { psampGroups 11 }
psampGroupHashBob OBJECT-GROUP
OBJECTS {
psampHashBobRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if the Bob hash function is
implemented."
::= { psampGroups 12 }
psampGroupReporting OBJECT-GROUP
OBJECTS {
psampCollectorDstIpAddressType,
psampCollectorDstIpAddress,
psampCollectorDstProtocol,
psampCollectorDstPort,
psampCollectorRowStatus,
psampCollectorGroupRowStatus
}
STATUS current
DESCRIPTION
"These objects define the collectors i.e., the destinations
of the exporting process."
::= { psampGroups 13 }
psampGroupStatistics OBJECT-GROUP
OBJECTS {
psampCollectorReportsSent,
psampSelectorListPacketsObserved,
psampSelectorListPacketsDropped,
psampBaseAssocPacketsObserved,
psampBaseAssocReportsSent,
psampBaseAssocPacketsDropped
}
STATUS current
DESCRIPTION
"These objects contain statistical values gathered at
different points in the metering process."
::= { psampGroups 14 }
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 59]
Internet-Draft PSAMP MIB October 2005
END
7. Security Considerations
There are a number of management objects defined in this MIB module
with a MAX-ACCESS clause of read-write and/or read-create. Such
objects may be considered sensitive or vulnerable in some network
environments. The support for SET operations in a non-secure
environment without proper protection can have a negative effect on
network operations.
8. Acknowledgment
This document is a product of the PSAMP working group.
9. References
9.1. Normative References
[1] Duffield, N., "A Framework for Packet Selection and Reporting",
draft-ietf-psamp-framework-10 (work in progress), January 2005.
[2] Zseby, T., "Sampling and Filtering Techniques for IP Packet
Selection", draft-ietf-psamp-sample-tech-07 (work in progress),
July 2005.
[3] Claise, B., "Packet Sampling (PSAMP) Protocol Specifications",
draft-ietf-psamp-protocol-01 (work in progress), February 2004.
[4] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
McCloghrie, K., Rose, M., and S. Waldbusser, "Structure of
Management Information Version 2 (SMIv2)", STD 58, RFC 2578,
April 1999.
[5] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
McCloghrie, K., Rose, M., and S. Waldbusser, "Textual
Conventions for SMIv2", STD 58, RFC 2579, April 1999.
[6] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Conformance
Statements for SMIv2", STD 58, RFC 2580, April 1999.
[7] Dietz, T., "Information Model for Packet Sampling Exports",
draft-ietf-psamp-info-02 (work in progress), July 2004.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 60]
Internet-Draft PSAMP MIB October 2005
9.2. Informative References
[8] Bradner, S., "Key words for use in RFCs to Indicate Requirement
Levels", BCP 14, RFC 2119, March 1997.
[9] Quittek, J., "Requirements for IP Flow Information Export",
draft-ietf-ipfix-reqs-16 (work in progress), June 2004.
[10] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction
and Applicability Statements for Internet-Standard Management
Framework", RFC 3410, December 2002.
[11] Quittek, J., "Information Model for IP Flow Information
Export", draft-ietf-ipfix-info-11 (work in progress),
September 2005.
[12] Sadasivan, G., "Architecture for IP Flow Information Export",
draft-ietf-ipfix-architecture-09 (work in progress),
August 2005.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 61]
Internet-Draft PSAMP MIB October 2005
Authors' Addresses
Thomas Dietz (editor)
NEC Europte Ltd.
Network Laboratories
Kurfuersten-Anlage 36
69115 Heidelberg
Germany
Phone: +49 6221 90511-28
Email: dietz@netlab.nec.de
Benoit Claise
Cisco Systems
De Kleetlaan 6a b1
1831 Degem
Belgium
Phone: +32 2 704 5622
Email: bclaise@cisco.com
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 62]
Internet-Draft PSAMP MIB October 2005
Intellectual Property Statement
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Disclaimer of Validity
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Copyright Statement
Copyright (C) The Internet Society (2005). This document is subject
to the rights, licenses and restrictions contained in BCP 78, and
except as set forth therein, the authors retain all their rights.
Acknowledgment
Funding for the RFC Editor function is currently provided by the
Internet Society.
Dietz & Claise draft-ietf-psamp-mib-05.txt [Page 63]
