| < draft-ietf-psamp-mib-05.txt | draft-ietf-psamp-mib-06.txt > | |||
|---|---|---|---|---|
| Network Working Group T. Dietz, Ed. | Network Working Group T. Dietz, Ed. | |||
| Internet-Draft NEC Europte Ltd. | Internet-Draft NEC Europte Ltd. | |||
| Expires: April 27, 2006 B. Claise | Expires: December 25, 2006 B. Claise | |||
| Cisco Systems | Cisco Systems | |||
| October 24, 2005 | June 23, 2006 | |||
| Definitions of Managed Objects for Packet Sampling | Definitions of Managed Objects for Packet Sampling | |||
| draft-ietf-psamp-mib-05.txt | <draft-ietf-psamp-mib-06.txt> | |||
| Status of this Memo | Status of this Memo | |||
| By submitting this Internet-Draft, each author represents that any | By submitting this Internet-Draft, each author represents that any | |||
| applicable patent or other IPR claims of which he or she is aware | applicable patent or other IPR claims of which he or she is aware | |||
| have been or will be disclosed, and any of which he or she becomes | have been or will be disclosed, and any of which he or she becomes | |||
| aware will be disclosed, in accordance with Section 6 of BCP 79. | aware will be disclosed, in accordance with Section 6 of BCP 79. | |||
| 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 | Task Force (IETF), its areas, and its working groups. Note that | |||
| skipping to change at page 1, line 35 ¶ | skipping to change at page 1, line 35 ¶ | |||
| 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 | The list of current Internet-Drafts can be accessed at | |||
| http://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 April 27, 2006. | This Internet-Draft will expire on December 25, 2006. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (C) The Internet Society (2005). | Copyright (C) The Internet Society (2006). | |||
| Abstract | Abstract | |||
| This memo defines managed objects for sampling and filtering | This memo defines managed objects for sampling and filtering | |||
| techniques for IP packet selection. These objects provide | techniques for IP packet selection. These objects provide | |||
| information about managed nodes supporting packet sampling, including | information about managed nodes supporting packet sampling, including | |||
| packet sampling capabilities, configuration and statistics. They | packet sampling capabilities and configuration. They also allow to | |||
| also allow to configure packet sampling concerning the IP interface | configure packet sampling concerning the IP interface at which | |||
| at which packets are sampled, the packet selections methods used for | packets are sampled and the packet selections methods used for | |||
| sampling, and the collector to which packet samples are exported. | sampling. | |||
| Table of Contents | Table of Contents | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 1. Open Issues/TODOs . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 1.1. Points of Discussion . . . . . . . . . . . . . . . . . . . 3 | ||||
| 2. PSAMP Documents Overview . . . . . . . . . . . . . . . . . . . 6 | ||||
| 3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 6 | ||||
| 3.1. Base Association . . . . . . . . . . . . . . . . . . . . . 6 | ||||
| 4. The Internet-Standard Management Framework . . . . . . . . . . 6 | ||||
| 5. Structure of the PSAMP MIB module . . . . . . . . . . . . . . 7 | ||||
| 5.1. TEXTUAL CONVENTIONS . . . . . . . . . . . . . . . . . . . 7 | ||||
| 5.2. The Selection Methods . . . . . . . . . . . . . . . . . . 8 | ||||
| 5.2.1. Selecting All Packets . . . . . . . . . . . . . . . . 8 | ||||
| 5.2.2. Systematic Count-based Sampling . . . . . . . . . . . 8 | ||||
| 5.2.3. Systematic Time-based Sampling . . . . . . . . . . . . 9 | ||||
| 5.2.4. Random n-out-of-N Sampling . . . . . . . . . . . . . . 9 | ||||
| 5.2.5. Uniform Probabilistic Sampling . . . . . . . . . . . . 9 | ||||
| 5.2.6. Non-Uniform Probabilistic Sampling . . . . . . . . . . 9 | ||||
| 5.2.7. Flow State Sampling . . . . . . . . . . . . . . . . . 10 | ||||
| 5.2.8. Match Filtering . . . . . . . . . . . . . . . . . . . 10 | ||||
| 5.2.9. Hash Filtering . . . . . . . . . . . . . . . . . . . . 10 | ||||
| 5.2.10. Router State Filtering . . . . . . . . . . . . . . . . 11 | ||||
| 5.3. The Hash Functions . . . . . . . . . . . . . . . . . . . . 12 | ||||
| 5.4. The Reporting . . . . . . . . . . . . . . . . . . . . . . 12 | ||||
| 5.5. The Base Associations . . . . . . . . . . . . . . . . . . 12 | ||||
| 6. Definition . . . . . . . . . . . . . . . . . . . . . . . . . . 14 | ||||
| 7. Security Considerations . . . . . . . . . . . . . . . . . . . 60 | ||||
| 8. Acknowledgment . . . . . . . . . . . . . . . . . . . . . . . . 60 | ||||
| 9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 60 | ||||
| 9.1. Normative References . . . . . . . . . . . . . . . . . . . 60 | ||||
| 9.2. Informative References . . . . . . . . . . . . . . . . . . 61 | ||||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 62 | ||||
| Intellectual Property and Copyright Statements . . . . . . . . . . 63 | ||||
| 1. Introduction | ||||
| The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | ||||
| "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | ||||
| document are to be interpreted as described in RFC 2119 [8]. | ||||
| This document is a product of the Packet Sampling (PSAMP) working | ||||
| group. Its purpose is to define standards-based MIB modules for | ||||
| monitoring and configuring PSAMP devices performing packet selection | ||||
| by sampling, filtering and hashing. | ||||
| It is assumed that packet sampling is performed according to the | ||||
| framework defined in [1]. Packet selection methods considered in the | ||||
| MIB module are specified in [2]. Configuration of the export of | ||||
| packet samples to a collector is modeled according to [3]. | ||||
| 1.1. Points of Discussion | ||||
| This section covers the open issues, still to be resolved/updated in | ||||
| this draft. | ||||
| MIB-1: Title should include sampling and filtering not only sampling. | ||||
| The titles of all documents not only the MIB document should | ||||
| reflect that. | ||||
| MIB-2: We are missing some examples, such as slide 8 of PSAMP-MIB- | ||||
| IETF60.ppt. It is planned to integrate a entity relationship | ||||
| diagram plus some examples in the next version. Examples should | ||||
| always display named OIDs otherwise they are difficult to | ||||
| understand. | ||||
| MIB-3: Do we want to be consistent with the upper cases in the | ||||
| terminology? Do we want to say a note about it in the terminology | ||||
| section. Something such as: "all terms in upper cases are defined | ||||
| in..." or "all referenced terminology are written with an upper | ||||
| case" | ||||
| MIB-4: The following caese definitively requires some more | ||||
| explanation, with some examples. | ||||
| * When you refers to an OID for the interface, you don't specify | ||||
| if we need the OID for the ifIndex, for the ifDescr, for | ||||
| something else | ||||
| * When you refer to an OID for a function, an example is needed | ||||
| * When you refer to an OID for set of input parameters, which OID | ||||
| do we need? What if there are multiple indexes in the table? | ||||
| 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: | 2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| IN; | ||||
| Parameter1 | ||||
| Parameter2 | ||||
| ... | ||||
| OUT | ||||
| Parameter1 | ||||
| Parameter2 | ||||
| MIB-6: Question: as far as I recall (but I could be wrong), when | 3. PSAMP Documents Overview . . . . . . . . . . . . . . . . . . . 3 | |||
| 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 | 4. The Internet-Standard Management Framework . . . . . . . . . . 4 | |||
| 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 | 5. Structure of the PSAMP MIB module . . . . . . . . . . . . . . 4 | |||
| mean? Above layer 4? It is not specified in [2]. | 5.1. The Sampling Group . . . . . . . . . . . . . . . . . . . . 5 | |||
| 5.1.1. Selecting All Packets . . . . . . . . . . . . . . . . 5 | ||||
| 5.1.2. Systematic Count-based Sampling . . . . . . . . . . . 6 | ||||
| 5.1.3. Systematic Time-based Sampling . . . . . . . . . . . . 6 | ||||
| 5.1.4. Random n-out-of-N Sampling . . . . . . . . . . . . . . 6 | ||||
| 5.1.5. Uniform Probabilistic Sampling . . . . . . . . . . . . 6 | ||||
| 5.1.6. Non-Uniform Probabilistic Sampling . . . . . . . . . . 7 | ||||
| 5.1.7. Flow State Sampling . . . . . . . . . . . . . . . . . 7 | ||||
| 5.2. The Filtering Methods Group . . . . . . . . . . . . . . . 7 | ||||
| 5.2.1. Match Filtering . . . . . . . . . . . . . . . . . . . 7 | ||||
| 5.2.2. Hash Filtering . . . . . . . . . . . . . . . . . . . . 7 | ||||
| 5.2.3. Router State Filtering . . . . . . . . . . . . . . . . 8 | ||||
| 5.3. The Hash Functions Group . . . . . . . . . . . . . . . . . 9 | ||||
| MIB-9: psampFilterRState OBJECT IDENTIFIER: Try to rename to | 6. Definition . . . . . . . . . . . . . . . . . . . . . . . . . . 10 | |||
| RouterState if maximum OID name length of 32 chars is not | ||||
| exceeded. | ||||
| MIB-10: psampFilterRStateAvail OBJECT-TYPE: It should be specified | 7. Security Considerations . . . . . . . . . . . . . . . . . . . 43 | |||
| 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 | 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 43 | |||
| 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 | 9. Acknowledgment . . . . . . . . . . . . . . . . . . . . . . . . 43 | |||
| PsampBaseAssocEntry and PSAMP-TECH document. | ||||
| MIB-13: psampBaseAssoceObservationPoint OBJECT-TYPE: Where should the | 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 43 | |||
| OID point to? ifIndex, ifDescr? | 10.1. Normative References . . . . . . . . . . . . . . . . . . . 43 | |||
| 10.2. Informative References . . . . . . . . . . . . . . . . . . 44 | ||||
| MIB-14: Capitalization should be consistent throughout the document. | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 45 | |||
| Maybe the solution is to list all reference terms from PSAMP and | Intellectual Property and Copyright Statements . . . . . . . . . . 46 | |||
| 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 | 1. Open Issues/TODOs | |||
| Integer32 with ranges) must be checked! Not sure if especially an | o Align MIB with other drafts, esp. the Sampling Techniques one. | |||
| index can be Unsigned32, if he must have a limited range, etc. | o Is the selecting all method mandatory for all implementations? | |||
| Can some experts speak up? | o Describe row status objects to writable tables. | |||
| o Elaborate conformance statements. | ||||
| o Add option template id to each parameter set for exporting option | ||||
| data. | ||||
| o Check data type for "microseconds", protocol type, port, template | ||||
| id and maybe some others. | ||||
| o Need to achieve a common layout and naming on the different MIB | ||||
| parts. | ||||
| o Elaborate security considerations, particularly concerning SET | ||||
| operations. | ||||
| MIB-16: Hash filtering again (see also MIB-5). The hash filtering | 2. Introduction | |||
| 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 | The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | |||
| Bob) specified in the PSAMP-TECH document and leave other hash | "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | |||
| functions to extended drafts. But what about vendor specific hash | document are to be interpreted as described in RFC 2119 [RFC2119]. | |||
| functions?? How do we know they exist?? | ||||
| Potentially because a vendor would produce a new private MIB? | This document is a product of the Packet Sampling (PSAMP) working | |||
| Maybe a question for the mailing list! We mainly need the hash | group. Its purpose is to define standards-based MIB modules for | |||
| function in hardware, where it can not be changed so easily as | monitoring and configuring PSAMP devices performing packet selection | |||
| changing a mib. | by sampling, filtering and hashing. | |||
| MIB-17: Hash filtering again (see also MIB-5 and MIB-16). Question | It is assumed that packet sampling is performed according to the | |||
| of security! Do we want to be able to read all of the values in | framework defined in [I-D.ietf-psamp-framework]. Packet selection | |||
| PsampFilterHashParamSetEntry. Including the output of the hash | methods considered in the MIB module are specified in [I-D.ietf- | |||
| function? Could an attacker with SNMP read access deduce what | psamp-sample-tech]. Configuration of the export of packet samples to | |||
| type of traffic to send to manipulate the NMS application? Do we | a collector is modeled according to [I-D.ietf-psamp-protocol]. The | |||
| want to export all the 10 parameters in PSAMP export? Does | exporter uses the IPFIX protocol as specified in [I-D.ietf-ipfix- | |||
| PSAMP-FW requires it? See "6.2.2 Guarding Against Pitfalls and | protocol]. | |||
| 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 | The MIB presented here is a module of the IPFIX MIB [I-D.dietz-ipfix- | |||
| with subtables for each router state function. That would also | mib]. It starts at an Object ID in the IPFIX MIB and imports the | |||
| clarify the point of psampFilterRStateAvail: one capability per | textual conventions defined there. | |||
| function -> that make more sense. That would also solve MIB-10. | ||||
| We can extend with new methods easily. | ||||
| 2. PSAMP Documents Overview | 3. PSAMP Documents Overview | |||
| [PSAMP-FW]: "A Framework for Packet Selection and Reporting" The | PSAMP Framework: [I-D.ietf-psamp-framework] "A Framework for Packet | |||
| document describes the PSAMP framework for network elements to | Selection and Reporting" The document describes the PSAMP | |||
| select subsets of packets by statistical and other methods, and to | framework for network elements to select subsets of packets by | |||
| export a stream of reports on the selected packets to a collector. | statistical and other methods, and to export a stream of reports | |||
| Definitions of terminology and the use of the terms "must", | on the selected packets to a collector. Definitions of | |||
| "should" and "may" in this document are informational only. | 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 | PSAMP Sampling Techniques: [I-D.ietf-psamp-sample-tech] "Sampling and | |||
| Selection", describes the set of packet selection techniques | Filtering Techniques for IP Packet Selection", describes the set | |||
| supported by PSAMP. | of packet selection techniques supported by PSAMP. | |||
| PSAMP-MIB: "Definitions of Managed Objects for Packet Sampling" (this | PSAMP MIB: "Definitions of Managed Objects for Packet Sampling" (this | |||
| document) describes the PSAMP Management Information Base. | document) describes the PSAMP Management Information Base. | |||
| [PSAMP-PROTO]: "Packet Sampling (PSAMP) Protocol Specifications" | PSAMP Protocol: [I-D.ietf-psamp-protocol] "Packet Sampling (PSAMP) | |||
| specifies the export of packet information from a PSAMP Exporting | Protocol Specifications" specifies the export of packet | |||
| Process to a PSAMP Colleting Process. | information from a PSAMP Exporting Process to a PSAMP Colleting | |||
| Process. | ||||
| [PSAMP-INFO]: "Information Model for Packet Sampling Exports" defines | ||||
| an information and data model for PSAMP. | ||||
| 3. Terminology | ||||
| The PSAMP terminology defined here includes (and is consistent with) | ||||
| all terms listed in [2]. We here define additional terms required | ||||
| for the definition of managed objects. An architecture overview and | ||||
| possible configurations of PSAMP elements can be found in [1]. | ||||
| Detailed definitions of selectors can be found in [2]. PSAMP | ||||
| terminology also aims to be consistent with terms used in [9]. The | ||||
| relationship between some PSAMP and IPFIX terms is described in [1]. | ||||
| 3.1. Base Association | PSAMP Information Model: [I-D.ietf-psamp-info] "Information Model for | |||
| Packet Sampling Exports" defines an information and data model for | ||||
| PSAMP. | ||||
| The Base Association combines several values defined at a PSAMP | Section 5 describes the structure of the PSAMP MIB module and section | |||
| device. It is derived from the ASSOCIATION defined in [2] section 7. | 6 contains the formal definition. Security issues are finally | |||
| It contains references to an Observation Point, a template record, a | discussed in section 7. | |||
| 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 | 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 [10]. | 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 [4], STD 58, RFC 2579 [5] and STD 58, RFC 2580 [6]. | RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 | |||
| [RFC2580]. | ||||
| 5. Structure of the PSAMP MIB module | 5. Structure of the PSAMP MIB module | |||
| The PSAMP MIB module follows the structures given in [1] and [2]. | The PSAMP MIB module is structure according to the sample techniques | |||
| The psampBaseAssociations subtree builds the heart of the PSAMP MIB. | document [I-D.ietf-psamp-sample-tech]. The main structure follows | |||
| This subtree models the values described by the Base Association. | the building blocks of the PSAMP framework [I-D.ietf-psamp- | |||
| The psampBaseAssocTable contains one entry per Base Association. The | framework], describing sampling/filtering at an observation point | |||
| list of Selectors is modelled by a second table the | then exporting the collected information to one or more collectors. | |||
| psampSelectorListTable. This table is linked to the | The objects needed for exporting the information and describing and | |||
| psampBaseAssocTable by the first index which is the | configuring the selection methods used in the metering process are | |||
| psampBaseAssocIndex. A psampBaseAssocEntry also references an entry | already defined in the IPFIX MIB Exporter Module [I-D.dietz-ipfix- | |||
| in the psampTemplateRecordTable and the psampCollectorGroupTable to | mib]. | |||
| link the metering process with the reporting process. | ||||
| Every selection method described in [2] gets its own subtree in the | ||||
| PSAMP MIB. The subtree always contains a capability section and a | ||||
| parameter set table. So several parameter sets can be defined for | ||||
| each selection method. The parameter set is linked to the Base | ||||
| Association by an entry in the psampSelectorListTable. The | ||||
| psampSelectorListMethod point to the first object id of a parameter | ||||
| set entry. The hash functions proposed in [2] are modelled in a | ||||
| similar way as the selection methods and are referenced by a | ||||
| psampFilterHashParamSetEntry. | ||||
| The reporting and exporting processes are modeled by the | ||||
| psampCollectorTable, the psampCollectorGroupTable and the | ||||
| psampTemplateRecordTable. The psampTemplateRecordTable contains | ||||
| Template Records as defined by the IPFIX protocol. They are used to | ||||
| export the selected packets to the collectors. The collectors itself | ||||
| are modelled in the psampCollectorTable and the | ||||
| psampCollectorGroupTable combines several Collectors to which the | ||||
| packet reports are sent simultaniously. | ||||
| 5.1. TEXTUAL CONVENTIONS | The PSAMP MIB Module contains parameter sets for the sampling and | |||
| filtering methods described in [I-D.ietf-psamp-sample-tech]. The | ||||
| sampling and filtering methods and their parameter sets are | ||||
| controlled by three groups of objects: The sampling group, the | ||||
| filtering group and the hash functions group. The sampling group and | ||||
| the filtering group define the parameters for the sampling and | ||||
| filtering methods. The hash functions group defines the available | ||||
| hash functions for hash based filtering. Finally we have the | ||||
| statistics group that represent all objects collecting the optional | ||||
| statistical values like packets observed by a hash function or | ||||
| reports sent to a collector. | ||||
| The PSAMP MIB defines one new textual convention, the | In the next sections we will briefly describe every object group and | |||
| PsampMethodAvailability. It is used as SYNTAX of all those objects | its usage. | |||
| that indicate if a selection method or hash function is available in | ||||
| a specific implementation of a PSAMP device. | ||||
| 5.2. The Selection Methods | 5.1. The Sampling Group | |||
| The first group of objects contains information about sampling | The first group of objects contains information about sampling | |||
| methods and filtering methods. Each method is covered by an | methods. Each sampling method is covered by an individual sub-tree | |||
| individual subtree. Expect for the first method that corresponds to | of this group. The following objects are defined for each method | |||
| the exceptional selection of all packets, the following objects are | except the first: a sub-group of objects indicating specific | |||
| defined for each method: a subtree of objects indicating specific | ||||
| capabilities and limits of the method that may be empty if no | capabilities and limits of the method that may be empty if no | |||
| capabilities or limits are available, and a subtree specifying sets | capabilities or limits are available, and a sub-group specifying sets | |||
| of parameters in a table. Each row in the parameter set table | of parameters in a table. Each row in the parameter set table | |||
| uniquely specifies all parameters of a packet selection process of | uniquely specifies all parameters of a packet sampling instance of | |||
| the method. Also all parameters sets contain a row status. | the method. Also all parameters sets contain a row status. | |||
| The PSAMP MIB covers all methods and their parameters specified in | Methods and parameters of methods are specified in [I-D.ietf-psamp- | |||
| [2]. If the given methods could be extended by some implementation | sample-tech]. The PSAMP MIB document specifies all methods defined | |||
| dependent functionality the MIB contains objects that reference an | in the sample tech document. If some object need further | |||
| OBJECT IDENTIFIER. These objects are used as pointers to functions | specification then OBJECT IDENTIFIERS are used as pointers to | |||
| or parameters that are out of the scope of this document. These | functions or parameters that are out of the scope of this document. | |||
| functions or parameters can be either vendor specific or may be | They can be implemented in a vendor specific way or may be documented | |||
| documented in an additional standard document or an updated version | in another document or a later version of this document. An | |||
| of this document. An implementer may specify e.g., one or more | implementer may specify e.g., one or more functions used for non- | |||
| functions used for non-uniform probabilistic sampling, additional | uniform probabilistic sampling. The seven methods specified in this | |||
| router state matches or additional hash functions for hash filtering. | document 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. | ||||
| 5.2.1. Selecting All Packets | 5.1.1. Selecting All Packets | |||
| This is the most trivial packet selection method. If it is applied, | This trivial packet selection method is alway available. If it is | |||
| all packets will be selected. | applied, all packets will be selected. | |||
| 5.2.2. Systematic Count-based Sampling | 5.1.2. Systematic Count-based Sampling | |||
| Count-based sampling means, that all packets that arrive in this | The systematic count-based sampling method has two capability | |||
| packet interval are selected. The spacing parameter defines the | objects: The psampSampCountBasedMaxInterval object indicates the | |||
| spacing in number of packets between the end of one sampling interval | maximum sampling interval in packets supported by the implementation, | |||
| and the start of the next succeeding interval. The systematic count- | whereas psampSampCountBasedMaxSpacing indicates the maximum spacing | |||
| based sampling method has two capability objects: The | in packets supported by the implementation. | |||
| 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 number of | the sampling interval length and the spacing specified in numbers of | |||
| packets. | packets. | |||
| 5.2.3. Systematic Time-based Sampling | 5.1.3. Systematic Time-based Sampling | |||
| Time-based sampling means, that all packets that arrive in this time | The systematic time-based sampling method has two capability objects: | |||
| interval are selected. The spacing parameter defines the spacing in | psampSampTimeBasedMaxInterval indicates the maximum sampling interval | |||
| time between the end of one sampling interval and the start of the | in microseconds supported by the implementation, whereas | |||
| next succeeding interval. The systematic time-based sampling methods | psampSampTimeBasedMaxSpacing indicates the maximum spacing in | |||
| have two capability objects: The psampSampTimeBasedMaxInterval object | microseconds supported by the implementation. | |||
| 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 number of | the sampling interval length and the spacing specified in | |||
| microseconds. | microseconds. | |||
| 5.2.4. Random n-out-of-N Sampling | 5.1.4. Random n-out-of-N Sampling | |||
| The random n-out-of-N sampling method has one capability object: | The random n-out-of-N sampling method has two capability objects: | |||
| psampSampRandOutOfNMaxPopulation specifying the maximum population N. | psampSampRandOutOfNMaxPopulation specifying the maximum population N, | |||
| and psampSampRandOutOfNMaxSample the maximum size of n supported by | ||||
| the implementation. | ||||
| 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 psampSampRandOutOfNSample gives | the parent population. The second psampSampRandOutOfNSample gives | |||
| the number of elements n taken from the parent population N. With | the number of elements n taken from the parent population N. With | |||
| these two parameters you sample n packets out of N. | these two parameters you sample n packets out of N. | |||
| 5.2.5. Uniform Probabilistic Sampling | 5.1.5. Uniform Probabilistic Sampling | |||
| Capability objects are not specified for the uniform probabilistic | The uniform probabilistic sampling method has no capabilities and | |||
| sampling method. It has only one parameter in the | only one parameter in the psampSampUniProbParamSetTable, the | |||
| psampSampUniProbParamSetTable, the psampSampUniProbProbability. This | psampSampUniProbProbability. This object gives the probability that | |||
| object gives the probability that a packet is sampled. The | a packet is sampled. The probability is equal for every packet. The | |||
| probability is equal for every packet. The given value must be | given value must be divided by 4294967295 (=2^32-1), so a value of 0 | |||
| divided by 4294967295 (=2^32-1), so a value of 0 means no packet is | means no packet is sampled (probability is 0) and a value of | |||
| sampled (probability is 0) and a value of 4294967295 means every | 4294967295 means every packet is sampled (probability is 1). | |||
| packet is sampled (probability is 1). | ||||
| 5.2.6. Non-Uniform Probabilistic Sampling | 5.1.6. Non-Uniform Probabilistic Sampling | |||
| Capability objects are not specified for the non-uniform | The non-uniform probabilistic sampling method has also no | |||
| probabilistic sampling method. The psampSampNonUniProbParamSetTable | capabilities defined. The psampSampNonUniProbParamSetTable contains | |||
| contains two parameters, the psampSampNonUniProbFunction and the | two parameters, the psampSampNonUniProbFunction and the | |||
| psampSampNonUniProbFuncParam. Those two objects point to the | psampSampNonUniProbFuncParam. Those two objects point to the | |||
| function that computes the probability that a packet is sampled and | function that computes the probability that a packet is sampled and | |||
| the parameters used for that function. The definition of the | the parameters used for that function. The definition of the | |||
| function and its parameters is implementation dependent and beyond | function and its parameters is implementation dependent and beyond | |||
| the scope of this document. | the scope of this document. | |||
| 5.2.7. Flow State Sampling | 5.1.7. Flow State Sampling | |||
| Capability objects are not specified for the flow state sampling | The capabilities and parameter set of the flow state sampling method | |||
| method. The psampSampFlowStateParamSetTable holds two parameters | are equal to those of the non-uniform probabilistic sampling method. | |||
| pointing to the flow state function and the parameters used by the | There are no capabilities defined and the | |||
| flow state function (psampSampFlowStateFunction and | psampSampFlowStateParamSetTable hold two parameters pointing to the | |||
| flow state function and the parameters used by the flow state | ||||
| function (psampSampFlowStateFunction and | ||||
| psampSampFlowStateFuncParam). Again the function and its parameters | psampSampFlowStateFuncParam). Again the function and its parameters | |||
| are implementation dependent and beyond the scope of this document. | are implementation dependent and beyond the scope of this document. | |||
| 5.2.8. Match Filtering | 5.2. The Filtering Methods Group | |||
| Capability objects are not specified for the match filtering method. | The second group contains information about the filtering methods. | |||
| It contains four parameters in the psampFilterMatchParamSetTable: The | This group is build up similarly to the sampling methods group. It | |||
| psampFilterMatchFieldId contain the PSAMP or IPFIX information | currently contains three filtering methods, the match filtering, the | |||
| element id defined in the information model [7], [11]. The | hash filtering and the router state filtering. | |||
| 5.2.1. Match Filtering | ||||
| The match filtering method has no capabilities defined and contains | ||||
| four parameters in the psampFilterMatchParamSetTable: The | ||||
| psampFilterMatchFieldId contain the PSAMP or IPFIX field id defined | ||||
| in the information model as reference what to match. The | ||||
| psampFilterMatchStartValue and psampFilterMatchStopValue contain the | psampFilterMatchStartValue and psampFilterMatchStopValue contain the | |||
| start and stop value to match the content against. In this way you | 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 | 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 | 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 | 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 | matched than start and stop value must be equal. A mask | |||
| psampFilterMatchMask can be applied if it is applicable for the field | 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 | id. The encoding of the values is dependent on the field id and has | |||
| to be done according to the PSAMP protocol document. | to be done according to the PSAMP protocol document. | |||
| 5.2.9. Hash Filtering | 5.2.2. Hash Filtering | |||
| Capability objects are not specified for the hash filtering method. | Capabilities are not specified for the hash filtering method. But | |||
| But according to the sample tech document [2] ten parameters are | according to the sample tech document [I-D.ietf-psamp-sample-tech] | |||
| defined in the psampFilterHashParamSetTable. The | ten parameters are defined in the psampFilterHashParamSetTable. The | |||
| psampFilterHashAddrType specifies the address type to hash - either | psampFilterHashAddrType specifies the address type to hash - either | |||
| IPv4 or IPv6. Then psampFilterHashHeaderBits specifies a bit mask | IPv4 or IPv6. Then psampFilterHashHeaderBits specifies a bit mask | |||
| applied to the packet header selecting the bits to hash from the | applied to the packet header selecting the bits to hash from the | |||
| packet header. Then psampFilterHashPayloadBytes gives the number of | packet header. Then psampFilterHashPayloadBytes gives the number of | |||
| payload bytes that should be included in the hashing. The final bits | payload bytes that should be included in the hashing. The final bits | |||
| that are selected from the payload bytes are masked with the | that are selected from the payload bytes are masked with the | |||
| psampFilterHashPayloadBits. | psampFilterHashPayloadBits. | |||
| The above parameters specified what gets feed into the hash function. | The above parameters specified what gets feed into the hash function. | |||
| The following parameters specify the hash function itself. The | The following parameters specify the hash function itself. The | |||
| psampFilterHashFunction points to a hash function and | psampFilterHashFunction points to a hash function and | |||
| psampFilterHashFuncParam point to a function specific parameter set | psampFilterHashFuncParam point to a function specific parameter set | |||
| for the hashing function. The number of input and output bits for | for the hashing function. The number of input and output bits for | |||
| the hash function is specified with psampFilterHashInputBits and | the hash function is specified with psampFilterHashInputBits and | |||
| psampFilterHashOutputBits. Finally the output may be masked with the | psampFilterHashOutputBits. Finally the output may be masked with the | |||
| psampFilterHashOutputMask. The results gained by applying all those | psampFilterHashOutputMask. The results gained by applying all those | |||
| parameters are then compared with the psampFilterHashSelection. The | parameters are then compared with the psampFilterHashSelection. The | |||
| psampFilterHashSelection contains the hash value ranges or single | psampFilterHashSelection contains the hash value ranges or single | |||
| hash values that get selected. The psampFilterHashSelection is a | hash values that get selected. The psampFilterHashSelection is a | |||
| human readable string containing only the ASCII characters 0-9, a-f, | human readable string containing only the ASCII characters 0-9, a-f, | |||
| comma(,) and dash(-). | comma(,) and dash(-). 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]* | ||||
| The two hash functions given in the sample tech document can be | The two hash functions given in the sample tech document can be | |||
| referenced within this parameter set table and are also contained in | referenced within this parameter set table and are also contained in | |||
| this PSAMP MIB document. | this PSAMP MIB document. | |||
| 5.2.10. Router State Filtering | 5.2.3. Router State Filtering | |||
| Capability objects are not specified for the router state filtering | The router state filtering does also not specify any capabilities. | |||
| method. The parameter table psampFilterRStateParamSetTable contains | The parameter table psampFilterRStateParamSetTable contains six | |||
| six parameters to specify the router state to filter against. The | parameters to specify the router state to filter against. The first | |||
| first object psampFilterRStateFunction defines one of nine functions | object psampFilterRStateFunction defines one of nine functions that | |||
| that may be used as router state. | may be used as router state. | |||
| other: an other router state function that is not defined here. Then | other: an other router state function that is not defined here. Then | |||
| psampFilterRStateVendorFunc points to the implementation specific | psampFilterRStateVendorFunc points to the implementation specific | |||
| function that is used. | function that is used. | |||
| ingressIf: packets that enter the PSAMP device at the interface | ingressIf: packets that enter the probe at the interface specified by | |||
| specified by psampFilterRStateIfIndex are matched. | psampFilterRStateIfIndex are matched. | |||
| egressIf: packets that leave the PSAMP device at the interface | egressIf: packets that leave the probe at the interface specified by | |||
| specified by psampFilterRStateIfIndex are matched. | psampFilterRStateIfIndex are matched. | |||
| aclViolation: packets that violate the access control list are | aclViolation: packets that violate the access control list are | |||
| matched. | matched. | |||
| rpfFailure: packets for which the reverse path forwarding fails are | rpfFailure: packets for that the reverse path forwarding fails are | |||
| matched. | matched. | |||
| noResources: packets for which not enough resources are allocated | noResources: packets for that not enough resources are allocated will | |||
| will be matched. | be matched. | |||
| noRoute: packets that could not be routed further are matched. | noRoute: packets that could not be routed further are matched. | |||
| originAS: packets that originate in an autonomous system specified by | originAS: packets that originate in an autonomous system specified by | |||
| the range of psampFilterRStateStartAS and psampFilterRStateStopAS | the range of psampFilterRStateStartAS and psampFilterRStateStopAS | |||
| are matched. | are matched. | |||
| destAS: packets whose destination is in an autonomous system | destAS: packets whose destination is in an autonomous system | |||
| specified by the range of psampFilterRStateStartAS and | specified by the range of psampFilterRStateStartAS and | |||
| psampFilterRStateStopAS are matched. | psampFilterRStateStopAS are matched. | |||
| skipping to change at page 12, line 4 ¶ | skipping to change at page 9, line 31 ¶ | |||
| originAS: packets that originate in an autonomous system specified by | originAS: packets that originate in an autonomous system specified by | |||
| the range of psampFilterRStateStartAS and psampFilterRStateStopAS | the range of psampFilterRStateStartAS and psampFilterRStateStopAS | |||
| are matched. | are matched. | |||
| destAS: packets whose destination is in an autonomous system | destAS: packets whose destination is in an autonomous system | |||
| specified by the range of psampFilterRStateStartAS and | specified by the range of psampFilterRStateStartAS and | |||
| psampFilterRStateStopAS are matched. | psampFilterRStateStopAS are matched. | |||
| The parameter psampFilterRStateIfIndex defaults to 0 if not used. | The parameter psampFilterRStateIfIndex defaults to 0 if not used. | |||
| The parameters psampFilterRStateStartAS and psampFilterRStateStopAS | The parameters psampFilterRStateStartAS and psampFilterRStateStopAS | |||
| default to 0 if they are not used. If a single autonomous system | default to 0 if they are not used. If a single autonomous system | |||
| number should be matched psampFilterRStateStopAS remains 0. | number should be matched psampFilterRStateStopAS remains 0. | |||
| 5.3. The Hash Functions | 5.3. The Hash Functions Group | |||
| The hash function subtree specifies the two hash functions defined in | The hash function group specifies the two hash functions defined in | |||
| the sample tech document [2]. The hash functions are defined here so | the sample tech document [I-D.ietf-psamp-sample-tech]. The hash | |||
| that they can be referenced by the hash filter above. The design of | functions are defined here so that they can be referenced by the hash | |||
| the hash function part of the MIB SHOULD be taken as a guideline for | filter above. The design of the hash function part of the MIB SHOULD | |||
| vendor specific hash function definitions. | be taken as a guideline for vendor specific hash function | |||
| definitions. | ||||
| The two hash functions IPSX and Bob have both an empty parameter set | The two hash functions IPSX and Bob have both an empty parameter set | |||
| table since they both take now additional parameters than those | table since they both take now additional parameters than those | |||
| specified in the hash filter method. Other hash functions of course | specified in the hash filter method. Other hash functions of course | |||
| could specify additional parameters. | could specify additional parameters. | |||
| 5.4. The Reporting | ||||
| The reporting subtree of managed objects provides information on | ||||
| collectors to which selected packets (sampled, filtered, or hashed) | ||||
| are exported and they allow to configure collectors. The group | ||||
| contains two tables, the psampCollectorTable and the | ||||
| psampCollectorGroupTable. | ||||
| Each entry in the psampCollectorTable specifies a collector by its IP | ||||
| address, used transport protocol and port number. Also it contains | ||||
| the number of reports sent to this collector. The default transport | ||||
| protocol is SCTP. | ||||
| The psampCollectorGroupTable groups one or more collectors to a set | ||||
| of collectors where sampled packets are sent to simultaneously. Thus | ||||
| reporting to more than one collector at the same time is possible. | ||||
| 5.5. The Base Associations | ||||
| The objects in the Base Asssociations subtree combine all the objects | ||||
| needed to model the measurement processes on the PSAMP device. It | ||||
| contains three tables, the psampBaseAssocTable, the | ||||
| psampSelectorListTable and the psampTemplateRecordTable. Each entry | ||||
| of the psampBaseAssocTable describes one measurement process on the | ||||
| PSAMP device. The observation point is given as a pointer to another | ||||
| object in psampBaseAssoceObservationPoint. This other object could | ||||
| be an entry in the mib-II interface table or any other interface | ||||
| point where you can observe packets. The | ||||
| psampBaseAssocTemplateRecordId gives the template record id used to | ||||
| link the data gathered in the metering process to an export format | ||||
| described in the information model of the PSAMP framework. The | ||||
| collectors where the data packets should be sent are specified by | ||||
| their index in the psampCollectorGroupTable. In addition the process | ||||
| id of the metering process and the process id of the exporting | ||||
| process used for this instance is saved in the instance table. Last | ||||
| but not least statistical values about the packets observed at the | ||||
| observation point, packets dropped during the metering process and | ||||
| the reports sent to the collectors are maintained. | ||||
| The psampSelectorListTable describes the concatenation of methods for | ||||
| a given Base Association. If concatenation of methods is not | ||||
| supported on the PSAMP device the table will hold exactly one entry | ||||
| per Base Association. | ||||
| The methods used for the metering process of an Base Association can | ||||
| be retrieved through the index given in the psampBaseAssocTable. The | ||||
| index of the Base Association table is also the first index in the | ||||
| psampSelectorListTable. So each method entry with the same (first) | ||||
| index as the Base Association is used to produce the data record for | ||||
| the reporting process. The second index is the running index for the | ||||
| method. The method itself is represented by a pointer (OID) to a | ||||
| parameter set. The methods are applied in the order given by this | ||||
| second index psampSelectorListIndex. Assume the following table: | ||||
| 1.4.4.1.2.5.1 = 1 (second index) | ||||
| 1.4.4.1.2.5.2 = 2 (second index) | ||||
| 1.4.4.1.3.5.1 = 1.3.6.1.2.1.XXX.1.1.2.3.1.10 | ||||
| (pointer to a parameter set psampSampTimeBasedParamSetTableEntry.10) | ||||
| 1.4.4.1.3.5.2 = 1.3.6.1.2.1.XXX.1.1.1.3.1.4 | ||||
| (pointer to a parameter set psampSampCountBasedParamSetTableEntry.4) | ||||
| 1.4.4.1.4.5.1 = xxx (status of the row) | ||||
| 1.4.4.1.4.5.2 = xxx (status of the row) | ||||
| This would mean that the method psampSampTimeBased with parameter set | ||||
| psampSampTimeBasedParamSetTableEntry.10 is applied prior to the | ||||
| method psampSampCountBased with parameter set | ||||
| psampSampCountBasedParamSetTableEntry.4 for the instance with index | ||||
| 5. | ||||
| In addition every entry in the selector list table contains two | ||||
| statistical values: the packets observed at the entry point of the | ||||
| method and the packets dropped by the method. | ||||
| The psampTemplateRecordTable lists all data template records that are | ||||
| used by the PSAMP exporter. It has two indexes. The first one is | ||||
| the template record id and the second one is just a running index for | ||||
| the information element ids listed in the table. So the | ||||
| psampTemplateRecordEntry.4.x will list all information element ids | ||||
| used for template record id 4 in the order given by x. | ||||
| 6. Definition | 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, DisplayString, RowStatus, TruthValue | TEXTUAL-CONVENTION, DateAndTime, 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 | |||
| InterfaceIndexOrZero | InterfaceIndexOrZero | |||
| FROM IF-MIB -- RFC2863 | FROM IF-MIB -- RFC2863 | |||
| InetAddressType, InetAddress, InetAutonomousSystemNumber | InetAddressType, InetAddress, InetAutonomousSystemNumber | |||
| FROM INET-ADDRESS-MIB; -- RFC3291 | FROM INET-ADDRESS-MIB -- RFC3291 | |||
| PsampMethodAvailability, ipfixMIB, ipfixGroupMetering, | ||||
| ipfixGroupReporting | ||||
| FROM IPFIX-EXPORTER-MIB; | ||||
| psampMIB MODULE-IDENTITY | psampMIB MODULE-IDENTITY | |||
| LAST-UPDATED "200502181600Z" -- 18 February 2005 | LAST-UPDATED "200606221200Z" -- 22 June 2006 | |||
| 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 14, line 43 ¶ | skipping to change at page 10, line 48 ¶ | |||
| 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. | |||
| and filtering techniques for IP packet selection. These | These objects provide information about managed nodes | |||
| objects provide information about managed nodes supporting | supporting packet sampling, including packet sampling | |||
| packet sampling, including packet sampling capabilities, | capabilities, configuration and statistics. | |||
| configuration and statistics. They also allow to configure | ||||
| packet sampling and filtering concerning the observation | ||||
| point at which packets are sampled, the packet selections | ||||
| methods used for sampling and filtering, and the collector | ||||
| to which packet samples are exported. | ||||
| Copyright (C) The Internet Society (2005). This version | Copyright (C) The Internet Society (2006). 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 "200502181600Z" -- 18 February 2005 | REVISION "200606221200Z" -- 22 June 2006 | |||
| 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 4937 } | ::= { ipfixMIB 3 } | |||
| -- XXX to be assigned by IANA. | ||||
| -- Textual Conventions | ||||
| PsampMethodAvailability ::= TEXTUAL-CONVENTION | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "Used to report the availability of a packet selection | ||||
| method: | ||||
| available (1) - the method is available on the PSAMP | ||||
| device | ||||
| notAvailable (2) - the method is not available on the | ||||
| PSAMP device" | ||||
| SYNTAX INTEGER { | ||||
| available(1), | ||||
| notAvailable(2) | ||||
| } | ||||
| -- Top level structure of the MIB | -- 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 | |||
| --================================================================== | --================================================================== | |||
| skipping to change at page 16, line 4 ¶ | skipping to change at page 11, line 35 ¶ | |||
| -- Packet selection sampling methods group of objects | -- Packet selection sampling methods group of objects | |||
| --================================================================== | --================================================================== | |||
| psampSamplingMethods OBJECT IDENTIFIER ::= { psampObjects 1 } | psampSamplingMethods OBJECT IDENTIFIER ::= { psampObjects 1 } | |||
| --================================================================== | --================================================================== | |||
| --* 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 | |||
| "This object indicates the availability of the trivial | "When retrieved, this object indicates the availability of | |||
| method of selecting all packets." | the trivial method of selecting all packets." | |||
| DEFVAL { notAvailable } | DEFVAL { available } | |||
| ::= { 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 | |||
| "This object indicates the availability of systematic | "When retrieved, this object indicates the availability of | |||
| count-based sampling at the managed node." | systematic 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 | |||
| "This object indicates the maximum number that can be | "When retrieved, this object indicates the maximum number | |||
| specified for the sampling interval. Sampling means, that | that can be specified for the sampling interval." | |||
| all packets that arrive in this interval are selected. | ||||
| The interval is given in number of packets." | ||||
| ::= { psampSampCountBasedCap 1 } | ::= { psampSampCountBasedCap 1 } | |||
| psampSampCountBasedMinSpacing OBJECT-TYPE | psampSampCountBasedMaxSpacing OBJECT-TYPE | |||
| SYNTAX Unsigned32 | SYNTAX Unsigned32 | |||
| UNITS "packets" | UNITS "number of packets" | |||
| MAX-ACCESS read-only | MAX-ACCESS read-only | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates the minimum number that can be | "When retrieved, this object indicates the maximum number | |||
| specified for the sampling spacing. The spacing parameter | that can be specified for the sampling spacing." | |||
| defines the spacing 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 | |||
| skipping to change at page 17, line 48 ¶ | skipping to change at page 13, line 27 ¶ | |||
| 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampSampCountBasedParamSetTable. 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 "packets" | UNITS "number of packets" | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object specifies the sampling interval for systematic | "When retrieved, this object specifies the sampling interval | |||
| count-based sampling. Sampling means, that all packets that | for systematic count-based sampling." | |||
| arrive in this interval are selected. The interval is | ||||
| given in number of packets." | ||||
| REFERENCE | REFERENCE | |||
| "PSAMP-SAMPLE-TECH, Section 5.1" | "PSAMP-SAMPLE-TECH, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampSampCountBasedParamSetEntry 2 } | ::= { psampSampCountBasedParamSetEntry 2 } | |||
| psampSampCountBasedSpacing OBJECT-TYPE | psampSampCountBasedSpacing OBJECT-TYPE | |||
| SYNTAX Unsigned32 | SYNTAX Unsigned32 | |||
| UNITS "packets" | UNITS "number of packets" | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object specifies the sampling spacing for systematic | "When retrieved, this object specifies the sampling spacing | |||
| count-based sampling. The spacing parameter defines the | for systematic count-based sampling." | |||
| spacing 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-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- 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 19, line 4 ¶ | skipping to change at page 14, line 21 ¶ | |||
| 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 } | |||
| --================================================================== | --================================================================== | |||
| --* 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 | |||
| "This object indicates the availability of systematic | "When retrieved, this object indicates the availability of | |||
| time-based sampling at the managed node." | systematic 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 "micro-seconds" | UNITS "microseconds" | |||
| MAX-ACCESS read-only | MAX-ACCESS read-only | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates the maximum number that can be | "When retrieved, this object indicates the maximum number | |||
| specified for the sampling interval. Sampling means, that | that can be specified for the sampling interval." | |||
| all packets that arrive in an interval are selected. The | ||||
| interval is given in micro-seconds." | ||||
| ::= { psampSampTimeBasedCap 1 } | ::= { psampSampTimeBasedCap 1 } | |||
| psampSampTimeBasedMinSpacing OBJECT-TYPE | psampSampTimeBasedMaxSpacing OBJECT-TYPE | |||
| SYNTAX Unsigned32 | SYNTAX Unsigned32 | |||
| UNITS "micro-seconds" | UNITS "microseconds" | |||
| MAX-ACCESS read-only | MAX-ACCESS read-only | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates the minimum number that can be | "When retrieved, this object indicates the maximum number | |||
| specified for the sampling spacing. The spacing parameter | that can be specified for the sampling spacing." | |||
| defines the spacing in micro-seconds 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 | |||
| skipping to change at page 20, line 34 ¶ | skipping to change at page 15, line 46 ¶ | |||
| 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampSampTimeBasedParameterSetTable. It is used in entries | |||
| of the psampInstanceTable as reference to this parameter | ||||
| The value is expected to remain constant at least from one | 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 "micro-seconds" | UNITS "microseconds" | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object specifies a sampling interval for systematic | "When retrieved, this object specifies a sampling interval | |||
| time-based sampling. Sampling means, that all packets that | for systematic time-based sampling." | |||
| arrive in this interval are selected. The interval is | ||||
| given in micro-seconds." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampSampTimeBasedParamSetEntry 2 } | ::= { psampSampTimeBasedParamSetEntry 2 } | |||
| psampSampTimeBasedSpacing OBJECT-TYPE | psampSampTimeBasedSpacing OBJECT-TYPE | |||
| SYNTAX Unsigned32 | SYNTAX Unsigned32 | |||
| UNITS "micro-seconds" | UNITS "microseconds" | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object specifies a sampling spacing for systematic | "When retrieved, this object specifies a sampling spacing | |||
| time-based sampling. The spacing parameter defines the | for systematic time-based sampling." | |||
| spacing in micro-seconds between the end of one sampling | ||||
| interval and the start of the next succeeding interval." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- 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 21, line 46 ¶ | skipping to change at page 16, line 50 ¶ | |||
| --* 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 | |||
| "This object indicates the availability of random | "When retrieved, this object indicates the availability of | |||
| n-out-of-N sampling at the managed node." | random 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 "packets" | UNITS "number of packets" | |||
| MAX-ACCESS read-only | MAX-ACCESS read-only | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates the maximum number of packets that | "When retrieved, this object indicates the maximum number | |||
| can be specified for the population size." | that can be specified for the population size." | |||
| ::= { psampSampRandOutOfNCap 1 } | ::= { psampSampRandOutOfNCap 1 } | |||
| psampSampRandOutOfNMaxSample OBJECT-TYPE | ||||
| SYNTAX Unsigned32 | ||||
| UNITS "number of packets" | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "When retrieved, this object indicates 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 two parameters: the population size and the | contains a single parameter only: the sampling rate." | |||
| 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 psampSampRandOutOfNParamSetTable." | "Defines an entry in the psampSampRandOutOfNParamSetTable." | |||
| INDEX { psampSampRandOutOfNIndex } | INDEX { psampSampRandOutOfNIndex } | |||
| ::= { psampSampRandOutOfNParamSetTable 1 } | ::= { psampSampRandOutOfNParamSetTable 1 } | |||
| skipping to change at page 23, line 5 ¶ | skipping to change at page 18, line 18 ¶ | |||
| psampSampRandOutOfNPopulation Unsigned32, | psampSampRandOutOfNPopulation Unsigned32, | |||
| psampSampRandOutOfNSample 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampSampRandOutOfNParamSetTable. 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 | |||
| "This object specifies the number of packets in the parent | "When retrieved, this object specifies the number of elements | |||
| population of the sampling algorithm." | in the parent population of the sampling algorithm." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampSampRandOutOfNParamSetEntry 2 } | ::= { psampSampRandOutOfNParamSetEntry 2 } | |||
| psampSampRandOutOfNSample 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 | |||
| "This object specifies the number of packets that are | "When retrieved, this object specifies the number of | |||
| sampled from the parent population of the sampling | elements that are sampled from the parent population of the | |||
| algorithm." | sampling algorithm." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- 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 } | |||
| skipping to change at page 24, line 14 ¶ | skipping to change at page 19, line 20 ¶ | |||
| --* 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 | |||
| "This object indicates the availability of uniform | "When retrieved, this object indicates the availability of | |||
| probabilistic sampling at the managed node." | random uniform 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 ++++++++++++++++++++++++++++++++++++++++++++++++++++ | |||
| -- 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 uniform probabilistic | "This table lists configurations of random probabilistic | |||
| sampling. A parameter set describing a configuration | sampling. A parameter set describing a configuration | |||
| contains a single parameter only: the sampling | contains a single parameter only: the sampling rate." | |||
| 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 psampSampUniProbParamSetTable." | "Defines an entry in the psampSampUniProbParamSetTable." | |||
| INDEX { psampSampUniProbIndex } | INDEX { psampSampUniProbIndex } | |||
| ::= { psampSampUniProbParamSetTable 1 } | ::= { psampSampUniProbParamSetTable 1 } | |||
| skipping to change at page 25, line 4 ¶ | skipping to change at page 20, line 10 ¶ | |||
| DESCRIPTION | DESCRIPTION | |||
| "Defines an entry in the psampSampUniProbParamSetTable." | "Defines an entry in the 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampSampUniProbParameterSetTable. 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 | |||
| "This object gives the probability that a packet is sampled. | "When retrieved, this object specifies the number of | |||
| The probability is equal for every packet. The given value | elements in the parent population of the sampling | |||
| must be divided by 4294967295 (=2^32-1), so a value of 0 | algorithm." | |||
| 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-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- 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 } | |||
| skipping to change at page 26, line 4 ¶ | skipping to change at page 20, line 49 ¶ | |||
| 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 | |||
| "This object indicates the availability of non-uniform | "When retrieved, this object indicates the availability of | |||
| probabilistic sampling at the managed node." | random non-uniform probabilistic sampling at the managed | |||
| 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 non-uniform | "This table lists configurations of random probabilistic | |||
| probabilistic sampling. A parameter set describing a | sampling. A parameter set describing a configuration | |||
| configuration contains two parameter: a pointer to a | contains a single parameter only: the sampling rate." | |||
| 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 psampSampNonUniProbParamSetTable." | "Defines an entry in the psampSampNonUniProbParamSetTable." | |||
| INDEX { psampSampNonUniProbIndex } | INDEX { psampSampNonUniProbIndex } | |||
| ::= { psampSampNonUniProbParamSetTable 1 } | ::= { psampSampNonUniProbParamSetTable 1 } | |||
| skipping to change at page 27, line 5 ¶ | skipping to change at page 21, line 49 ¶ | |||
| psampSampNonUniProbFunction OBJECT IDENTIFIER, | psampSampNonUniProbFunction OBJECT IDENTIFIER, | |||
| psampSampNonUniProbFuncParam 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampSampNonUniProbParameterSetTable. It is used in entries | |||
| of the psampInstanceTable as reference to this parameter | ||||
| The value is expected to remain constant at least from one | 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." | ||||
| ::= { 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 | |||
| "This object specifies the function that is used to compute | "When retrieved, this object specifies the function that is | |||
| the probability for sampling." | used to compute the probability for sampling." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampSampNonUniProbParamSetEntry 2 } | ::= { psampSampNonUniProbParamSetEntry 2 } | |||
| psampSampNonUniProbFuncParam OBJECT-TYPE | psampSampNonUniProbFuncParam OBJECT-TYPE | |||
| SYNTAX OBJECT IDENTIFIER | SYNTAX OBJECT IDENTIFIER | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object specifies the parameters set for the function | "When retrieved, this object specifies the parameter set for | |||
| specified with psampSampNonUniProbFunction that is used to | the function specified with psampSampNonUniProbFunction | |||
| compute the probability for sampling." | that is used to compute the probability for sampling." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampSampNonUniProbParamSetEntry 3 } | ::= { 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 4 } | ::= { psampSampNonUniProbParamSetEntry 4 } | |||
| skipping to change at page 28, line 4 ¶ | skipping to change at page 22, line 43 ¶ | |||
| 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 4 } | ::= { 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 | |||
| "This object indicates the availability of flow state | "When retrieved, this object indicates the availability of | |||
| sampling at the managed node." | flow state 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 flow state sampling. A | "This table lists configurations of random probabilistic | |||
| parameter set describing a configuration contains two | sampling. A parameter set describing a configuration | |||
| parameter: a pointer to a flow state function and a pointer | contains a single parameter only: the sampling rate." | |||
| 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 psampSampFlowStateParamSetTable." | "Defines an entry in the psampSampFlowStateParamSetTable." | |||
| INDEX { psampSampFlowStateIndex } | INDEX { psampSampFlowStateIndex } | |||
| ::= { psampSampFlowStateParamSetTable 1 } | ::= { psampSampFlowStateParamSetTable 1 } | |||
| skipping to change at page 29, line 6 ¶ | skipping to change at page 23, line 45 ¶ | |||
| psampSampFlowStateFunction OBJECT IDENTIFIER, | psampSampFlowStateFunction OBJECT IDENTIFIER, | |||
| psampSampFlowStateFuncParam 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampSampFlowStateParameterSetTable. It is used in entries | |||
| of the psampInstanceTable as reference to this parameter | ||||
| The value is expected to remain constant at least from one | 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." | ||||
| ::= { 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 | |||
| "This object specifies the function that is used to check | "When retrieved, this object specifies the function that is | |||
| the flow state for sampling." | used to check the flow state for sampling." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampSampFlowStateParamSetEntry 2 } | ::= { psampSampFlowStateParamSetEntry 2 } | |||
| psampSampFlowStateFuncParam OBJECT-TYPE | psampSampFlowStateFuncParam OBJECT-TYPE | |||
| SYNTAX OBJECT IDENTIFIER | SYNTAX OBJECT IDENTIFIER | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object specifies the parameter set for the function | "When retrieved, this object specifies the parameter set for | |||
| specified with psampSampFlowStateFunction that is used to | the function specified with psampSampFlowStateFunction that | |||
| determine the packet that is to be sampled." | is used to determine the packet that is to be sampled." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampSampFlowStateParamSetEntry 3 } | ::= { 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 4 } | ::= { psampSampFlowStateParamSetEntry 4 } | |||
| skipping to change at page 30, line 19 ¶ | skipping to change at page 25, line 5 ¶ | |||
| --* Method 0: Match filtering | --* Method 0: Match filtering | |||
| --================================================================== | --================================================================== | |||
| psampFilterMatch OBJECT IDENTIFIER ::= { psampFilteringMethods 0 } | psampFilterMatch OBJECT IDENTIFIER ::= { psampFilteringMethods 0 } | |||
| psampFilterMatchAvail OBJECT-TYPE | psampFilterMatchAvail OBJECT-TYPE | |||
| SYNTAX PsampMethodAvailability | SYNTAX PsampMethodAvailability | |||
| MAX-ACCESS read-only | MAX-ACCESS read-only | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates the availability of match filtering | "When retrieved, this object indicates the availability of | |||
| at the managed node." | match filtering at the managed node." | |||
| DEFVAL { notAvailable } | DEFVAL { notAvailable } | |||
| ::= { psampFilterMatch 1 } | ::= { psampFilterMatch 1 } | |||
| -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ | -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ | |||
| -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ | -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ | |||
| psampFilterMatchParamSetTable OBJECT-TYPE | psampFilterMatchParamSetTable OBJECT-TYPE | |||
| SYNTAX SEQUENCE OF | SYNTAX SEQUENCE OF | |||
| PsampFilterMatchParamSetEntry | PsampFilterMatchParamSetEntry | |||
| MAX-ACCESS not-accessible | MAX-ACCESS not-accessible | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This table lists configurations of match filtering. The | "This table lists configurations of match filtering. The | |||
| match filtering is based on the IPFIX/PSAMP Information | match filtering is based on the IPFIX/PSAMP Information | |||
| Elements. The parameter set contains the Information | Elements. The parameter set contains the Field Id, a value | |||
| Element Id, a value or value range and a mask." | or value range and a mask." | |||
| ::= { psampFilterMatch 3 } | ::= { psampFilterMatch 3 } | |||
| psampFilterMatchParamSetEntry OBJECT-TYPE | psampFilterMatchParamSetEntry OBJECT-TYPE | |||
| SYNTAX PsampFilterMatchParamSetEntry | SYNTAX PsampFilterMatchParamSetEntry | |||
| MAX-ACCESS not-accessible | MAX-ACCESS not-accessible | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "Defines an entry in the psampFilterMatchParamSetTable." | "Defines an entry in the psampFilterMatchParamSetTable." | |||
| INDEX { psampFilterMatchIndex } | INDEX { psampFilterMatchIndex } | |||
| ::= { psampFilterMatchParamSetTable 1 } | ::= { psampFilterMatchParamSetTable 1 } | |||
| PsampFilterMatchParamSetEntry ::= | PsampFilterMatchParamSetEntry ::= | |||
| SEQUENCE { | SEQUENCE { | |||
| psampFilterMatchIndex Integer32, | psampFilterMatchIndex Integer32, | |||
| psampFilterMatchInfoElementId Integer32, | psampFilterMatchFieldId Integer32, | |||
| psampFilterMatchStartValue OCTET STRING, | psampFilterMatchStartValue OCTET STRING, | |||
| psampFilterMatchEndValue OCTET STRING, | psampFilterMatchStopValue OCTET STRING, | |||
| psampFilterMatchMask OCTET STRING, | psampFilterMatchMask OCTET STRING, | |||
| psampFilterMatchRowStatus RowStatus | psampFilterMatchRowStatus RowStatus | |||
| } | } | |||
| psampFilterMatchIndex 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampFilterMatchParameterSetTable. 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." | ||||
| ::= { psampFilterMatchParamSetEntry 1 } | ::= { psampFilterMatchParamSetEntry 1 } | |||
| psampFilterMatchInfoElementId OBJECT-TYPE | psampFilterMatchFieldId OBJECT-TYPE | |||
| SYNTAX Integer32 (1..2147483647) | SYNTAX Integer32 (1..2147483647) | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The id of the information element that is encoded as the | "The id of the field that is encoded as the FieldId defined | |||
| InfoElementId defined in the IPFIX/PSAMP Information | in the IPFIX/PSAMP Information Models." | |||
| Models." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1, ipfix and | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, ipfix and | |||
| psamp info model!!" | psamp info model!!" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterMatchParamSetEntry 2 } | ::= { psampFilterMatchParamSetEntry 2 } | |||
| psampFilterMatchStartValue OBJECT-TYPE | psampFilterMatchStartValue OBJECT-TYPE | |||
| SYNTAX OCTET STRING | SYNTAX OCTET STRING | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The value of the information element or the start of the | "The value of the field or the start of the value range if | |||
| value range. If psampFilterMatchEndValue is defined then | psampFilterMatchStopValue is not equal to this value. The | |||
| this value is the start value of a value range. If | data type and its encoding is the same as in PSAMP-PROTO." | |||
| psampFilterMatchMask is defined then | ||||
| psampFilterMatchEndValue is ignored. In this case the | ||||
| packet is selected if the masked value exactly matches the | ||||
| start value psampFilterMatchStartValue. The data type and | ||||
| its encoding is the same as in PSAMP-PROTO." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1, PROTO!!" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterMatchParamSetEntry 3 } | ::= { psampFilterMatchParamSetEntry 3 } | |||
| psampFilterMatchEndValue OBJECT-TYPE | psampFilterMatchStopValue OBJECT-TYPE | |||
| SYNTAX OCTET STRING | SYNTAX OCTET STRING | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The final value of a value range. It should be equal to | "The final value of a value range. It should be equal to | |||
| it's default value (''H) if a single value should be | psampFilterMatchStartValue if a single value should be | |||
| encoded. It is ignored if psampFilterMatchMask is defined. | encoded. The data type and its encoding is the same as in | |||
| The data type and its encoding is the same as in | PSAMP-PROTO." | |||
| PSAMP-PROTO." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1, PROTO!!" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| DEFVAL { ''H } | ||||
| ::= { psampFilterMatchParamSetEntry 4 } | ::= { psampFilterMatchParamSetEntry 4 } | |||
| psampFilterMatchMask OBJECT-TYPE | psampFilterMatchMask OBJECT-TYPE | |||
| SYNTAX OCTET STRING | SYNTAX OCTET STRING | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The selected value of the given information element is | "The value of the field is a mask like the netmask for IP | |||
| masked with this value. The resulting value is compared to | addresses if this is applicable for the given field Id | |||
| psampFilterMatchStartValue and the packet is selected if | psampFilterMatchFieldId or empty if not. The data type and | |||
| they match. If psampFilterMatchEndValue and | its encoding is the same as in PSAMP-PROTO." | |||
| psampFilterMatchMask are defined at the same time | ||||
| psampFilterMatchEndValue is ignored. Note that a mask does | ||||
| not make sense for all information elements and if it is | ||||
| specified the mask has the same data type and encoding as | ||||
| the information element referenced by the | ||||
| psampFilterMatchInfoElementId." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1, PROTO!!" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| DEFVAL { ''H } | DEFVAL { ''H } | |||
| ::= { psampFilterMatchParamSetEntry 5 } | ::= { psampFilterMatchParamSetEntry 5 } | |||
| psampFilterMatchRowStatus OBJECT-TYPE | 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." | |||
| skipping to change at page 33, line 19 ¶ | skipping to change at page 27, line 33 ¶ | |||
| --* 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 | |||
| "This object indicates the availability of hash filtering | "When retrieved, this object indicates the availability of | |||
| at the managed node." | hash filtering 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 +++++++++++++++++++++++++++++++++++++++++++++ | |||
| skipping to change at page 34, line 26 ¶ | skipping to change at page 28, line 39 ¶ | |||
| psampFilterHashOutputMask OCTET STRING, | psampFilterHashOutputMask OCTET STRING, | |||
| psampFilterHashSelection DisplayString, | 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampFilterHashParamSetTable. 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 | psampFilterHashAddrType OBJECT-TYPE | |||
| SYNTAX InetAddressType | SYNTAX InetAddressType | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The address type the hash function is applied to (either | "The address type the hash function is applied to (either | |||
| IPv4 or IPv6 packets). If a hash function applies to both | IPv4 or IPv6 packets)." | |||
| IPv4 and IPv6 addresses two entries in this table are | ||||
| needed." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterHashParamSetEntry 2 } | ::= { psampFilterHashParamSetEntry 2 } | |||
| psampFilterHashHeaderBits OBJECT-TYPE | psampFilterHashHeaderBits OBJECT-TYPE | |||
| SYNTAX OCTET STRING (SIZE (40)) | SYNTAX OCTET STRING (SIZE (40)) | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The object specifies the header bits of the layer 3 header | "The object specifies the header bits used for hashing. The | |||
| used for hashing. The size is 40 bytes but when | size is 40 bytes but when psampFilterHashAddrType is IPv4 | |||
| psampFilterHashAddrType is IPv4 then only the first 20 | then only the first 20 bytes are used." | |||
| bytes are used." | ||||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterHashParamSetEntry 3 } | ::= { psampFilterHashParamSetEntry 3 } | |||
| psampFilterHashPayloadBytes OBJECT-TYPE | psampFilterHashPayloadBytes OBJECT-TYPE | |||
| SYNTAX Integer32 (0..2147483647) | SYNTAX Integer32 (0..2147483647) | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The number of bytes of payload used as input to the hash | "The number of bytes of payload used as input to the hash | |||
| function." | function." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterHashParamSetEntry 4 } | ::= { psampFilterHashParamSetEntry 4 } | |||
| psampFilterHashPayloadBits OBJECT-TYPE | psampFilterHashPayloadBits OBJECT-TYPE | |||
| SYNTAX OCTET STRING | SYNTAX OCTET STRING | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The object specifies the payload bits used for hashing. The | "The object specifies the payload bits used for hashing. The | |||
| size depends on the value of psampFilterHashPayloadBytes." | size depends on the value of psampFilterHashPayloadBytes." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterHashParamSetEntry 5 } | ::= { 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 | |||
| "This object specifies the hash function executed by the | "When retrieved, this object specifies the the hash function | |||
| current filtering method." | executed by the current filtering method." | |||
| ::= { psampFilterHashParamSetEntry 6 } | ::= { psampFilterHashParamSetEntry 6 } | |||
| psampFilterHashFuncParam OBJECT-TYPE | psampFilterHashFuncParam OBJECT-TYPE | |||
| SYNTAX OBJECT IDENTIFIER | SYNTAX OBJECT IDENTIFIER | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object specifies the parameters used in addition to | "When retrieved, this object specifies the the paramters | |||
| those specified in this table." | used in addition to those specified in this table." | |||
| ::= { psampFilterHashParamSetEntry 7 } | ::= { psampFilterHashParamSetEntry 7 } | |||
| psampFilterHashInputBits OBJECT-TYPE | psampFilterHashInputBits OBJECT-TYPE | |||
| SYNTAX Integer32 (1..2147483647) | SYNTAX Integer32 (1..2147483647) | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The number of bits used as input key to the hash function. | "The number of bits used as input key to the hash function. | |||
| Usually this should be in the form of 2^x." | Usually this should be in the form of 2^x." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterHashParamSetEntry 8 } | ::= { psampFilterHashParamSetEntry 8 } | |||
| psampFilterHashOutputBits OBJECT-TYPE | psampFilterHashOutputBits OBJECT-TYPE | |||
| SYNTAX Integer32 (1..2147483647) | SYNTAX Integer32 (1..2147483647) | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The number of bits that form the output value of the hash | "The number of bits that form the output value of the hash | |||
| function." | function. Usually this should be in the form of 2^x." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterHashParamSetEntry 9 } | ::= { psampFilterHashParamSetEntry 9 } | |||
| psampFilterHashOutputMask OBJECT-TYPE | psampFilterHashOutputMask OBJECT-TYPE | |||
| SYNTAX OCTET STRING | SYNTAX OCTET STRING | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "The mask applied to the output bits of the hash function. | "The mask applied to the output bits of the hash function. | |||
| If less hash values are needed the number of hashes can be | If less hash values are needed the number of hashes can be | |||
| reduced by masking the output value. The size is dependent | reduced by masking the output value. The size is dependent | |||
| on the number of output bits. If the output mask is empty | on the number of output bits. If the output mask is empty | |||
| then no mask is applied." | then no mask is applied." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| DEFVAL { ''H } | DEFVAL { ''H } | |||
| ::= { psampFilterHashParamSetEntry 10 } | ::= { psampFilterHashParamSetEntry 10 } | |||
| psampFilterHashSelection OBJECT-TYPE | psampFilterHashSelection OBJECT-TYPE | |||
| SYNTAX DisplayString | SYNTAX DisplayString | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object represents the hash values that select a | "This object represents the hash values that select a | |||
| packet. It is represented in a human readable form. The | packet. It is represented in a human readable form. The | |||
| only allowed characters are [0-9a-f,-x]. A single hash | only allowed characters are [0-9a-f,-x]. A single hash | |||
| value is represented by its decimal ASCII notation or if | value is represented by its decimal ASCII notation or if | |||
| prefixed with 0x by its hexadecimal ASCII notation. A range | prefixed with 0x by its hexadecimal ASCII notation. A range | |||
| can be given by hash_value - hash_value and several single | can be given by hash_value - hash_value and several single | |||
| values or ranges are separated by , (comma). The ASCII | values or ranges are separated by , (comma). So, if you | |||
| string is defined as follows: | with to select hash values 0, 5 - 10 and 250-255 you could | |||
| specify: 0,5-10,0xfa-0xff" | ||||
| 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 | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterHashParamSetEntry 11 } | ::= { 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 12 } | ::= { psampFilterHashParamSetEntry 12 } | |||
| skipping to change at page 37, line 47 ¶ | skipping to change at page 31, line 45 ¶ | |||
| --* 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 | |||
| "This object indicates the availability of router state | "When retrieved, this object indicates the availability of | |||
| filtering at the managed node." | router state 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 router state filtering. | "This table lists configurations of router state filtering. | |||
| A parameter set describing a configuration contains six | A parameter set describing a configuration contains six | |||
| skipping to change at page 38, line 39 ¶ | skipping to change at page 32, line 36 ¶ | |||
| INDEX { psampFilterRStateIndex } | INDEX { psampFilterRStateIndex } | |||
| ::= { psampFilterRStateParamSetTable 1 } | ::= { psampFilterRStateParamSetTable 1 } | |||
| PsampFilterRStateParamSetEntry ::= | PsampFilterRStateParamSetEntry ::= | |||
| SEQUENCE { | SEQUENCE { | |||
| psampFilterRStateIndex Integer32, | psampFilterRStateIndex Integer32, | |||
| psampFilterRStateFunction INTEGER, | psampFilterRStateFunction INTEGER, | |||
| psampFilterRStateNegate TruthValue, | psampFilterRStateNegate TruthValue, | |||
| psampFilterRStateIfIndex InterfaceIndexOrZero, | psampFilterRStateIfIndex InterfaceIndexOrZero, | |||
| psampFilterRStateStartAS InetAutonomousSystemNumber, | psampFilterRStateStartAS InetAutonomousSystemNumber, | |||
| psampFilterRStateEndAS InetAutonomousSystemNumber, | psampFilterRStateStopAS InetAutonomousSystemNumber, | |||
| psampFilterRStateVendorFunc OBJECT IDENTIFIER, | 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 locally arbitrary, but unique identifier of an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampFilterRStateParameterSetTable. | |||
| 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." | ||||
| ::= { psampFilterRStateParamSetEntry 1 } | ::= { psampFilterRStateParamSetEntry 1 } | |||
| psampFilterRStateFunction OBJECT-TYPE | psampFilterRStateFunction OBJECT-TYPE | |||
| SYNTAX INTEGER { | SYNTAX INTEGER { | |||
| other (1), | other (1), | |||
| ingressIf (2), | ingressIf (2), | |||
| egressIf (3), | egressIf (3), | |||
| aclViolation (4), | aclViolation (4), | |||
| rpfFailure (5), | rpfFailure (5), | |||
| noResources (6), | noResources (6), | |||
| skipping to change at page 39, line 33 ¶ | skipping to change at page 33, line 27 ¶ | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates which function is applied to the | "This object indicates which function is applied to the | |||
| router state. The validity of the following objects depends | router state. The validity of the following objects depends | |||
| on the function selected here. The psampFilterRStateIfIndex | on the function selected here. The psampFilterRStateIfIndex | |||
| is only valid if the function is ingressIf or egressIf. The | is only valid if the function is ingressIf or egressIf. The | |||
| psampFilterRstateStartAS/StopAS objects are only valid if | psampFilterRstateStartAS/StopAS objects are only valid if | |||
| the function is originAS or destAS. The | the function is originAS or destAS. The | |||
| psampFilterRStateVendor object is only valid if the function | psampFilterRStateVendor object is only valid if the function | |||
| other is chosen; in that case it points to a vendor specific | other is chosen. Then it point to a vendor specific | |||
| function." | function." | |||
| REFERENCE | REFERENCE | |||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" | |||
| -- Editor Note: get reference right! | -- Editor Note: get reference right! | |||
| ::= { psampFilterRStateParamSetEntry 2 } | ::= { psampFilterRStateParamSetEntry 2 } | |||
| psampFilterRStateNegate OBJECT-TYPE | psampFilterRStateNegate OBJECT-TYPE | |||
| SYNTAX TruthValue | SYNTAX TruthValue | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "If set to true this object will negate the output of the | "If set to true this object will negate the output of the | |||
| psampFilterRStateFunction." | psampFilterRStateFunction." | |||
| skipping to change at page 40, line 11 ¶ | skipping to change at page 34, line 4 ¶ | |||
| psampFilterRStateIfIndex OBJECT-TYPE | psampFilterRStateIfIndex OBJECT-TYPE | |||
| SYNTAX InterfaceIndexOrZero | SYNTAX InterfaceIndexOrZero | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "Used if the function is egressIf or ingressIf. Selects | "Used if the function is egressIf or ingressIf. Selects | |||
| the packet if the egressIf/ingressIf is the same as the | the packet if the egressIf/ingressIf is the same as the | |||
| interface indicated by this object. If the object is not | interface indicated by this object. If the object is not | |||
| used it contains a value of 0." | used it contains a value of 0." | |||
| DEFVAL { 0 } | DEFVAL { 0 } | |||
| ::= { psampFilterRStateParamSetEntry 4 } | ::= { psampFilterRStateParamSetEntry 4 } | |||
| psampFilterRStateStartAS OBJECT-TYPE | psampFilterRStateStartAS OBJECT-TYPE | |||
| SYNTAX InetAutonomousSystemNumber | SYNTAX InetAutonomousSystemNumber | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "Used if the function is originAS or destAS. Selects the | "Used if the function is originAS or destAS. Selects the | |||
| packet if the AS Number lies in the range of | packet if the AS Number lies in the range of | |||
| psampFilterRStateStartAS and psampFilterRStateEndAS. If | psampFilterRStateStartAS and psampFilterRStateStopAS. If | |||
| the object is not used it default to 0." | the object is not used it default to 0." | |||
| DEFVAL { 0 } | DEFVAL { 0 } | |||
| ::= { psampFilterRStateParamSetEntry 5 } | ::= { psampFilterRStateParamSetEntry 5 } | |||
| psampFilterRStateEndAS OBJECT-TYPE | psampFilterRStateStopAS OBJECT-TYPE | |||
| SYNTAX InetAutonomousSystemNumber | SYNTAX InetAutonomousSystemNumber | |||
| MAX-ACCESS read-create | MAX-ACCESS read-create | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "Used if the function is originAS or destAS. Selects the | "Used if the function is originAS or destAS. Selects the | |||
| packet if the AS Number lies in the range of | packet if the AS Number lies in the range of | |||
| psampFilterRStateStartAS and psampFilterRStateStopAS. If | psampFilterRStateStartAS and psampFilterRStateStopAS. If | |||
| psampFilterRStateStartAS is not 0 and this object is 0 then | psampFilterRStateStartAS is not 0 and this object is 0 then | |||
| the range is single value, the value given in | the range is single value, the value given in | |||
| psampFilterRStateStartAS." | psampFilterRStateStartAS." | |||
| skipping to change at page 41, line 30 ¶ | skipping to change at page 35, line 22 ¶ | |||
| --* Hash Function 0: IPSX | --* Hash Function 0: IPSX | |||
| --================================================================== | --================================================================== | |||
| psampHashIPSX OBJECT IDENTIFIER ::= { psampHashFunctions 0 } | psampHashIPSX OBJECT IDENTIFIER ::= { psampHashFunctions 0 } | |||
| psampHashIPSXAvail OBJECT-TYPE | psampHashIPSXAvail OBJECT-TYPE | |||
| SYNTAX PsampMethodAvailability | SYNTAX PsampMethodAvailability | |||
| MAX-ACCESS read-only | MAX-ACCESS read-only | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates the availability of the IPSX hash | "When retrieved, this object indicates the availability of | |||
| function at the managed node." | the IPSX hash function at the managed node." | |||
| DEFVAL { notAvailable } | DEFVAL { notAvailable } | |||
| ::= { psampHashIPSX 1 } | ::= { psampHashIPSX 1 } | |||
| -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ | -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ | |||
| -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ | -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ | |||
| psampHashIPSXParamSetTable OBJECT-TYPE | psampHashIPSXParamSetTable OBJECT-TYPE | |||
| SYNTAX SEQUENCE OF | SYNTAX SEQUENCE OF | |||
| PsampHashIPSXParamSetEntry | PsampHashIPSXParamSetEntry | |||
| skipping to change at page 42, line 23 ¶ | skipping to change at page 36, line 16 ¶ | |||
| SEQUENCE { | SEQUENCE { | |||
| psampHashIPSXIndex Integer32, | psampHashIPSXIndex Integer32, | |||
| psampHashIPSXRowStatus RowStatus | psampHashIPSXRowStatus RowStatus | |||
| } | } | |||
| psampHashIPSXIndex OBJECT-TYPE | psampHashIPSXIndex 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 an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampHashIPSXParameterSetTable. It is used in entries of | |||
| the psampFilterHashParamSetTable as reference to this | ||||
| The value is expected to remain constant at least from one | parameter set." | |||
| 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 } | ::= { psampHashIPSXParamSetEntry 1 } | |||
| psampHashIPSXRowStatus OBJECT-TYPE | psampHashIPSXRowStatus 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." | |||
| ::= { psampHashIPSXParamSetEntry 2 } | ::= { psampHashIPSXParamSetEntry 2 } | |||
| skipping to change at page 43, line 6 ¶ | skipping to change at page 36, line 41 ¶ | |||
| --* Hash Function 1: Bob | --* Hash Function 1: Bob | |||
| --================================================================== | --================================================================== | |||
| psampHashBob OBJECT IDENTIFIER ::= { psampHashFunctions 1 } | psampHashBob OBJECT IDENTIFIER ::= { psampHashFunctions 1 } | |||
| psampHashBobAvail OBJECT-TYPE | psampHashBobAvail OBJECT-TYPE | |||
| SYNTAX PsampMethodAvailability | SYNTAX PsampMethodAvailability | |||
| MAX-ACCESS read-only | MAX-ACCESS read-only | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "This object indicates the availability of the Bob hash | "When retrieved, this object indicates the availability of | |||
| function at the managed node." | the Bob hash function at the managed node." | |||
| DEFVAL { notAvailable } | DEFVAL { notAvailable } | |||
| ::= { psampHashBob 1 } | ::= { psampHashBob 1 } | |||
| -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ | -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ | |||
| -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ | -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ | |||
| psampHashBobParamSetTable OBJECT-TYPE | psampHashBobParamSetTable OBJECT-TYPE | |||
| SYNTAX SEQUENCE OF | SYNTAX SEQUENCE OF | |||
| PsampHashBobParamSetEntry | PsampHashBobParamSetEntry | |||
| skipping to change at page 43, line 48 ¶ | skipping to change at page 37, line 35 ¶ | |||
| SEQUENCE { | SEQUENCE { | |||
| psampHashBobIndex Integer32, | psampHashBobIndex Integer32, | |||
| psampHashBobRowStatus RowStatus | psampHashBobRowStatus RowStatus | |||
| } | } | |||
| psampHashBobIndex OBJECT-TYPE | psampHashBobIndex 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 an entry | "The index of this parameter set in the | |||
| in this parameter set table. | psampHashBobParameterSetTable. It is used in entries of the | |||
| psampFilterHashParamSetTable as reference to this parameter | ||||
| 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." | set." | |||
| ::= { psampHashBobParamSetEntry 1 } | ::= { psampHashBobParamSetEntry 1 } | |||
| psampHashBobRowStatus OBJECT-TYPE | psampHashBobRowStatus 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." | |||
| ::= { psampHashBobParamSetEntry 2 } | ::= { psampHashBobParamSetEntry 2 } | |||
| --================================================================== | --================================================================== | |||
| -- Reporting Group | ||||
| --================================================================== | ||||
| psampReporting OBJECT IDENTIFIER ::= { psampObjects 4 } | ||||
| -- Collector Table +++++++++++++++++++++++++++++++++++++++++++++++++ | ||||
| psampCollectorTable OBJECT-TYPE | ||||
| SYNTAX SEQUENCE OF PsampCollectorEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "This table lists collectors to which PSAMP selected | ||||
| packets are exported." | ||||
| ::= { psampReporting 1 } | ||||
| psampCollectorEntry OBJECT-TYPE | ||||
| SYNTAX PsampCollectorEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "Defines an entry in the psampCollectorTable." | ||||
| INDEX { psampCollectorIndex } | ||||
| ::= { psampCollectorTable 1 } | ||||
| PsampCollectorEntry ::= SEQUENCE { | ||||
| psampCollectorIndex Integer32, | ||||
| psampCollectorDstIpAddressType InetAddressType, | ||||
| psampCollectorDstIpAddress InetAddress, | ||||
| psampCollectorDstProtocol Integer32, | ||||
| psampCollectorDstPort Integer32, | ||||
| psampCollectorReportsSent Integer32, | ||||
| psampCollectorRowStatus RowStatus | ||||
| } | ||||
| psampCollectorIndex OBJECT-TYPE | ||||
| SYNTAX Integer32 (1..2147483647) | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The locally arbitrary, but unique identifier of an entry | ||||
| in this collector table. | ||||
| The value is expected to remain constant at least from one | ||||
| re-initialization of the entity's network management system | ||||
| to the next re-initialization. | ||||
| It is used in entries of the psampCollectorGroupTable as | ||||
| reference to this collector and its associated parameters." | ||||
| ::= { psampCollectorEntry 1 } | ||||
| psampCollectorDstIpAddressType OBJECT-TYPE | ||||
| SYNTAX InetAddressType | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The IP address type of the collector. The value for IPv4 | ||||
| is ipv4(1). The value for IPv6 is ipv6(2)." | ||||
| ::= { psampCollectorEntry 2 } | ||||
| psampCollectorDstIpAddress OBJECT-TYPE | ||||
| SYNTAX InetAddress | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The IP address of the collector." | ||||
| ::= { psampCollectorEntry 3 } | ||||
| psampCollectorDstProtocol OBJECT-TYPE | ||||
| SYNTAX Integer32 (0..256) | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The transport protocol used for exporting sampled packets | ||||
| to the collector. The recommended protocols are TCP (6), | ||||
| UDP (17) and SCTP (132). The default is SCTP." | ||||
| DEFVAL { 132 } | ||||
| ::= { psampCollectorEntry 4 } | ||||
| psampCollectorDstPort OBJECT-TYPE | ||||
| SYNTAX Integer32 (0..65535) | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The transport protocol port number of the collector." | ||||
| ::= { psampCollectorEntry 5 } | ||||
| psampCollectorReportsSent OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The number of packet reports sent to the collector." | ||||
| ::= { psampCollectorEntry 6 } | ||||
| psampCollectorRowStatus OBJECT-TYPE | ||||
| SYNTAX RowStatus | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The status of this row of the table." | ||||
| ::= { psampCollectorEntry 7 } | ||||
| -- Collector Group Table +++++++++++++++++++++++++++++++++++++++++++ | ||||
| psampCollectorGroupTable OBJECT-TYPE | ||||
| SYNTAX SEQUENCE OF PsampCollectorGroupEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "This table lists groups of collectors to which PSAMP | ||||
| selected packets are exported simultaneously. If PSAMP | ||||
| selected packets are exported to only one collector the | ||||
| group consists of exactly one collector." | ||||
| ::= { psampReporting 2 } | ||||
| psampCollectorGroupEntry OBJECT-TYPE | ||||
| SYNTAX PsampCollectorGroupEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "Defines an entry in the psampCollectorGroupTable." | ||||
| INDEX { psampCollectorGroupIndex, psampCollectorIndex } | ||||
| ::= { psampCollectorGroupTable 1 } | ||||
| PsampCollectorGroupEntry ::= SEQUENCE { | ||||
| psampCollectorGroupIndex Integer32, | ||||
| psampCollectorGroupRowStatus RowStatus | ||||
| } | ||||
| psampCollectorGroupIndex OBJECT-TYPE | ||||
| SYNTAX Integer32 (1..2147483647) | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The locally arbitrary, but unique identifier of an entry | ||||
| in this parameter set table. | ||||
| The value is expected to remain constant at least from one | ||||
| re-initialization of the entity's network management system | ||||
| to the next re-initialization. | ||||
| It is used in entries of the psampBaseAssocTable as | ||||
| reference to this collector group and its associated | ||||
| parameters." | ||||
| ::= { psampCollectorGroupEntry 1 } | ||||
| psampCollectorGroupRowStatus OBJECT-TYPE | ||||
| SYNTAX RowStatus | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The status of this row of the table." | ||||
| ::= { psampCollectorGroupEntry 3 } | ||||
| -- (Data) Template Record Table | ||||
| psampTemplateRecordTable OBJECT-TYPE | ||||
| SYNTAX SEQUENCE OF PsampTemplateRecordEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "This table lists templates used by the exporter." | ||||
| ::= { psampReporting 3 } | ||||
| psampTemplateRecordEntry OBJECT-TYPE | ||||
| SYNTAX PsampTemplateRecordEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "Defines an entry in the psampTemplateTable." | ||||
| INDEX { psampTemplateRecordId, psampTemplateRecordIndex } | ||||
| ::= { psampTemplateRecordTable 1 } | ||||
| PsampTemplateRecordEntry ::= SEQUENCE { | ||||
| psampTemplateRecordId Integer32, | ||||
| psampTemplateRecordIndex Integer32, | ||||
| psampTemplateRecordInfoElementId Integer32, | ||||
| psampTemplateRecordRowStatus RowStatus | ||||
| } | ||||
| psampTemplateRecordId OBJECT-TYPE | ||||
| SYNTAX Integer32 (1..2147483647) | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The locally arbitrary, but unique identifier of an entry | ||||
| in this template record table. | ||||
| The value is expected to remain constant at least from one | ||||
| re-initialization of the entity's network management system | ||||
| to the next re-initialization. | ||||
| It is used in entries of the psampBaseAssocTable as | ||||
| reference to this template record and its associated | ||||
| parameters. It groups the information element ids in a | ||||
| template record." | ||||
| REFERENCE | ||||
| "draft-ietf-psamp-sample-tech-07.txt, Section 5.1" | ||||
| -- Editor Note: get reference right! | ||||
| ::= { psampTemplateRecordEntry 1 } | ||||
| psampTemplateRecordIndex OBJECT-TYPE | ||||
| SYNTAX Integer32 (1..2147483647) | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The locally arbitrary, but unique identifier of a | ||||
| information element id in the template record identified by | ||||
| psampTemplateRecordId. | ||||
| The value is expected to remain constant at least from one | ||||
| re-initialization of the entity's network management system | ||||
| to the next re-initialization. | ||||
| The psampTemplateRecordIndex specifies the order in which | ||||
| the informatation element ids are used in the template | ||||
| record." | ||||
| ::= { psampTemplateRecordEntry 2 } | ||||
| psampTemplateRecordInfoElementId OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The Information Element Id at position | ||||
| psampTemplateRecordIndex in the template | ||||
| psampTemplateRecordId. This implicitly gives the data type | ||||
| and state values that are exported." | ||||
| REFERENCE | ||||
| "draft-ietf-psamp-sample-tech-07.txt, IPFIX/PSAMP INFO MODEL" | ||||
| -- Editor Note: get reference right! | ||||
| ::= { psampTemplateRecordEntry 3 } | ||||
| psampTemplateRecordRowStatus OBJECT-TYPE | ||||
| SYNTAX RowStatus | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The status of this row of the table." | ||||
| ::= { psampTemplateRecordEntry 4 } | ||||
| --================================================================== | ||||
| -- Base Associations Group | ||||
| --================================================================== | ||||
| psampBaseAssociations OBJECT IDENTIFIER ::= { psampObjects 5 } | ||||
| psampBaseAssociationTable OBJECT-TYPE | ||||
| SYNTAX SEQUENCE OF PsampBaseAssociationEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "This table lists all base associations at the managed | ||||
| node." | ||||
| ::= { psampBaseAssociations 1 } | ||||
| psampBaseAssociationEntry OBJECT-TYPE | ||||
| SYNTAX PsampBaseAssociationEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "Defines an entry in the psampInstanceTable." | ||||
| INDEX { psampBaseAssocIndex } | ||||
| ::= { psampBaseAssociationTable 1 } | ||||
| PsampBaseAssociationEntry ::= SEQUENCE { | ||||
| psampBaseAssocIndex Integer32, | ||||
| psampBaseAssocObservationPoint OBJECT IDENTIFIER, | ||||
| psampBaseAssocTemplateRecordId Integer32, | ||||
| psampBaseAssocCollectorGrpIndex Integer32, | ||||
| psampBaseAssocPacketsObserved Integer32, | ||||
| psampBaseAssocPacketsDropped Integer32, | ||||
| psampBaseAssocMeteringProcessId Integer32, | ||||
| psampBaseAssocReportingProcessId Integer32, | ||||
| psampBaseAssocReportsSent Integer32, | ||||
| psampBaseAssocRowStatus RowStatus | ||||
| } | ||||
| psampBaseAssocIndex OBJECT-TYPE | ||||
| SYNTAX Integer32 (1..2147483647) | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The locally arbitrary, but unique identifier of the base | ||||
| associations. | ||||
| The value is expected to remain constant at least from one | ||||
| re-initialization of the entity's network management system | ||||
| to the next re-initialization." | ||||
| ::= { psampBaseAssociationEntry 1 } | ||||
| psampBaseAssocObservationPoint OBJECT-TYPE | ||||
| SYNTAX OBJECT IDENTIFIER | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The point where the packet is observed. If it is e.g, an | ||||
| interface it points to the mib-II object of the interface." | ||||
| ::= { psampBaseAssociationEntry 2 } | ||||
| psampBaseAssocTemplateRecordId OBJECT-TYPE | ||||
| SYNTAX Integer32 (1..2147483647) | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The Id of a template in the template table. This implies | ||||
| the knowledge about the method chain from the method chain | ||||
| table. Furthermore it links the instance, method chain | ||||
| (selector) and template together. | ||||
| The identified template is applied to the stream of | ||||
| filtered/sampled packets observed after applying the method | ||||
| chain at the observation point." | ||||
| ::= { psampBaseAssociationEntry 3 } | ||||
| psampBaseAssocCollectorGrpIndex OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The index of the collector group to which packet reports | ||||
| are sent." | ||||
| ::= { psampBaseAssociationEntry 4 } | ||||
| psampBaseAssocPacketsObserved OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The number of packets passing at the observation point." | ||||
| ::= { psampBaseAssociationEntry 5 } | ||||
| psampBaseAssocPacketsDropped OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The number of packets dropped while filtering/sampling | ||||
| packets due to lack of resources." | ||||
| ::= { psampBaseAssociationEntry 6 } | ||||
| psampBaseAssocMeteringProcessId OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The process id of the metering process used by this | ||||
| Base Association." | ||||
| ::= { psampBaseAssociationEntry 7 } | ||||
| psampBaseAssocReportingProcessId OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The process id of the reporting process used by this | ||||
| Base Association." | ||||
| ::= { psampBaseAssociationEntry 8 } | ||||
| psampBaseAssocReportsSent OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The number of packet reports on sampled packets sent to | ||||
| the collector." | ||||
| ::= { psampBaseAssociationEntry 9 } | ||||
| psampBaseAssocRowStatus OBJECT-TYPE | ||||
| SYNTAX RowStatus | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The status of this row of the table." | ||||
| ::= { psampBaseAssociationEntry 10 } | ||||
| -- Selector List Table ++++++++++++++++++++++++++++++++++++++++++++++ | ||||
| psampSelectorListTable OBJECT-TYPE | ||||
| SYNTAX SEQUENCE OF PsampSelectorListEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "This table contains lists of selectors and connects them | ||||
| to the base associations where they are applied to | ||||
| different observation points. The packets that are selected | ||||
| by the last selection method are then exported." | ||||
| ::= { psampBaseAssociations 4 } | ||||
| psampSelectorListEntry OBJECT-TYPE | ||||
| SYNTAX PsampSelectorListEntry | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "Defines an entry in the psampSelectorListTable." | ||||
| INDEX { psampBaseAssocIndex, psampSelectorListIndex } | ||||
| ::= { psampSelectorListTable 1 } | ||||
| PsampSelectorListEntry ::= SEQUENCE { | ||||
| psampSelectorListIndex Integer32, | ||||
| psampSelectorListMethod OBJECT IDENTIFIER, | ||||
| psampSelectorListPacketsObserved Integer32, | ||||
| psampSelectorListPacketsDropped Integer32, | ||||
| psampSelectorListRowStatus RowStatus | ||||
| } | ||||
| psampSelectorListIndex OBJECT-TYPE | ||||
| SYNTAX Integer32 (1..2147483647) | ||||
| MAX-ACCESS not-accessible | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The locally arbitrary, but unique identifier of an entry | ||||
| in this selector list table. | ||||
| The value is expected to remain constant at least from one | ||||
| re-initialization of the entity's network management system | ||||
| to the next re-initialization. | ||||
| It is used in entries of the psampBaseAssocTable as | ||||
| reference to this selector list and its associated | ||||
| parameters." | ||||
| ::= { psampSelectorListEntry 2 } | ||||
| psampSelectorListMethod OBJECT-TYPE | ||||
| SYNTAX OBJECT IDENTIFIER | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The selector used at a certain position in the selector | ||||
| list." | ||||
| ::= { psampSelectorListEntry 3 } | ||||
| psampSelectorListPacketsObserved OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The number of packets observed at the method entry point." | ||||
| ::= { psampSelectorListEntry 4 } | ||||
| psampSelectorListPacketsDropped OBJECT-TYPE | ||||
| SYNTAX Integer32 | ||||
| MAX-ACCESS read-only | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The number of packets dropped due to lack of resources by | ||||
| this selection method." | ||||
| ::= { psampSelectorListEntry 5 } | ||||
| psampSelectorListRowStatus OBJECT-TYPE | ||||
| SYNTAX RowStatus | ||||
| MAX-ACCESS read-create | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "The status of this row of the table." | ||||
| ::= { psampSelectorListEntry 6 } | ||||
| --================================================================== | ||||
| -- Conformance information | -- 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 | |||
| "An implementation that complies to this module must | "An implementation that complies to this module must | |||
| implement the objects defined in the mandatory groups | implement the objects defined in the mandatory groups | |||
| psampGroupMetering and psampGroupReporting. The | ipfixGroupMetering and ipfixGroupReporting. The | |||
| implementation of all other objects depends on the | implementation of all other objects depends on the | |||
| implementation of the corresponding functionality in the | implementation of the corresponding functionality in the | |||
| equipment." | equipment." | |||
| MODULE -- this module | MODULE -- this module | |||
| MANDATORY-GROUPS { | MANDATORY-GROUPS { | |||
| psampGroupMetering, | psampGroupSelectAll, | |||
| psampGroupReporting | ipfixGroupMetering, | |||
| ipfixGroupReporting | ||||
| } | } | |||
| GROUP psampGroupSampCountBased | GROUP psampGroupSampCountBased | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| sampling function is implemented in the equipment." | sampling function is implemented in the equipment." | |||
| GROUP psampGroupSampTimeBased | GROUP psampGroupSampTimeBased | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| sampling function is implemented in the equipment." | sampling function is implemented in the equipment." | |||
| GROUP psampGroupSampRandOutOfN | GROUP psampGroupSampRandOutOfN | |||
| skipping to change at page 55, line 4 ¶ | skipping to change at page 39, line 6 ¶ | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| sampling function is implemented in the equipment." | sampling function is implemented in the equipment." | |||
| GROUP psampGroupSampFlowState | GROUP psampGroupSampFlowState | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| sampling function is implemented in the equipment." | sampling function is implemented in the equipment." | |||
| GROUP psampGroupFilterMatch | GROUP psampGroupFilterMatch | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| filter function is implemented in the equipment." | filter function is implemented in the equipment." | |||
| GROUP psampGroupFilterHash | GROUP psampGroupFilterHash | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| filter function is implemented in the equipment." | filter function is implemented in the equipment." | |||
| GROUP psampGroupFilterRState | GROUP psampGroupFilterRState | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| filter function is implemented in the equipment." | filter function is implemented in the equipment." | |||
| GROUP psampGroupHashIPSX | GROUP psampGroupHashIPSX | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| hash function is implemented in the equipment." | hash function is implemented in the equipment." | |||
| GROUP psampGroupHashBob | GROUP psampGroupHashBob | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects must be implemented if the corresponding | "These objects must be implemented if the corresponding | |||
| hash function is implemented in the equipment." | 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 | |||
| --================================================================== | --================================================================== | |||
| psampGroupMetering OBJECT-GROUP | psampGroupSelectAll OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampSelectAllAvail, | psampSelectAllAvail | |||
| psampSampCountBasedAvail, | ||||
| psampSampTimeBasedAvail, | ||||
| psampSampRandOutOfNAvail, | ||||
| psampSampUniProbAvail, | ||||
| psampSampNonUniProbAvail, | ||||
| psampSampFlowStateAvail, | ||||
| psampFilterMatchAvail, | ||||
| psampFilterHashAvail, | ||||
| psampFilterRStateAvail, | ||||
| psampHashIPSXAvail, | ||||
| psampHashBobAvail, | ||||
| psampTemplateRecordInfoElementId, | ||||
| psampTemplateRecordRowStatus, | ||||
| psampSelectorListMethod, | ||||
| psampSelectorListRowStatus, | ||||
| psampBaseAssocObservationPoint, | ||||
| psampBaseAssocTemplateRecordId, | ||||
| psampBaseAssocCollectorGrpIndex, | ||||
| psampBaseAssocMeteringProcessId, | ||||
| psampBaseAssocReportingProcessId, | ||||
| psampBaseAssocRowStatus | ||||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "All objects that are basic for the metering process. It | "The select all Method that must be present on all PSAMP | |||
| contains a basic metering function (psampSelectAll), The | complient devices." | |||
| 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 } | ::= { psampGroups 1 } | |||
| psampGroupSampCountBased OBJECT-GROUP | psampGroupSampCountBased OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampSampCountBasedAvail, | ||||
| psampSampCountBasedMaxInterval, | psampSampCountBasedMaxInterval, | |||
| psampSampCountBasedMinSpacing, | psampSampCountBasedMaxSpacing, | |||
| psampSampCountBasedInterval, | psampSampCountBasedInterval, | |||
| psampSampCountBasedSpacing, | psampSampCountBasedSpacing, | |||
| psampSampCountBasedRowStatus | psampSampCountBasedRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if count based sampling is | "These objects are needed if count based sampling is | |||
| implemented." | implemented." | |||
| ::= { psampGroups 2 } | ::= { psampGroups 2 } | |||
| psampGroupSampTimeBased OBJECT-GROUP | psampGroupSampTimeBased OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampSampTimeBasedAvail, | ||||
| psampSampTimeBasedMaxInterval, | psampSampTimeBasedMaxInterval, | |||
| psampSampTimeBasedMinSpacing, | psampSampTimeBasedMaxSpacing, | |||
| psampSampTimeBasedInterval, | psampSampTimeBasedInterval, | |||
| psampSampTimeBasedSpacing, | psampSampTimeBasedSpacing, | |||
| psampSampTimeBasedRowStatus | psampSampTimeBasedRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if time based sampling is | "These objects are needed if time based sampling is | |||
| implemented." | implemented." | |||
| ::= { psampGroups 3 } | ::= { psampGroups 3 } | |||
| psampGroupSampRandOutOfN OBJECT-GROUP | psampGroupSampRandOutOfN OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampSampRandOutOfNAvail, | ||||
| psampSampRandOutOfNMaxPopulation, | psampSampRandOutOfNMaxPopulation, | |||
| psampSampRandOutOfNMaxSample, | ||||
| psampSampRandOutOfNPopulation, | psampSampRandOutOfNPopulation, | |||
| psampSampRandOutOfNSample, | psampSampRandOutOfNSample, | |||
| psampSampRandOutOfNRowStatus | psampSampRandOutOfNRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if random n-out-of-N sampling is | "These objects are needed if random n-out-of-N sampling is | |||
| implemented." | implemented." | |||
| ::= { psampGroups 4 } | ::= { psampGroups 4 } | |||
| psampGroupSampUniProb OBJECT-GROUP | psampGroupSampUniProb OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampSampUniProbAvail, | ||||
| psampSampUniProbProbability, | psampSampUniProbProbability, | |||
| psampSampUniProbRowStatus | psampSampUniProbRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if uniform probabilistic sampling | "These objects are needed if uniform probabilistic sampling | |||
| is implemented." | is implemented." | |||
| ::= { psampGroups 5 } | ::= { psampGroups 5 } | |||
| psampGroupSampNonUniProb OBJECT-GROUP | psampGroupSampNonUniProb OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampSampNonUniProbAvail, | ||||
| psampSampNonUniProbFunction, | psampSampNonUniProbFunction, | |||
| psampSampNonUniProbFuncParam, | psampSampNonUniProbFuncParam, | |||
| psampSampNonUniProbRowStatus | psampSampNonUniProbRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if non-uniform probabilistic | "These objects are needed if non-uniform probabilistic | |||
| sampling is implemented." | sampling is implemented." | |||
| ::= { psampGroups 6 } | ::= { psampGroups 6 } | |||
| psampGroupSampFlowState OBJECT-GROUP | psampGroupSampFlowState OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampSampFlowStateAvail, | ||||
| psampSampFlowStateFunction, | psampSampFlowStateFunction, | |||
| psampSampFlowStateFuncParam, | psampSampFlowStateFuncParam, | |||
| psampSampFlowStateRowStatus | psampSampFlowStateRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if flow state sampling is | "These objects are needed if flow state sampling is | |||
| implemented." | implemented." | |||
| ::= { psampGroups 7 } | ::= { psampGroups 7 } | |||
| psampGroupFilterMatch OBJECT-GROUP | psampGroupFilterMatch OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampFilterMatchInfoElementId, | psampFilterMatchAvail, | |||
| psampFilterMatchFieldId, | ||||
| psampFilterMatchStartValue, | psampFilterMatchStartValue, | |||
| psampFilterMatchEndValue, | psampFilterMatchStopValue, | |||
| psampFilterMatchMask, | psampFilterMatchMask, | |||
| psampFilterMatchRowStatus | psampFilterMatchRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if match filtering is implemented." | "These objects are needed if match filtering is implemented." | |||
| ::= { psampGroups 8 } | ::= { psampGroups 8 } | |||
| psampGroupFilterHash OBJECT-GROUP | psampGroupFilterHash OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampFilterHashAvail, | ||||
| psampFilterHashAddrType, | psampFilterHashAddrType, | |||
| psampFilterHashHeaderBits, | psampFilterHashHeaderBits, | |||
| psampFilterHashPayloadBytes, | psampFilterHashPayloadBytes, | |||
| psampFilterHashPayloadBits, | psampFilterHashPayloadBits, | |||
| psampFilterHashFunction, | psampFilterHashFunction, | |||
| psampFilterHashFuncParam, | psampFilterHashFuncParam, | |||
| psampFilterHashInputBits, | psampFilterHashInputBits, | |||
| psampFilterHashOutputBits, | psampFilterHashOutputBits, | |||
| psampFilterHashOutputMask, | psampFilterHashOutputMask, | |||
| psampFilterHashSelection, | psampFilterHashSelection, | |||
| skipping to change at page 58, line 26 ¶ | skipping to change at page 42, line 4 ¶ | |||
| psampFilterHashHeaderBits, | psampFilterHashHeaderBits, | |||
| psampFilterHashPayloadBytes, | psampFilterHashPayloadBytes, | |||
| psampFilterHashPayloadBits, | psampFilterHashPayloadBits, | |||
| psampFilterHashFunction, | psampFilterHashFunction, | |||
| psampFilterHashFuncParam, | psampFilterHashFuncParam, | |||
| psampFilterHashInputBits, | psampFilterHashInputBits, | |||
| psampFilterHashOutputBits, | psampFilterHashOutputBits, | |||
| psampFilterHashOutputMask, | psampFilterHashOutputMask, | |||
| psampFilterHashSelection, | psampFilterHashSelection, | |||
| psampFilterHashRowStatus | psampFilterHashRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if hash filtering is implemented." | "These objects are needed if hash filtering is implemented." | |||
| ::= { psampGroups 9 } | ::= { psampGroups 9 } | |||
| psampGroupFilterRState OBJECT-GROUP | psampGroupFilterRState OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampFilterRStateAvail, | ||||
| psampFilterRStateFunction, | psampFilterRStateFunction, | |||
| psampFilterRStateNegate, | psampFilterRStateNegate, | |||
| psampFilterRStateIfIndex, | psampFilterRStateIfIndex, | |||
| psampFilterRStateStartAS, | psampFilterRStateStartAS, | |||
| psampFilterRStateEndAS, | psampFilterRStateStopAS, | |||
| psampFilterRStateVendorFunc, | psampFilterRStateVendorFunc, | |||
| psampFilterRStateRowStatus | psampFilterRStateRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if router state filtering is | "These objects are needed if router state filtering is | |||
| implemented." | implemented." | |||
| ::= { psampGroups 10 } | ::= { psampGroups 10 } | |||
| psampGroupHashIPSX OBJECT-GROUP | psampGroupHashIPSX OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampHashIPSXAvail, | ||||
| psampHashIPSXRowStatus | psampHashIPSXRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if the IPSX hash function is | "These objects are needed if the IPSX hash function is | |||
| implemented." | implemented." | |||
| ::= { psampGroups 11 } | ::= { psampGroups 11 } | |||
| psampGroupHashBob OBJECT-GROUP | psampGroupHashBob OBJECT-GROUP | |||
| OBJECTS { | OBJECTS { | |||
| psampHashBobAvail, | ||||
| psampHashBobRowStatus | psampHashBobRowStatus | |||
| } | } | |||
| STATUS current | STATUS current | |||
| DESCRIPTION | DESCRIPTION | |||
| "These objects are needed if the Bob hash function is | "These objects are needed if the Bob hash function is | |||
| implemented." | implemented." | |||
| ::= { psampGroups 12 } | ::= { psampGroups 12 } | |||
| psampGroupReporting OBJECT-GROUP | ||||
| OBJECTS { | ||||
| psampCollectorDstIpAddressType, | ||||
| psampCollectorDstIpAddress, | ||||
| psampCollectorDstProtocol, | ||||
| psampCollectorDstPort, | ||||
| psampCollectorRowStatus, | ||||
| psampCollectorGroupRowStatus | ||||
| } | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "These objects define the collectors i.e., the destinations | ||||
| of the exporting process." | ||||
| ::= { psampGroups 13 } | ||||
| psampGroupStatistics OBJECT-GROUP | ||||
| OBJECTS { | ||||
| psampCollectorReportsSent, | ||||
| psampSelectorListPacketsObserved, | ||||
| psampSelectorListPacketsDropped, | ||||
| psampBaseAssocPacketsObserved, | ||||
| psampBaseAssocReportsSent, | ||||
| psampBaseAssocPacketsDropped | ||||
| } | ||||
| STATUS current | ||||
| DESCRIPTION | ||||
| "These objects contain statistical values gathered at | ||||
| different points in the metering process." | ||||
| ::= { psampGroups 14 } | ||||
| END | END | |||
| 7. 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. | network operations. | |||
| 8. Acknowledgment | 8. IANA Considerations | |||
| This document is a product of the PSAMP working group. | This document requires no assignment to be made by IANA. | |||
| 9. References | 9. Acknowledgment | |||
| 9.1. Normative References | This document is a product of the PSAMP working group. | |||
| [1] Duffield, N., "A Framework for Packet Selection and Reporting", | 10. References | |||
| draft-ietf-psamp-framework-10 (work in progress), January 2005. | ||||
| [2] Zseby, T., "Sampling and Filtering Techniques for IP Packet | 10.1. Normative References | |||
| Selection", draft-ietf-psamp-sample-tech-07 (work in progress), | ||||
| July 2005. | ||||
| [3] Claise, B., "Packet Sampling (PSAMP) Protocol Specifications", | [I-D.ietf-psamp-framework] | |||
| draft-ietf-psamp-protocol-01 (work in progress), February 2004. | Duffield, N., "A Framework for Packet Selection and | |||
| Reporting", draft-ietf-psamp-framework-10 (work in | ||||
| progress), January 2005. | ||||
| [4] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., | [I-D.ietf-psamp-sample-tech] | |||
| McCloghrie, K., Rose, M., and S. Waldbusser, "Structure of | Zseby, T., "Sampling and Filtering Techniques for IP | |||
| Management Information Version 2 (SMIv2)", STD 58, RFC 2578, | Packet Selection", draft-ietf-psamp-sample-tech-07 (work | |||
| April 1999. | in progress), July 2005. | |||
| [5] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., | [I-D.ietf-psamp-protocol] | |||
| McCloghrie, K., Rose, M., and S. Waldbusser, "Textual | Claise, B., "Packet Sampling (PSAMP) Protocol | |||
| Conventions for SMIv2", STD 58, RFC 2579, April 1999. | Specifications", draft-ietf-psamp-protocol-05 (work in | |||
| progress), April 2006. | ||||
| [6] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Conformance | [I-D.ietf-ipfix-protocol] | |||
| Statements for SMIv2", STD 58, RFC 2580, April 1999. | Claise, B., "IPFIX Protocol Specification", | |||
| draft-ietf-ipfix-protocol-20 (work in progress), | ||||
| April 2006. | ||||
| [7] Dietz, T., "Information Model for Packet Sampling Exports", | [I-D.dietz-ipfix-mib] | |||
| draft-ietf-psamp-info-02 (work in progress), July 2004. | Dietz, T., Kobayashi, A., and B. Claise, "Definitions of | |||
| Managed Objects for IP Flow Information Export", | ||||
| draft-dietz-ipfix-mib-00 (work in progress), June 2006. | ||||
| 9.2. Informative References | [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. | |||
| Schoenwaelder, Ed., "Structure of Management Information | ||||
| Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. | ||||
| [8] Bradner, S., "Key words for use in RFCs to Indicate Requirement | [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. | |||
| Levels", BCP 14, RFC 2119, March 1997. | Schoenwaelder, Ed., "Textual Conventions for SMIv2", | |||
| STD 58, RFC 2579, April 1999. | ||||
| [9] Quittek, J., "Requirements for IP Flow Information Export", | [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, | |||
| draft-ietf-ipfix-reqs-16 (work in progress), June 2004. | "Conformance Statements for SMIv2", STD 58, RFC 2580, | |||
| April 1999. | ||||
| [10] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction | 10.2. Informative References | |||
| and Applicability Statements for Internet-Standard Management | ||||
| Framework", RFC 3410, December 2002. | ||||
| [11] Quittek, J., "Information Model for IP Flow Information | [I-D.ietf-psamp-info] | |||
| Export", draft-ietf-ipfix-info-11 (work in progress), | Dietz, T., "Information Model for Packet Sampling | |||
| September 2005. | Exports", draft-ietf-psamp-info-04 (work in progress), | |||
| March 2006. | ||||
| [12] Sadasivan, G., "Architecture for IP Flow Information Export", | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | |||
| draft-ietf-ipfix-architecture-09 (work in progress), | Requirement Levels", BCP 14, RFC 2119, March 1997. | |||
| August 2005. | ||||
| [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, | ||||
| "Introduction and Applicability Statements for Internet- | ||||
| Standard Management Framework", RFC 3410, 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 | Heidelberg 69115 | |||
| Germany | DE | |||
| Phone: +49 6221 90511-28 | Phone: +49 6221 4342-128 | |||
| 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 | Degem 1831 | |||
| Belgium | BE | |||
| 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 Rights 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 | |||
| skipping to change at page 63, line 41 ¶ | skipping to change at page 46, line 41 ¶ | |||
| This document and the information contained herein are provided on an | This document and the information contained herein are provided on an | |||
| "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS | "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS | |||
| OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET | OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET | |||
| ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, | ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, | |||
| INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE | INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE | |||
| INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED | INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED | |||
| WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. | WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. | |||
| Copyright Statement | Copyright Statement | |||
| Copyright (C) The Internet Society (2005). This document is subject | Copyright (C) The Internet Society (2006). This document is subject | |||
| to the rights, licenses and restrictions contained in BCP 78, and | to the rights, licenses and restrictions contained in BCP 78, and | |||
| except as set forth therein, the authors retain all their rights. | except as set forth therein, the authors retain all their rights. | |||
| 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. 236 change blocks. | ||||
| 1321 lines changed or deleted | 512 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||