draft-ietf-psamp-mib-03.txt   draft-ietf-psamp-mib-04.txt 
Network Working Group T. Dietz, Ed. Network Working Group T. Dietz, Ed.
Internet-Draft NEC Europte Ltd. Internet-Draft NEC Europte Ltd.
Expires: Dezember 30, 2004 B. Claise Expires: August 22, 2005 B. Claise
Cisco Systems Cisco Systems
July 2004 February 18, 2005
Definitions of Managed Objects for Packet Sampling Definitions of Managed Objects for Packet Sampling
<draft-ietf-psamp-mib-03.txt> <draft-ietf-psamp-mib-04.txt>
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance with This document is an Internet-Draft and is subject to all provisions
all provisions of Section 10 of RFC2026. of Section 3 of RFC 3667. 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 become aware will be disclosed, in accordance with
RFC 3668.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that other Task Force (IETF), its areas, and its working groups. Note that
groups may also distribute working documents as Internet-Drafts. other groups may also distribute working documents as
Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at http:// The list of current Internet-Drafts can be accessed at
www.ietf.org/ietf/1id-abstracts.txt. http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html. http://www.ietf.org/shadow.html.
This Internet-Draft will expire on Dezember 30, 2004. This Internet-Draft will expire on August 22, 2005.
Copyright Notice Copyright Notice
Copyright (C) The Internet Society (2004). All Rights Reserved. Copyright (C) The Internet Society (2005).
Abstract Abstract
This memo defines managed objects for packet sampling. These objects This memo defines managed objects for sampling and filtering
provide information about managed nodes supporting packet sampling, techniques for IP packet selection. These objects provide
including packet sampling capabilities, configuration and statistics. information about managed nodes supporting packet sampling, including
They also allow to configure packet sampling concerning the IP packet sampling capabilities, configuration and statistics. They
interface at which packets are sampled, the packet selections methods also allow to configure packet sampling concerning the IP interface
used for sampling, and the collector to which packet samples are at which packets are sampled, the packet selections methods used for
exported. sampling, and the collector to which packet samples are exported.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1 Points of Discussion . . . . . . . . . . . . . . . . . . . 3
2. The Internet-Standard Management Framework . . . . . . . . . 3 2. PSAMP Documents Overview . . . . . . . . . . . . . . . . . . 5
3. Structure of the PSAMP MIB module . . . . . . . . . . . . . 3 3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1 The Sampling Methods Group . . . . . . . . . . . . . . . . . 4 3.1 Base Association . . . . . . . . . . . . . . . . . . . . . 6
3.1.1 Selecting All Packets . . . . . . . . . . . . . . . . . . . 4
3.1.2 Systematic Count-based Sampling . . . . . . . . . . . . . . 4
3.1.3 Systematic Time-based Sampling . . . . . . . . . . . . . . . 5
3.1.4 Random n-out-of-N Sampling . . . . . . . . . . . . . . . . . 5
3.1.5 Uniform Probabilistic Sampling . . . . . . . . . . . . . . . 5
3.1.6 Non-Uniform Probabilistic Sampling . . . . . . . . . . . . . 6
3.1.7 Flow State Sampling . . . . . . . . . . . . . . . . . . . . 6
3.2 The Filtering Methods Group . . . . . . . . . . . . . . . . 6
3.2.1 Mask Filtering . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.2 Hash Filtering . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.3 Router State Filtering . . . . . . . . . . . . . . . . . . . 7
3.3 The Reporting Group . . . . . . . . . . . . . . . . . . . . 7
3.4 The Instance Group . . . . . . . . . . . . . . . . . . . . . 7
4. Definition . . . . . . . . . . . . . . . . . . . . . . . . . 8 4. The Internet-Standard Management Framework . . . . . . . . . 6
5. Security Considerations . . . . . . . . . . . . . . . . . . 38 5. Structure of the PSAMP MIB module . . . . . . . . . . . . . 6
5.1 TEXTUAL CONVENTIONS . . . . . . . . . . . . . . . . . . . 7
5.2 The Selection Methods . . . . . . . . . . . . . . . . . . 7
5.2.1 Selecting All Packets . . . . . . . . . . . . . . . . 8
5.2.2 Systematic Count-based Sampling . . . . . . . . . . . 8
5.2.3 Systematic Time-based Sampling . . . . . . . . . . . . 8
5.2.4 Random n-out-of-N Sampling . . . . . . . . . . . . . . 8
5.2.5 Uniform Probabilistic Sampling . . . . . . . . . . . . 9
5.2.6 Non-Uniform Probabilistic Sampling . . . . . . . . . . 9
5.2.7 Flow State Sampling . . . . . . . . . . . . . . . . . 9
5.2.8 Match Filtering . . . . . . . . . . . . . . . . . . . 9
5.2.9 Hash Filtering . . . . . . . . . . . . . . . . . . . . 10
5.2.10 Router State Filtering . . . . . . . . . . . . . . . 10
5.3 The Hash Functions . . . . . . . . . . . . . . . . . . . . 11
5.4 The Reporting . . . . . . . . . . . . . . . . . . . . . . 11
5.5 The Base Associations . . . . . . . . . . . . . . . . . . 12
6. Open Issues . . . . . . . . . . . . . . . . . . . . . . . . 38 6. Definition . . . . . . . . . . . . . . . . . . . . . . . . . 13
7. Acknowledgment . . . . . . . . . . . . . . . . . . . . . . . 39 7. Security Considerations . . . . . . . . . . . . . . . . . . 59
Normative References . . . . . . . . . . . . . . . . . . . . 39 8. Acknowledgment . . . . . . . . . . . . . . . . . . . . . . . 59
Informative References . . . . . . . . . . . . . . . . . . . 39 9. References . . . . . . . . . . . . . . . . . . . . . . . . . 59
9.1 Normative References . . . . . . . . . . . . . . . . . . . 59
9.2 Informative References . . . . . . . . . . . . . . . . . . 60
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . 40 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . 60
Intellectual Property and Copyright Statements . . . . . . . 41 Intellectual Property and Copyright Statements . . . . . . . 62
1. Introduction 1. Introduction
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119]. document are to be interpreted as described in RFC 2119 [RFC2119].
This document is a product of the Packet Sampling (PSAMP) working This document is a product of the Packet Sampling (PSAMP) working
group. Its purpose is to define standards-based MIB modules for group. Its purpose is to define standards-based MIB modules for
monitoring and configuring managed nodes performing packet sampling. monitoring and configuring PSAMP devices performing packet selection
by sampling, filtering and hashing.
It is assumed that packet sampling is performed according to the It is assumed that packet sampling is performed according to the
framework defined in [I-D.ietf-psamp-framework]. Packet selection framework defined in [PSAMP-FW]. Packet selection methods considered
methods considered in the MIB module are specified in in the MIB module are specified in [PSAMP-TECH]. Configuration of
[I-D.ietf-psamp-sample-tech]. Configuration of the export of samples the export of packet samples to a collector is modeled according to
to a collector is modeled according to [I-D.ietf-psamp-protocol]. [PSAMP-PROTO].
Section 3 describes the structure of the PSAMP MIB module and section 1.1 Points of Discussion
4 contains the formal definition. Security issues are discussed in
section 5.
2. The Internet-Standard Management Framework 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?
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 [PSAMP-TECH].
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.
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.
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 [PSAMP-TECH]. 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 [PSAMP-FW]. Detailed definitions of selectors can be found in
[PSAMP-TECH]. PSAMP terminology also aims to be consistent with
terms used in [I-D.ietf-ipfix-reqs]. The relationship between some
PSAMP and IPFIX terms is described in [PSAMP-FW].
3.1 Base Association
The Base Association combines several values defined at a PSAMP
device. It is derived from the ASSOCIATION defined in [PSAMP-TECH]
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
For a detailed overview of the documents that describe the current For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410]. RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP). accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies a MIB Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58, module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
[RFC2580]. [RFC2580].
3. Structure of the PSAMP MIB module 5. Structure of the PSAMP MIB module
This draft does still not contain a complete PSAMP MIB module The PSAMP MIB module follows the structures given in [PSAMP-FW] and
definition, but some essential components of it sketching the [PSAMP-TECH]. The psampBaseAssociations subtree builds the heart of
structure of the complete module. The sketch serves as input to a the PSAMP MIB. This subtree models the values described by the Base
discussion of the MIB module structure, particular of the modeling of Association. The psampBaseAssocTable contains one entry per Base
capabilities and configured packet sampling instances. Please find a Association. The list of Selectors is modelled by a second table the
(not complete) list of open issues at the end of the document. 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.
The PSAMP-MIB module defined below contains four groups of objects: Every selection method described in [PSAMP-TECH] gets its own subtree
the sampling methods group, the filtering methods group, the in the PSAMP MIB. The subtree always contains a capability section
reporting group, and the instances group. 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 [PSAMP-TECH] are modelled
in a similar way as the selection methods and are referenced by a
psampFilterHashParamSetEntry.
3.1 The Sampling Methods Group 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.
The first group of objects contains information about sampling 5.1 TEXTUAL CONVENTIONS
methods. Each sampling method is covered by an individual sub-tree of
this group. For each method a single object indicating the
availability of the method is defined. Furthermore, the following
objects are defined for each method except the first: a sub-group of
objects indicating specific capabilities and limits of the method,
and a sub-group specifying sets of parameters in a table. Each
parameter set uniquely specifies all parameters of a packet sampling
instance of the method. Also all parameters sets contain a row
status.
Methods and parameters of methods are specified in The PSAMP MIB defines one new textual convention, the
[I-D.ietf-psamp-sample-tech]. So far, objects for six methods defined PsampMethodAvailability. It is used as SYNTAX of all those objects
in this Internet drafts are contained in the PSAMP MIB module plus an that indicate if a selection method or hash function is available in
additional trivial method. Some of the methods cannot be finished a specific implementation of a PSAMP device.
within the PSAMP framework because they need some assistance from the
vendor side. The vendor must specify e.g., the algorithm used for
non-uniform probabilistic sampling. The seven methods are selecting
all, systematic count-based sampling, systematic time-based sampling,
random n-out-of-N sampling, uniform probabilistic sampling,
non-uniform probabilistic sampling and flow state sampling.
All methods - except the selecting all method - have an object called 5.2 The Selection Methods
psampSamp"MethodName"Avail indicating if the method is implemented
and available in the managed node. The capability objects are
following after that object. These objects depend on the sampling
method. After the capabilities the parameter set table follows. The
objects in the table also depend on the sampling method. These
parameter sets are not necessarily instantiated at the managed node,
but for each instantiated parameter set of a method, there MUST be an
entry in the corresponding table.
EDITOR NOTE: TBD define usage of RowStatus. The whole paragraph must The first group of objects contains information about sampling
be reviewed before the final version to remove remarks for final methods and filtering methods. Each method is covered by an
refinements that must be ready/solved in the final version. 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.
3.1.1 Selecting All Packets The PSAMP MIB covers all methods and their parameters specified in
[PSAMP-TECH]. 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.
This trivial packet selection method is alway available. If it is 5.2.1 Selecting All Packets
applied, all packets will be selected.
3.1.2 Systematic Count-based Sampling This is the most trivial packet selection method. If it is applied,
all packets will be selected.
The systematic count-based sampling method has two capability 5.2.2 Systematic Count-based Sampling
objects: The psampSampCountBasedMaxInterval object indicates the
maximum sampling interval in packets supported by the implementation, Count-based sampling means, that all packets that arrive in this
whereas psampSampCountBasedMaxSpacing indicates the maximum spacing packet interval are selected. The spacing parameter defines the
in packets supported by the implementation. 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: Finally the psampSampCountBasedParamSetTable contains two parameters:
the sampling interval length and the spacing specified in numbers of the sampling interval length and the spacing specified in number of
packets. packets.
3.1.3 Systematic Time-based Sampling 5.2.3 Systematic Time-based Sampling
The systematic time-based sampling method has two capability objects: Time-based sampling means, that all packets that arrive in this time
psampSampTimeBasedMaxInterval indicates the maximum sampling interval interval are selected. The spacing parameter defines the spacing in
in microseconds supported by the implementation, whereas time between the end of one sampling interval and the start of the
psampSampTimeBasedMaxSpacing indicates the maximum spacing in next succeeding interval. The systematic time-based sampling methods
microseconds supported by the implementation. 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: Finally the psampSampTimeBasedParamSetTable contains two parameters:
the sampling interval length and the spacing specified in the sampling interval length and the spacing specified in number of
microseconds. microseconds.
3.1.4 Random n-out-of-N Sampling 5.2.4 Random n-out-of-N Sampling
The random n-out-of-N sampling method has two capability objects:
psampSampRandOutOfNMaxPopulation specifying the maximum population N,
and psampSampRandOutOfNMaxSize the maximum size of n supported by the
implementation.
EDITOR NOTE: maximum size of n should be naturally the same as the The random n-out-of-N sampling method has one capability object:
maximum population N! So we may drop psampSampRandOutOfNMaxSize in psampSampRandOutOfNMaxPopulation specifying the maximum population N.
the next version.
The random n-out-of-N sampling method has also two parameter objects The random n-out-of-N sampling method has also two parameter objects
in the psampSampRandOutOfNParamSetTable. The first one is in the psampSampRandOutOfNParamSetTable. The first one is
psampSampRandOutOfNPopulation and gives the number of elements N in psampSampRandOutOfNPopulation and gives the number of elements N in
the parent population. The second psampSampRandOutOfNSize gives the the parent population. The second psampSampRandOutOfNSample gives
number of elements n taken from the parent population N. With these the number of elements n taken from the parent population N. With
two parameters you sample n packets out of N. these two parameters you sample n packets out of N.
3.1.5 Uniform Probabilistic Sampling
So far, the sub-group of objects specifying capabilities is empty for
this method.
EDITOR NOTE: this must be changed since we somehow can define some
constraints now.
The psampSampUniProbParamSetTable contains one parameters, the
psampSampUniProbProbability and 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).
3.1.6 Non-Uniform Probabilistic Sampling
So far, the sub-group of objects specifying capabilities is empty for 5.2.5 Uniform Probabilistic Sampling
this method.
The psampSampNonUniProbParamSetTable contains one parameters, the Capability objects are not specified for the uniform probabilistic
psampSampNonUniProbFunction object that points to another object sampling method. It has only one parameter in the
(OID) describing the function that computes the propability that a psampSampUniProbParamSetTable, the psampSampUniProbProbability. This
packet is sampled. 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).
EDITOR NOTE: Do we need to define a standard function? 5.2.6 Non-Uniform Probabilistic Sampling
3.1.7 Flow State 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
the scope of this document.
So far, the sub-group of objects specifying capabilities is empty for 5.2.7 Flow State Sampling
this method.
The psampSampFlowStateParamSetTable contains one parameters, the Capability objects are not specified for the flow state sampling
psampSampFlowStateFunction object that points to another object (OID) method. The psampSampFlowStateParamSetTable holds two parameters
describing the function that checks the flow state and decides if a pointing to the flow state function and the parameters used by the
packet is sampled. flow state function (psampSampFlowStateFunction and
psampSampFlowStateFuncParam). Again the function and its parameters
are implementation dependent and beyond the scope of this document.
EDITOR NOTE: Do we need to define a standard function? 5.2.8 Match Filtering
3.2 The Filtering Methods Group 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 [PSAMP-INFO],
[I-D.ietf-ipfix-info]. 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.
EDITOR NOTE: This section does need a complete rewrite. The rewrite 5.2.9 Hash Filtering
is deferred until the input for the filtering methods from the other
WG documents is stable.
The second group contains information about the filtering methods. Capability objects are not specified for the hash filtering method.
This group is build up similarly to the sampling methods group. It But according to the sample tech document [PSAMP-TECH] ten parameters
currently contains three filtering methods, the mask filtering, the are defined in the psampFilterHashParamSetTable. The
hash filtering and the router state filtering. 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.
3.2.1 Mask Filtering 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
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(-).
to be done... 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.
3.2.2 Hash Filtering 5.2.10 Router State Filtering
The first object in this group is psampHashFilteringAvailability Capability objects are not specified for the router state filtering
indicating the availability of this method. So far, the sub-group of method. The parameter table psampFilterRStateParamSetTable contains
objects specifying capabilities is empty for this method. 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.
EDITOR NOTE: The capabilites should somehow say what hash functions aclViolation: packets that violate the access control list are
are available. 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 psampHashFilteringParameterSetTable contains a parameter set in The parameter psampFilterRStateIfIndex defaults to 0 if not used.
each of its entries that completely specifies a configuration of an The parameters psampFilterRStateStartAS and psampFilterRStateStopAS
instance of the packet filtering method. These parameter sets are not default to 0 if they are not used. If a single autonomous system
necessarily instantiated at the managed node, but for each number should be matched psampFilterRStateStopAS remains 0.
instantiated parameter set of this method, there MUST be an entry in
this table. The parameter set contains one parameters, the
psampHashFilteringFunction contains an object ID poiting to the hash
function used.
3.2.3 Router State Filtering 5.3 The Hash Functions
to be done... The hash function subtree specifies the two hash functions defined in
the sample tech document [PSAMP-TECH]. 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.
3.3 The Reporting Group 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.
The reporting group of managed objects provides information on 5.4 The Reporting
collectors to which sampled packets are exported and they allow to
configure collectors.
The group contains three tables, the psampCollectorTable, the The reporting subtree of managed objects provides information on
psampCollectorGroupTable and the psampTemplateTable. 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 Each entry in the psampCollectorTable specifies a collector by its IP
address, used transport protocol and port number. Also it contains address, used transport protocol and port number. Also it contains
the number of reports sent to this collector. the number of reports sent to this collector. The default transport
protocol is SCTP.
The psampCollectorGroupTable groups one or more collectors to a set The psampCollectorGroupTable groups one or more collectors to a set
of collectors where sampled packets are sent to. Thus reporting to of collectors where sampled packets are sent to simultaneously. Thus
more than one collector at the same time is possible. reporting to more than one collector at the same time is possible.
The psampTemplateTable lists all data templates that are used by the
PSAMP exporter.
EDITOR NOTE: These table must be completed and the templates must be
somehow linked to the collector and an instance.
3.4 The Instance Group
The instance group of managed objects provides information about
active packet sampling instances at the managed node. It also allows
to create new instances and to terminate them.
The group contains two tables, the psampInstanceTable and the 5.5 The Base Associations
psampMethodChainTable. Each entry of the psampInstanceTable describes
an instance by the IP interface it is acting at and by the collector
group to which reports on sampled packets are sent. Furthermore a
start and stop time can be given when the sampling method should run.
The collectors are specified by their index in the
psampCollectorGroupTable. The number of packets sampled and sent by
the instance is available as statistical value
psampInstancePacketsObserved for each instance.
The methods used for the instance can be retrieved through the index The objects in the Base Asssociations subtree combine all the objects
given in the psampInstanceTable. The index of the instance table is needed to model the measurement processes on the PSAMP device. It
also the first index in the psampMethodChainTable. So each method contains three tables, the psampBaseAssocTable, the
entry with the same (first) index as the instance is used to produce psampSelectorListTable and the psampTemplateRecordTable. Each entry
the data record for the instance. 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
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 psampMethodChainTable describes the concatenation of methods for The psampSelectorListTable describes the concatenation of methods for
a given instance. If concatenation of methods is not supported on the a given Base Association. If concatenation of methods is not
managed node the table will hold exactly one entry per instance. supported on the PSAMP device the table will hold exactly one entry
per Base Association.
The table has two indexes: the first one references an entry in the The methods used for the metering process of an Base Association can
instance table and the second one is the running index for the 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 method. The method itself is represented by a pointer (OID) to a
paremeter set. The methods are applied in the order indicated by the parameter set. The methods are applied in the order given by this
second index psampMethodChainIndex. Assume the following table: second index psampSelectorListIndex. Assume the following table:
1.4.4.1.2.5.1 = 1 (second index) 1.4.4.1.2.5.1 = 1 (second index)
1.4.4.1.2.5.2 = 2 (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 1.4.4.1.3.5.1 = 1.3.6.1.2.1.XXX.1.1.2.3.1.10
(pointer to a parmeter set psampSampTimeBasedParamSetTableEntry.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 1.4.4.1.3.5.2 = 1.3.6.1.2.1.XXX.1.1.1.3.1.4
(pointer to a parmeter set psampSampCountBasedParamSetTableEntry.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.1 = xxx (status of the row)
1.4.4.1.4.5.2 = 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 This would mean that the method psampSampTimeBased with parameter set
psampSampTimeBasedParamSetTableEntry.10 is applied prior to the psampSampTimeBasedParamSetTableEntry.10 is applied prior to the
method psampSampCountBased with parameter set method psampSampCountBased with parameter set
psampSampCountBasedParamSetTableEntry.4 for the instance with index psampSampCountBasedParamSetTableEntry.4 for the instance with index
5. 5.
4. Definition 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.
6. Definition
PSAMP-MIB DEFINITIONS ::= BEGIN PSAMP-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Integer32, Unsigned32, mib-2 MODULE-IDENTITY, OBJECT-TYPE, Integer32, Unsigned32, mib-2
FROM SNMPv2-SMI -- RFC2578 FROM SNMPv2-SMI -- RFC2578
TEXTUAL-CONVENTION, DateAndTime, RowStatus TEXTUAL-CONVENTION, DisplayString, RowStatus, TruthValue
FROM SNMPv2-TC -- RFC2579 FROM SNMPv2-TC -- RFC2579
MODULE-COMPLIANCE, OBJECT-GROUP MODULE-COMPLIANCE, OBJECT-GROUP
FROM SNMPv2-CONF -- RFC2580 FROM SNMPv2-CONF -- RFC2580
InterfaceIndex -- RFC2863 InterfaceIndexOrZero
FROM IF-MIB FROM IF-MIB -- RFC2863
InetAddressType, InetAddress InetAddressType, InetAddress, InetAutonomousSystemNumber
FROM INET-ADDRESS-MIB; -- RFC3291 FROM INET-ADDRESS-MIB; -- RFC3291
psampMIB MODULE-IDENTITY psampMIB MODULE-IDENTITY
LAST-UPDATED "200401131200Z" -- 13 February 2004 LAST-UPDATED "200502181600Z" -- 18 February 2005
ORGANIZATION "IETF Packet Sampling Working Group" ORGANIZATION "IETF Packet Sampling Working Group"
CONTACT-INFO CONTACT-INFO
"WG charter: "WG charter:
http://www.ietf.org/html.charters/psamp-charter.html http://www.ietf.org/html.charters/psamp-charter.html
Mailing Lists: Mailing Lists:
General Discussion: psamp@ops.ietf.org General Discussion: psamp@ops.ietf.org
To Subscribe: psamp-request@ops.ietf.org To Subscribe: psamp-request@ops.ietf.org
In Body: subscribe In Body: subscribe
Archive: https://ops.ietf.org/lists/psamp/ Archive: https://ops.ietf.org/lists/psamp/
skipping to change at page 9, line 32 skipping to change at page 14, line 9
Editor: Editor:
Thomas Dietz Thomas Dietz
NEC Europe Ltd. NEC Europe Ltd.
Network Laboratories Network Laboratories
Kurfuersten-Anlage 36 Kurfuersten-Anlage 36
69115 Heidelberg 69115 Heidelberg
Germany Germany
Phone: +49 6221 90511-28 Phone: +49 6221 90511-28
Email: dietz@netlab.nec.de" Email: dietz@netlab.nec.de"
DESCRIPTION DESCRIPTION
"The PSAMP MIB defines managed objects for packet sampling. "The PSAMP MIB defines managed objects for packet sampling
These objects provide information about managed nodes and filtering techniques for IP packet selection. These
supporting packet sampling, including packet sampling objects provide information about managed nodes supporting
capabilities, configuration and statistics. They also allow packet sampling, including packet sampling capabilities,
to configure packet sampling concerning the IP interface at configuration and statistics. They also allow to configure
which packets are sampled, the packet selections methods packet sampling and filtering concerning the observation
used for sampling, and the collector to which packet samples point at which packets are sampled, the packet selections
are exported. methods used for sampling and filtering, and the collector
to which packet samples are exported.
Copyright (C) The Internet Society (2004). This version Copyright (C) The Internet Society (2005). This version
of this MIB module is part of RFC yyyy; see the RFC of this MIB module is part of RFC yyyy; see the RFC
itself for full legal notices." itself for full legal notices."
-- RFC Ed.: replace yyyy with actual RFC number & remove this notice -- RFC Ed.: replace yyyy with actual RFC number & remove this notice
-- Revision history -- Revision history
REVISION "200407151200Z" -- 15 July 2004 REVISION "200502181600Z" -- 18 February 2005
DESCRIPTION DESCRIPTION
"Initial version, published as RFC yyyy." "Initial version, published as RFC yyyy."
-- RFC Ed.: replace yyyy with actual RFC number & remove this notice -- RFC Ed.: replace yyyy with actual RFC number & remove this notice
::= { mib-2 XXX } ::= { mib-2 XXX }
-- XXX to be assigned by IANA. -- XXX to be assigned by IANA.
-- Textual Conventions -- Textual Conventions
PsampMethodAvailability ::= TEXTUAL-CONVENTION PsampMethodAvailability ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Used to report the availability of a packet selection "Used to report the availability of a packet selection
method: method:
skipping to change at page 10, line 15 skipping to change at page 14, line 42
-- XXX to be assigned by IANA. -- XXX to be assigned by IANA.
-- Textual Conventions -- Textual Conventions
PsampMethodAvailability ::= TEXTUAL-CONVENTION PsampMethodAvailability ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Used to report the availability of a packet selection "Used to report the availability of a packet selection
method: method:
available(1) - the method is supported and can be used available (1) - the method is available on the PSAMP
notAvailable(2) - the mothos is not available" device
notAvailable (2) - the method is not available on the
PSAMP device"
SYNTAX INTEGER { SYNTAX INTEGER {
available(1), available(1),
notAvailable(2) notAvailable(2)
} }
-- Top level structure of the MIB -- Top level structure of the MIB
psampObjects OBJECT IDENTIFIER ::= { psampMIB 1 } psampObjects OBJECT IDENTIFIER ::= { psampMIB 1 }
psampConformance OBJECT IDENTIFIER ::= { psampMIB 2 } psampConformance OBJECT IDENTIFIER ::= { psampMIB 2 }
--================================================================== --==================================================================
-- Packet selection sampling methods group of objects -- Packet selection sampling methods group of objects
--================================================================== --==================================================================
psampSamplingMethods OBJECT IDENTIFIER ::= { psampObjects 1 } psampSamplingMethods OBJECT IDENTIFIER ::= { psampObjects 1 }
--================================================================== --==================================================================
skipping to change at page 10, line 44 skipping to change at page 15, line 24
--* Method 0: Selecting All Packets --* Method 0: Selecting All Packets
--================================================================== --==================================================================
psampSelectAll OBJECT IDENTIFIER ::= { psampSamplingMethods 0 } psampSelectAll OBJECT IDENTIFIER ::= { psampSamplingMethods 0 }
psampSelectAllAvail OBJECT-TYPE psampSelectAllAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of the trivial
of the trivial method of selecting all packets." method of selecting all packets."
DEFVAL { available } DEFVAL { notAvailable }
::= { psampSelectAll 1 } ::= { psampSelectAll 1 }
--================================================================== --==================================================================
--* Method 1: Systematic Count-based Sampling --* Method 1: Systematic Count-based Sampling
--================================================================== --==================================================================
psampSampCountBased OBJECT IDENTIFIER ::= { psampSamplingMethods 1 } psampSampCountBased OBJECT IDENTIFIER ::= { psampSamplingMethods 1 }
psampSampCountBasedAvail OBJECT-TYPE psampSampCountBasedAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of systematic
of systematic count-based sampling at the managed node." count-based sampling at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampSampCountBased 1 } ::= { psampSampCountBased 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
psampSampCountBasedCap OBJECT IDENTIFIER psampSampCountBasedCap OBJECT IDENTIFIER
::= { psampSampCountBased 2 } ::= { psampSampCountBased 2 }
psampSampCountBasedMaxInterval OBJECT-TYPE psampSampCountBasedMaxInterval OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "number of packets" UNITS "number of packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the the maximum "This object indicates the maximum number that can be
number that can be specified for the sampling interval." specified for the sampling interval. Sampling means, that
all packets that arrive in this interval are selected."
::= { psampSampCountBasedCap 1 } ::= { psampSampCountBasedCap 1 }
psampSampCountBasedMaxSpacing OBJECT-TYPE psampSampCountBasedMinSpacing OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "number of packets" UNITS "number of packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the the maximum "This object indicates the minimum number that can be
number that can be specified for the sampling spacing." specified for the sampling spacing. The spacing parameter
defines the spacing in time or number of packets between
the end of one sampling interval and the start of the next
succeeding interval."
::= { psampSampCountBasedCap 2 } ::= { psampSampCountBasedCap 2 }
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampCountBasedParamSetTable OBJECT-TYPE psampSampCountBasedParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampSampCountBasedParamSetEntry PsampSampCountBasedParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of systematic count- "This table lists configurations of systematic count-based
based packet sampling. A parameter set describing a packet sampling. A parameter set describing a
configuration contains two parameters: the sampling configuration contains two parameters: the sampling
interval length and the spacing." interval length and the spacing."
::= { psampSampCountBased 3 } ::= { psampSampCountBased 3 }
psampSampCountBasedParamSetEntry OBJECT-TYPE psampSampCountBasedParamSetEntry OBJECT-TYPE
SYNTAX PsampSampCountBasedParamSetEntry SYNTAX PsampSampCountBasedParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampSampCountBasedParamSetTable."
psampSampCountBasedParamSetTable."
INDEX { psampSampCountBasedIndex } INDEX { psampSampCountBasedIndex }
::= { psampSampCountBasedParamSetTable 1 } ::= { psampSampCountBasedParamSetTable 1 }
PsampSampCountBasedParamSetEntry ::= PsampSampCountBasedParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampSampCountBasedIndex Integer32, psampSampCountBasedIndex Integer32,
psampSampCountBasedInterval Unsigned32, psampSampCountBasedInterval Unsigned32,
psampSampCountBasedSpacing Unsigned32, psampSampCountBasedSpacing Unsigned32,
psampSampCountBasedRowStatus RowStatus psampSampCountBasedRowStatus RowStatus
} }
psampSampCountBasedIndex OBJECT-TYPE psampSampCountBasedIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampSampCountBasedParamSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set." 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."
::= { psampSampCountBasedParamSetEntry 1 } ::= { psampSampCountBasedParamSetEntry 1 }
psampSampCountBasedInterval OBJECT-TYPE psampSampCountBasedInterval OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "number of packets" UNITS "number of packets"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the sampling "This object specifies the sampling interval for systematic
interval for systematic count-based sampling." count-based sampling. Sampling means, that all packets that
arrive in this interval are selected."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "PSAMP-SAMPLE-TECH, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampCountBasedParamSetEntry 2 } ::= { psampSampCountBasedParamSetEntry 2 }
psampSampCountBasedSpacing OBJECT-TYPE psampSampCountBasedSpacing OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "number of packets" UNITS "number of packets"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the sampling "This object specifies the sampling spacing for systematic
spacing for systematic count-based sampling." count-based sampling. The spacing parameter defines the
spacing in time or number of packets between the end of one
sampling interval and the start of the next succeeding
interval."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampCountBasedParamSetEntry 3 } ::= { psampSampCountBasedParamSetEntry 3 }
psampSampCountBasedRowStatus OBJECT-TYPE psampSampCountBasedRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampCountBasedParamSetEntry 4 } ::= { psampSampCountBasedParamSetEntry 4 }
skipping to change at page 13, line 31 skipping to change at page 18, line 26
--* Method 2: Systematic Time-based Sampling --* Method 2: Systematic Time-based Sampling
--================================================================== --==================================================================
psampSampTimeBased OBJECT IDENTIFIER ::= { psampSamplingMethods 2 } psampSampTimeBased OBJECT IDENTIFIER ::= { psampSamplingMethods 2 }
psampSampTimeBasedAvail OBJECT-TYPE psampSampTimeBasedAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of systematic
of systematic time-based sampling at the managed node." time-based sampling at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampSampTimeBased 1 } ::= { psampSampTimeBased 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
psampSampTimeBasedCap OBJECT IDENTIFIER psampSampTimeBasedCap OBJECT IDENTIFIER
::= { psampSampTimeBased 2 } ::= { psampSampTimeBased 2 }
psampSampTimeBasedMaxInterval OBJECT-TYPE psampSampTimeBasedMaxInterval OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "microseconds" UNITS "microseconds"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the the maximum "This object indicates the maximum number that can be
number that can be specified for the sampling interval." specified for the sampling interval. Sampling means, that
all packets that arrive in this interval are selected."
::= { psampSampTimeBasedCap 1 } ::= { psampSampTimeBasedCap 1 }
psampSampTimeBasedMaxSpacing OBJECT-TYPE psampSampTimeBasedMinSpacing OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "microseconds" UNITS "microseconds"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the the maximum "This object indicates the minimum number that can be
number that can be specified for the sampling spacing." specified for the sampling spacing. The spacing parameter
defines the spacing in time or number of packets between
the end of one sampling interval and the start of the next
succeeding interval."
::= { psampSampTimeBasedCap 2 } ::= { psampSampTimeBasedCap 2 }
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampTimeBasedParamSetTable OBJECT-TYPE psampSampTimeBasedParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampSampTimeBasedParamSetEntry PsampSampTimeBasedParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of systematic time- "This table lists configurations of systematic time-based
based packet sampling. A parameter set describing a packet sampling. A parameter set describing a configuration
configuration contains two parameters: the sampling contains two parameters: the sampling interval length and
interval length and the spacing." the spacing."
::= { psampSampTimeBased 3 } ::= { psampSampTimeBased 3 }
psampSampTimeBasedParamSetEntry OBJECT-TYPE psampSampTimeBasedParamSetEntry OBJECT-TYPE
SYNTAX PsampSampTimeBasedParamSetEntry SYNTAX PsampSampTimeBasedParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampSampTimeBasedParamSetTable."
psampSampTimeBasedParamSetTable."
INDEX { psampSampTimeBasedIndex } INDEX { psampSampTimeBasedIndex }
::= { psampSampTimeBasedParamSetTable 1 } ::= { psampSampTimeBasedParamSetTable 1 }
PsampSampTimeBasedParamSetEntry ::= PsampSampTimeBasedParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampSampTimeBasedIndex Integer32, psampSampTimeBasedIndex Integer32,
psampSampTimeBasedInterval Unsigned32, psampSampTimeBasedInterval Unsigned32,
psampSampTimeBasedSpacing Unsigned32, psampSampTimeBasedSpacing Unsigned32,
psampSampTimeBasedRowStatus RowStatus psampSampTimeBasedRowStatus RowStatus
} }
psampSampTimeBasedIndex OBJECT-TYPE psampSampTimeBasedIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampSampTimeBasedParameterSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as The value is expected to remain constant at least from one
reference to this parameter set." 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 } ::= { psampSampTimeBasedParamSetEntry 1 }
psampSampTimeBasedInterval OBJECT-TYPE psampSampTimeBasedInterval OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "microseconds" UNITS "microseconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies a sampling "This object specifies a sampling interval for systematic
interval for systematic time-based sampling." time-based sampling. Sampling means, that all packets that
arrive in this interval are selected."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampTimeBasedParamSetEntry 2 } ::= { psampSampTimeBasedParamSetEntry 2 }
psampSampTimeBasedSpacing OBJECT-TYPE psampSampTimeBasedSpacing OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "microseconds" UNITS "microseconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies a sampling "This object specifies a sampling spacing for systematic
spacing for systematic time-based sampling." time-based sampling. The spacing parameter defines the
spacing in time or number of packets between the end of one
sampling interval and the start of the next succeeding
interval."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampTimeBasedParamSetEntry 3 } ::= { psampSampTimeBasedParamSetEntry 3 }
psampSampTimeBasedRowStatus OBJECT-TYPE psampSampTimeBasedRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampTimeBasedParamSetEntry 4 } ::= { psampSampTimeBasedParamSetEntry 4 }
skipping to change at page 15, line 44 skipping to change at page 21, line 4
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampTimeBasedParamSetEntry 4 } ::= { psampSampTimeBasedParamSetEntry 4 }
--================================================================== --==================================================================
--* Method 3: Random n-out-of-N Sampling --* Method 3: Random n-out-of-N Sampling
--================================================================== --==================================================================
psampSampRandOutOfN OBJECT IDENTIFIER ::= { psampSamplingMethods 3 } psampSampRandOutOfN OBJECT IDENTIFIER ::= { psampSamplingMethods 3 }
psampSampRandOutOfNAvail OBJECT-TYPE psampSampRandOutOfNAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of random
of random n-out-of-N sampling at the managed node." n-out-of-N sampling at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampSampRandOutOfN 1 } ::= { psampSampRandOutOfN 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
psampSampRandOutOfNCap OBJECT IDENTIFIER psampSampRandOutOfNCap OBJECT IDENTIFIER
::= { psampSampRandOutOfN 2 } ::= { psampSampRandOutOfN 2 }
psampSampRandOutOfNMaxPopulation OBJECT-TYPE psampSampRandOutOfNMaxPopulation OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "number of packets" UNITS "number of packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the the maximum "This object indicates the maximum number that can be
number that can be specified for the population size." specified for the population size."
::= { psampSampRandOutOfNCap 1 } ::= { psampSampRandOutOfNCap 1 }
psampSampRandOutOfNMaxSize OBJECT-TYPE
SYNTAX Unsigned32
UNITS "number of packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"When retrieved, this object indicates the the maximum
number that can be specified for the sampling size."
::= { psampSampRandOutOfNCap 2 }
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampRandOutOfNParamSetTable OBJECT-TYPE psampSampRandOutOfNParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampSampRandOutOfNParamSetEntry PsampSampRandOutOfNParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of random n-out-of-N "This table lists configurations of random n-out-of-N
sampling. A parameter set describing a configuration sampling. A parameter set describing a configuration
contains a single parameter only: the sampling rate." contains a two parameters: the population size and the
sample size."
::= { psampSampRandOutOfN 3 } ::= { psampSampRandOutOfN 3 }
psampSampRandOutOfNParamSetEntry OBJECT-TYPE psampSampRandOutOfNParamSetEntry OBJECT-TYPE
SYNTAX PsampSampRandOutOfNParamSetEntry SYNTAX PsampSampRandOutOfNParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampSampRandOutOfNParamSetTable."
psampSampRandOutOfNParamSetTable."
INDEX { psampSampRandOutOfNIndex } INDEX { psampSampRandOutOfNIndex }
::= { psampSampRandOutOfNParamSetTable 1 } ::= { psampSampRandOutOfNParamSetTable 1 }
PsampSampRandOutOfNParamSetEntry ::= PsampSampRandOutOfNParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampSampRandOutOfNIndex Integer32, psampSampRandOutOfNIndex Integer32,
psampSampRandOutOfNPopulation Unsigned32, psampSampRandOutOfNPopulation Unsigned32,
psampSampRandOutOfNSize Unsigned32, psampSampRandOutOfNSample Unsigned32,
psampSampRandOutOfNRowStatus RowStatus psampSampRandOutOfNRowStatus RowStatus
} }
psampSampRandOutOfNIndex OBJECT-TYPE psampSampRandOutOfNIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampSampRandOutOfNParamSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set." 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 } ::= { psampSampRandOutOfNParamSetEntry 1 }
psampSampRandOutOfNPopulation OBJECT-TYPE psampSampRandOutOfNPopulation OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "packets" UNITS "packets"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the number "This object specifies the number of elements in the parent
of elements in the parent population of the sampling population of the sampling algorithm."
algorithm."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampRandOutOfNParamSetEntry 2 } ::= { psampSampRandOutOfNParamSetEntry 2 }
psampSampRandOutOfNSize OBJECT-TYPE psampSampRandOutOfNSample OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "packets" UNITS "packets"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the number "This object specifies the number of elements that are
of elements that are sampled from the parent sampled from the parent population of the sampling
population of the sampling algorithm." algorithm."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampRandOutOfNParamSetEntry 3 } ::= { psampSampRandOutOfNParamSetEntry 3 }
psampSampRandOutOfNRowStatus OBJECT-TYPE psampSampRandOutOfNRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampRandOutOfNParamSetEntry 4 } ::= { psampSampRandOutOfNParamSetEntry 4 }
--================================================================== --==================================================================
--* Method 4: Uniform Probabilistic Sampling --* Method 4: Uniform Probabilistic Sampling
skipping to change at page 18, line 23 skipping to change at page 23, line 28
--* Method 4: Uniform Probabilistic Sampling --* Method 4: Uniform Probabilistic Sampling
--================================================================== --==================================================================
psampSampUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 4 } psampSampUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 4 }
psampSampUniProbAvail OBJECT-TYPE psampSampUniProbAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of uniform
of random uniform probabilistic sampling at the managed node." probabilistic sampling at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampSampUniProb 1 } ::= { psampSampUniProb 1 }
psampSampUniProbCap OBJECT IDENTIFIER psampSampUniProbCap OBJECT IDENTIFIER
::= { psampSampUniProb 2 } ::= { psampSampUniProb 2 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- No capabilities defined, yet.
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampUniProbParamSetTable OBJECT-TYPE psampSampUniProbParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampSampUniProbParamSetEntry PsampSampUniProbParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of random probabilistic "This table lists configurations of uniform probabilistic
sampling. A parameter set describing a configuration sampling. A parameter set describing a configuration
contains a single parameter only: the sampling rate." contains a single parameter only: the sampling
probability."
::= { psampSampUniProb 3 } ::= { psampSampUniProb 3 }
psampSampUniProbParamSetEntry OBJECT-TYPE psampSampUniProbParamSetEntry OBJECT-TYPE
SYNTAX PsampSampUniProbParamSetEntry SYNTAX PsampSampUniProbParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampSampUniProbParamSetTable."
psampSampUniProbParamSetTable."
INDEX { psampSampUniProbIndex } INDEX { psampSampUniProbIndex }
::= { psampSampUniProbParamSetTable 1 } ::= { psampSampUniProbParamSetTable 1 }
PsampSampUniProbParamSetEntry ::= PsampSampUniProbParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampSampUniProbIndex Integer32, psampSampUniProbIndex Integer32,
psampSampUniProbProbability Unsigned32, psampSampUniProbProbability Unsigned32,
psampSampUniProbRowStatus RowStatus psampSampUniProbRowStatus RowStatus
} }
psampSampUniProbIndex OBJECT-TYPE psampSampUniProbIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampSampUniProbParameterSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set." 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 } ::= { psampSampUniProbParamSetEntry 1 }
psampSampUniProbProbability OBJECT-TYPE psampSampUniProbProbability OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295) SYNTAX Unsigned32 (0..4294967295)
UNITS "packets"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the number "This object gives the probability that a packet is
of elements in the parent population of the sampling sampled. The probability is equal for every packet. The
algorithm." 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 REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampUniProbParamSetEntry 2 } ::= { psampSampUniProbParamSetEntry 2 }
psampSampUniProbRowStatus OBJECT-TYPE psampSampUniProbRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampUniProbParamSetEntry 3 } ::= { psampSampUniProbParamSetEntry 3 }
--================================================================== --==================================================================
--* Method 5: Non-Uniform Probabilistic Sampling --* Method 5: Non-Uniform Probabilistic Sampling
skipping to change at page 20, line 4 skipping to change at page 25, line 15
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampUniProbParamSetEntry 3 } ::= { psampSampUniProbParamSetEntry 3 }
--================================================================== --==================================================================
--* Method 5: Non-Uniform Probabilistic Sampling --* Method 5: Non-Uniform Probabilistic Sampling
--================================================================== --==================================================================
psampSampNonUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 5 } psampSampNonUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 5 }
psampSampNonUniProbAvail OBJECT-TYPE psampSampNonUniProbAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of non-uniform
of random non-uniform probabilistic sampling at the managed probabilistic sampling at the managed node."
node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampSampNonUniProb 1 } ::= { psampSampNonUniProb 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampNonUniProbParamSetTable OBJECT-TYPE psampSampNonUniProbParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampSampNonUniProbParamSetEntry PsampSampNonUniProbParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of random probabilistic "This table lists configurations of non-uniform
sampling. A parameter set describing a configuration probabilistic sampling. A parameter set describing a
contains a single parameter only: the sampling rate." configuration contains two parameter: a pointer to a
probability function and a pointer to an associated
parameter set."
::= { psampSampNonUniProb 3 } ::= { psampSampNonUniProb 3 }
psampSampNonUniProbParamSetEntry OBJECT-TYPE psampSampNonUniProbParamSetEntry OBJECT-TYPE
SYNTAX PsampSampNonUniProbParamSetEntry SYNTAX PsampSampNonUniProbParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampSampNonUniProbParamSetTable."
psampSampNonUniProbParamSetTable."
INDEX { psampSampNonUniProbIndex } INDEX { psampSampNonUniProbIndex }
::= { psampSampNonUniProbParamSetTable 1 } ::= { psampSampNonUniProbParamSetTable 1 }
PsampSampNonUniProbParamSetEntry ::= PsampSampNonUniProbParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampSampNonUniProbIndex Integer32, psampSampNonUniProbIndex Integer32,
psampSampNonUniProbFunction OBJECT IDENTIFIER, psampSampNonUniProbFunction OBJECT IDENTIFIER,
psampSampNonUniProbFuncParam OBJECT IDENTIFIER,
psampSampNonUniProbRowStatus RowStatus psampSampNonUniProbRowStatus RowStatus
} }
psampSampNonUniProbIndex OBJECT-TYPE psampSampNonUniProbIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampSampNonUniProbParameterSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set." 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 } ::= { psampSampNonUniProbParamSetEntry 1 }
psampSampNonUniProbFunction OBJECT-TYPE psampSampNonUniProbFunction OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the function "This object specifies the function that is used to compute
that is used to compute the probability for sampling." the probability for sampling."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampNonUniProbParamSetEntry 2 } ::= { 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-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampNonUniProbParamSetEntry 3 }
psampSampNonUniProbRowStatus OBJECT-TYPE psampSampNonUniProbRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampNonUniProbParamSetEntry 3 } ::= { psampSampNonUniProbParamSetEntry 4 }
--================================================================== --==================================================================
--* Method 6: Flow State Sampling --* Method 6: Flow State Sampling
--================================================================== --==================================================================
psampSampFlowState OBJECT IDENTIFIER ::= { psampSamplingMethods 6 } psampSampFlowState OBJECT IDENTIFIER ::= { psampSamplingMethods 6 }
psampSampFlowStateAvail OBJECT-TYPE psampSampFlowStateAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of flow state
of flow state sampling at the managed node." sampling at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampSampFlowState 1 } ::= { psampSampFlowState 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampSampFlowStateParamSetTable OBJECT-TYPE psampSampFlowStateParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampSampFlowStateParamSetEntry PsampSampFlowStateParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of random probabilistic "This table lists configurations of flow state sampling. A
sampling. A parameter set describing a configuration parameter set describing a configuration contains two
contains a single parameter only: the sampling rate." parameter: a pointer to a flow state function and a pointer
to an associated parameter set."
::= { psampSampFlowState 3 } ::= { psampSampFlowState 3 }
psampSampFlowStateParamSetEntry OBJECT-TYPE psampSampFlowStateParamSetEntry OBJECT-TYPE
SYNTAX PsampSampFlowStateParamSetEntry SYNTAX PsampSampFlowStateParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampSampFlowStateParamSetTable."
psampSampFlowStateParamSetTable."
INDEX { psampSampFlowStateIndex } INDEX { psampSampFlowStateIndex }
::= { psampSampFlowStateParamSetTable 1 } ::= { psampSampFlowStateParamSetTable 1 }
PsampSampFlowStateParamSetEntry ::= PsampSampFlowStateParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampSampFlowStateIndex Integer32, psampSampFlowStateIndex Integer32,
psampSampFlowStateFunction OBJECT IDENTIFIER, psampSampFlowStateFunction OBJECT IDENTIFIER,
psampSampFlowStateFuncParam OBJECT IDENTIFIER,
psampSampFlowStateRowStatus RowStatus psampSampFlowStateRowStatus RowStatus
} }
psampSampFlowStateIndex OBJECT-TYPE psampSampFlowStateIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampSampFlowStateParameterSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set." 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 } ::= { psampSampFlowStateParamSetEntry 1 }
psampSampFlowStateFunction OBJECT-TYPE psampSampFlowStateFunction OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the function "This object specifies the function that is used to check
that is used to check the flow state for sampling." the flow state for sampling."
REFERENCE REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1" "draft-ietf-psamp-sample-tech-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampFlowStateParamSetEntry 2 } ::= { 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-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampSampFlowStateParamSetEntry 3 }
psampSampFlowStateRowStatus OBJECT-TYPE psampSampFlowStateRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampSampFlowStateParamSetEntry 3 } ::= { psampSampFlowStateParamSetEntry 4 }
--================================================================== --==================================================================
-- Packet selection filtering methods group of objects -- Packet selection filtering methods group of objects
--================================================================== --==================================================================
psampFilteringMethods OBJECT IDENTIFIER ::= { psampObjects 2 } psampFilteringMethods OBJECT IDENTIFIER ::= { psampObjects 2 }
--================================================================== --==================================================================
--* Method 0: Mask filtering --* Method 0: Match filtering
--================================================================== --==================================================================
psampFilterMask OBJECT IDENTIFIER ::= { psampFilteringMethods 0 } psampFilterMatch OBJECT IDENTIFIER ::= { psampFilteringMethods 0 }
psampFilterMaskAvail OBJECT-TYPE psampFilterMatchAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of match filtering
of mask filtering at the managed node." at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampFilterMask 1 } ::= { psampFilterMatch 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampFilterMaskParamSetTable OBJECT-TYPE psampFilterMatchParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampFilterMaskParamSetEntry PsampFilterMatchParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of random probabilistic "This table lists configurations of match filtering. The
sampling. A parameter set describing a configuration match filtering is based on the IPFIX/PSAMP Information
contains a single parameter only: the sampling rate." Elements. The parameter set contains the Information
::= { psampFilterMask 3 } Element Id, a value or value range and a mask."
::= { psampFilterMatch 3 }
psampFilterMaskParamSetEntry OBJECT-TYPE psampFilterMatchParamSetEntry OBJECT-TYPE
SYNTAX PsampFilterMaskParamSetEntry SYNTAX PsampFilterMatchParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampFilterMatchParamSetTable."
psampFilterMaskParamSetTable." INDEX { psampFilterMatchIndex }
INDEX { psampFilterMaskIndex } ::= { psampFilterMatchParamSetTable 1 }
::= { psampFilterMaskParamSetTable 1 }
PsampFilterMaskParamSetEntry ::= PsampFilterMatchParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampFilterMaskIndex Integer32, psampFilterMatchIndex Integer32,
psampFilterMaskRowStatus RowStatus psampFilterMatchInfoElementId Integer32,
psampFilterMatchStartValue OCTET STRING,
psampFilterMatchStopValue OCTET STRING,
psampFilterMatchMask OCTET STRING,
psampFilterMatchRowStatus RowStatus
} }
psampFilterMaskIndex OBJECT-TYPE psampFilterMatchIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampFilterMaskParameterSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set."
::= { psampFilterMaskParamSetEntry 1 }
psampFilterMaskRowStatus OBJECT-TYPE 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-04.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 psampFilterMatchStopValue is not equal to
this value. The data type and its encoding is the same as
in PSAMP-PROTO."
REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!"
-- Editor Note: get reference right!
::= { psampFilterMatchParamSetEntry 3 }
psampFilterMatchStopValue OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The final value of a value range. It should be equal to
psampFilterMatchStartValue if a single value should be
encoded. The data type and its encoding is the same as in
PSAMP-PROTO."
REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!"
-- Editor Note: get reference right!
::= { 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. 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-04.txt, Section 5.1, PROTO!!"
-- Editor Note: get reference right!
DEFVAL { ''H }
::= { psampFilterMatchParamSetEntry 5 }
psampFilterMatchRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampFilterMaskParamSetEntry 2 } ::= { psampFilterMatchParamSetEntry 6 }
--================================================================== --==================================================================
--* Method 1: Hash filtering --* Method 1: Hash filtering
--================================================================== --==================================================================
psampFilterHash OBJECT IDENTIFIER ::= { psampFilteringMethods 1 } psampFilterHash OBJECT IDENTIFIER ::= { psampFilteringMethods 1 }
psampFilterHashAvail OBJECT-TYPE psampFilterHashAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of hash filtering
of hash filtering at the managed node." at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampFilterHash 1 } ::= { psampFilterHash 1 }
psampFilterHashCapabilities OBJECT IDENTIFIER psampFilterHashCapabilities OBJECT IDENTIFIER
::= { psampFilterHash 2 } ::= { psampFilterHash 2 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampFilterHashParamSetTable OBJECT-TYPE psampFilterHashParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampFilterHashParamSetEntry PsampFilterHashParamSetEntry
skipping to change at page 25, line 17 skipping to change at page 32, line 43
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampFilterHashParamSetTable OBJECT-TYPE psampFilterHashParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampFilterHashParamSetEntry PsampFilterHashParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of hash filtering. "This table lists configurations of hash filtering. A
A parameter set describing a configuration parameter set describing a configuration contains ten
contains one parameter: the hash function used." parameter describing the hash function, the input bits feed
into the hash function and the output of the function."
::= { psampFilterHash 3 } ::= { psampFilterHash 3 }
psampFilterHashParamSetEntry OBJECT-TYPE psampFilterHashParamSetEntry OBJECT-TYPE
SYNTAX PsampFilterHashParamSetEntry SYNTAX PsampFilterHashParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampFilterHashParamSetTable."
psampFilterHashParamSetTable."
INDEX { psampFilterHashIndex } INDEX { psampFilterHashIndex }
::= { psampFilterHashParamSetTable 1 } ::= { psampFilterHashParamSetTable 1 }
PsampFilterHashParamSetEntry ::= PsampFilterHashParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampFilterHashIndex Integer32, psampFilterHashIndex Integer32,
psampFilterHashAddrType InetAddressType,
psampFilterHashHeaderBits OCTET STRING,
psampFilterHashPayloadBytes Integer32,
psampFilterHashPayloadBits OCTET STRING,
psampFilterHashFunction OBJECT IDENTIFIER, psampFilterHashFunction OBJECT IDENTIFIER,
psampFilterHashFuncParam OBJECT IDENTIFIER,
psampFilterHashInputBits Integer32,
psampFilterHashOutputBits Integer32,
psampFilterHashOutputMask OCTET STRING,
psampFilterHashSelection DisplayString,
psampFilterHashRowStatus RowStatus psampFilterHashRowStatus RowStatus
} }
psampFilterHashIndex OBJECT-TYPE psampFilterHashIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampFilterHashParamSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set." 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 } ::= { 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-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 2 }
psampFilterHashHeaderBits OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (40))
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-04.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-04.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-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 5 }
psampFilterHashFunction OBJECT-TYPE psampFilterHashFunction OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object specifies the the hash "This object specifies the hash function executed by the
function executed by the current filtering method." current filtering method."
::= { psampFilterHashParamSetEntry 2 } ::= { psampFilterHashParamSetEntry 6 }
psampFilterHashFuncParam OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
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-04.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-04.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-04.txt, Section 5.1"
-- Editor Note: get reference right!
DEFVAL { ''H }
::= { psampFilterHashParamSetEntry 10 }
psampFilterHashSelection OBJECT-TYPE
SYNTAX DisplayString
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-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampFilterHashParamSetEntry 11 }
psampFilterHashRowStatus OBJECT-TYPE psampFilterHashRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampFilterHashParamSetEntry 3 } ::= { psampFilterHashParamSetEntry 12 }
--================================================================== --==================================================================
--* Method 2: Router State filtering --* Method 2: Router State filtering
--================================================================== --==================================================================
psampFilterRState OBJECT IDENTIFIER ::= { psampFilteringMethods 2 } psampFilterRState OBJECT IDENTIFIER ::= { psampFilteringMethods 2 }
psampFilterRStateAvail OBJECT-TYPE psampFilterRStateAvail OBJECT-TYPE
SYNTAX PsampMethodAvailability SYNTAX PsampMethodAvailability
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"When retrieved, this object indicates the availability "This object indicates the availability of router state
of mask filtering at the managed node." filtering at the managed node."
DEFVAL { notAvailable } DEFVAL { notAvailable }
::= { psampFilterRState 1 } ::= { psampFilterRState 1 }
-- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++
psampFilterRStateParamSetTable OBJECT-TYPE psampFilterRStateParamSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF SYNTAX SEQUENCE OF
PsampFilterRStateParamSetEntry PsampFilterRStateParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists configurations of random probabilistic "This table lists configurations of router state filtering.
sampling. A parameter set describing a configuration A parameter set describing a configuration contains six
contains a single parameter only: the sampling rate." 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 } ::= { psampFilterRState 3 }
psampFilterRStateParamSetEntry OBJECT-TYPE psampFilterRStateParamSetEntry OBJECT-TYPE
SYNTAX PsampFilterRStateParamSetEntry SYNTAX PsampFilterRStateParamSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the "Defines an entry in the psampFilterRStateParamSetTable."
psampFilterRStateParamSetTable."
INDEX { psampFilterRStateIndex } INDEX { psampFilterRStateIndex }
::= { psampFilterRStateParamSetTable 1 } ::= { psampFilterRStateParamSetTable 1 }
PsampFilterRStateParamSetEntry ::= PsampFilterRStateParamSetEntry ::=
SEQUENCE { SEQUENCE {
psampFilterRStateIndex Integer32, psampFilterRStateIndex Integer32,
psampFilterRStateFunction INTEGER,
psampFilterRStateNegate TruthValue,
psampFilterRStateIfIndex InterfaceIndexOrZero,
psampFilterRStateStartAS InetAutonomousSystemNumber,
psampFilterRStateStopAS InetAutonomousSystemNumber,
psampFilterRStateVendorFunc OBJECT IDENTIFIER,
psampFilterRStateRowStatus RowStatus psampFilterRStateRowStatus RowStatus
} }
psampFilterRStateIndex OBJECT-TYPE psampFilterRStateIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of this parameter set in the "The locally arbitrary, but unique identifier of an entry
psampFilterRStateParameterSetTable. in this parameter set table.
It is used in entries of the psampInstanceTable as
reference to this parameter set." 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."
::= { psampFilterRStateParamSetEntry 1 } ::= { 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-04.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
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 psampFilterRStateStopAS. If
the object is not used it default to 0."
DEFVAL { 0 }
::= { psampFilterRStateParamSetEntry 5 }
psampFilterRStateStopAS 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 }
psampFilterRStateRowStatus OBJECT-TYPE psampFilterRStateRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampFilterRStateParamSetEntry 2 } ::= { 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
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
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
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 -- Reporting Group
--================================================================== --==================================================================
psampReporting OBJECT IDENTIFIER ::= { psampObjects 3 } psampReporting OBJECT IDENTIFIER ::= { psampObjects 4 }
-- Collector Table +++++++++++++++++++++++++++++++++++++++++++++++++ -- Collector Table +++++++++++++++++++++++++++++++++++++++++++++++++
psampCollectorTable OBJECT-TYPE psampCollectorTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampCollectorEntry SYNTAX SEQUENCE OF PsampCollectorEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists collectors to which sampled packets are "This table lists collectors to which PSAMP selected
exported." packets are exported."
::= { psampReporting 1 } ::= { psampReporting 1 }
psampCollectorEntry OBJECT-TYPE psampCollectorEntry OBJECT-TYPE
SYNTAX PsampCollectorEntry SYNTAX PsampCollectorEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the psampCollectorTable." "Defines an entry in the psampCollectorTable."
INDEX { psampCollectorIndex } INDEX { psampCollectorIndex }
::= { psampCollectorTable 1 } ::= { psampCollectorTable 1 }
skipping to change at page 28, line 30 skipping to change at page 44, line 18
psampCollectorDstPort Integer32, psampCollectorDstPort Integer32,
psampCollectorReportsSent Integer32, psampCollectorReportsSent Integer32,
psampCollectorRowStatus RowStatus psampCollectorRowStatus RowStatus
} }
psampCollectorIndex OBJECT-TYPE psampCollectorIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The locally arbitrary, but unique identifier of "The locally arbitrary, but unique identifier of an entry
a collector. in this collector table.
The value is expected to remain constant at least from one The value is expected to remain constant at least from one
re-initialization of the entity's network management system re-initialization of the entity's network management system
to the next re-initialization." to the next re-initialization.
It is used in entries of the psampCollectorGroupTable as
reference to this collector and its associated parameters."
::= { psampCollectorEntry 1 } ::= { psampCollectorEntry 1 }
psampCollectorDstIpAddressType OBJECT-TYPE psampCollectorDstIpAddressType OBJECT-TYPE
SYNTAX InetAddressType SYNTAX InetAddressType
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP address type of the collector." "The IP address type of the collector. The value for IPv4
is ipv4(1). The value for IPv6 is ipv6(2)."
::= { psampCollectorEntry 2 } ::= { psampCollectorEntry 2 }
psampCollectorDstIpAddress OBJECT-TYPE psampCollectorDstIpAddress OBJECT-TYPE
SYNTAX InetAddress SYNTAX InetAddress
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP address of the collector." "The IP address of the collector."
::= { psampCollectorEntry 3 } ::= { psampCollectorEntry 3 }
psampCollectorDstProtocol OBJECT-TYPE psampCollectorDstProtocol OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32 (0..256)
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The transport protocol used for exporting sampled "The transport protocol used for exporting sampled packets
packets to the collector. Allowed values are ... " to the collector. The recommended protocols are TCP (6),
UDP (17) and SCTP (132). The default is SCTP."
DEFVAL { 132 }
::= { psampCollectorEntry 4 } ::= { psampCollectorEntry 4 }
psampCollectorDstPort OBJECT-TYPE psampCollectorDstPort OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32 (0..65535)
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The port number of the collector." "The transport protocol port number of the collector."
::= { psampCollectorEntry 5 } ::= { psampCollectorEntry 5 }
psampCollectorReportsSent OBJECT-TYPE psampCollectorReportsSent OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of reports sent to the collector." "The number of packet reports sent to the collector."
::= { psampCollectorEntry 6 } ::= { psampCollectorEntry 6 }
psampCollectorRowStatus OBJECT-TYPE psampCollectorRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampCollectorEntry 7 } ::= { psampCollectorEntry 7 }
-- Collector Group Table +++++++++++++++++++++++++++++++++++++++++++ -- Collector Group Table +++++++++++++++++++++++++++++++++++++++++++
psampCollectorGroupTable OBJECT-TYPE psampCollectorGroupTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampCollectorGroupEntry SYNTAX SEQUENCE OF PsampCollectorGroupEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists groups of collectors to which sampled "This table lists groups of collectors to which PSAMP
packets are exported. If sampled packets are exported to only selected packets are exported simultaneously. If PSAMP
one collector the group consists of exactly one collector." selected packets are exported to only one collector the
group consists of exactly one collector."
::= { psampReporting 2 } ::= { psampReporting 2 }
psampCollectorGroupEntry OBJECT-TYPE psampCollectorGroupEntry OBJECT-TYPE
SYNTAX PsampCollectorGroupEntry SYNTAX PsampCollectorGroupEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the psampCollectorGroupTable." "Defines an entry in the psampCollectorGroupTable."
INDEX { psampCollectorGroupIndex, psampCollectorIndex } INDEX { psampCollectorGroupIndex, psampCollectorIndex }
::= { psampCollectorGroupTable 1 } ::= { psampCollectorGroupTable 1 }
skipping to change at page 30, line 22 skipping to change at page 46, line 17
PsampCollectorGroupEntry ::= SEQUENCE { PsampCollectorGroupEntry ::= SEQUENCE {
psampCollectorGroupIndex Integer32, psampCollectorGroupIndex Integer32,
psampCollectorGroupRowStatus RowStatus psampCollectorGroupRowStatus RowStatus
} }
psampCollectorGroupIndex OBJECT-TYPE psampCollectorGroupIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The locally arbitrary, but unique identifier of "The locally arbitrary, but unique identifier of an entry
a collector group. in this parameter set table.
The value is expected to remain constant at least from one The value is expected to remain constant at least from one
re-initialization of the entity's network management system re-initialization of the entity's network management system
to the next re-initialization." 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 } ::= { psampCollectorGroupEntry 1 }
psampCollectorGroupRowStatus OBJECT-TYPE psampCollectorGroupRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampCollectorGroupEntry 3 } ::= { psampCollectorGroupEntry 3 }
-- (Data) Template Table -- (Data) Template Record Table
psampTemplateTable OBJECT-TYPE psampTemplateRecordTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampTemplateEntry SYNTAX SEQUENCE OF PsampTemplateRecordEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists templates used by the exporter." "This table lists templates used by the exporter."
::= { psampReporting 3 } ::= { psampReporting 3 }
psampTemplateEntry OBJECT-TYPE psampTemplateRecordEntry OBJECT-TYPE
SYNTAX PsampTemplateEntry SYNTAX PsampTemplateRecordEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the psampTemplateTable." "Defines an entry in the psampTemplateTable."
INDEX { psampTemplateIndex } INDEX { psampTemplateRecordId, psampTemplateRecordIndex }
::= { psampTemplateTable 1 } ::= { psampTemplateRecordTable 1 }
PsampTemplateEntry ::= SEQUENCE { PsampTemplateRecordEntry ::= SEQUENCE {
psampTemplateIndex Integer32, psampTemplateRecordId Integer32,
psampTemplateId Integer32, psampTemplateRecordIndex Integer32,
psampTemplateReportsSent Integer32, psampTemplateRecordInfoElementId Integer32,
psampTemplateRowStatus RowStatus psampTemplateRecordRowStatus RowStatus
} }
psampTemplateIndex OBJECT-TYPE psampTemplateRecordId OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The locally arbitrary, but unique identifier of "The locally arbitrary, but unique identifier of an entry
a template. in this template record table.
The value is expected to remain constant at least from one The value is expected to remain constant at least from one
re-initialization of the entity's network management system re-initialization of the entity's network management system
to the next re-initialization." to the next re-initialization.
::= { psampTemplateEntry 1 }
psampTemplateId OBJECT-TYPE 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-04.txt, Section 5.1"
-- Editor Note: get reference right!
::= { psampTemplateRecordEntry 1 }
psampTemplateRecordIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-create MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The unique identifier for the template." "The locally arbitrary, but unique identifier of a
REFERENCE information element id in the template record identified by
"draft-ietf-ipfix-protocol-02.txt" psampTemplateRecordId.
::= { psampTemplateEntry 2 }
psampTemplateReportsSent OBJECT-TYPE 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 SYNTAX Integer32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of reports sent with this template." "The Information Element Id at position
::= { psampTemplateEntry 3 } psampTemplateRecordIndex in the template
psampTemplateRecordId. This implicitly gives the data type
and state values that are exported."
REFERENCE
"draft-ietf-psamp-sample-tech-04.txt, IPFIX/PSAMP INFO MODEL"
-- Editor Note: get reference right!
::= { psampTemplateRecordEntry 3 }
psampTemplateRowStatus OBJECT-TYPE psampTemplateRecordRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampTemplateEntry 4 } ::= { psampTemplateRecordEntry 4 }
--================================================================== --==================================================================
-- Instance Group -- Base Associations Group
--================================================================== --==================================================================
psampInstances OBJECT IDENTIFIER ::= { psampObjects 4 } psampBaseAssociations OBJECT IDENTIFIER ::= { psampObjects 5 }
psampInstanceTable OBJECT-TYPE psampBaseAssociationTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampInstanceEntry SYNTAX SEQUENCE OF PsampBaseAssociationEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table lists active instances of packet sampling at "This table lists all base associations at the managed
the managed node." node."
::= { psampInstances 1 } ::= { psampBaseAssociations 1 }
psampInstanceEntry OBJECT-TYPE psampBaseAssociationEntry OBJECT-TYPE
SYNTAX PsampInstanceEntry SYNTAX PsampBaseAssociationEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the psampInstanceTable." "Defines an entry in the psampInstanceTable."
INDEX { psampInstanceIndex } INDEX { psampBaseAssocIndex }
::= { psampInstanceTable 1 } ::= { psampBaseAssociationTable 1 }
PsampBaseAssociationEntry ::= SEQUENCE {
PsampInstanceEntry ::= SEQUENCE { psampBaseAssocIndex Integer32,
psampInstanceIndex Integer32, psampBaseAssocObservationPoint OBJECT IDENTIFIER,
psampInstanceIfIndex InterfaceIndex, psampBaseAssocTemplateRecordId Integer32,
psampInstanceStartTime DateAndTime, psampBaseAssocCollectorGrpIndex Integer32,
psampInstanceStopTime DateAndTime, psampBaseAssocPacketsObserved Integer32,
psampInstanceTemplateIndex Integer32, psampBaseAssocPacketsDropped Integer32,
psampInstanceCollectorGroupIndex Integer32, psampBaseAssocMeteringProcessId Integer32,
psampInstancePacketsObserved Integer32, psampBaseAssocReportingProcessId Integer32,
psampInstanceReportsSent Integer32, psampBaseAssocReportsSent Integer32,
psampInstanceRowStatus RowStatus psampBaseAssocRowStatus RowStatus
} }
psampInstanceIndex OBJECT-TYPE psampBaseAssocIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The locally arbitrary, but unique identifier of "The locally arbitrary, but unique identifier of the base
an instance. associations.
The value is expected to remain constant at least from one The value is expected to remain constant at least from one
re-initialization of the entity's network management system re-initialization of the entity's network management system
to the next re-initialization." to the next re-initialization."
::= { psampInstanceEntry 1 } ::= { psampBaseAssociationEntry 1 }
psampInstanceIfIndex OBJECT-TYPE psampBaseAssocObservationPoint OBJECT-TYPE
SYNTAX InterfaceIndex SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Index of the IP interface at which the packet stream "The point where the packet is observed. If it is e.g, an
is observed by packet selection method 1." interface it points to the mib-II object of the interface."
::= { psampInstanceEntry 2 } ::= { psampBaseAssociationEntry 2 }
psampInstanceStartTime OBJECT-TYPE psampBaseAssocTemplateRecordId OBJECT-TYPE
SYNTAX DateAndTime SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The date and time when collecting samples for this parameter "The Id of a template in the template table. This implies
set should start." the knowledge about the method chain from the method chain
::= { psampInstanceEntry 3 } table. Furthermore it links the instance, method chain
(selector) and template together.
psampInstanceStopTime OBJECT-TYPE The identified template is applied to the stream of
SYNTAX DateAndTime filtered/sampled packets observed after applying the method
chain at the observation point."
::= { psampBaseAssociationEntry 3 }
psampBaseAssocCollectorGrpIndex OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The date and time when collecting samples for this parameter "The index of the collector group to which packet reports
set should stop." are sent."
::= { psampInstanceEntry 4 } ::= { psampBaseAssociationEntry 4 }
psampInstanceTemplateIndex OBJECT-TYPE psampBaseAssocPacketsObserved OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32
MAX-ACCESS read-create MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The Index of a template in the template table. This implies "The number of packets passing at the observation point."
the knowledge about the method chain from the method chain ::= { psampBaseAssociationEntry 5 }
table. Furthermore it links the instance, method chain
(selector) and template together.
The identified template is applied to the stream of packets psampBaseAssocPacketsDropped OBJECT-TYPE
observed at the interface." SYNTAX Integer32
::= { psampInstanceEntry 5 } MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets dropped while filtering/sampling
packets due to lack of resources."
::= { psampBaseAssociationEntry 6 }
psampInstanceCollectorGroupIndex OBJECT-TYPE psampBaseAssocMeteringProcessId OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-create MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of the collector group to which packet reports are "The process id of the metering process used by this
sent." Base Association."
::= { psampInstanceEntry 6 } ::= { psampBaseAssociationEntry 7 }
psampInstancePacketsObserved OBJECT-TYPE psampBaseAssocReportingProcessId OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of packets observed by method before selecting "The process id of the reporting process used by this
packets." Base Association."
::= { psampInstanceEntry 7 } ::= { psampBaseAssociationEntry 8 }
psampInstanceReportsSent OBJECT-TYPE psampBaseAssocReportsSent OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of reports on sampled packets sent to the "The number of packet reports on sampled packets sent to
collector." the collector."
::= { psampInstanceEntry 8 } ::= { psampBaseAssociationEntry 9 }
psampInstanceRowStatus OBJECT-TYPE psampBaseAssocRowStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampInstanceEntry 9 } ::= { psampBaseAssociationEntry 10 }
-- Method Chain Table ++++++++++++++++++++++++++++++++++++++++++++++ -- Selector List Table ++++++++++++++++++++++++++++++++++++++++++++++
psampMethodChainTable OBJECT-TYPE psampSelectorListTable OBJECT-TYPE
SYNTAX SEQUENCE OF PsampMethodChainEntry SYNTAX SEQUENCE OF PsampSelectorListEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains method chains lists and "This table contains lists of selectors and connects them
connects them to instances used by export the data." to the base associations where they are applied to
::= { psampInstances 4 } different observation points. The packets that are selected
by the last selection method are then exported."
::= { psampBaseAssociations 4 }
psampMethodChainEntry OBJECT-TYPE psampSelectorListEntry OBJECT-TYPE
SYNTAX PsampMethodChainEntry SYNTAX PsampSelectorListEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines an entry in the psampMethodChainTable." "Defines an entry in the psampSelectorListTable."
INDEX { psampInstanceIndex, psampMethodChainIndex } INDEX { psampBaseAssocIndex, psampSelectorListIndex }
::= { psampMethodChainTable 1 } ::= { psampSelectorListTable 1 }
PsampMethodChainEntry ::= SEQUENCE { PsampSelectorListEntry ::= SEQUENCE {
psampMethodChainIndex Integer32, psampSelectorListIndex Integer32,
psampMethodChainMethod OBJECT IDENTIFIER, psampSelectorListMethod OBJECT IDENTIFIER,
psampMethodChainRowStatus RowStatus psampSelectorListPacketsObserved Integer32,
psampSelectorListPacketsDropped Integer32,
psampSelectorListRowStatus RowStatus
} }
psampMethodChainIndex OBJECT-TYPE psampSelectorListIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The locally arbitrary, but unique identifier of "The locally arbitrary, but unique identifier of an entry
a template. in this selector list table.
The value is expected to remain constant at least from one The value is expected to remain constant at least from one
re-initialization of the entity's network management system re-initialization of the entity's network management system
to the next re-initialization." to the next re-initialization.
::= { psampMethodChainEntry 2 }
psampMethodChainMethod OBJECT-TYPE 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 SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The method used for the template at a certain position in "The selector used at a certain position in the selector
the method chain." list."
::= { psampMethodChainEntry 3 } ::= { psampSelectorListEntry 3 }
psampMethodChainRowStatus OBJECT-TYPE 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 SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row of the table." "The status of this row of the table."
::= { psampMethodChainEntry 4 } ::= { psampSelectorListEntry 6 }
--================================================================== --==================================================================
-- Conformance information -- Conformance information
--================================================================== --==================================================================
psampCompliances OBJECT IDENTIFIER ::= { psampConformance 1 } psampCompliances OBJECT IDENTIFIER ::= { psampConformance 1 }
psampGroups OBJECT IDENTIFIER ::= { psampConformance 2 } psampGroups OBJECT IDENTIFIER ::= { psampConformance 2 }
--================================================================== --==================================================================
-- Compliance statements -- Compliance statements
--================================================================== --==================================================================
psampCompliance MODULE-COMPLIANCE psampCompliance MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for the PSAMP-MIB." "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 MODULE -- this module
MANDATORY-GROUPS { psampGroup } 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."
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 } ::= { psampCompliances 1 }
--================================================================== --==================================================================
-- MIB groupings -- MIB groupings
--================================================================== --==================================================================
psampGroup OBJECT-GROUP psampGroupMetering OBJECT-GROUP
OBJECTS { OBJECTS {
psampSelectAllAvail, psampSelectAllAvail,
psampSampCountBasedAvail, psampSampCountBasedAvail,
psampSampTimeBasedAvail,
psampSampRandOutOfNAvail,
psampSampUniProbAvail,
psampSampNonUniProbAvail,
psampSampFlowStateAvail,
psampFilterMatchAvail,
psampFilterHashAvail,
psampFilterRStateAvail,
psampHashIPSXAvail,
psampHashBobAvail,
psampTemplateRecordInfoElementId,
psampTemplateRecordRowStatus,
psampSelectorListMethod,
psampSelectorListRowStatus,
psampBaseAssocObservationPoint,
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, psampSampCountBasedMaxInterval,
psampSampCountBasedMaxSpacing, psampSampCountBasedMaxSpacing,
psampSampCountBasedInterval, psampSampCountBasedInterval,
psampSampCountBasedSpacing, psampSampCountBasedSpacing,
psampSampCountBasedRowStatus, psampSampCountBasedRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if count based sampling is
implemented."
::= { psampGroups 2 }
psampSampTimeBasedAvail, psampGroupSampTimeBased OBJECT-GROUP
OBJECTS {
psampSampTimeBasedMaxInterval, psampSampTimeBasedMaxInterval,
psampSampTimeBasedMaxSpacing, psampSampTimeBasedMaxSpacing,
psampSampTimeBasedInterval, psampSampTimeBasedInterval,
psampSampTimeBasedSpacing, psampSampTimeBasedSpacing,
psampSampTimeBasedRowStatus, psampSampTimeBasedRowStatus
}
psampSampRandOutOfNAvail, STATUS current
DESCRIPTION
"These objects are needed if time based sampling is
implemented."
::= { psampGroups 3 }
psampGroupSampRandOutOfN OBJECT-GROUP
OBJECTS {
psampSampRandOutOfNMaxPopulation, psampSampRandOutOfNMaxPopulation,
psampSampRandOutOfNMaxSize, psampSampRandOutOfNMaxSample,
psampSampRandOutOfNPopulation, psampSampRandOutOfNPopulation,
psampSampRandOutOfNSize, psampSampRandOutOfNSample,
psampSampRandOutOfNRowStatus, psampSampRandOutOfNRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if random n-out-of-N sampling is
implemented."
::= { psampGroups 4 }
psampSampUniProbAvail, psampGroupSampUniProb OBJECT-GROUP
OBJECTS {
psampSampUniProbProbability, psampSampUniProbProbability,
psampSampUniProbRowStatus, psampSampUniProbRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if uniform probabilistic sampling
is implemented."
::= { psampGroups 5 }
psampSampNonUniProbAvail, psampGroupSampNonUniProb OBJECT-GROUP
OBJECTS {
psampSampNonUniProbFunction, psampSampNonUniProbFunction,
psampSampNonUniProbRowStatus, psampSampNonUniProbFuncParam,
psampSampFlowStateAvail, psampSampNonUniProbRowStatus
psampSampFlowStateFunction, }
psampSampFlowStateRowStatus, STATUS current
DESCRIPTION
"These objects are needed if non-uniform probabilistic
sampling is implemented."
::= { psampGroups 6 }
psampFilterMaskAvail, psampGroupSampFlowState OBJECT-GROUP
psampFilterMaskRowStatus, 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,
psampFilterMatchStopValue,
psampFilterMatchMask,
psampFilterMatchRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if match filtering is implemented."
::= { psampGroups 8 }
psampFilterHashAvail, psampGroupFilterHash OBJECT-GROUP
OBJECTS {
psampFilterHashAddrType,
psampFilterHashHeaderBits,
psampFilterHashPayloadBytes,
psampFilterHashPayloadBits,
psampFilterHashFunction, psampFilterHashFunction,
psampFilterHashRowStatus, psampFilterHashFuncParam,
psampFilterHashInputBits,
psampFilterHashOutputBits,
psampFilterHashOutputMask,
psampFilterHashSelection,
psampFilterHashRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if hash filtering is implemented."
::= { psampGroups 9 }
psampFilterRStateAvail, psampGroupFilterRState OBJECT-GROUP
psampFilterRStateRowStatus, OBJECTS {
psampFilterRStateFunction,
psampFilterRStateNegate,
psampFilterRStateIfIndex,
psampFilterRStateStartAS,
psampFilterRStateStopAS,
psampFilterRStateVendorFunc,
psampFilterRStateRowStatus
}
STATUS current
DESCRIPTION
"These objects are needed if router state filtering is
implemented."
::= { psampGroups 10 }
psampGroupHashIPSX OBJECT-GROUP
OBJECTS {
psampHashIPSXRowStatus
}
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, psampCollectorDstIpAddressType,
psampCollectorDstIpAddress, psampCollectorDstIpAddress,
psampCollectorDstProtocol, psampCollectorDstProtocol,
psampCollectorDstPort, psampCollectorDstPort,
psampCollectorReportsSent,
psampCollectorRowStatus, psampCollectorRowStatus,
psampCollectorGroupRowStatus, psampCollectorGroupRowStatus
}
STATUS current
DESCRIPTION
"These objects define the collectors i.e., the destinations
of the exporting process."
::= { psampGroups 13 }
psampTemplateId, psampGroupStatistics OBJECT-GROUP
psampTemplateReportsSent, OBJECTS {
psampTemplateRowStatus, psampCollectorReportsSent,
psampMethodChainMethod, psampSelectorListPacketsObserved,
psampMethodChainRowStatus, psampSelectorListPacketsDropped,
psampInstanceIfIndex, psampBaseAssocPacketsObserved,
psampInstanceStartTime, psampBaseAssocReportsSent,
psampInstanceStopTime, psampBaseAssocPacketsDropped
psampInstanceTemplateIndex,
psampInstanceCollectorGroupIndex,
psampInstancePacketsObserved,
psampInstanceReportsSent,
psampInstanceRowStatus
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The group of all accessible objects of the PSAMP MIB." "These objects contain statistical values gathered at
::= { psampGroups 1 } different points in the metering process."
::= { psampGroups 14 }
END END
5. Security Considerations 7. Security Considerations
There are a number of management objects defined in this MIB module 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 with a MAX-ACCESS clause of read-write and/or read-create. Such
objects may be considered sensitive or vulnerable in some network objects may be considered sensitive or vulnerable in some network
environments. The support for SET operations in a non-secure environments. The support for SET operations in a non-secure
environment without proper protection can have a negative effect on environment without proper protection can have a negative effect on
network operations. These are the tables and objects and their network operations.
sensitivity/vulnerability:
To be done.
6. Open Issues
o is the selecting all method mandatory for all implementations?
o should we have standard functions for non-uniform probabilistic
sampling, flow state sampling and the hash and router state
filtering?
o describe row status objects to writable tables
o support for reporting from a single instance to multiple
collectors may be refined
o elaborate conformance statements
o complete security considerations
o observed packets may be expanded to number of packets before
sampling and after sampling or something similar.
o align wording with the other draft documents (e.g. instance vs.
selector)
o check definition of selector, currently selector and instance
represent not quite the same thing
o add option template id to each parameter set for exporting option
data
o finish data template table and link it with the other elements.
o implement observation point for the sampling/filtering methods.
o change instance ifIndex to observation point in some way.
o improve the linking between instance and collector group like it
is between instance and method chain (take indexes to link those
tables). Advantage: the collector must exist before an instance
for it can be created. Same is true for instance and data template
table.
o check data type for "microseconds", protocol type, port, template
id and maybe some others
o ...
7. Acknowledgment 8. Acknowledgment
This document is a product of the PSAMP working group. This document is a product of the PSAMP working group.
Normative References 9. References
[I-D.ietf-psamp-framework] 9.1 Normative References
[PSAMP-FW]
Duffield, N., "A Framework for Passive Packet Duffield, N., "A Framework for Passive Packet
Measurement", draft-ietf-psamp-framework-05 (work in Measurement",
progress), January 2004. Internet-Draft draft-ietf-psamp-framework-05, January
2004.
[I-D.ietf-psamp-sample-tech] [PSAMP-TECH]
Zseby, T., Molina, M., Raspall, F. and N. Duffield, Zseby, T., Molina, M., Raspall, F. and N. Duffield,
"Sampling and Filtering Techniques for IP Packet "Sampling and Filtering Techniques for IP Packet
Selection", draft-ietf-psamp-sample-tech-04 (work in Selection",
progress), February 2004. Internet-Draft draft-ietf-psamp-sample-tech-04, February
2004.
[I-D.ietf-psamp-protocol] [PSAMP-INFO]
Dietz, T., "Information Model for Packet Sampling
Exports", Internet-Draft draft-ietf-psamp-info-01,
February 2004.
[PSAMP-PROTO]
Claise, B., "Packet Sampling (PSAMP) Protocol Claise, B., "Packet Sampling (PSAMP) Protocol
Specifications", draft-ietf-psamp-protocol-01 (work in Specifications",
progress), February 2004. Internet-Draft draft-ietf-psamp-protocol-01, February
2004.
[RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
McCloghrie, K., Rose, M. and S. Waldbusser, "Structure of McCloghrie, K., Rose, M. and S. Waldbusser, "Structure of
Management Information Version 2 (SMIv2)", STD 58, RFC Management Information Version 2 (SMIv2)", STD 58,
2578, April 1999. RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
McCloghrie, K., Rose, M. and S. Waldbusser, "Textual McCloghrie, K., Rose, M. and S. Waldbusser, "Textual
Conventions for SMIv2", STD 58, RFC 2579, April 1999. Conventions for SMIv2", STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D. and J. Schoenwaelder, [RFC2580] McCloghrie, K., Perkins, D. and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580, "Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999. April 1999.
Informative References 9.2 Informative References
[I-D.ietf-ipfix-reqs]
Quittek, J., "Requirements for IP Flow Information
Export", Internet-Draft draft-ietf-ipfix-reqs-16, June
2004.
[I-D.ietf-ipfix-info]
Calato, P., "Information Model for IP Flow Information
Export", Internet-Draft draft-ietf-ipfix-info-03, February
2004.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997. Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart,
"Introduction and Applicability Statements for "Introduction and Applicability Statements for
Internet-Standard Management Framework", RFC 3410, Internet-Standard Management Framework", RFC 3410,
December 2002. December 2002.
Authors' Addresses Authors' Addresses
Thomas Dietz (editor) Thomas Dietz (editor)
NEC Europte Ltd. NEC Europte Ltd.
Network Laboratories Network Laboratories
Kurfuersten-Anlage 36 Kurfuersten-Anlage 36
69115 Heidelberg 69115 Heidelberg
Germany Germany
Phone: +49 6221 90511-28 Phone: +49 6221 90511-28
EMail: dietz@netlab.nec.de Email: dietz@netlab.nec.de
Benoit Claise Benoit Claise
Cisco Systems Cisco Systems
De Kleetlaan 6a b1 De Kleetlaan 6a b1
1831 Degem 1831 Degem
Belgium Belgium
Phone: +32 2 704 5622 Phone: +32 2 704 5622
EMail: bclaise@cisco.com Email: bclaise@cisco.com
Intellectual Property Statement Intellectual Property Statement
The IETF takes no position regarding the validity or scope of any The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights this document or the extent to which any license under such rights
might or might not be available; neither does it represent that it might or might not be available; nor does it represent that it has
has made any effort to identify any such rights. Information on the made any independent effort to identify any such rights. Information
IETF's procedures with respect to rights in standards-track and on the procedures with respect to rights in RFC documents can be
standards-related documentation can be found in BCP-11. Copies of found in BCP 78 and BCP 79.
claims of rights made available for publication and any assurances of
licenses to be made available, or the result of an attempt made to Copies of IPR disclosures made to the IETF Secretariat and any
obtain a general license or permission for the use of such assurances of licenses to be made available, or the result of an
proprietary rights by implementors or users of this specification can attempt made to obtain a general license or permission for the use of
be obtained from the IETF Secretariat. 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 The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary copyrights, patents or patent applications, or other proprietary
rights which may cover technology that may be required to practice rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF Executive this standard. Please address the information to the IETF at
Director. ietf-ipr@ietf.org.
Full Copyright Statement
Copyright (C) The Internet Society (2004). All Rights Reserved. Disclaimer of Validity
This document and translations of it may be copied and furnished to This document and the information contained herein are provided on an
others, and derivative works that comment on or otherwise explain it "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
or assist in its implementation may be prepared, copied, published OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
and distributed, in whole or in part, without restriction of any ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
kind, provided that the above copyright notice and this paragraph are INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
included on all such copies and derivative works. However, this INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
document itself may not be modified in any way, such as by removing WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for
copyrights defined in the Internet Standards process must be
followed, or as required to translate it into languages other than
English.
The limited permissions granted above are perpetual and will not be Copyright Statement
revoked by the Internet Society or its successors or assignees.
This document and the information contained herein is provided on an Copyright (C) The Internet Society (2005). This document is subject
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING to the rights, licenses and restrictions contained in BCP 78, and
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING except as set forth therein, the authors retain all their rights.
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.
Acknowledgment Acknowledgment
Funding for the RFC Editor function is currently provided by the Funding for the RFC Editor function is currently provided by the
Internet Society. Internet Society.
 End of changes. 

This html diff was produced by rfcdiff 1.23, available from http://www.levkowetz.com/ietf/tools/rfcdiff/