[要約] RFC 6728は、IPFIXとPSAMPプロトコルのための設定データモデルに関するものです。このRFCの目的は、ネットワークデバイスの設定情報を効果的に管理し、IPFIXとPSAMPの機能を最大限に活用することです。

Internet Engineering Task Force (IETF)                          G. Muenz
Request for Comments: 6728                                   TU Muenchen
Category: Standards Track                                      B. Claise
ISSN: 2070-1721                                                P. Aitken
                                                     Cisco Systems, Inc.
                                                            October 2012
        

Configuration Data Model for the IP Flow Information Export (IPFIX) and Packet Sampling (PSAMP) Protocols

IPフロー情報エクスポート(IPFIX)およびパケットサンプリング(PSAMP)プロトコルの構成データモデル

Abstract

概要

This document specifies a data model for the IP Flow Information Export (IPFIX) and Packet Sampling (PSAMP) protocols. It is for configuring and monitoring Selection Processes, Caches, Exporting Processes, and Collecting Processes of IPFIX- and PSAMP-compliant Monitoring Devices using the Network Configuration Protocol (NETCONF). The data model is defined using UML (Unified Modeling Language) class diagrams and formally specified using YANG. The configuration data is encoded in Extensible Markup Language (XML).

このドキュメントでは、IPフロー情報エクスポート(IPFIX)およびパケットサンプリング(PSAMP)プロトコルのデータモデルについて説明します。これは、ネットワーク構成プロトコル(NETCONF)を使用して、IPFIXおよびPSAMP準拠の監視デバイスの選択プロセス、キャッシュ、エクスポートプロセス、および収集プロセスを構成および監視するためのものです。データモデルは、UML(統一モデリング言語)クラス図を使用して定義され、YANGを使用して正式に指定されます。構成データはExtensible Markup Language(XML)でエンコードされています。

Status of This Memo

本文書の状態

This is an Internet Standards Track document.

これはInternet Standards Trackドキュメントです。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741.

このドキュメントは、IETF(Internet Engineering Task Force)の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ(IESG)による公開が承認されました。インターネット標準の詳細については、RFC 5741のセクション2をご覧ください。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc6728.

このドキュメントの現在のステータス、エラータ、およびフィードバックの提供方法に関する情報は、http://www.rfc-editor.org/info/rfc6728で入手できます。

Copyright Notice

著作権表示

Copyright (c) 2012 IETF Trust and the persons identified as the document authors. All rights reserved.

Copyright(c)2012 IETF Trustおよびドキュメントの作成者として特定された人物。全著作権所有。

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

この文書は、BCP 78およびこの文書の発行日に有効なIETF文書に関するIETFトラストの法的規定(http://trustee.ietf.org/license-info)の対象となります。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。

This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.

このドキュメントには、2008年11月10日より前に公開または公開されたIETFドキュメントまたはIETFコントリビューションの資料が含まれている場合があります。 IETF標準プロセス外。このような資料の著作権を管理する人から適切なライセンスを取得しない限り、このドキュメントはIETF標準プロセス外で変更できません。また、その派生物は、IETF標準プロセス外で作成できません。 RFCとして、またはそれを英語以外の言語に翻訳するための出版物。

Table of Contents

目次

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
     1.1.  IPFIX Documents Overview  . . . . . . . . . . . . . . . .   4
     1.2.  PSAMP Documents Overview  . . . . . . . . . . . . . . . .   5
   2.  Terminology . . . . . . . . . . . . . . . . . . . . . . . . .   5
   3.  Structure of the Configuration Data Model . . . . . . . . . .   7
     3.1.  Metering Process Decomposition in Selection Process
           and Cache . . . . . . . . . . . . . . . . . . . . . . . .   8
     3.2.  UML Representation  . . . . . . . . . . . . . . . . . . .  10
     3.3.  Exporter Configuration  . . . . . . . . . . . . . . . . .  15
     3.4.  Collector Configuration . . . . . . . . . . . . . . . . .  17
   4.  Configuration Parameters  . . . . . . . . . . . . . . . . . .  18
     4.1.  ObservationPoint Class  . . . . . . . . . . . . . . . . .  18
     4.2.  SelectionProcess Class  . . . . . . . . . . . . . . . . .  20
       4.2.1.  Selector Class  . . . . . . . . . . . . . . . . . . .  21
       4.2.2.  Sampler Classes . . . . . . . . . . . . . . . . . . .  22
       4.2.3.  Filter Classes  . . . . . . . . . . . . . . . . . . .  23
     4.3.  Cache Class . . . . . . . . . . . . . . . . . . . . . . .  25
       4.3.1.  ImmediateCache Class  . . . . . . . . . . . . . . . .  26
       4.3.2.  TimeoutCache, NaturalCache, and PermanentCache
               Class . . . . . . . . . . . . . . . . . . . . . . . .  27
       4.3.3.  CacheLayout Class . . . . . . . . . . . . . . . . . .  29
     4.4.  ExportingProcess Class  . . . . . . . . . . . . . . . . .  32
       4.4.1.  SctpExporter Class  . . . . . . . . . . . . . . . . .  34
       4.4.2.  UdpExporter Class . . . . . . . . . . . . . . . . . .  36
       4.4.3.  TcpExporter Class . . . . . . . . . . . . . . . . . .  37
       4.4.4.  FileWriter Class  . . . . . . . . . . . . . . . . . .  38
       4.4.5.  Options Class . . . . . . . . . . . . . . . . . . . .  39
     4.5.  CollectingProcess Class . . . . . . . . . . . . . . . . .  41
       4.5.1.  SctpCollector Class . . . . . . . . . . . . . . . . .  42
       4.5.2.  UdpCollector Class  . . . . . . . . . . . . . . . . .  43
        
       4.5.3.  TcpCollector Class  . . . . . . . . . . . . . . . . .  44
       4.5.4.  FileReader Class  . . . . . . . . . . . . . . . . . .  45
     4.6.  Transport Layer Security Class  . . . . . . . . . . . . .  46
     4.7.  Transport Session Class . . . . . . . . . . . . . . . . .  49
     4.8.  Template Class  . . . . . . . . . . . . . . . . . . . . .  53
   5.  Adaptation to Device Capabilities . . . . . . . . . . . . . .  54
   6.  YANG Module of the IPFIX/PSAMP Configuration Data Model . . .  57
   7.  Examples  . . . . . . . . . . . . . . . . . . . . . . . . . . 104
     7.1.  PSAMP Device  . . . . . . . . . . . . . . . . . . . . . . 104
     7.2.  IPFIX Device  . . . . . . . . . . . . . . . . . . . . . . 115
     7.3.  Export of Flow Records and Packet Reports . . . . . . . . 118
     7.4.  Collector and File Writer . . . . . . . . . . . . . . . . 121
     7.5.  Deviations  . . . . . . . . . . . . . . . . . . . . . . . 122
   8.  Security Considerations . . . . . . . . . . . . . . . . . . . 122
   9.  IANA Considerations . . . . . . . . . . . . . . . . . . . . . 124
   10. Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . 125
   11. References  . . . . . . . . . . . . . . . . . . . . . . . . . 125
     11.1. Normative References  . . . . . . . . . . . . . . . . . . 125
     11.2. Informative References  . . . . . . . . . . . . . . . . . 126
        
1. Introduction
1. はじめに

IPFIX- and PSAMP-compliant Monitoring Devices (routers, switches, monitoring probes, Collectors, etc.) offer various configuration possibilities that allow adapting network monitoring to the goals and purposes of the application, such as accounting and charging, traffic analysis, performance monitoring, and security monitoring. The use of a common vendor-independent configuration data model for IPFIX-and PSAMP-compliant Monitoring Devices facilitates network management and configuration, especially if Monitoring Devices of different implementers or manufacturers are deployed simultaneously. On the one hand, a vendor-independent configuration data model helps to store and manage the configuration data of Monitoring Devices in a consistent format. On the other hand, it can be used for local and remote configuration of Monitoring Devices.

IPFIXおよびPSAMP準拠の監視デバイス(ルーター、スイッチ、監視プローブ、コレクターなど)は、アカウンティングと課金、トラフィック分析、パフォーマンス監視など、ネットワーク監視をアプリケーションの目的と目的に適合させるさまざまな構成の可能性を提供します、およびセキュリティ監視。 IPFIXおよびPSAMP準拠の監視デバイスに共通のベンダーに依存しない構成データモデルを使用すると、特に異なる実装者または製造元の監視デバイスが同時に展開されている場合、ネットワークの管理と構成が容易になります。一方では、ベンダーに依存しない構成データモデルは、監視デバイスの構成データを一貫した形式で格納および管理するのに役立ちます。一方、監視デバイスのローカルおよびリモート構成に使用できます。

The purpose of this document is the specification of a vendor-independent configuration data model that covers the commonly available configuration parameters of Selection Processes, Caches, Exporting Processes, and Collecting Processes. In addition, it includes common states parameters of a Monitoring Device. The configuration data model is defined using UML (Unified Modeling Language) class diagrams [UML], while the actual configuration data is encoded in Extensible Markup Language (XML) [W3C.REC-xml-20081126]. An XML document conforming to the configuration data model contains the configuration data of one Monitoring Device.

このドキュメントの目的は、選択プロセス、キャッシュ、エクスポートプロセス、および収集プロセスの一般的に利用可能な構成パラメーターをカバーする、ベンダーに依存しない構成データモデルの仕様です。さらに、監視デバイスの一般的な状態パラメーターが含まれています。構成データモデルはUML(統一モデリング言語)クラス図[UML]を使用して定義されますが、実際の構成データは拡張マークアップ言語(XML)[W3C.REC-xml-20081126]でエンコードされます。構成データモデルに準拠したXMLドキュメントには、1つの監視デバイスの構成データが含まれています。

The configuration data model is designed for use with the NETCONF protocol [RFC6241] in order to configure remote Monitoring Devices. With the NETCONF protocol, it is possible to transfer a complete set of configuration data to a Monitoring Device, to query the current configuration and state parameters of a Monitoring Device, and to change specific parameter values of an existing Monitoring Device configuration.

構成データモデルは、リモート監視デバイスを構成するために、NETCONFプロトコル[RFC6241]で使用するように設計されています。 NETCONFプロトコルを使用すると、構成データの完全なセットを監視デバイスに転送し、現在の構成と監視デバイスの状態パラメーターをクエリし、既存の監視デバイス構成の特定のパラメーター値を変更できます。

In order to ensure compatibility with the NETCONF protocol [RFC6241], YANG [RFC6020] is used to formally specify the configuration data model. If required, the YANG specification of the configuration data model can be converted into XML Schema language [W3C.REC-xmlschema-0-20041028] or DSDL (Document Schema Definition Languages) [RFC6110], for example, by using the pyang tool [YANG-WEB]. YANG provides mechanisms to adapt the configuration data model to device-specific constraints and to augment the model with additional device-specific or vendor-specific parameters.

NETCONFプロトコル[RFC6241]との互換性を確保するために、YANG [RFC6020]を使用して、構成データモデルを正式に指定します。必要に応じて、構成データモデルのYANG仕様をXMLスキーマ言語[W3C.REC-xmlschema-0-20041028]またはDSDL(ドキュメントスキーマ定義言語)[RFC6110]に変換できます。たとえば、pyangツールを使用します[ YANG-WEB]。 YANGは、構成データモデルをデバイス固有の制約に適合させ、デバイス固有またはベンダー固有のパラメーターを追加してモデルを拡張するメカニズムを提供します。

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 [RFC2119].

このドキュメントのキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、 [RFC2119]で説明されているように解釈されます。

1.1. IPFIX Documents Overview
1.1. IPFIXドキュメントの概要

The IPFIX protocol [RFC5101] provides network administrators with access to IP Flow information. The architecture for the export of measured IP Flow information out of an IPFIX Exporting Process to a Collecting Process is defined in [RFC5470], per the requirements defined in [RFC3917]. The IPFIX protocol [RFC5101] specifies how IPFIX Data Records and Templates are carried via a number of transport protocols from IPFIX Exporting Processes to IPFIX Collecting Process. IPFIX has a formal description of IPFIX Information Elements, their name, type, and additional semantic information, as specified in [RFC5102]. [RFC6615] specifies the IPFIX Management Information Base, consisting of the IPFIX MIB module and the IPFIX SELECTOR MIB module. Finally, [RFC5472] describes what type of applications can use the IPFIX protocol and how they can use the information provided. It furthermore shows how the IPFIX framework relates to other architectures and frameworks. Methods for efficient export of bidirectional Flow information and common properties in Data Records are specified in [RFC5103] and [RFC5473], respectively. [RFC5610] addresses the export of extended type information for enterprise-specific Information Elements. The storage of IPFIX Messages in a file is specified in [RFC5655].

IPFIXプロトコル[RFC5101]は、ネットワーク管理者にIPフロー情報へのアクセスを提供します。 IPFIXエクスポートプロセスから収集プロセスへの測定されたIPフロー情報のエクスポートのアーキテクチャは、[RFC3917]で定義されている要件に従って、[RFC5470]で定義されています。 IPFIXプロトコル[RFC5101]は、IPFIXエクスポートプロセスからIPFIX収集プロセスへの多数のトランスポートプロトコルを介して、IPFIXデータレコードとテンプレートがどのように運ばれるかを指定します。 IPFIXは、[RFC5102]で指定されているように、IPFIX情報要素、それらの名前、タイプ、および追加のセマンティック情報の正式な説明を持っています。 [RFC6615]は、IPFIX MIBモジュールとIPFIX SELECTOR MIBモジュールで構成されるIPFIX管理情報ベースを指定します。最後に、[RFC5472]は、IPFIXプロトコルを使用できるアプリケーションのタイプと、提供される情報をどのように使用できるかについて説明しています。さらに、IPFIXフレームワークが他のアーキテクチャーやフレームワークとどのように関連しているかを示しています。双方向フロー情報とデータレコードの共通プロパティを効率的にエクスポートする方法は、それぞれ[RFC5103]と[RFC5473]で指定されています。 [RFC5610]は、企業固有の情報要素の拡張タイプ情報のエクスポートを扱います。ファイルへのIPFIXメッセージの格納は、[RFC5655]で指定されています。

1.2. PSAMP Documents Overview
1.2. PSAMPドキュメントの概要

The framework for packet selection and reporting [RFC5474] enables network elements to select subsets of packets by statistical and other methods, and to export a stream of reports on the selected packets to a Collector. The set of packet selection techniques (Sampling, Filtering, and hashing) standardized by PSAMP is described in [RFC5475]. The PSAMP protocol [RFC5476] specifies the export of packet information from a PSAMP Exporting Process to a PSAMP Collector. Instead of exporting PSAMP Packet Reports, the stream of selected packets may also serve as input to the generation of IPFIX Flow Records. Like IPFIX, PSAMP has a formal description of its Information Elements, their name, type, and additional semantic information. The PSAMP information model is defined in [RFC5477]. [RFC6727] specifies the PSAMP MIB module as an extension of the IPFIX SELECTOR MIB module defined in [RFC6615].

パケットの選択とレポートのフレームワーク[RFC5474]により、ネットワーク要素は統計的およびその他の方法でパケットのサブセットを選択し、選択したパケットに関するレポートのストリームをコレクターにエクスポートできます。 PSAMPによって標準化された一連のパケット選択技術(サンプリング、フィルタリング、およびハッシュ)は、[RFC5475]で説明されています。 PSAMPプロトコル[RFC5476]は、PSAMPエクスポートプロセスからPSAMPコレクターへのパケット情報のエクスポートを指定します。 PSAMPパケットレポートをエクスポートする代わりに、選択したパケットのストリームをIPFIXフローレコードの生成への入力として使用することもできます。 IPFIXと同様に、PSAMPには、その情報要素、その名前、タイプ、および追加のセマンティック情報の正式な説明があります。 PSAMP情報モデルは[RFC5477]で定義されています。 [RFC6727]は、PSAMP MIBモジュールを[RFC6615]で定義されているIPFIX SELECTOR MIBモジュールの拡張として指定します。

2. Terminology
2. 用語

This document adopts the terminologies used in [RFC5101], [RFC5103], [RFC5655], and [RFC5476]. As in these documents, all specific terms have the first letter of a word capitalized when used in this document. The following listing indicates in which references the definitions of those terms that are commonly used throughout this document can be found:

このドキュメントは、[RFC5101]、[RFC5103]、[RFC5655]、および[RFC5476]で使用されている用語を採用しています。これらのドキュメントと同様に、すべての特定の用語は、このドキュメントで使用される場合、単語の最初の文字が大文字になります。次のリストは、このドキュメント全体で一般的に使用されている用語の定義が参照できるリファレンスを示しています。

o Definitions adopted from [RFC5101]: * Collection Process * Collector * Data Record * Exporter * Flow * Flow Key * Flow Record * Information Element * IPFIX Device * IPFIX Message * Observation Domain * Observation Point * (Options) Template

o [RFC5101]から採用された定義:*収集プロセス*コレクター*データレコード*エクスポーター*フロー*フローキー*フローレコード*情報要素* IPFIXデバイス* IPFIXメッセージ*観測ドメイン*観測ポイント*(オプション)テンプレート

o Definitions adopted from [RFC5103]: * Reverse Information Element

o [RFC5103]から採用された定義:*逆情報要素

o Definitions adopted from [RFC5655]: * File Reader * File Writer

o [RFC5655]から採用された定義:*ファイルリーダー*ファイルライター

o Definitions adopted from [RFC5476]: * Filtering * Observed Packet Stream * Packet Report * PSAMP Device * Sampling * Selection Process * Selection Sequence * Selection Sequence Report Interpretation * Selection Sequence Statistics Report Interpretation * Selection State * Selector, Primitive Selector, Composite Selector * Selector Report Interpretation

o [RFC5476]から採用された定義:*フィルタリング*観測されたパケットストリーム*パケットレポート* PSAMPデバイス*サンプリング*選択プロセス*選択シーケンス*選択シーケンスレポートの解釈*選択シーケンス統計レポートの解釈*選択状態*セレクター、プリミティブセレクター、コンポジットセレクター*セレクタレポートの解釈

The terms Metering Process and Exporting Process have different definitions in [RFC5101] and [RFC5476]. In the scope of this document, these terms are used according to the following definitions, which cover the deployment in both PSAMP Devices and IPFIX Devices:

[RFC5101]と[RFC5476]では、メータリングプロセスとエクスポートプロセスという用語の定義が異なります。このドキュメントの範囲では、これらの用語は、PSAMPデバイスとIPFIXデバイスの両方での展開を対象とする次の定義に従って使用されます。

Metering Process

計量プロセス

The Metering Process generates IPFIX Flow Records or PSAMP Packet Reports, depending on its deployment as part of an IPFIX Device or PSAMP Device. Inputs to the process are packets observed at one or more Observation Points, as well as characteristics describing the packet treatment at these Observation Points. If IPFIX Flow Records are generated, the Metering Process MUST NOT aggregate packets observed at different Observation Domains in the same Flow. The function of the Metering Process is split into two functional blocks: Selection Process and Cache.

メータリングプロセスは、IPFIXデバイスまたはPSAMPデバイスの一部としての展開に応じて、IPFIXフローレコードまたはPSAMPパケットレポートを生成します。プロセスへの入力は、1つ以上の観測ポイントで観測されたパケットと、これらの観測ポイントでのパケット処理を記述する特性です。 IPFIXフローレコードが生成される場合、メータリングプロセスは、同じフロー内の異なる観測ドメインで観測されたパケットを集約してはなりません(MUST NOT)。計量プロセスの機能は、選択プロセスとキャッシュという2つの機能ブロックに分かれています。

Exporting Process

輸出プロセス

Depending on its deployment as part of an IPFIX Device or PSAMP Device, the Exporting Process sends IPFIX Flow Records or PSAMP Packet Reports to one or more Collecting Processes. The IPFIX Flow Records or PSAMP Packet Reports are generated by one or more Metering Processes.

IPFIXデバイスまたはPSAMPデバイスの一部としての展開に応じて、エクスポートプロセスはIPFIXフローレコードまたはPSAMPパケットレポートを1つ以上の収集プロセスに送信します。 IPFIXフローレコードまたはPSAMPパケットレポートは、1つ以上のメータリングプロセスによって生成されます。

In addition to the existing IPFIX and PSAMP terminology, the following terms are defined:

既存のIPFIXとPSAMPの用語に加えて、次の用語が定義されています。

Cache

キャッシュ

The Cache is a functional block in a Metering Process that generates IPFIX Flow Records or PSAMP Packet Reports from a Selected Packet Stream, in accordance with its configuration. If Flow Records are generated, the Cache performs tasks like creating new records, updating existing ones, computing Flow statistics, deriving further Flow properties, detecting Flow expiration, passing Flow Records to the Exporting Process, and deleting Flow Records. If Packet Reports are generated, the Cache performs tasks like extracting packet contents and derived packet properties from the Selected Packet Stream, creating new records, and passing them as Packet Reports to the Exporting Process.

キャッシュは、メータリングプロセスの機能ブロックであり、構成に従って、選択されたパケットストリームからIPFIXフローレコードまたはPSAMPパケットレポートを生成します。フローレコードが生成されると、キャッシュは、新しいレコードの作成、既存のレコードの更新、フロー統計の計算、フロープロパティの派生、フローの有効期限の検出、フローレコードのエクスポートプロセスへの受け渡し、フローレコードの削除などのタスクを実行します。パケットレポートが生成されると、キャッシュは、選択されたパケットストリームからパケットコンテンツと派生パケットプロパティを抽出し、新しいレコードを作成して、それらをパケットレポートとしてエクスポートプロセスに渡すなどのタスクを実行します。

Cache Layout

キャッシュレイアウト

The Cache Layout defines the superset of fields that are included in the Packet Reports or Flow Records maintained by the Cache. The fields are specified by the corresponding Information Elements. In general, the largest possible subset of the specified fields is derived for every Packet Report or Flow Record. More specific rules about which fields must be included are given in Section 4.3.3.

キャッシュレイアウトは、キャッシュによって維持されるパケットレポートまたはフローレコードに含まれるフィールドのスーパーセットを定義します。フィールドは、対応する情報要素によって指定されます。一般に、指定されたフィールドの可能な最大のサブセットは、すべてのパケットレポートまたはフローレコードから取得されます。どのフィールドを含める必要があるかについてのより具体的なルールは、セクション4.3.3に記載されています。

Monitoring Device

監視装置

A Monitoring Device implements at least one of the functional blocks specified in the context of IPFIX or PSAMP. In particular, the term Monitoring Device encompasses Exporters, Collectors, IPFIX Devices, and PSAMP Devices.

監視デバイスは、IPFIXまたはPSAMPのコンテキストで指定された機能ブロックの少なくとも1つを実装します。特に、監視デバイスという用語には、エクスポーター、コレクター、IPFIXデバイス、およびPSAMPデバイスが含まれます。

Selected Packet Stream

選択されたパケットストリーム

The Selected Packet Stream is the set of all packets selected by a Selection Process.

Selected Packet Streamは、選択プロセスによって選択されたすべてのパケットのセットです。

3. Structure of the Configuration Data Model
3. 構成データモデルの構造

The IPFIX reference model in [RFC5470] describes Metering Processes, Exporting Processes, and Collecting Processes as functional blocks of IPFIX Devices. The PSAMP framework [RFC5474] provides the corresponding information for PSAMP Devices and introduces the Selection Process as a functional block within Metering Processes. In Section 2 of the document, the Cache is defined as another functional block within Metering Processes. Further explanations about the relationship between Selection Process and Cache are given in Section 3.1. IPFIX File Reader and File Writer are defined as specific kinds of Exporting and Collecting Processes in [RFC5655].

[RFC5470]のIPFIX参照モデルでは、メータリングプロセス、エクスポートプロセス、および収集プロセスをIPFIXデバイスの機能ブロックとして説明しています。 PSAMPフレームワーク[RFC5474]は、PSAMPデバイスに対応する情報を提供し、メータリングプロセス内の機能ブロックとして選択プロセスを導入します。このドキュメントのセクション2では、キャッシュはメータリングプロセス内の別の機能ブロックとして定義されています。選択プロセスとキャッシュの関係については、セクション3.1で詳しく説明します。 IPFIXファイルリーダーとファイルライターは、[RFC5655]で特定の種類のエクスポートおよび収集プロセスとして定義されています。

Monitoring Device implementations usually maintain the separation of various functional blocks, although they do not necessarily implement all of them. Furthermore, they provide various configuration possibilities; some of them are specified as mandatory by the IPFIX protocol [RFC5101] or PSAMP protocol [RFC5476]. The configuration data model enables the setting of commonly available configuration parameters for Selection Processes, Caches, Exporting Processes, and Collecting Processes. In addition, it allows specifying the composition of functional blocks within a Monitoring Device configuration and their linkage with Observation Points.

監視デバイスの実装は通常、さまざまな機能ブロックの分離を維持しますが、必ずしもすべてを実装しているわけではありません。さらに、さまざまな構成の可能性を提供します。それらのいくつかは、IPFIXプロトコル[RFC5101]またはPSAMPプロトコル[RFC5476]によって必須として指定されています。構成データモデルにより、選択プロセス、キャッシュ、エクスポートプロセス、および収集プロセスの一般的に利用可能な構成パラメーターを設定できます。さらに、監視デバイス構成内の機能ブロックの構成と、観測ポイントとのリンクを指定できます。

The selection of parameters in the configuration data model is based on configuration issues discussed in the IPFIX and PSAMP documents [RFC3917], [RFC5101], [RFC5470], [RFC5476], [RFC5474], and [RFC5475]. Furthermore, the structure and content of the IPFIX MIB module [RFC6615] and the PSAMP MIB module [RFC6727] have been taken into consideration. Consistency between the configuration data model and the IPFIX and PSAMP MIB modules is an intended goal. Therefore, parameters in the configuration data model are named according to corresponding managed objects. Certain IPFIX MIB objects containing state data have been adopted as state parameters in the configuration data model. State parameters cannot be configured, yet their values can be queried from the Monitoring Device by a network manager.

構成データモデルのパラメーターの選択は、IPFIXおよびPSAMPドキュメント[RFC3917]、[RFC5101]、[RFC5470]、[RFC5476]、[RFC5474]、および[RFC5475]で説明されている構成の問題に基づいています。さらに、IPFIX MIBモジュール[RFC6615]とPSAMP MIBモジュール[RFC6727]の構造と内容も考慮されています。構成データモデルとIPFIXおよびPSAMP MIBモジュール間の整合性は、意図された目標です。したがって、構成データモデルのパラメーターは、対応する管理対象オブジェクトに従って名前が付けられます。状態データを含む特定のIPFIX MIBオブジェクトは、構成データモデルの状態パラメーターとして採用されています。状態パラメーターは構成できませんが、その値はネットワークマネージャーによって監視デバイスからクエリできます。

Section 3.2 explains how UML class diagrams are deployed to illustrate the structure of the configuration data model. Thereafter, Section 3.3 and Section 3.4 explain the class diagrams for the configuration of Exporters and Collectors, respectively. Each of the presented classes contains specific configuration parameters that are specified in Section 4. Section 5 gives a short introduction to YANG concepts that allow adapting the configuration data model to the capabilities of a device. The formal definition of the configuration data model in YANG is given in Section 6. Section 7 illustrates the usage of the model with example configurations in XML.

セクション3.2では、構成データモデルの構造を示すためにUMLクラス図がどのように展開されるかについて説明します。その後、セクション3.3とセクション3.4で、それぞれエクスポーターとコレクターの構成のクラス図について説明します。提示された各クラスには、セクション4で指定された特定の構成パラメーターが含まれています。セクション5では、構成データモデルをデバイスの機能に適合させるYANGの概念を簡単に紹介します。 YANGでの構成データモデルの正式な定義は、セクション6に記載されています。セクション7は、XMLの構成例を使用したモデルの使用法を示しています。

3.1. Metering Process Decomposition in Selection Process and Cache
3.1. 選択プロセスとキャッシュにおけるメータリングプロセスの分解

In a Monitoring Device implementation, the functionality of the Metering Process is commonly split into packet Sampling and Filtering functions performed by Selection Processes, and the maintenance of Flow Records and Packet Reports is performed by a Cache. Figure 1 illustrates this separation with the example of a basic Metering Process.

モニタリングデバイスの実装では、メータリングプロセスの機能は通常、選択プロセスによって実行されるパケットサンプリングおよびフィルタリング機能に分割され、フローレコードとパケットレポートのメンテナンスはキャッシュによって実行されます。図1は、この分離を基本的な計量プロセスの例で示しています。

               +-----------------------------------+
               | Metering Process                  |
               | +-----------+ Selected            |
      Observed | | Selection | Packet    +-------+ |  Stream of
      Packet  -->| Process   |---------->| Cache |--> Flow Records or
      Stream   | +-----------+ Stream    +-------+ |  Packet Reports
               +-----------------------------------+
        

Figure 1: Selection Process and Cache forming a Metering Process

図1:測定プロセスを形成する選択プロセスとキャッシュ

The configuration data model adopts the separation of Selection Processes and Caches in order to support the flexible configuration and combination of these functional blocks. As defined in [RFC5476], the Selection Process takes an Observed Packet Stream as its input and selects a subset of that stream as its output (Selected Packet Stream). The action of the Selection Process on a single packet of its input is defined by one Selector (called a Primitive Selector) or an ordered composition of multiple Selectors (called a Composite Selector). The Cache generates Flow Records or Packet Reports from the Selected Packet Stream, depending on its configuration.

構成データモデルは、これらの機能ブロックの柔軟な構成と組み合わせをサポートするために、選択プロセスとキャッシュの分離を採用しています。 [RFC5476]で定義されているように、選択プロセスは観測パケットストリームを入力として受け取り、そのストリームのサブセットを出力(選択パケットストリーム)として選択します。入力の単一パケットに対する選択プロセスのアクションは、1つのセレクター(プリミティブセレクターと呼ばれる)または複数のセレクターの順序付けられた構成(複合セレクターと呼ばれる)によって定義されます。キャッシュは、その構成に応じて、選択されたパケットストリームからフローレコードまたはパケットレポートを生成します。

The configuration data model does not allow configuring a Metering Process without any Selection Process in front of the Cache. If all packets in the Observed Packet Stream shall be selected and passed to the Cache without any Filtering or Sampling, a Selection Process needs to be configured with a Selector that selects all packets ("SelectAll" class in Section 4.2.1).

構成データモデルでは、選択プロセスがキャッシュの前にない場合、メータリングプロセスを構成できません。監視対象パケットストリーム内のすべてのパケットを選択し、フィルタリングやサンプリングを行わずにキャッシュに渡す場合は、すべてのパケットを選択するセレクター(セクション4.2.1の「SelectAll」クラス)を使用して選択プロセスを構成する必要があります。

The configuration data model enables the configuration of a Selection Process that receives packets from multiple Observation Points as its input. In this case, the Observed Packet Streams of the Observation Points are processed in independent Selection Sequences. As specified in [RFC5476], a distinct set of Selector instances needs to be maintained per Selection Sequence in order to keep the Selection States and statistics separate.

構成データモデルにより、複数の観測ポイントからのパケットを入力として受信する選択プロセスの構成が可能になります。この場合、観測ポイントの観測パケットストリームは、独立した選択シーケンスで処理されます。 [RFC5476]で指定されているように、選択状態と統計を別々に保つために、Selectorインスタンスごとに異なる一連のSelectorインスタンスを維持する必要があります。

With the configuration data model, it is possible to configure a Metering Process with more than one Selection Processes whose output is processed by a single Cache. This is illustrated in Figure 2.

構成データモデルを使用すると、出力が単一のキャッシュによって処理される複数の選択プロセスでメータリングプロセスを構成できます。これを図2に示します。

              +-------------------------------------+
              | Metering Process                    |
              | +-----------+ Selected              |
     Observed | | Selection | Packet                |
     Packet  -->| Process   |----------+  +-------+ |
     Stream   | +-----------+ Stream   +->|       | |  Stream of
              |      ...                  | Cache |--> Flow Records or
              | +-----------+ Selected +->|       | |  Packet Reports
     Observed | | Selection | Packet   |  +-------+ |
     Packet  -->| Process   |----------+            |
     Stream   | +-----------+ Stream                |
              +-------------------------------------+
        

Figure 2: Metering Process with multiple Selection Processes

図2:複数の選択プロセスを含む計量プロセス

The Observed Packet Streams at the input of a Metering Process may originate from Observation Points belonging to different Observation Domains. By definition of the Observation Domain (see [RFC5101]), however, a Cache MUST NOT aggregate packets observed at different Observation Domains in the same Flow. Hence, if the Cache is configured to generate Flow Records, it needs to distinguish packets according to their Observation Domains.

計測プロセスの入力で観測されたパケットストリームは、異なる観測ドメインに属する観測ポイントから発生する場合があります。ただし、観測ドメインの定義([RFC5101]を参照)により、キャッシュは、同じフロー内の異なる観測ドメインで観測されたパケットを集約してはなりません(MUST NOT)。したがって、キャッシュがフローレコードを生成するように構成されている場合、観測ドメインに従ってパケットを区別する必要があります。

3.2. UML Representation
3.2. UML表現

We use UML class diagrams [UML] to explain the structure of the configuration data model. The attributes of the classes are the configuration or state parameters. The configuration and state parameters of a given Monitoring Device are represented as objects of these classes encoded in XML.

UMLクラス図[UML]を使用して、構成データモデルの構造を説明します。クラスの属性は、構成または状態パラメーターです。特定の監視デバイスの構成および状態パラメータは、XMLでエンコードされたこれらのクラスのオブジェクトとして表されます。

    +------------------------------+
    | SctpExporter                 |
    +------------------------------+    0..1 +------------------------+
    | name                         |<>-------| TransportLayerSecurity |
    | ipfixVersion = 10            |         +------------------------+
    | sourceIPAddress[0..*]        |
    | destinationIPAddress[1..*]   |    0..1 +------------------------+
    | destinationPort = 4739|4740  |<>-------| TransportSession       |
    | ifName/ifIndex[0..1]         |         +------------------------+
    | sendBufferSize {opt.}        |
    | rateLimit[0..1]              |
    | timedReliability = 0         |
    +------------------------------+
        

Figure 3: UML example: SctpExporter class

図3:UMLの例:SctpExporterクラス

As an example, Figure 3 shows the UML diagram of the SctpExporter class, which is specified in more detail in Section 4.4.1. The upper box contains the name of the class. The lower box lists the attributes of the class. Each attribute corresponds to a parameter of the configuration data model.

例として、図3は、セクション4.4.1でより詳細に指定されているSctpExporterクラスのUML図を示しています。上部のボックスには、クラスの名前が含まれています。下のボックスには、クラスの属性が一覧表示されます。各属性は、構成データモデルのパラメーターに対応しています。

Behind an attribute's name, there may appear a multiplicity indicator in brackets (i.e., between "[" and "]"). An attribute with multiplicity indicator "[0..1]" represents an OPTIONAL configuration parameter that is only included in the configuration data if the user configures it. Typically, the absence of an OPTIONAL parameter has a specific meaning. For example, not configuring rateLimit in an object of the SctpExporter class means that no rate limiting will be applied to the exported data. In YANG, an OPTIONAL parameter is specified as a "leaf" without "mandatory true" substatement. The "description" substatement specifies the behavior for the case that the parameter is not configured.

属性の名前の後ろに、括弧で囲まれた多重度インジケータが表示される場合があります(つまり、「[」と「]」の間)。多重度インジケータ「[0..1]」の属性は、ユーザーが構成した場合にのみ構成データに含まれるOPTIONAL構成パラメーターを表します。通常、OPTIONALパラメータがないことには特定の意味があります。たとえば、SctpExporterクラスのオブジェクトでrateLimitを構成しないことは、エクスポートされたデータにレート制限が適用されないことを意味します。 YANGでは、OPTIONALパラメーターは、「必須の真」サブステートメントのない「リーフ」として指定されています。 「説明」サブステートメントは、パラメーターが構成されていない場合の動作を指定します。

The multiplicity indicator "[0..*]" means that this parameter is OPTIONAL and MAY be configured multiple times with different values. In the example, multiple source IP addresses (sourceIPAddress) may be configured for a multihomed Exporting Process. In YANG, an attribute with multiplicity indicator "[0..*]" corresponds to a "leaf-list".

多重度インジケータ「[0 .. *]」は、このパラメータがオプションであり、異なる値で複数回設定できることを意味します。この例では、マルチホームエクスポートプロセスに対して複数のソースIPアドレス(sourceIPAddress)を構成できます。 YANGでは、多重度インジケータ「[0 .. *]」の属性は「リーフリスト」に対応します。

The multiplicity indicator "[1..*]" means that this parameter MUST be configured at least once and MAY be configured multiple times with different values. In the example, one or more destination IP addresses (destinationIPAddress) must be configured to specify the export destination. In YANG, an attribute with multiplicity indicator "[1..*]" corresponds to a "leaf-list" with "min-elements 1" substatement. Note that attributes without this multiplicity indicator MUST NOT appear more than once in each object of the class.

多重度インジケータ「[1 .. *]」は、このパラメータを少なくとも1回設定する必要があり、異なる値で複数回設定する必要があることを意味します。この例では、1つ以上の宛先IPアドレス(destinationIPAddress)を構成して、エクスポート宛先を指定する必要があります。 YANGでは、多重度インジケータ「[1 .. *]」を持つ属性は、「min-elements 1」サブステートメントを持つ「リーフリスト」に対応します。この多重度インジケータのない属性は、クラスの各オブジェクトに複数回出現してはならないことに注意してください。

Attributes without multiplicity indicator may be endued with a default value that is indicated behind the equality symbol ("="). If a default value exists, the parameter does not have to be explicitly configured by the user. If the parameter is not configured by the user, the Monitoring Device MUST use the specified default value for the given parameter. In the example, IPFIX version 10 must be used unless a different value is configured for ipfixVersion. In YANG, an attribute with default value corresponds to a "leaf" with "default" substatement.

多重度インジケータのない属性は、等号( "=")の後ろに示されているデフォルト値で終了する場合があります。デフォルト値が存在する場合、パラメーターをユーザーが明示的に構成する必要はありません。パラメータがユーザーによって構成されていない場合、監視デバイスは、指定されたパラメータに指定されたデフォルト値を使用する必要があります。この例では、ipfixVersionに別の値が構成されていない限り、IPFIXバージョン10を使用する必要があります。 YANGでは、デフォルト値を持つ属性は、「デフォルト」サブステートメントを持つ「リーフ」に対応します。

In the example, there exist two default values for the destination port (destinationPort) -- namely, the registered ports for IPFIX with and without transport layer security (i.e., DTLS or TLS), which are 4740 and 4739, respectively. In the UML diagram, the two default values are separated by a vertical bar ("|"). In YANG, such conditional default value alternatives cannot be specified formally. Instead, they are defined in the "description" substatement of the "leaf".

この例では、宛先ポート(destinationPort)に2つのデフォルト値が存在します。つまり、トランスポート層セキュリティ(DTLSまたはTLS)を使用した場合と使用しない場合のIPFIXの登録済みポートで、それぞれ4740と4739です。 UML図では、2つのデフォルト値は縦棒( "|")で区切られています。 YANGでは、このような条件付きデフォルト値の代替を正式に指定することはできません。代わりに、「リーフ」の「説明」サブステートメントで定義されます。

Further attribute properties are denoted in braces (i.e., between "{" and "}"). An attribute with property "{opt.}", such as sendBufferSize in the SctpExporter class, represents a parameter that MAY be configured by the user. If not configured by the user, the Monitoring Device MUST set an appropriate value for this parameter at configuration time. As a result, the parameter will always exist in the configuration data, yet it is not mandatory for the user to configure it. This behavior can be implemented as a static device-specific default value, but does not have to be. Therefore, the user MUST NOT expect that the device always sets the same values for the same parameter. Regardless of whether the parameter value has been configured by the user or set by the device, the parameter value MUST NOT be changed by the device after configuration. Since this behavior cannot be specified formally in YANG, it is specified in the "description" substatement of the "leaf".

さらなる属性プロパティは中括弧で示されます(つまり、「{」と「}」の間)。 SctpExporterクラスのsendBufferSizeなど、プロパティが「{opt。}」の属性は、ユーザーが設定できるパラメーターを表します。ユーザーが構成しない場合、監視デバイスは構成時にこのパラメーターに適切な値を設定する必要があります。その結果、パラメーターは常に構成データに存在しますが、ユーザーが構成する必要はありません。この動作は、静的なデバイス固有のデフォルト値として実装できますが、そうする必要はありません。したがって、ユーザーは、デバイスが常に同じパラメーターに同じ値を設定することを期待してはなりません。パラメータ値がユーザーによって構成されたか、デバイスによって設定されたかに関係なく、パラメータ値は構成後にデバイスによって変更されてはなりません。この動作はYANGでは正式に指定できないため、「リーフ」の「説明」サブステートメントで指定されています。

The availability of a parameter may depend on another parameter value. In the UML diagram, such restrictions are indicated as attribute properties (e.g., "{SCTP only}"). The given example does not show such restrictions. In YANG, the availability of a parameter is formally restricted with the "when" substatement of the "leaf".

パラメーターの可用性は、別のパラメーター値に依存する場合があります。 UMLダイアグラムでは、このような制限は属性プロパティとして示されます(たとえば、「{SCTPのみ}」)。与えられた例はそのような制限を示していません。 YANGでは、パラメーターの使用可能性は、「リーフ」の「いつ」サブステートメントで正式に制限されています。

Another attribute property not shown in the example is "{readOnly}", which specifies state parameters that cannot be configured. In YANG, this corresponds to the "config false" substatement.

例に示されていない別の属性プロパティは「{readOnly}」です。これは、構成できない状態パラメーターを指定します。 YANGでは、これは「config false」サブステートメントに対応します。

Attributes without multiplicity indicator, without default value, and without "{readOnly}" property are mandatory configuration parameters. These parameters MUST be configured by the user unless an attribute property determines that the parameter is not available. In YANG, a mandatory parameter corresponds to a "leaf" with "mandatory true" substatement. In the example, the user MUST configure the name parameter.

多重度インジケーターなし、デフォルト値なし、および「{readOnly}」プロパティーなしの属性は、必須の構成パラメーターです。これらのパラメーターは、属性プロパティがパラメーターを使用できないと判断しない限り、ユーザーが構成する必要があります。 YANGでは、必須パラメーターは「必須のtrue」サブステートメントを持つ「リーフ」に対応します。この例では、ユーザーはnameパラメータを設定する必要があります。

If some parameters are related to each other, it makes sense to group these parameters in a subclass. This is especially useful if different subclasses represent choices of different parameter sets, or if the parameters of a subclass may appear multiple times. For example, the SctpExporter class MAY contain the parameters of the TransportLayerSecurity subclass.

一部のパラメーターが相互に関連している場合、これらのパラメーターをサブクラスにグループ化することは理にかなっています。これは、異なるサブクラスが異なるパラメーターセットの選択肢を表す場合、またはサブクラスのパラメーターが複数回出現する場合に特に便利です。たとえば、SctpExporterクラスにはTransportLayerSecurityサブクラスのパラメーターが含まれる場合があります。

An object of a class is encoded as an XML element. In order to distinguish between classes and objects, class names start with an uppercase character while the associated XML elements start with lowercase characters. Parameters appear as XML elements that are nested in the XML element of the object. In XML, the parameters of an object can appear in any order and do not have to follow the order in the UML class diagram. Unless specified differently, the order in which parameters appear does not have a meaning. As an example, an object of the SctpExporter class corresponds to one occurrence of

クラスのオブジェクトは、XML要素としてエンコードされます。クラスとオブジェクトを区別するために、クラス名は大文字で始まり、関連するXML要素は小文字で始まります。パラメータは、オブジェクトのXML要素にネストされたXML要素として表示されます。 XMLでは、オブジェクトのパラメーターは任意の順序で表示でき、UMLクラス図の順序に従う必要はありません。別に指定されていない限り、パラメータの表示順序は意味がありません。例として、SctpExporterクラスのオブジェクトは、

     <sctpExporter>
       <name>my-sctp-export</name>
       ...
     </sctpExporter>
        

There are various possibilities how objects of classes can be related to each other. In the scope of this document, we use two different types of relationship between objects: aggregation and unidirectional association. In UML class diagrams, two different arrow types are used as shown in Figure 4.

クラスのオブジェクトを相互に関連付ける方法にはさまざまな可能性があります。このドキュメントの範囲では、オブジェクト間の2つの異なるタイプの関係を使用します。集約と単方向の関連付けです。 UMLクラス図では、図4に示すように2つの異なる矢印タイプが使用されます。

            +---+   0..* +---+         +---+ 0..*  1 +---+
            | A |<>------| B |         | A |-------->| B |
            +---+        +---+         +---+         +---+
             (a) Aggregation     (b) Unidirectional association
        

Figure 4: Class relationships in UML class diagrams

図4:UMLクラス図のクラス関係

Aggregation means that one object is part of the other object. In Figure 4 (a), an object of class B is part of an object of class A. This corresponds to nested XML elements:

集約とは、1つのオブジェクトが他のオブジェクトの一部であることを意味します。図4(a)では、クラスBのオブジェクトはクラスAのオブジェクトの一部です。これはネストされたXML要素に対応しています。

     <a>
       <b>
         ...
       </b>
       ...
     </a>
        

In the example, objects of the TransportLayerSecurity class and the TransportSession class appear as nested XML elements <transportLayerSecurity> and <transportSession> within an object of the SctpExporter class <sctpExporter>.

この例では、TransportLayerSecurityクラスとTransportSessionクラスのオブジェクトは、SctpExporterクラス<sctpExporter>のオブジェクト内にネストされたXML要素<transportLayerSecurity>および<transportSession>として表示されます。

A unidirectional association is a reference to an object. In Figure 4(b), an object of class A contains a reference to an object of class B. This corresponds to separate XML elements that are not nested. To distinguish different objects of class B, class B must have a key. In the configuration data model, keys are string parameters called "name", corresponding to XML elements <name>. The names MUST be unique within the given XML subtree. The reference to a specific object of class B is encoded with an XML element <b>, which contains the name of an object. If an object of class A refers to the object of class B with name "foo", this looks as follows:

単方向の関連付けは、オブジェクトへの参照です。図4(b)では、クラスAのオブジェクトにクラスBのオブジェクトへの参照が含まれています。これは、ネストされていない個別のXML要素に対応しています。クラスBの異なるオブジェクトを区別するには、クラスBにキーが必要です。構成データモデルでは、キーは "name"と呼ばれる文字列パラメーターで、XML要素<name>に対応します。名前は、指定されたXMLサブツリー内で一意である必要があります。クラスBの特定のオブジェクトへの参照は、オブジェクトの名前を含むXML要素<b>でエンコードされます。クラスAのオブジェクトが「foo」という名前のクラスBのオブジェクトを参照する場合、これは次のようになります。

     <a>
       ...
       <b>foo</b>
       ...
     </a>
        
     <b>
       <name>foo</name>
       ...
     </b>
        

In Figure 4, the indicated numbers define the multiplicity:

図4では、示された数値が多重度を定義しています。

      "1": one only
      "0..*": zero or more
      "1..*": one or more
        

In the case of aggregation, the multiplicity indicates how many objects of one class may be included in one object of the other class. In Figure 4(a), an object of class A may contain an arbitrary number of objects of class B. In the case of unidirectional association, the multiplicity at the arrowhead specifies the number of objects of a given class that may be referred to. The multiplicity at the arrow tail specifies how many different objects of one class may refer to a single object of the other class. In Figure 4(b), an object of class A refers to single object of class B. One object of class B can be referred to from an arbitrary number of objects of class A.

集約の場合、多重度は、1つのクラスのオブジェクトが他のクラスの1つのオブジェクトに含まれる可能性がある数を示します。図4(a)では、クラスAのオブジェクトに任意の数のクラスBのオブジェクトを含めることができます。単方向の関連付けの場合、矢印の多重度は、参照できる特定のクラスのオブジェクトの数を指定します。矢印の尾の多重度は、あるクラスの異なるオブジェクトが他のクラスの単一のオブジェクトを参照できる数を指定します。図4(b)では、クラスAのオブジェクトはクラスBの単一のオブジェクトを参照しています。クラスBの1つのオブジェクトは、クラスAの任意の数のオブジェクトから参照できます。

Similar to classes that are referenced in UML associations, classes that contain configuration parameters and that occur in an aggregation relationship with multiplicity greater than one must have a key. This key is necessary because every configuration parameter must be addressable in order to manipulate or delete it. The key values MUST be unique in the given XML subtree (i.e., unique within the aggregating object). Hence, if class B in Figure 4(a) contains a configuration parameter, all objects of class B belonging to the same object of class A must have different key values. Again, the key appears as an attribute called "name" in the concerned classes.

UML関連付けで参照されるクラスと同様に、構成パラメーターを含み、1より大きい多重度との集約関係で発生するクラスには、キーが必要です。このキーが必要なのは、操作または削除するために、すべての構成パラメーターがアドレス可能でなければならないためです。キー値は、特定のXMLサブツリー内で一意である必要があります(つまり、集約オブジェクト内で一意です)。したがって、図4(a)のクラスBに構成パラメーターが含まれている場合、クラスAの同じオブジェクトに属するクラスBのすべてのオブジェクトは、異なるキー値を持つ必要があります。この場合も、キーは関連するクラスで「名前」と呼ばれる属性として表示されます。

A class that contains state parameters but no configuration parameters, such as the Template class (see Section 4.8), does not have a key. This is because state parameters cannot be manipulated or deleted, and therefore do not need to be addressable.

状態パラメーターを含むが、テンプレートクラス(セクション4.8を参照)などの構成パラメーターを含まないクラスには、キーがありません。これは、状態パラメータを操作または削除できないため、アドレス可能である必要がないためです。

Note that the usage of keys as described above is required by YANG [RFC6020], which mandates the existence of a key for elements that appear in a list of configuration data.

上記のようなキーの使用は、構成データのリストに表示される要素のキーの存在を義務付けるYANG [RFC6020]によって要求されることに注意してください。

The configuration data model for IPFIX and PSAMP makes use of unidirectional associations to specify the data flow between different functional blocks. For example, if the output of a Selection Process is processed by a Cache, this corresponds to an object of the SelectionProcess class that contains a reference to an object of the Cache class. The configuration data model does not mandate that such a reference exists for every functional block that has an output. If such a reference is absent, the output is dropped without any further processing. Although such configurations are incomplete, we do not consider them invalid as they may temporarily occur if a Monitoring Device is configured in multiple steps. Also, it might be useful to pre-configure certain functions of a Monitoring Device in order to be able to switch to a new configuration more quickly.

IPFIXとPSAMPの構成データモデルは、単方向の関連付けを利用して、異なる機能ブロック間のデータフローを指定します。たとえば、選択プロセスの出力がキャッシュによって処理される場合、これは、キャッシュクラスのオブジェクトへの参照を含むSelectionProcessクラスのオブジェクトに対応します。構成データモデルは、出力を持つすべての機能ブロックにそのような参照が存在することを義務付けていません。そのような参照が存在しない場合、出力はそれ以上処理されずにドロップされます。このような構成は不完全ですが、監視デバイスが複数のステップで構成されている場合は一時的に発生する可能性があるため、無効とは見なしません。また、新しい構成にすばやく切り替えることができるように、監視デバイスの特定の機能を事前に構成しておくと便利な場合があります。

3.3. Exporter Configuration
3.3. エクスポーター構成

Figure 5 below shows the main classes of the configuration data model that are involved in the configuration of an IPFIX or PSAMP Exporter. The role of the classes can be briefly summarized as follows:

以下の図5は、IPFIXまたはPSAMPエクスポーターの構成に関係する構成データモデルの主なクラスを示しています。クラスの役割は、次のように簡単に要約できます。

o The ObservationPoint class specifies an Observation Point (i.e., an interface or linecard) of the Monitoring Device at which packets are captured for traffic measurements. An object of the ObservationPoint class may be associated with one or more objects of the SelectionProcess class configuring Selection Processes that process the observed packets in parallel. As long as an ObservationPoint object is specified without any references to SelectionProcess objects, the captured packets are not considered by any Metering Process.

o ObservationPointクラスは、トラフィック測定のためにパケットがキャプチャされる監視デバイスの監視ポイント(つまり、インターフェースまたはラインカード)を指定します。 ObservationPointクラスのオブジェクトは、監視対象のパケットを並行して処理する選択プロセスを構成するSelectionProcessクラスの1つ以上のオブジェクトに関連付けることができます。 SelectionProcessオブジェクトへの参照なしでObservationPointオブジェクトが指定されている限り、キャプチャされたパケットはどのメータリングプロセスでも考慮されません。

o The SelectionProcess class contains the configuration and state parameters of a Selection Process. The Selection Process may be composed of a single Selector or a sequence of Selectors, defining a Primitive or Composite Selector, respectively.

o SelectionProcessクラスには、選択プロセスの構成パラメーターと状態パラメーターが含まれています。選択プロセスは、それぞれプリミティブセレクターまたはコンポジットセレクターを定義する、単一のセレクターまたは一連のセレクターで構成できます。

The Selection Process selects packets from one or more Observed Packet Streams, each originating from a different Observation Point. Therefore, a SelectionProcess object MAY be referred to from one or more ObservationPoint objects.

選択プロセスでは、1つ以上の監視対象パケットストリームからパケットを選択します。各パケットは、異なる監視ポイントから発信されます。したがって、SelectionProcessオブジェクトは、1つ以上のObservationPointオブジェクトから参照される場合があります。

A Selection Process MAY pass the Selected Packet Stream to a Cache. Therefore, the SelectionProcess class contains a reference to an object of the Cache class. If a Selection Process is configured without any reference to a Cache, the selected packets are not accounted in any Packet Report or Flow Record.

選択プロセスは、選択されたパケットストリームをキャッシュに渡す場合があります。したがって、SelectionProcessクラスには、Cacheクラスのオブジェクトへの参照が含まれています。選択プロセスがキャッシュを参照せずに構成されている場合、選択されたパケットはパケットレポートまたはフローレコードに含まれません。

o The Cache class contains configuration and state parameters of a Cache. A Cache may receive the output of one or more Selection Processes and maintains corresponding Packet Reports or Flow Records. Therefore, an object of the Cache class MAY be referred to from multiple SelectionProcess objects.

o Cacheクラスには、キャッシュの構成および状態パラメーターが含まれます。キャッシュは、1つ以上の選択プロセスの出力を受信し、対応するパケットレポートまたはフローレコードを保持します。したがって、Cacheクラスのオブジェクトは、複数のSelectionProcessオブジェクトから参照される場合があります。

Configuration parameters of the Cache class specify the size of the Cache, the Cache Layout, and expiration parameters if applicable. The Cache configuration also determines whether Packet Reports or Flow Records are generated.

キャッシュクラスの構成パラメーターは、キャッシュのサイズ、キャッシュレイアウト、および必要に応じて有効期限パラメーターを指定します。キャッシュ構成は、パケットレポートまたはフローレコードを生成するかどうかも決定します。

A Cache MAY pass its output to one or more Exporting Processes. Therefore, the Cache class enables references to one or more objects of the ExportingProcess class. If a Cache object does not specify any reference to an ExportingProcess object, the Cache output is dropped.

キャッシュは、その出力を1つ以上のエクスポートプロセスに渡す場合があります。したがって、Cacheクラスは、ExportingProcessクラスの1つ以上のオブジェクトへの参照を有効にします。 CacheオブジェクトがExportingProcessオブジェクトへの参照を指定していない場合、Cache出力はドロップされます。

o The ExportingProcess class contains configuration and state parameters of an Exporting Process. It includes various transport-protocol-specific parameters and the export destinations. An object of the ExportingProcess class MAY be referred to from multiple objects of the Cache class.

o ExportingProcessクラスには、エクスポートプロセスの構成パラメーターと状態パラメーターが含まれています。これには、さまざまなトランスポートプロトコル固有のパラメータとエクスポート先が含まれます。 ExportingProcessクラスのオブジェクトは、Cacheクラスの複数のオブジェクトから参照される場合があります。

An Exporting Process MAY be configured as a File Writer according to [RFC5655].

[RFC5655]に従って、エクスポートプロセスをファイルライターとして構成できます。

                            +------------------+
                            | ObservationPoint |
                            +------------------+
                                 0..* |
                                      |
                                 0..* V
                            +------------------+
                            | SelectionProcess |
                            +------------------+
                                 0..* |
                                      |
                                 0..1 V
                            +------------------+
                            | Cache            |
                            +------------------+
                                 0..* |
                                      |
                                 0..* V
                            +------------------+
                            | ExportingProcess |
                            +------------------+
        

Figure 5: Class diagram of Exporter configuration

図5:エクスポーター構成のクラス図

3.4. Collector Configuration
3.4. コレクター構成

Figure 6 below shows the main classes of the configuration data model that are involved in the configuration of a Collector. An object of the CollectingProcess class specifies the local IP addresses, transport protocols, and port numbers of a Collecting Process. Alternatively, the Collecting Process MAY be configured as a File Reader according to [RFC5655].

以下の図6は、コレクターの構成に関係する構成データモデルの主なクラスを示しています。 CollectingProcessクラスのオブジェクトは、収集プロセスのローカルIPアドレス、トランスポートプロトコル、およびポート番号を指定します。あるいは、[RFC5655]に従って、収集プロセスをファイルリーダーとして構成できます。

An object of the CollectingProcess class may refer to one or more ExportingProcess objects configuring Exporting Processes that reexport the received data. As an example, an Exporting Process can be configured as a File Writer in order to save the received IPFIX Messages in a file.

CollectingProcessクラスのオブジェクトは、受信したデータを再エクスポートするエクスポートプロセスを構成する1つ以上のExportingProcessオブジェクトを参照する場合があります。例として、受信したIPFIXメッセージをファイルに保存するために、エクスポートプロセスをファイルライターとして構成できます。

                           +-------------------+
                           | CollectingProcess |
                           +-------------------+
                                0..* |
                                     |
                                0..* V
                           +-------------------+
                           | ExportingProcess  |
                           +-------------------+
        

Figure 6: Class diagram of Collector configuration

図6:コレクター構成のクラス図

4. Configuration Parameters
4. 構成パラメータ

This section specifies the configuration and state parameters of the configuration data model separately for each class.

このセクションでは、構成データモデルの構成および状態パラメーターをクラスごとに個別に指定します。

4.1. ObservationPoint Class
4.1. ObservationPointクラス
         +-------------------------------+
         | ObservationPoint              |
         +-------------------------------+
         | name                          |
         | observationPointId {readOnly} |
         | observationDomainId           | 0..*
         | ifName[0..*]                  |-------------+
         | ifIndex[0..*]                 |             | 0..*
         | entPhysicalName[0..*]         |             V
         | entPhysicalIndex[0..*]        |    +------------------+
         | direction = "both"            |    | SelectionProcess |
         +-------------------------------+    +------------------+
        

Figure 7: ObservationPoint class

図7:ObservationPointクラス

Figure 7 shows the ObservationPoint class that specifies an Observation Point of the Monitoring Device.

図7は、監視デバイスの観測ポイントを指定するObservationPointクラスを示しています。

As defined in [RFC5101], an Observation Point can be any location where packets are observed. A Monitoring Device potentially has more than one such location. An instance of ObservationPoint class defines which location is associated with a specific Observation Point. For this purpose, interfaces and physical entities are identified using their names. Alternatively, index values of the corresponding entries in the ifTable (IF-MIB module [RFC2863]) or the entPhysicalTable (ENTITY-MIB module [RFC4133]) can be used as identifiers. However, indices SHOULD only be used as identifiers if an SNMP agent on the same Monitoring Device enables access to the corresponding MIB tables.

[RFC5101]で定義されているように、観測ポイントは、パケットが観測される任意の場所にすることができます。監視デバイスには、そのような場所が複数ある可能性があります。 ObservationPointクラスのインスタンスは、特定の観測ポイントに関連付けられている場所を定義します。この目的のために、インターフェースと物理エンティティはそれらの名前を使用して識別されます。または、ifTable(IF-MIBモジュール[RFC2863])またはentPhysicalTable(ENTITY-MIBモジュール[RFC4133])の対応するエントリのインデックス値を識別子として使用できます。ただし、インデックスは、同じ監視デバイス上のSNMPエージェントが対応するMIBテーブルへのアクセスを有効にする場合にのみ識別子として使用する必要があります(SHOULD)。

By its definition in [RFC5101], an Observation Point may be associated with a set of interfaces. Therefore, the configuration data model allows configuring multiple interfaces and physical entities for a single Observation Point.

[RFC5101]での定義により、観測ポイントは一連のインターフェースに関連付けることができます。したがって、構成データモデルでは、単一の観測ポイントに対して複数のインターフェイスと物理エンティティを構成できます。

The Observation Point ID (i.e., the value of the Information Element observationPointId [IANA-IPFIX]) is assigned by the Monitoring Device. It appears as a state parameter in the ObservationPoint class.

監視ポイントID(つまり、情報要素のObservationPointId [IANA-IPFIX]の値)は、監視デバイスによって割り当てられます。これは、ObservationPointクラスの状態パラメーターとして表示されます。

The configuration parameters of the Observation Point are:

観測ポイントの構成パラメータは次のとおりです。

observationDomainId: This parameter defines the identifier of the Observation Domain the Observation Point belongs to. Observation Points that are configured with the same Observation Domain ID belong to the same Observation Domain. Note that this parameter corresponds to ipfixObservationPointObservationDomainId in the IPFIX MIB module [RFC6615].

ObservationDomainId:このパラメーターは、観測ポイントが属する観測ドメインの識別子を定義します。同じ観測ドメインIDで構成された観測ポイントは、同じ観測ドメインに属します。このパラメーターは、IPFIX MIBモジュール[RFC6615]のipfixObservationPointObservationDomainIdに対応することに注意してください。

ifName/ifIndex/entPhysicalName/entPhysicalIndex: These parameters identify interfaces and physical entities (e.g., linecards) that are on the Monitoring Device and are associated with the given Observation Point. An interface is either identified by its name (ifName) or the ifIndex value of the corresponding object in the IF-MIB module [RFC2863]. ifIndex SHOULD only be used if an SNMP agent enables access to the ifTable. Similarly, a physical entity is either identified by its name (entPhysicalName) or the entPhysicalIndex value of the corresponding object in the ENTITY-MIB module [RFC4133]. entPhysicalIndex SHOULD only be used if an SNMP agent enables access to the entPhysicalTable. Note that the parameters ifIndex and entPhysicalIndex correspond to ipfixObservationPointPhysicalInterface and ipfixObservationPointPhysicalEntity in the IPFIX MIB module [RFC6615].

ifName / ifIndex / entPhysicalName / entPhysicalIndex:これらのパラメーターは、監視デバイス上にあり、特定の観測ポイントに関連付けられているインターフェースと物理エンティティー(ラインカードなど)を識別します。インターフェイスは、名前(ifName)またはIF-MIBモジュール[RFC2863]の対応するオブジェクトのifIndex値で識別されます。 ifIndexは、SNMPエージェントがifTableへのアクセスを有効にする場合にのみ使用してください。同様に、物理エンティティは、その名前(entPhysicalName)またはENTITY-MIBモジュール[RFC4133]内の対応するオブジェクトのentPhysicalIndex値によって識別されます。 entPhysicalIndexは、SNMPエージェントがentPhysicalTableへのアクセスを有効にする場合にのみ使用してください。パラメータifIndexおよびentPhysicalIndexは、IPFIX MIBモジュール[RFC6615]のipfixObservationPointPhysicalInterfaceおよびipfixObservationPointPhysicalEntityに対応することに注意してください。

direction: This parameter specifies if ingress traffic, egress traffic, or both ingress and egress traffic is captured, using the values "ingress", "egress", and "both", respectively. If not configured, ingress and egress traffic is captured (i.e., the default value is "both"). If not applicable (e.g., in the case of a sniffing interface in promiscuous mode), the value of this parameter is ignored.

direction:このパラメータは、「ingress」、「egress」、および「both」という値をそれぞれ使用して、入力トラフィック、出力トラフィック、または入力トラフィックと出力トラフィックの両方をキャプチャするかどうかを指定します。設定されていない場合、入力トラフィックと出力トラフィックがキャプチャされます(つまり、デフォルト値は「両方」です)。該当しない場合(たとえば、混合モードのスニッフィングインターフェイスの場合)、このパラメーターの値は無視されます。

An ObservationPoint object MAY refer to one or more SelectionProcess objects configuring Selection Processes that process the observed packets in parallel.

ObservationPointオブジェクトは、監視対象のパケットを並行して処理する選択プロセスを構成する1つ以上のSelectionProcessオブジェクトを参照する場合があります。

4.2. SelectionProcess Class
4.2. 選択プロセスクラス
       +------------------+
       | SelectionProcess |
       +------------------+   1..* +----------+
       | name             |<>------| Selector |
       |                  |        +----------+
       |                  |
       |                  |   0..* +--------------------------------+
       |                  |<>------| SelectionSequence              |
       |                  |        +--------------------------------+
       |                  |        | observationDomainId {readOnly} |
       |                  |        | selectionSequenceId {readOnly} |
       |                  |        +--------------------------------+
       |                  |
       |                  | 0..*  0..1 +-------+
       |                  |----------->| Cache |
       +------------------+            +-------+
        

Figure 8: SelectionProcess class

図8:SelectionProcessクラス

Figure 8 shows the SelectionProcess class. The SelectionProcess class contains the configuration and state parameters of a Selection Process that selects packets from one or more Observed Packet Streams and generates a Selected Packet Stream as its output. A non-empty ordered list defines a sequence of Selectors. The actions defined by the Selectors are applied to the stream of incoming packets in the specified order.

図8は、SelectionProcessクラスを示しています。 SelectionProcessクラスには、1つ以上の監視されたパケットストリームからパケットを選択し、その出力として選択されたパケットストリームを生成する選択プロセスの構成および状態パラメーターが含まれています。空でない順序付きリストは、セレクターのシーケンスを定義します。セレクタによって定義されたアクションは、指定された順序で着信パケットのストリームに適用されます。

If the Selection Process receives packets from multiple Observation Points, the Observed Packet Streams need to be processed independently in separate Selection Sequences. Each Selection Sequence is identified by a Selection Sequence ID that is unique within the Observation Domain the Observation Point belongs to (see [RFC5477]). Selection Sequence IDs are assigned by the Monitoring Device. As state parameters, the SelectionProcess class contains a list of (observationDomainId, selectionSequenceId) tuples specifying the assigned Selection Sequence IDs and corresponding Observation Domain IDs. With this information, it is possible to associate Selection Sequence (Statistics) Report Interpretations exported according to the PSAMP protocol specification [RFC5476] with the corresponding object of the SelectionProcess class.

選択プロセスが複数の観測ポイントからパケットを受信する場合、観測されたパケットストリームは個別の選択シーケンスで個別に処理する必要があります。各選択シーケンスは、観測ポイントが属する観測ドメイン内で一意の選択シーケンスIDによって識別されます([RFC5477]を参照)。選択シーケンスIDは、監視デバイスによって割り当てられます。状態パラメーターとして、SelectionProcessクラスには、割り当てられた選択シーケンスIDと対応する監視ドメインIDを指定する(observationDomainId、selectionSequenceId)タプルのリストが含まれます。この情報を使用して、PSAMPプロトコル仕様[RFC5476]に従ってエクスポートされた選択シーケンス(統計)レポート解釈を、SelectionProcessクラスの対応するオブジェクトに関連付けることができます。

A SelectionProcess object MAY include a reference to an object of the Cache class to generate Packet Reports or Flow Records from the Selected Packet Stream.

SelectionProcessオブジェクトは、選択されたパケットストリームからパケットレポートまたはフローレコードを生成するために、キャッシュクラスのオブジェクトへの参照を含めることができます。

4.2.1. Selector Class
4.2.1. セレクタークラス
    +--------------------------------------+
    | Selector                             |
    +--------------------------------------+      1 +-----------------+
    | name                                 |<>------+ SelectAll/      |
    | packetsObserved {readOnly}           |        | SampCountBased/ |
    | packetsDropped {readOnly}            |        | SampTimeBased/  |
    | selectorDiscontinuityTime {readOnly} |        | SampRandOutOfN/ |
    |                                      |        | SampUniProb/    |
    |                                      |        | FilterMatch/    |
    |                                      |        | FilterHash/     |
    +--------------------------------------+        +-----------------+
        

Figure 9: Selector class

図9:セレクタークラス

The Selector class in Figure 9 contains the configuration and state parameters of a Selector. Standardized PSAMP Sampling and Filtering methods are described in [RFC5475]; their configuration parameters are specified in the classes SampCountBased, SampTimeBased, SampRandOutOfN, SampUniProb, FilterMatch, and FilterHash. In addition, the SelectAll class, which has no parameters, is used for a Selector that selects all packets. The Selector class includes exactly one of these sampler and filter classes, depending on the applied method.

図9のSelectorクラスには、セレクターの構成パラメーターと状態パラメーターが含まれています。標準化されたPSAMPサンプリングおよびフィルタリング方法は、[RFC5475]で説明されています。それらの構成パラメーターは、SampCountBased、SampTimeBased、SampRandOutOfN、SampUniProb、FilterMatch、およびFilterHashクラスで指定されます。また、すべてのパケットを選択するセレクターには、パラメーターを持たないSelectAllクラスが使用されます。 Selectorクラスには、適用されるメソッドに応じて、これらのサンプラークラスとフィルタークラスのいずれか1つが含まれます。

As state parameters, the Selector class contains the Selector statistics packetsObserved and packetsDropped as well as selectorDiscontinuityTime, which correspond to the IPFIX MIB module objects ipfixSelectionProcessStatsPacketsObserved, ipfixSelectionProcessStatsPacketsDropped, and ipfixSelectionProcessStatsDiscontinuityTime, respectively [RFC6615]:

Selectorクラスには、状態パラメーターとして、Selector統計のpacketObserved、packetsDropped、およびselectorDiscontinuityTimeが含まれています。これらはIPFIX MIBモジュールオブジェクトipfixSelectionProcessStatsPacketsObserved、ipfixSelectionProcessStatsPacketsDropped、およびipfixSelectionProcessStatsDiscontinuityTimeにそれぞれ対応しています[RFC6615]:

packetsObserved: The total number of packets observed at the input of the Selector. If this is the first Selector in the Selection Process, this counter corresponds to the total number of packets in all Observed Packet Streams at the input of the Selection Process. Otherwise, the counter corresponds to the total number of packets at the output of the preceding Selector. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of selectorDiscontinuityTime.

packetsObserved:セレクターの入力で観測されたパケットの総数。これが選択プロセスの最初のセレクタである場合、このカウンタは、選択プロセスの入力で観測されたすべてのパケットストリームのパケットの総数に対応します。それ以外の場合、カウンタは、先行するセレクタの出力でのパケットの総数に対応します。このカウンターの値の不連続は、管理システムの再初期化時に発生する場合と、selectorDiscontinuityTimeの値によって示される他の場合に発生する場合があります。

packetsDropped: The total number of packets discarded by the Selector. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of selectorDiscontinuityTime.

packetsDropped:セレクタによって破棄されたパケットの総数。このカウンターの値の不連続は、管理システムの再初期化時に発生する場合と、selectorDiscontinuityTimeの値によって示される他の場合に発生する場合があります。

selectorDiscontinuityTime: Timestamp of the most recent occasion at which one or more of the Selector counters suffered a discontinuity. In contrast to ipfixSelectionProcessStatsDiscontinuityTime, the time is absolute and not relative to sysUpTime.

selectorDiscontinuityTime:1つ以上のセレクターカウンターで不連続性が発生した最新のタイムスタンプ。 ipfixSelectionProcessStatsDiscontinuityTimeとは対照的に、時間は絶対値であり、sysUpTimeに関連していません。

Note that packetsObserved and packetsDropped are aggregate statistics calculated over all Selection Sequences of the Selection Process. This is in contrast to the counter values in the Selection Sequence Statistics Report Interpretation [RFC5476], which are related to a single Selection Sequence only.

packetsObservedとpacketsDroppedは、選択プロセスのすべての選択シーケンスで計算された集計統計であることに注意してください。これは、単一の選択シーケンスのみに関連する、選択シーケンス統計レポート解釈[RFC5476]のカウンター値とは対照的です。

4.2.2. Sampler Classes
4.2.2. サンプラークラス
        +----------------+   +----------------+   +----------------+
        | SampCountBased |   | SampTimeBased  |   | SampRandOutOfN |
        +----------------+   +----------------+   +----------------+
        | packetInterval |   | timeInterval   |   | population     |
        | packetSpace    |   | timeSpace      |   | size           |
        +----------------+   +----------------+   +----------------+
        
        +----------------+
        | SampUniProb    |
        +----------------+
        | probability    |
        +----------------+
        

Figure 10: Sampler classes

図10:サンプラークラス

The Sampler classes in Figure 10 contain the configuration parameters of specific Sampling algorithms:

図10のサンプラークラスには、特定のサンプリングアルゴリズムの構成パラメーターが含まれています。

packetInterval, packetSpace: For systematic count-based Sampling, packetInterval defines the number of packets that are consecutively sampled between gaps of length packetSpace. These parameters correspond to the Information Elements samplingPacketInterval and samplingPacketSpace [RFC5477], as well as to the PSAMP MIB objects psampSampCountBasedInterval and psampSampCountBasedSpace [RFC6727].

packetInterval、packetSpace:系統的なカウントベースのサンプリングの場合、packetIntervalは、packetSpaceの長さのギャップ間で連続的にサンプリングされるパケットの数を定義します。これらのパラメーターは、情報要素のsamplingPacketIntervalおよびsamplingPacketSpace [RFC5477]、およびPSAMP MIBオブジェクトpsampSampCountBasedIntervalおよびpsampSampCountBasedSpace [RFC6727]に対応しています。

timeInterval, timeSpace: For systematic time-based Sampling, timeInterval defines the time interval during which all arriving packets are sampled. timeSpace is the gap between two Sampling intervals. These parameters correspond to the Information Elements samplingTimeInterval and samplingTimeSpace [RFC5477], as well as to the PSAMP MIB objects psampSampTimeBasedInterval and psampSampTimeBasedSpace [RFC6727]. The unit is microseconds.

timeInterval、timeSpace:体系的な時間ベースのサンプリングの場合、timeIntervalは、到着するすべてのパケットがサンプリングされる時間間隔を定義します。 timeSpaceは、2つのサンプリング間隔の間のギャップです。これらのパラメーターは、情報要素のサンプリング時間間隔とサンプリング時間スペース[RFC5477]、およびPSAMP MIBオブジェクトのpsampSampTimeBasedIntervalとpsampSampTimeBasedSpace [RFC6727]に対応しています。単位はマイクロ秒です。

size, population: For n-out-of-N random Sampling, size defines the number of elements taken from the parent population. population defines the number of elements in the parent population. These parameters correspond to the Information Elements samplingSize and samplingPopulation [RFC5477], as well as to the PSAMP MIB objects psampSampRandOutOfNSize and psampSampRandOutOfNPopulation [RFC6727].

サイズ、母集団:n-out-of-Nランダムサンプリングの場合、サイズは親母集団から取得される要素の数を定義します。母集団は、親母集団の要素数を定義します。これらのパラメーターは、情報要素のsamplingSizeおよびsamplingPopulation [RFC5477]、およびPSAMP MIBオブジェクトpsampSampRandOutOfNSizeおよびpsampSampRandOutOfNPopulation [RFC6727]に対応しています。

probability: For uniform probabilistic Sampling, probability defines the Sampling probability. The probability is expressed as a value between 0 and 1. This parameter corresponds to the Information Element samplingProbability [RFC5477], as well as to the PSAMP MIB object psampSampUniProbProbability [RFC6727].

確率:一様確率的サンプリングの場合、確率はサンプリング確率を定義します。確率は0と1の間の値として表されます。このパラメーターは、情報要素のサンプリングの確率[RFC5477]、およびPSAMP MIBオブジェクトのpsampSampUniProbProbability [RFC6727]に対応します。

4.2.3. Filter Classes
4.2.3. フィルタークラス
          +---------------------------+
          | FilterMatch               |
          +---------------------------+
          | ieId/ieName               |
          | ieEnterpriseNumber = 0    |
          | value                     |
          +---------------------------+
        
          +---------------------------+
          | FilterHash                |
          +---------------------------+    1..* +---------------+
          | hashFunction = "BOB"      |<>-------| SelectedRange |
          | initializerValue[0..1]    |         +---------------+
          | ipPayloadOffset = 0       |         | name          |
          | ipPayloadSize = 8         |         | min           |
          | digestOutput = "false"    |         | max           |
          | outputRangeMin {readOnly} |         +---------------+
          | outputRangeMax {readOnly} |
          +---------------------------+
        

Figure 11: Filter classes

図11:フィルタークラス

The Filter classes in Figure 11 contain the configuration parameters of specific Filtering methods. For property match Filtering, the configuration parameters are:

図11のフィルタークラスには、特定のフィルタリングメソッドの構成パラメーターが含まれています。プロパティ一致フィルタリングの場合、構成パラメーターは次のとおりです。

ieId, ieName, ieEnterpriseNumber: The property to be matched is specified by either ieId or ieName, specifying the identifier or name of the Information Element, respectively. If ieEnterpriseNumber is zero (which is the default), this Information Element is registered in the IANA registry of IPFIX Information Elements [IANA-IPFIX]. A non-zero value of ieEnterpriseNumber specifies an enterprise-specific Information Element [IANA-ENTERPRISE-NUMBERS].

ieId、ieName、ieEnterpriseNumber:一致するプロパティは、情報要素の識別子または名前をそれぞれ指定するieIdまたはieNameのいずれかによって指定されます。 ieEnterpriseNumberがゼロ(デフォルト)の場合、この情報要素はIPFIX情報要素のIANAレジストリに登録されます[IANA-IPFIX]。 ieEnterpriseNumberのゼロ以外の値は、エンタープライズ固有の情報要素[IANA-ENTERPRISE-NUMBERS]を指定します。

value: Matching value.

value:一致する値。

For hash-based Filtering, the configuration and state parameters are:

ハッシュベースのフィルタリングの場合、構成パラメーターと状態パラメーターは次のとおりです。

hashFunction: Hash function to be used. The following parameter values are defined by the configuration data model: * BOB: BOB Hash Function as specified in [RFC5475], Appendix A.2 * IPSX: IP Shift-XOR (IPSX) Hash Function as specified in [RFC5475], Appendix A.1 * CRC: CRC-32 function as specified in [RFC1141] Default value is "BOB". This parameter corresponds to the PSAMP MIB object psampFiltHashFunction [RFC6727].

hashFunction:使用するハッシュ関数。以下のパラメーター値は、構成データモデルによって定義されています。* BOB:[RFC5475]、付録Aで指定されているBOBハッシュ関数* IPSX:[RFC5475]、付録Aで指定されているIP Shift-XOR(IPSX)ハッシュ関数.1 * CRC:[RFC1141]で指定されたCRC-32機能デフォルト値は「BOB」です。このパラメーターは、PSAMP MIBオブジェクトpsampFiltHashFunction [RFC6727]に対応しています。

initializerValue: Initializer value to the hash function. This parameter corresponds to the Information Element hashInitialiserValue [RFC5477], as well as to the PSAMP MIB object psampFiltHashInitializerValue [RFC6727]. If not configured by the user, the Monitoring Device arbitrarily chooses an initializer value.

initializerValue:ハッシュ関数への初期化子の値。このパラメーターは、情報要素のhashInitialiserValue [RFC5477]と、PSAMP MIBオブジェクトのpsampFiltHashInitializerValue [RFC6727]に対応しています。ユーザーが構成していない場合、監視デバイスは任意に初期化子の値を選択します。

ipPayloadOffset, ipPayloadSize: ipPayloadOffset and ipPayloadSize configure the offset and the size of the payload section used as input to the hash function. Default values are 0 and 8, respectively, corresponding to the minimum configurable values according to [RFC5476], Section 6.5.2.6. These parameters correspond to the Information Elements hashIPPayloadOffset and hashIPPayloadSize [RFC5477], as well as to the PSAMP MIB objects psampFiltHashIpPayloadOffset and psampFiltHashIpPayloadSize [RFC6727].

ipPayloadOffset、ipPayloadSize:ipPayloadOffsetおよびipPayloadSizeは、ハッシュ関数への入力として使用されるペイロードセクションのオフセットとサイズを構成します。デフォルト値はそれぞれ0と8で、[RFC5476]のセクション6.5.2.6に従って構成可能な最小値に対応しています。これらのパラメーターは、情報要素のhashIPPayloadOffsetとhashIPPayloadSize [RFC5477]、およびPSAMP MIBオブジェクトのpsampFiltHashIpPayloadOffsetとpsampFiltHashIpPayloadSize [RFC6727]に対応しています。

digestOutput: digestOutput enables or disables the inclusion of the packet digest in the resulting PSAMP Packet Report. This requires that the Cache Layout of the Cache generating the Packet Reports includes a digestHashValue field. This parameter corresponds to the Information Element hashDigestOutput [RFC5477].

digestOutput:digestOutputは、結果のPSAMPパケットレポートにパケットダイジェストを含めることを有効または無効にします。これには、パケットレポートを生成するキャッシュのキャッシュレイアウトにdigestHashValueフィールドが含まれている必要があります。このパラメータは、情報要素hashDigestOutput [RFC5477]に対応しています。

outputRangeMin, outputRangeMax: The values of these two state parameters are the beginning and end of the hash function's potential output range. These parameters correspond to the Information Elements hashOutputRangeMin and hashOutputRangeMax [RFC5477], as well as to the PSAMP MIB objects psampFiltHashOutputRangeMin and psampFiltHashOutputRangeMax [RFC6727].

outputRangeMin、outputRangeMax:これら2つの状態パラメーターの値は、ハッシュ関数の潜在的な出力範囲の開始と終了です。これらのパラメーターは、情報要素のhashOutputRangeMinとhashOutputRangeMax [RFC5477]、およびPSAMP MIBオブジェクトのpsampFiltHashOutputRangeMinとpsampFiltHashOutputRangeMax [RFC6727]に対応しています。

One or more ranges of matching hash values are defined by the min and max parameters of the SelectedRange subclass. These parameters correspond to the Information Elements hashSelectedRangeMin and hashSelectedRangeMax [RFC5477], as well as to the PSAMP MIB objects psampFiltHashSelectedRangeMin and psampFiltHashSelectedRangeMax [RFC6727].

一致するハッシュ値の1つ以上の範囲は、SelectedRangeサブクラスのminおよびmaxパラメーターによって定義されます。これらのパラメーターは、情報要素のhashSelectedRangeMinとhashSelectedRangeMax [RFC5477]、およびPSAMP MIBオブジェクトのpsampFiltHashSelectedRangeMinとpsampFiltHashSelectedRangeMax [RFC6727]に対応しています。

4.3. Cache Class
4.3. キャッシュクラス
    +-----------------------------------+
    | Cache                             |
    +-----------------------------------+        1 +------------------+
    | name                              |<>--------| immediateCache/  |
    | meteringProcessId {readOnly}      |          | timeoutCache/    |
    | dataRecords {readOnly}            |          | naturalCache/    |
    | cacheDiscontinuityTime {readOnly} |          | permanentCache   |
    |                                   |          +------------------+
    |                                   |
    |                                   |     0..* +------------------+
    |                                   |--------->| ExportingProcess |
    +-----------------------------------+          +------------------+
        

Figure 12: Cache class

図12:キャッシュクラス

Figure 12 shows the Cache class that contains the configuration and state parameters of a Cache. Most of these parameters are specific to the type of the Cache and therefore contained in the subclasses immediateCache, timeoutCache, naturalCache, and permanentCache, which are presented below in Sections 4.3.1 and 4.3.2. The following three state parameters are common to all Caches and therefore included in the Cache class itself:

図12は、キャッシュの構成パラメーターと状態パラメーターを含むキャッシュクラスを示しています。これらのパラメータのほとんどはキャッシュのタイプに固有であるため、セクション4.3.1と4.3.2で後述するサブクラスimmediateCache、timeoutCache、naturalCache、permanentCacheに含まれています。次の3つの状態パラメータはすべてのキャッシュに共通なので、キャッシュクラス自体に含まれます。

meteringProcessId: The identifier of the Metering Process the Cache belongs to. This parameter corresponds to the Information Element meteringProcessId [IANA-IPFIX]. Its occurrence helps to associate Metering Process (Reliability) Statistics exported according to the IPFIX protocol specification [RFC5101] with the corresponding object of the MeteringProcess class.

meteringProcessId:キャッシュが属する測定プロセスのID。このパラメーターは、情報要素meteringProcessId [IANA-IPFIX]に対応しています。その発生は、IPFIXプロトコル仕様[RFC5101]に従ってエクスポートされたMetering Process(Reliability)StatisticsをMeteringProcessクラスの対応するオブジェクトに関連付けるのに役立ちます。

dataRecords: The number of Data Records generated by this Cache. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of cacheDiscontinuityTime. Note that this parameter corresponds to ipfixMeteringProcessDataRecords in the IPFIX MIB module [RFC6615].

dataRecords:このキャッシュによって生成されたデータレコードの数。このカウンターの値の不連続は、管理システムの再初期化時に発生する可能性があります。また、cacheDiscontinuityTimeの値によって示される他の場合にも発生する可能性があります。このパラメータは、IPFIX MIBモジュール[RFC6615]のipfixMeteringProcessDataRecordsに対応することに注意してください。

cacheDiscontinuityTime: Timestamp of the most recent occasion at which dataRecords suffered a discontinuity. In contrast to ipfixMeteringProcessDiscontinuityTime, the time is absolute and not relative to sysUpTime. Note that this parameter functionally corresponds to ipfixMeteringProcessDiscontinuityTime in the IPFIX MIB module [RFC6615].

cacheDiscontinuityTime:dataRecordsで不連続性が発生した最新のタイムスタンプ。 ipfixMeteringProcessDiscontinuityTimeとは対照的に、時間は絶対値であり、sysUpTimeを基準とするものではありません。このパラメータは機能的にIPFIX MIBモジュール[RFC6615]のipfixMeteringProcessDiscontinuityTimeに対応することに注意してください。

A Cache object MAY refer to one or more ExportingProcess objects configuring different Exporting Processes.

キャッシュオブジェクトは、さまざまなエクスポートプロセスを構成する1つ以上のExportingProcessオブジェクトを参照する場合があります。

4.3.1. ImmediateCache Class
4.3.1. ImmediateCacheクラス
         +-------------------------------+
         | ImmediateCache                |
         +-------------------------------+       1 +-------------+
         |                               |<>-------| CacheLayout |
         +-------------------------------+         +-------------+
        

Figure 13: ImmediateCache class

図13:ImmediateCacheクラス

The ImmediateCache class depicted in Figure 13 is used to configure a Cache that generates a PSAMP Packet Report for each packet at its input. The fields contained in the generated Data Records are defined in an object of the CacheLayout class, which is defined below in Section 4.3.3.

図13に示すImmediateCacheクラスを使用して、入力で各パケットのPSAMPパケットレポートを生成するキャッシュを構成します。生成されたデータレコードに含まれるフィールドは、セクション4.3.3で定義されるCacheLayoutクラスのオブジェクトで定義されます。

4.3.2. TimeoutCache, NaturalCache, and PermanentCache Class
4.3.2. TimeoutCache、NaturalCache、およびPermanentCacheクラス
         +-------------------------------+
         | TimeoutCache                  |
         +-------------------------------+       1 +-------------+
         | maxFlows {opt.}               |<>-------| CacheLayout |
         | activeTimeout {opt.}          |         +-------------+
         | idleTimeout {opt.}            |
         | activeFlows {readOnly}        |
         | unusedCacheEntries {readOnly} |
         +-------------------------------+
        
         +-------------------------------+
         | NaturalCache                  |
         +-------------------------------+       1 +-------------+
         | maxFlows {opt.}               |<>-------| CacheLayout |
         | activeTimeout {opt.}          |         +-------------+
         | idleTimeout {opt.}            |
         | activeFlows {readOnly}        |
         | unusedCacheEntries {readOnly} |
         +-------------------------------+
        
         +-------------------------------+
         | PermanentCache                |
         +-------------------------------+       1 +-------------+
         | maxFlows {opt.}               |<>-------| CacheLayout |
         | exportInterval {opt.}         |         +-------------+
         | activeFlows {readOnly}        |
         | unusedCacheEntries {readOnly} |
         +-------------------------------+
        

Figure 14: TimeoutCache, NaturalCache, and PermanentCache class

図14:TimeoutCache、NaturalCache、およびPermanentCacheクラス

Figure 14 shows the TimeoutCache class, the NaturalCache class, and the PermanentCache class. These classes are used to configure a Cache that aggregates the packets at its input and generates IPFIX Flow Records. The three classes differ in when Flows expire:

図14は、TimeoutCacheクラス、NaturalCacheクラス、およびPermanentCacheクラスを示しています。これらのクラスは、入力でパケットを集約し、IPFIXフローレコードを生成するキャッシュを構成するために使用されます。 3つのクラスは、フローが期限切れになる時期が異なります。

o TimeoutCache: Flows expire after active or idle timeout. o NaturalCache: Flows expire after active or idle timeout, or on natural termination (e.g., TCP FIN or TCP RST) of the Flow. o PermanentCache: Flows never expire, but are periodically exported with the interval set by exportInterval.

o TimeoutCache:フローは、アクティブまたはアイドルタイムアウト後に期限切れになります。 o NaturalCache:フローは、アクティブまたはアイドルタイムアウトの後、またはフローの自然終了(TCP FINまたはTCP RSTなど)で期限切れになります。 o PermanentCache:フローは期限切れになりませんが、exportIntervalで設定された間隔で定期的にエクスポートされます。

The following configuration and state parameters are common to the three classes:

次の構成および状態パラメータは、3つのクラスに共通です。

maxFlows: This parameter configures the maximum number of entries in the Cache, which is the maximum number of Flows that can be measured simultaneously. If this parameter is configured, the Monitoring Device MUST ensure that sufficient resources are available to store the configured maximum number of Flows. If the maximum number of Cache entries is in use, no additional Flows can be measured. However, traffic that pertains to existing Flows can continue to be measured.

maxFlows:このパラメーターは、キャッシュ内のエントリーの最大数を構成します。これは、同時に測定できるフローの最大数です。このパラメーターが構成されている場合、監視デバイスは、構成された最大数のフローを格納するために十分なリソースが利用可能であることを確認する必要があります。キャッシュエントリの最大数が使用中の場合、追加のフローは測定できません。ただし、既存のフローに関連するトラフィックは引き続き測定できます。

activeFlows: This state parameter indicates the number of Flows currently active in this Cache (i.e., the number of Cache entries currently in use). Note that this parameter corresponds to ipfixMeteringProcessCacheActiveFlows in the IPFIX MIB module [RFC6615].

activeFlows:この状態パラメータは、このキャッシュで現在アクティブなフローの数(つまり、現在使用中のキャッシュエントリの数)を示します。このパラメータは、IPFIX MIBモジュール[RFC6615]のipfixMeteringProcessCacheActiveFlowsに対応することに注意してください。

unusedCacheEntries: The number of unused cache entries. Note that the sum of activeFlows and unusedCacheEntries equals maxFlows if maxFlows is configured. Note that this parameter corresponds to ipfixMeteringProcessCacheUnusedCacheEntries in the IPFIX MIB module [RFC6615].

unusedCacheEntries:未使用のキャッシュエントリの数。 maxFlowsが構成されている場合、activeFlowsとunusedCacheEntriesの合計はmaxFlowsに等しいことに注意してください。このパラメータは、IPFIX MIBモジュール[RFC6615]のipfixMeteringProcessCacheUnusedCacheEntriesに対応することに注意してください。

The following timeout parameters are only available in the TimeoutCache class and the NaturalCache class:

次のタイムアウトパラメータは、TimeoutCacheクラスとNaturalCacheクラスでのみ使用できます。

activeTimeout: This parameter configures the time in seconds after which a Flow is expired even though packets matching this Flow are still received by the Cache. The parameter value zero indicates infinity, meaning that there is no active timeout. If not configured by the user, the Monitoring Device sets this parameter. Note that this parameter corresponds to ipfixMeteringProcessCacheActiveTimeout in the IPFIX MIB module [RFC6615].

activeTimeout:このパラメーターは、このフローに一致するパケットがまだキャッシュによって受信されている場合でも、フローが期限切れになるまでの時間を秒単位で構成します。パラメータ値0は無限を示します。つまり、アクティブなタイムアウトはありません。ユーザーによって構成されていない場合、監視デバイスはこのパラメーターを設定します。このパラメータは、IPFIX MIBモジュール[RFC6615]のipfixMeteringProcessCacheActiveTimeoutに対応することに注意してください。

idleTimeout: This parameter configures the time in seconds after which a Flow is expired if no more packets matching this Flow are received by the Cache. The parameter value zero indicates infinity, meaning that there is no idle timeout. If not configured by the user, the Monitoring Device sets this parameter. Note that this parameter corresponds to ipfixMeteringProcessCacheIdleTimeout in the IPFIX MIB module [RFC6615].

idleTimeout:このパラメーターは、このフローに一致するパケットがキャッシュによって受信されなくなった場合にフローが期限切れになるまでの時間を秒単位で構成します。パラメータ値0は無限を示します。これは、アイドルタイムアウトがないことを意味します。ユーザーによって構成されていない場合、監視デバイスはこのパラメーターを設定します。このパラメーターは、IPFIX MIBモジュール[RFC6615]のipfixMeteringProcessCacheIdleTimeoutに対応することに注意してください。

The following interval parameter is only available in the PermanentCache class:

次の間隔パラメーターは、PermanentCacheクラスでのみ使用できます。

exportInterval: This parameter configures the interval (in seconds) for periodical export of Flow Records. If not configured by the user, the Monitoring Device sets this parameter.

exportInterval:このパラメーターは、フローレコードの定期的なエクスポートの間隔(秒単位)を構成します。ユーザーによって構成されていない場合、監視デバイスはこのパラメーターを設定します。

Every generated Flow Record MUST be associated with a single Observation Domain. Hence, although a Cache MAY be configured to process packets observed at multiple Observation Domains, the Cache MUST NOT aggregate packets observed at different Observation Domains in the same Flow.

生成されたすべてのフローレコードは、単一の観測ドメインに関連付けられている必要があります。したがって、キャッシュは、複数の観測ドメインで観測されたパケットを処理するように構成できますが、同じフロー内の異なる観測ドメインで観測されたパケットを集約してはなりません(MUST NOT)。

An object of the Cache class contains an object of the CacheLayout class that defines which fields are included in the Flow Records.

Cacheクラスのオブジェクトには、フローレコードに含めるフィールドを定義するCacheLayoutクラスのオブジェクトが含まれています。

4.3.3. CacheLayout Class
4.3.3. CacheLayoutクラス
         +--------------+
         | CacheLayout  |
         +--------------+   1..* +--------------------------------+
         |              |<>------| CacheField                     |
         |              |        +--------------------------------+
         |              |        | name                           |
         |              |        | ieId/ieName                    |
         |              |        | ieLength {opt.}                |
         |              |        | ieEnterpriseNumber = 0         |
         |              |        | isFlowKey[0..1] {not used with |
         |              |        |   ImmediateCache class}        |
         +--------------+        +--------------------------------+
        

Figure 15: CacheLayout class

図15:CacheLayoutクラス

A Cache generates and maintains Packet Reports or Flow Records containing information that has been extracted from the incoming stream of packets. Using the CacheField class, the CacheLayout class specifies the superset of fields that are included in the Packet Reports or Flow Records (see Figure 15).

キャッシュは、着信パケットストリームから抽出された情報を含むパケットレポートまたはフローレコードを生成および維持します。 CacheFieldクラスを使用して、CacheLayoutクラスはパケットレポートまたはフローレコードに含まれるフィールドのスーパーセットを指定します(図15を参照)。

If Packet Reports are generated (i.e., if ImmediateCache class is used to configure the Cache), every field specified by the Cache Layout MUST be included in the resulting Packet Report unless the corresponding Information Element is not applicable or cannot be derived from the content or treatment of the incoming packet. Any other field specified by the Cache Layout MAY only be included in the Packet Report if it is obvious from the field value itself or from the values of other fields in same Packet Report that the field value was not determined from the packet.

パケットレポートが生成される場合(つまり、ImmediateCacheクラスを使用してキャッシュを構成する場合)、対応する情報要素が該当しないか、コンテンツから派生できない場合を除き、キャッシュレイアウトで指定されたすべてのフィールドを結果のパケットレポートに含める必要があります。着信パケットの扱い。キャッシュレイアウトで指定された他のフィールドは、フィールド値自体または同じパケットレポートの他のフィールドの値から、フィールド値がパケットから決定されなかったことが明らかな場合にのみ、パケットレポートに含めることができます。

For example, if a field is configured to contain the TCP source port (Information Element tcpSourcePort [IANA-IPFIX]), the field MUST be included in all Packet Reports that are related to TCP packets. Although the field value cannot be determined for non-TCP packets, the field MAY be included in the Packet Reports if another field contains the transport protocol identifier (Information Element protocolIdentifier [IANA-IPFIX]).

たとえば、フィールドがTCP送信元ポート(情報要素tcpSourcePort [IANA-IPFIX])を含むように構成されている場合、TCPパケットに関連するすべてのパケットレポートにフィールドを含める必要があります。 TCP以外のパケットではフィールド値を特定できませんが、別のフィールドにトランスポートプロトコル識別子(情報要素protocolIdentifier [IANA-IPFIX])が含まれている場合、フィールドはパケットレポートに含まれる場合があります。

If Flow Records are generated (i.e., if TimeoutCache, NaturalCache, or PermanentCache class is used to configure the Cache), the Cache Layout differentiates between Flow Key fields and non-key fields. Every Flow Key field specified by the Cache Layout MUST be included as Flow Key in the resulting Flow Record unless the corresponding Information Element is not applicable or cannot be derived from the content or treatment of the incoming packet. Any other Flow Key field specified by the Cache Layout MAY only be included in the Flow Record if it is obvious from the field value itself or from the values of other Flow Key fields in the same Flow Record that the field value was not determined from the packet. Two packets are accounted by the same Flow Record if none of their Flow Key fields differ. If a Flow Key field can be determined for one packet but not for the other, the two packets are accounted in different Flow Records.

フローレコードが生成される場合(つまり、TimeoutCache、NaturalCache、またはPermanentCacheクラスがキャッシュの構成に使用される場合)、キャッシュレイアウトはフローキーフィールドと非キーフィールドを区別します。キャッシュレイアウトで指定されたすべてのフローキーフィールドは、対応する情報要素が適用できないか、着信パケットのコンテンツまたは処理から導出できない場合を除き、結果のフローレコードにフローキーとして含める必要があります。キャッシュレイアウトで指定された他のフローキーフィールドは、フィールド値自体または同じフローレコードの他のフローキーフィールドの値から、フィールド値がフィールドから決定されなかったことが明らかな場合にのみ、フローレコードに含めることができます。パケット。 2つのパケットは、フローキーフィールドに違いがない場合は、同じフローレコードによって説明されます。 1つのパケットに対してフローキーフィールドを決定でき、他のパケットに対しては決定できない場合、2つのパケットは異なるフローレコードに含まれます。

Every non-key field specified by the Cache Layout MUST be included in the resulting Flow Record unless the corresponding Information Element is not applicable or cannot be derived for the given Flow. Any other non-key field specified by the Cache Layout MAY only be included in the Flow Record if it is obvious from the field value itself or from the values of other fields in same Flow Record that the field value was not determined from the packet. Packets which are accounted by the same Flow Record may differ in their non-key fields, or one or more of the non-key fields can be undetermined for all or some of the packets.

キャッシュレイアウトで指定されたすべての非キーフィールドは、対応する情報要素が該当しないか、特定のフローに派生できない場合を除いて、結果のフローレコードに含める必要があります。キャッシュレイアウトで指定された他の非キーフィールドは、フィールド値自体または同じフローレコード内の他のフィールドの値から、フィールド値がパケットから決定されなかったことが明らかな場合にのみ、フローレコードに含めることができます。同じフローレコードによって説明されるパケットは、非キーフィールドが異なる場合があります。または、1つまたは複数の非キーフィールドが、すべてまたは一部のパケットに対して不定である可能性があります。

For example, if a non-key field specifies an Information Element whose value is determined by the first packet observed within a Flow (which is the default rule according to [RFC5102] unless specified differently in the description of the Information Element), this field MUST be included in the resulting Flow Record if it can be determined from the first packet of the Flow.

たとえば、非キーフィールドが、フロー内で観測された最初のパケットによって決定される情報要素を指定する場合(これは、情報要素の説明で異なる指定がない限り、[RFC5102]によるデフォルトのルールです)、このフィールドはフローの最初のパケットから判断できる場合は、結果のフローレコードに含める必要があります。

The CacheLayout class does not have any parameters. The configuration parameters of the CacheField class are as follows:

CacheLayoutクラスにはパラメーターがありません。 CacheFieldクラスの構成パラメーターは次のとおりです。

ieId, ieName, ieEnterpriseNumber: These parameters specify a field by the combination of the Information Element identifier or name, and the Information Element enterprise number. Either ieId or ieName MUST be specified. If ieEnterpriseNumber is zero (which is the default), this Information Element is registered in the IANA registry of IPFIX Information Elements [IANA-IPFIX]. A non-zero value of ieEnterpriseNumber specifies an enterprise-specific Information Element [IANA-ENTERPRISE-NUMBERS]. If the enterprise number is set to 29305, this field contains a Reverse Information Element. In this case, the Cache MUST generate Data Records in accordance to [RFC5103].

ieId、ieName、ieEnterpriseNumber:これらのパラメーターは、情報要素の識別子または名前と情報要素のエンタープライズ番号の組み合わせによってフィールドを指定します。 ieIdまたはieNameのいずれかを指定する必要があります。 ieEnterpriseNumberがゼロ(デフォルト)の場合、この情報要素はIPFIX情報要素のIANAレジストリに登録されます[IANA-IPFIX]。 ieEnterpriseNumberのゼロ以外の値は、エンタープライズ固有の情報要素[IANA-ENTERPRISE-NUMBERS]を指定します。企業番号が29305に設定されている場合、このフィールドには逆情報要素が含まれます。この場合、キャッシュは[RFC5103]に従ってデータレコードを生成しなければなりません。

ieLength: This parameter specifies the length of the field in octets. A value of 65535 means that the field is encoded as a variable-length Information Element. For Information Elements of integer and float type, the field length MAY be set to a smaller value than the standard length of the abstract data type if the rules of reduced size encoding are fulfilled (see [RFC5101], Section 6.2). If not configured by the user, the field length is set by the Monitoring Device.

ieLength:このパラメーターは、フィールドの長さをオクテットで指定します。値65535は、フィールドが可変長の情報要素としてエンコードされることを意味します。整数および浮動小数点型の情報要素の場合、縮小サイズのエンコーディングのルールが満たされている場合、フィールド長を抽象データ型の標準長よりも小さい値に設定できます([RFC5101]、セクション6.2を参照)。ユーザーが設定しない場合、フィールド長は監視デバイスによって設定されます。

isFlowKey: If present, this field is a Flow Key. If the field contains a Reverse Information Element, it MUST NOT be configured as Flow Key. This parameter is not available if the Cache is configured using the ImmediateCache class since there is no distinction between Flow Key fields and non-key fields in Packet Reports.

isFlowKey:存在する場合、このフィールドはフローキーです。フィールドに逆方向情報要素が含まれている場合、それをフローキーとして構成してはなりません。パケットレポートのフローキーフィールドと非キーフィールドは区別されないため、ImmediateCacheクラスを使用してキャッシュが構成されている場合、このパラメーターは使用できません。

Note that the use of Information Elements can be restricted to certain Cache types as well as to Flow Key or non-key fields. Such restrictions may result from Information Element definitions or from device-specific constraints. According to Section 5, the Monitoring Device MUST notify the user if a Cache field cannot be configured with the given Information Element.

情報要素の使用は、特定のキャッシュタイプだけでなく、フローキーフィールドまたは非キーフィールドにも制限できることに注意してください。このような制限は、情報要素の定義またはデバイス固有の制約に起因する場合があります。セクション5によると、指定された情報要素でキャッシュフィールドを構成できない場合、監視デバイスはユーザーに通知する必要があります。

4.4. ExportingProcess Class
4.4. ExportingProcessクラス
     +-------------------------------+
     | ExportingProcess              |
     +-------------------------------+   1..* +-------------+
     | name                          |<>------| Destination |
     | exportingProcessId {readOnly} |        +-------------+
     | exportMode = "parallel"       |        | name        |<>-+
     |                               |        +-------------+   | 1
     |                               |                          |
     |                               |               +---------------+
     |                               |               | SctpExporter/ |
     |                               |               | UdpExporter/  |
     |                               |               | TcpExporter/  |
     |                               |               | FileWriter    |
     |                               |               +---------------+
     |                               |
     |                               |   0..* +------------------+
     |                               |<>------| Options          |
     +-------------------------------+        +------------------+
        

Figure 16: ExportingProcess class

図16:ExportingProcessクラス

The ExportingProcess class in Figure 16 specifies destinations to which the incoming Packet Reports and Flow Records are exported using objects of the Destination class. The Destination class includes one object of the SctpExporter, UdpExporter, TcpExporter, or FileWriter class which contains further configuration parameters. These classes are described in Sections 4.4.1, 4.4.2, 4.4.3, and 4.4.4.

図16のExportingProcessクラスは、Destinationクラスのオブジェクトを使用して、着信パケットレポートとフローレコードがエクスポートされる宛先を指定します。 Destinationクラスには、追加の構成パラメーターを含むSctpExporter、UdpExporter、TcpExporter、またはFileWriterクラスの1つのオブジェクトが含まれます。これらのクラスについては、セクション4.4.1、4.4.2、4.4.3、および4.4.4で説明します。

As state parameter, the ExportingProcess class contains the identifier of the Exporting Process (exportingProcessId). This parameter corresponds to the Information Element exportingProcessId [IANA-IPFIX]. Its occurrence helps to associate Exporting Process Reliability Statistics exported according to the IPFIX protocol specification [RFC5101] with the corresponding object of the ExportingProcess class.

状態パラメーターとして、ExportingProcessクラスにはエクスポートプロセスの識別子(exportingProcessId)が含まれます。このパラメーターは、情報要素exportingProcessId [IANA-IPFIX]に対応しています。その発生は、IPFIXプロトコル仕様[RFC5101]に従ってエクスポートされたエクスポートプロセス信頼性統計を、ExportingProcessクラスの対応するオブジェクトに関連付けるのに役立ちます。

The order in which objects of the Destination class appear is defined by the user. However, the order has a specific meaning only if the exportMode parameter is set to "fallback". The exportMode parameter is defined as follows:

Destinationクラスのオブジェクトが表示される順序は、ユーザーが定義します。ただし、exportModeパラメータが「フォールバック」に設定されている場合にのみ、順序に特定の意味があります。 exportModeパラメータは次のように定義されています。

exportMode: This parameter determines to which configured destination(s) the incoming Data Records are exported. The following parameter values are specified by the configuration data model:

exportMode:このパラメーターは、着信データレコードがエクスポートされる構成済みの宛先に決定します。以下のパラメーター値は、構成データモデルによって指定されます。

* parallel: every Data Record is exported to all configured destinations in parallel * loadBalancing: every Data Record is exported to exactly one configured destination according to a device-specific load-balancing policy * fallback: every Data Record is exported to exactly one configured destination according to the fallback policy described below If exportMode is set to "fallback", the first object of the Destination class defines the primary destination, the second object of the Destination class defines the secondary destination, and so on. If the Exporting Process fails to export Data Records to the primary destination, it tries to export them to the secondary one. If the secondary destination fails as well, it continues with the tertiary, etc. "parallel" is the default value if exportMode is not configured.

* 並列:すべてのデータレコードが構成済みのすべての宛先に並行してエクスポートされます* loadBalancing:すべてのデータレコードがデバイス固有の負荷分散ポリシーに従って構成された1つの宛先にエクスポートされます*フォールバック:すべてのデータレコードが構成された1つの宛先にエクスポートされますexportModeが「fallback」に設定されている場合、Destinationクラスの最初のオブジェクトはプライマリ宛先を定義し、Destinationクラスの2番目のオブジェクトはセカンダリ宛先を定義し、以下同様に続きます。エクスポートプロセスがデータレコードをプライマリの宛先にエクスポートできない場合、データレコードをセカンダリにエクスポートしようとします。 2次宛先も失敗した場合、3次などが続行されます。exportModeが構成されていない場合、デフォルト値は「parallel」です。

Note that the exportMode parameter is related to the ipfixExportMemberType object in [RFC6615]. If exportMode is "parallel", the ipfixExportMemberType values of the corresponding entries in ipfixExportTable are set to parallel(3). If exportMode is "loadBalancing", the ipfixExportMemberType values of the corresponding entries in ipfixExportTable are set to loadBalancing(4). If exportMode is "fallback", the ipfixExportMemberType value that refers to the primary destination is set to primary(1); the ipfixExportMemberType values that refer to the remaining destinations need to be set to secondary(2). The IPFIX MIB module does not define any value for tertiary destination, etc.

exportModeパラメータは[RFC6615]のipfixExportMemberTypeオブジェクトに関連していることに注意してください。 exportModeが "parallel"の場合、ipfixExportTableの対応するエントリのipfixExportMemberType値はparallel(3)に設定されます。 exportModeが "loadBalancing"の場合、ipfixExportTableの対応するエントリのipfixExportMemberType値はloadBalancing(4)に設定されます。 exportModeが「fallback」の場合、プライマリ宛先を参照するipfixExportMemberType値はprimary(1)に設定されます。残りの宛先を参照するipfixExportMemberType値は、secondary(2)に設定する必要があります。 IPFIX MIBモジュールは、3次宛先などの値を定義していません。

The reporting of information with Options Templates is defined with objects of the Options class.

オプションテンプレートを使用した情報のレポートは、オプションクラスのオブジェクトで定義されます。

The Exporting Process may modify the Packet Reports and Flow Records to enable a more efficient transmission or storage under the condition that no information is changed or suppressed. For example, the Exporting Process may shorten the length of a field according to the rules of reduced size encoding [RFC5101]. The Exporting Process may also export certain fields in a separate Data Record as described in [RFC5476].

エクスポートプロセスは、パケットレポートとフローレコードを変更して、情報が変更または抑制されていない条件下で、より効率的な送信または保存を可能にする場合があります。たとえば、エクスポートプロセスは、縮小サイズエンコーディング[RFC5101]のルールに従ってフィールドの長さを短くする場合があります。 [RFC5476]で説明されているように、エクスポートプロセスは特定のフィールドを別のデータレコードにエクスポートすることもできます。

4.4.1. SctpExporter Class
4.4.1. SctpExporterクラス
    +------------------------------+
    | SctpExporter                 |
    +------------------------------+    0..1 +------------------------+
    | ipfixVersion = 10            |<>-------| TransportLayerSecurity |
    | sourceIPAddress[0..*]        |         +------------------------+
    | destinationIPAddress[1..*]   |
    | destinationPort = 4739|4740  |    0..1 +------------------------+
    | ifName/ifIndex[0..1]         |<>-------| TransportSession       |
    | sendBufferSize {opt.}        |         +------------------------+
    | rateLimit[0..1]              |
    | timedReliability = 0         |
    +------------------------------+
        

Figure 17: SctpExporter class

図17:SctpExporterクラス

The SctpExporter class shown in Figure 17 contains the configuration parameters of an SCTP export destination. The configuration parameters are:

図17に示されているSctpExporterクラスには、SCTPエクスポート宛先の構成パラメーターが含まれています。構成パラメーターは次のとおりです。

ipfixVersion: Version number of the IPFIX protocol used. If omitted, the default value is 10 (=0x000a) as specified in [RFC5101].

ipfixVersion:使用されるIPFIXプロトコルのバージョン番号。省略した場合、デフォルト値は[RFC5101]で指定されている10(= 0x000a)です。

sourceIPAddress: List of source IP addresses used by the Exporting Process. If configured, the specified addresses are eligible local IP addresses of the multihomed SCTP endpoint. If not configured, all locally assigned IP addresses are eligible local IP addresses.

sourceIPAddress:エクスポートプロセスで使用されるソースIPアドレスのリスト。構成されている場合、指定されたアドレスは、マルチホームSCTPエンドポイントの適格なローカルIPアドレスです。構成されていない場合、ローカルに割り当てられたすべてのIPアドレスは、適格なローカルIPアドレスです。

destinationIPAddress: One or more IP addresses of the Collecting Process to which IPFIX Messages are sent. The user must ensure that all configured IP addresses belong to the same Collecting Process. The Exporting Process tries to establish an SCTP association to any of the configured destination IP addresses.

destinationIPAddress:IPFIXメッセージの送信先の収集プロセスの1つ以上のIPアドレス。ユーザーは、構成されたすべてのIPアドレスが同じ収集プロセスに属していることを確認する必要があります。エクスポートプロセスは、設定された宛先IPアドレスのいずれかにSCTPアソシエーションを確立しようとします。

destinationPort: Destination port number to be used. If not configured, standard port 4739 (IPFIX without TLS and DTLS) or 4740 (IPFIX over TLS or DTLS) is used.

destinationPort:使用する宛先ポート番号。構成されていない場合、標準ポート4739(TLSおよびDTLSを使用しないIPFIX)または4740(TLSまたはDTLSを介したIPFIX)が使用されます。

ifIndex/ifName: Either the index or the name of the interface used by the Exporting Process to export IPFIX Messages to the given destination MAY be specified according to corresponding objects in the IF-MIB [RFC2863]. If omitted, the Exporting Process selects the outgoing interface based on local routing decision and accepts return traffic, such as transport-layer acknowledgments, on all available interfaces.

ifIndex / ifName:IPFIXメッセージを特定の宛先にエクスポートするためにエクスポートプロセスで使用されるインターフェイスのインデックスまたは名前のいずれかを、IF-MIB [RFC2863]の対応するオブジェクトに従って指定できます。省略した場合、エクスポートプロセスはローカルルーティングの決定に基づいて発信インターフェイスを選択し、トランスポート層の確認応答など、利用可能なすべてのインターフェイスでリターントラフィックを受け入れます。

sendBufferSize: Size of the socket send buffer in bytes. If not configured by the user, the buffer size is set by the Monitoring Device.

sendBufferSize:ソケット送信バッファーのサイズ(バイト単位)。ユーザーが構成しない場合、バッファサイズは監視デバイスによって設定されます。

rateLimit: Maximum number of bytes per second the Exporting Process may export to the given destination as required by [RFC5476]. The number of bytes is calculated from the lengths of the IPFIX Messages exported. If this parameter is not configured, no rate limiting is performed for this destination.

rateLimit:[RFC5476]の要求に応じて、エクスポートプロセスが指定の宛先にエクスポートできる1秒あたりの最大バイト数。バイト数は、エクスポートされたIPFIXメッセージの長さから計算されます。このパラメーターが構成されていない場合、この宛先に対してレート制限は実行されません。

timedReliability: Lifetime in milliseconds until an IPFIX Message containing Data Sets only is "abandoned" due to the timed reliability mechanism of the Partial Reliability extension of SCTP (PR-SCTP) [RFC3758]. If this parameter is set to zero, reliable SCTP transport MUST be used for all Data Records. Regardless of the value of this parameter, the Exporting Process MAY use reliable SCTP transport for Data Sets associated with certain Options Templates, such as the Data Record Reliability Options Template specified in [RFC6526].

timedReliability:SCTPの部分信頼性拡張(PR-SCTP)[RFC3758]の時限信頼性メカニズムにより、データセットのみを含むIPFIXメッセージが「放棄」されるまでのミリ秒単位のライフタイム。このパラメーターがゼロに設定されている場合、信頼できるSCTPトランスポートをすべてのデータレコードに使用する必要があります。このパラメーターの値に関係なく、エクスポートプロセスは、[RFC6526]で指定されたデータレコード信頼性オプションテンプレートなど、特定のオプションテンプレートに関連付けられたデータセットに信頼性の高いSCTPトランスポートを使用できます。

Using the TransportLayerSecurity class described in Section 4.6, Datagram Transport Layer Security (DTLS) is enabled and configured for this export destination.

セクション4.6、データグラムトランスポート層セキュリティ(DTLS)で説明されているTransportLayerSecurityクラスを使用して、このエクスポート先に対して有効化および構成されます。

If a Transport Session is established to the configured destination, the SctpExporter class includes an object of the TransportSession class containing state parameters of the Transport Session. The TransportSession class is specified in Section 4.7.

コンフィグレーションされた送り先へのトランスポートセッションが確立されている場合、SctpExporterクラスには、トランスポートセッションの状態パラメータを含むTransportSessionクラスのオブジェクトが含まれます。 TransportSessionクラスはセクション4.7で指定されています。

4.4.2. UdpExporter Class
4.4.2. UdpExporterクラス
    +-------------------------------------+
    | UdpExporter                         |
    +-------------------------------------+   0..1 +------------------+
    | ipfixVersion = 10                   |<>------| TransportLayer-  |
    | sourceIPAddress[0..1]               |        | Security         |
    | destinationIPAddress                |        +------------------+
    | destinationPort = 4739|4740         |
    | ifName/ifIndex[0..1]                |   0..1 +------------------+
    | sendBufferSize {opt.}               |<>------| TransportSession |
    | rateLimit[0..1]                     |        +------------------+
    | maxPacketSize {opt.}                |
    | templateRefreshTimeout = 600        |
    | optionsTemplateRefreshTimeout = 600 |
    | templateRefreshPacket[0..1]         |
    | optionsTemplateRefreshPacket[0..1]  |
    +-------------------------------------+
        

Figure 18: UdpExporter class

図18:UdpExporterクラス

The UdpExporter class shown in Figure 18 contains the configuration parameters of a UDP export destination. The parameters ipfixVersion, destinationPort, ifName, ifIndex, sendBufferSize, and rateLimit have the same meaning as in the SctpExporter class (see Section 4.4.1). The remaining configuration parameters are:

図18に示すUdpExporterクラスには、UDPエクスポート宛先の構成パラメーターが含まれています。パラメータipfixVersion、destinationPort、ifName、ifIndex、sendBufferSize、rateLimitは、SctpExporterクラスと同じ意味です(セクション4.4.1を参照)。残りの構成パラメーターは次のとおりです。

sourceIPAddress: This parameter specifies the source IP address used by the Exporting Process. If this parameter is omitted, the IP address assigned to the outgoing interface is used as the source IP address.

sourceIPAddress:このパラメーターは、エクスポートプロセスで使用されるソースIPアドレスを指定します。このパラメーターを省略すると、発信インターフェースに割り当てられたIPアドレスがソースIPアドレスとして使用されます。

destinationIPAddress: Destination IP address to which IPFIX Messages are sent (i.e., the IP address of the Collecting Process).

destinationIPAddress:IPFIXメッセージの送信先のIPアドレス(つまり、収集プロセスのIPアドレス)。

maxPacketSize: This parameter specifies the maximum size of IP packets sent to the Collector. If set to zero, the Exporting Device MUST derive the maximum packet size from path MTU discovery mechanisms. If not configured by the user, this parameter is set by the Monitoring Device.

maxPacketSize:このパラメーターは、コレクターに送信されるIPパケットの最大サイズを指定します。ゼロに設定する場合、エクスポートデバイスは、パスMTU検出メカニズムから最大パケットサイズを導出する必要があります。ユーザーによって構成されていない場合、このパラメーターは監視デバイスによって設定されます。

templateRefreshTimeout, optionsTemplateRefreshTimeout, templateRefreshPacket, optionsTemplateRefreshPacket: These parameters specify when (Options) Templates are refreshed by the Exporting Process. templateRefreshTimeout and optionsTemplateRefreshTimeout are specified in seconds between resendings of (Options) Templates.

templateRefreshTimeout、optionsTemplateRefreshTimeout、templateRefreshPacket、optionsTemplateRefreshPacket:これらのパラメーターは、(オプション)テンプレートがエクスポートプロセスによって更新されるタイミングを指定します。 templateRefreshTimeoutおよびoptionsTemplateRefreshTimeoutは、(オプション)テンプレートの再送信間の秒数で指定されます。

If omitted, the default value of 600 seconds (10 minutes) is used [RFC5101]. templateRefreshPacket and optionsTemplateRefreshPacket specify the number of IPFIX Messages after which (Options) Templates are resent. If omitted, the (Options) Templates are only resent after timeout. Note that the values configured for templateRefreshTimeout and optionsTemplateRefreshTimeout MUST be adapted to the templateLifeTime and optionsTemplateLifeTime parameter settings at the receiving Collecting Process (see Section 4.5.2). Note that these parameters correspond to ipfixTransportSessionTemplateRefreshTimeout, ipfixTransportSessionOptionsTemplateRefreshTimeout, ipfixTransportSessionTemplateRefreshPacket, and ipfixTransportSessionOptionsTemplateRefreshPacket in the IPFIX MIB module [RFC6615].

省略した場合、デフォルト値の600秒(10分)が使用されます[RFC5101]。 templateRefreshPacketおよびoptionsTemplateRefreshPacketは、(オプション)テンプレートが再送信されるまでのIPFIXメッセージの数を指定します。省略した場合、(オプション)テンプレートはタイムアウト後にのみ再送信されます。 templateRefreshTimeoutおよびoptionsTemplateRefreshTimeoutに構成された値は、受信収集プロセスでのtemplateLifeTimeおよびoptionsTemplateLifeTimeパラメータ設定に適合させる必要があることに注意してください(セクション4.5.2を参照)。これらのパラメーターは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionTemplateRefreshTimeout、ipfixTransportSessionOptionsTemplateRefreshTimeout、ipfixTransportSessionTemplateRefreshPacket、およびipfixTransportSessionOptionsTemplateRefreshPacketに対応することに注意してください。

Using the TransportLayerSecurity class described in Section 4.6, DTLS is enabled and configured for this export destination.

セクション4.6で説明されているTransportLayerSecurityクラスを使用すると、DTLSが有効になり、このエクスポート先に対して構成されます。

If a Transport Session is established to the configured destination, the UdpExporter class includes an object of the TransportSession class containing state parameters of the Transport Session. The TransportSession class is specified in Section 4.7.

構成された宛先へのトランスポートセッションが確立されている場合、UdpExporterクラスには、トランスポートセッションの状態パラメーターを含むTransportSessionクラスのオブジェクトが含まれます。 TransportSessionクラスはセクション4.7で指定されています。

4.4.3. TcpExporter Class
4.4.3. TcpExporterクラス
    +------------------------------+
    | TcpExporter                  |
    +------------------------------+    0..1 +------------------------+
    | ipfixVersion = 10            |<>-------| TransportLayerSecurity |
    | sourceIPAddress[0..1]        |         +------------------------+
    | destinationIPAddress         |
    | destinationPort = 4739|4740  |    0..1 +------------------------+
    | ifName/ifIndex[0..1]         |<>-------| TransportSession       |
    | sendBufferSize {opt.}        |         +------------------------+
    | rateLimit[0..1]              |
    +------------------------------+
        

Figure 19: TcpExporter class

図19:TcpExporterクラス

The TcpExporter class shown in Figure 19 contains the configuration parameters of a TCP export destination. The parameters have the same meaning as in the UdpExporter class (see Section 4.4.2).

図19に示すTcpExporterクラスには、TCPエクスポート宛先の構成パラメーターが含まれています。パラメータの意味は、UdpExporterクラスと同じです(4.4.2項を参照)。

Using the TransportLayerSecurity class described in Section 4.6, Transport Layer Security (TLS) is enabled and configured for this export destination.

セクション4.6、トランスポート層セキュリティ(TLS)で説明されているTransportLayerSecurityクラスを使用して、このエクスポート先に対して有効になり、構成されます。

If a Transport Session is established to the configured destination, the TcpExporter class includes an object of the TransportSession class containing state parameters of the Transport Session. The TransportSession class is specified in Section 4.7.

コンフィグレーションされた送り先へのトランスポートセッションが確立されている場合、TcpExporterクラスには、トランスポートセッションの状態パラメータを含むTransportSessionクラスのオブジェクトが含まれます。 TransportSessionクラスはセクション4.7で指定されています。

4.4.4. FileWriter Class
4.4.4. FileWriterクラス
      +-----------------------------------------+
      | FileWriter                              |
      +-----------------------------------------+    0..* +----------+
      | ipfixVersion = 10                       |<>-------| Template |
      | file                                    |         +----------+
      | status {readOnly}                       |
      | bytes {readOnly}                        |
      | messages {readOnly}                     |
      | discardedMessages {readOnly}            |
      | records {readOnly}                      |
      | templates {readOnly}                    |
      | optionsTemplates {readOnly}             |
      | fileWriterDiscontinuityTime {readOnly}  |
      +-----------------------------------------+
        

Figure 20: FileWriter classes

図20:FileWriterクラス

If an object of the FileWriter class is included in an object of the Destination class, IPFIX Messages are written into a file as specified in [RFC5655]. The FileWriter class contains the following configuration parameters:

FileWriterクラスのオブジェクトがDestinationクラスのオブジェクトに含まれている場合、[RFC5655]で指定されているように、IPFIXメッセージがファイルに書き込まれます。 FileWriterクラスには、次の構成パラメーターが含まれています。

ipfixVersion: Version number of the IPFIX protocol used. If omitted, the default value is 10 (=0x000a) as specified in [RFC5101].

ipfixVersion:使用されるIPFIXプロトコルのバージョン番号。省略した場合、デフォルト値は[RFC5101]で指定されている10(= 0x000a)です。

file: File name and location specified as URI.

file:URIとして指定されたファイル名と場所。

The state parameters of the FileWriter class are:

FileWriterクラスの状態パラメーターは次のとおりです。

bytes, messages, records, templates, optionsTemplates: The number of bytes, IPFIX Messages, Data Records, Template Records, and Options Template Records written by the File Writer. Discontinuities in the values of these counters can occur at re-initialization of the management system, and at other times as indicated by the value of fileWriterDiscontinuityTime.

バイト、メッセージ、レコード、テンプレート、optionsTemplates:ファイルライターによって書き込まれたバイト数、IPFIXメッセージ、データレコード、テンプレートレコード、およびオプションテンプレートレコード。これらのカウンターの値の不連続は、管理システムの再初期化時に発生する可能性があります。また、fileWriterDiscontinuityTimeの値によって示される他の場合にも発生する可能性があります。

discardedMessages: The number of IPFIX Messages that could not be written by the File Writer due to internal buffer overflows, limited storage capacity, etc. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of fileWriterDiscontinuityTime.

捨てられたメッセージ:内部バッファオーバーフロー、限られた記憶容量などのためにファイルライターによって書き込めなかったIPFIXメッセージの数。このカウンターの値の不連続は、管理システムの再初期化時などに発生する可能性があります。 fileWriterDiscontinuityTimeの値によって示されます。

fileWriterDiscontinuityTime: Timestamp of the most recent occasion at which one or more File Writer counters suffered a discontinuity. In contrast to discontinuity times in the IPFIX MIB module, the time is absolute and not relative to sysUpTime.

fileWriterDiscontinuityTime:1つ以上のファイルライターカウンターが不連続になった最新のタイムスタンプ。 IPFIX MIBモジュールの不連続時間とは対照的に、時間は絶対値であり、sysUpTimeに対するものではありません。

Each object of the FileWriter class includes a list of objects of the Template class with information and statistics about the Templates written to the file. The Template class is specified in Section 4.8.

FileWriterクラスの各オブジェクトには、テンプレートクラスのオブジェクトのリストと、ファイルに書き込まれたテンプレートに関する情報と統計が含まれます。 Templateクラスはセクション4.8で指定されています。

4.4.5. Options Class
4.4.5. オプションクラス
                         +-----------------------+
                         | Options               |
                         +-----------------------+
                         | name                  |
                         | optionsType           |
                         | optionsTimeout {opt.} |
                         +-----------------------+
        

Figure 21: Options class

図21:オプションクラス

The Options class in Figure 21 defines the type of specific information to be reported, such as statistics, flow keys, Sampling and Filtering parameters, etc. [RFC5101] and [RFC5476] specify several types of reporting information that may be exported. The following parameter values are specified by the configuration data model:

図21のOptionsクラスは、統計、フローキー、サンプリングとフィルタリングのパラメーターなど、レポートされる特定の情報のタイプを定義します。[RFC5101]と[RFC5476]は、エクスポートできるいくつかのタイプのレポート情報を指定します。以下のパラメーター値は、構成データモデルによって指定されます。

meteringStatistics: Export of Metering Process statistics using the Metering Process Statistics Options Template [RFC5101].

meteringStatistics:メータリングプロセス統計オプションテンプレート[RFC5101]を使用したメータリングプロセス統計のエクスポート。

meteringReliability: Export of Metering Process reliability statistics using the Metering Process Reliability Statistics Options Template [RFC5101].

meteringReliability:メータリングプロセス信頼性統計オプションテンプレート[RFC5101]を使用したメータリングプロセス信頼性統計のエクスポート。

exportingReliability: Export of Exporting Process reliability statistics using the Exporting Process Reliability Statistics Options Template [RFC5101].

exportingReliability:エクスポートプロセス信頼性統計オプションテンプレート[RFC5101]を使用したエクスポートプロセス信頼性統計のエクスポート。

flowKeys: Export of the Flow Key specification using the Flow Keys Options Template [RFC5101].

flowKeys:フローキーオプションテンプレート[RFC5101]を使用したフローキー仕様のエクスポート。

selectionSequence: Export of Selection Sequence Report Interpretation and Selector Report Interpretation [RFC5476].

selectionSequence:選択シーケンスレポート解釈とセレクタレポート解釈のエクスポート[RFC5476]。

selectionStatistics: Export of Selection Sequence Statistics Report Interpretation [RFC5476].

selectionStatistics:Export of Selection Sequence Statistics Report Interpretation [RFC5476]。

accuracy: Export of Accuracy Report Interpretation [RFC5476].

精度:精度レポート解釈のエクスポート[RFC5476]。

reducingRedundancy: Enables the utilization of Options Templates to reduce redundancy in the exported Data Records according to [RFC5473]. The Exporting Process decides when to apply these Options Templates.

reductionRedundancy:[RFC5473]に従って、エクスポートされたデータレコードの冗長性を減らすためにオプションテンプレートの使用を有効にします。エクスポートプロセスは、これらのオプションテンプレートをいつ適用するかを決定します。

extendedTypeInformation: Export of extended type information for enterprise-specific Information Elements used in the exported Templates [RFC5610].

extendedTypeInformation:エクスポートされたテンプレートで使用される企業固有の情報要素の拡張タイプ情報のエクスポート[RFC5610]。

The Exporting Process MUST choose a Template definition according to the options type and available options data.

エクスポートプロセスは、オプションタイプと使用可能なオプションデータに従ってテンプレート定義を選択する必要があります。

The optionsTimeout parameter specifies the reporting interval (in milliseconds) for periodic export of the option data. A parameter value of zero means that the export of the option data is not triggered periodically, but whenever the available option data has changed. This is the typical setting for options types flowKeys, selectionSequence, accuracy, and reducingRedundancy. If optionsTimeout is not configured by the user, it is set by the Monitoring Device.

optionsTimeoutパラメーターは、オプションデータの定期的なエクスポートのレポート間隔(ミリ秒単位)を指定します。パラメーター値がゼロの場合、オプションデータのエクスポートは定期的にトリガーされず、使用可能なオプションデータが変更されるたびにトリガーされます。これは、オプションタイプflowKeys、selectionSequence、正確性、reducingRedundancyの一般的な設定です。 optionsTimeoutがユーザーによって構成されていない場合は、監視デバイスによって設定されます。

4.5. CollectingProcess Class
4.5. CollectingProcessクラス
           +-------------------+
           | CollectingProcess |
           +-------------------+
           | name              |       0..* +------------------+
           |                   |<>----------| SctpCollector    |
           |                   |            +------------------+
           |                   |
           |                   |       0..* +------------------+
           |                   |<>----------| UdpCollector     |
           |                   |            +------------------+
           |                   |
           |                   |       0..* +------------------+
           |                   |<>----------| TcpCollector     |
           |                   |            +------------------+
           |                   |
           |                   |       0..* +------------------+
           |                   |<>----------| FileReader       |
           |                   |            +------------------+
           |                   |
           |                   | 0..*  0..* +------------------+
           |                   |----------->| ExportingProcess |
           +-------------------+            +------------------+
        

Figure 22: CollectingProcess class

図22:CollectingProcessクラス

Figure 22 shows the CollectingProcess class that contains the configuration and state parameters of a Collecting Process. Objects of the SctpCollector, UdpCollector, and TcpCollector classes specify how IPFIX Messages are received from remote Exporters. The Collecting Process can also be configured as a File Reader using objects of the FileReader class. These classes are described in Sections 4.5.1, 4.5.2, 4.5.3, and 4.5.4.

図22は、収集プロセスの構成パラメーターと状態パラメーターを含むCollectingProcessクラスを示しています。 SctpCollector、UdpCollector、およびTcpCollectorクラスのオブジェクトは、リモートエクスポーターからIPFIXメッセージを受信する方法を指定します。収集プロセスは、FileReaderクラスのオブジェクトを使用してファイルリーダーとして構成することもできます。これらのクラスについては、セクション4.5.1、4.5.2、4.5.3、および4.5.4で説明しています。

A CollectingProcess object MAY refer to one or more ExportingProcess objects configuring Exporting Processes that export the received data without modifications to a file or to another Collector.

CollectingProcessオブジェクトは、ファイルまたは別のコレクターを変更せずに受信したデータをエクスポートするエクスポートプロセスを構成する1つ以上のExportingProcessオブジェクトを参照する場合があります。

4.5.1. SctpCollector Class
4.5.1. SctpCollectorクラス
      +--------------------------+
      | SctpCollector            |
      +--------------------------+    0..1 +------------------------+
      | name                     |<>-------| TransportLayerSecurity |
      | localIPAddress[0..*]     |         +------------------------+
      | localPort = 4739|4740    |
      |                          |    0..* +------------------------+
      |                          |<>-------| TransportSession       |
      +--------------------------+         +------------------------+
        

Figure 23: SctpCollector class

図23:SctpCollectorクラス

The SctpCollector class contains the configuration parameters of a listening SCTP socket at a Collecting Process. The parameters are:

SctpCollectorクラスには、収集プロセスでのリスニングSCTPソケットの構成パラメーターが含まれています。パラメータは次のとおりです。

localIPAddress: List of local IP addresses on which the Collecting Process listens for IPFIX Messages. The IP addresses are used as eligible local IP addresses of the multihomed SCTP endpoint [RFC4960]. If omitted, the Collecting Process listens on all local IP addresses.

localIPAddress:収集プロセスがIPFIXメッセージをリッスンするローカルIPアドレスのリスト。 IPアドレスは、マルチホームSCTPエンドポイント[RFC4960]の適格なローカルIPアドレスとして使用されます。省略した場合、収集プロセスはすべてのローカルIPアドレスで待機します。

localPort: Local port number on which the Collecting Process listens for IPFIX Messages. If omitted, standard port 4739 (IPFIX without TLS and DTLS) or 4740 (IPFIX over TLS or DTLS) is used.

localPort:収集プロセスがIPFIXメッセージをリッスンするローカルポート番号。省略した場合、標準ポート4739(TLSおよびDTLSを使用しないIPFIX)または4740(TLSまたはDTLSを介したIPFIX)が使用されます。

Using the TransportLayerSecurity class described in Section 4.6, DTLS is enabled and configured for this receiving socket.

セクション4.6で説明されているTransportLayerSecurityクラスを使用すると、DTLSが有効になり、この受信ソケットに対して構成されます。

As state data, the SctpCollector class contains the list of currently established Transport Sessions that terminate at the given SCTP socket of the Collecting Process. The TransportSession class is specified in Section 4.7.

状態データとして、SctpCollectorクラスには、収集プロセスの特定のSCTPソケットで終了する、現在確立されているトランスポートセッションのリストが含まれています。 TransportSessionクラスはセクション4.7で指定されています。

4.5.2. UdpCollector Class
4.5.2. UdpCollectorクラス
   +---------------------------------+
   | UdpCollector                    |
   +---------------------------------+   0..1 +------------------------+
   | name                            |<>------| TransportLayerSecurity |
   | localIPAddress[0..*]            |        +------------------------+
   | localPort = 4739|4740           |
   | templateLifeTime = 1800         |   0..* +------------------------+
   | optionsTemplateLifeTime = 1800  |<>------| TransportSession       |
   | templateLifePacket[0..*]        |        +------------------------+
   | optionsTemplateLifePacket[0..*] |
   +---------------------------------+
        

Figure 24: UdpCollector class

図24:UdpCollectorクラス

The UdpCollector class contains the configuration parameters of a listening UDP socket at a Collecting Process. The parameter localPort has the same meaning as in the SctpCollector class (see Section 4.5.1). The remaining parameters are:

UdpCollectorクラスには、収集プロセスでのリスニングUDPソケットの構成パラメーターが含まれています。パラメータlocalPortは、SctpCollectorクラスと同じ意味です(セクション4.5.1を参照)。残りのパラメーターは次のとおりです。

localIPAddress: List of local IP addresses on which the Collecting Process listens for IPFIX Messages. If omitted, the Collecting Process listens on all local IP addresses.

localIPAddress:収集プロセスがIPFIXメッセージをリッスンするローカルIPアドレスのリスト。省略した場合、収集プロセスはすべてのローカルIPアドレスで待機します。

templateLifeTime, optionsTemplateLifeTime: (Options) Template lifetime in seconds for all UDP Transport Sessions terminating at this UDP socket. (Options) Templates that are not received again within the configured lifetime become invalid at the Collecting Process. As specified in [RFC5101], Section 10.3.7, the lifetime of Templates and Options Templates MUST be at least three times higher than the templateRefreshTimeout and optionTemplatesRefreshTimeout parameter values configured on the corresponding Exporting Processes. If not configured, the default value 1800 is used, which is three times the default (Options) Template refresh timeout (see Section 4.4.2) as specified in [RFC5101]. Note that these parameters correspond to ipfixTransportSessionTemplateRefreshTimeout and ipfixTransportSessionOptionsTemplateRefreshTimeout in the IPFIX MIB module [RFC6615].

templateLifeTime、optionsTemplateLifeTime:(オプション)このUDPソケットで終了するすべてのUDPトランスポートセッションのテンプレート存続時間(秒)。 (オプション)構成された有効期間内に再度受信されないテンプレートは、収集プロセスで無効になります。 [RFC5101]のセクション10.3.7で指定されているように、テンプレートとオプションテンプレートのライフタイムは、対応するエクスポートプロセスで構成されているtemplateRefreshTimeoutおよびoptionTemplatesRefreshTimeoutパラメータ値よりも少なくとも3倍長くなければなりません。構成されていない場合、デフォルト値1800が使用されます。これは、[RFC5101]で指定されているデフォルト(オプション)テンプレート更新タイムアウト(セクション4.4.2を参照)の3倍です。これらのパラメーターは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionTemplateRefreshTimeoutおよびipfixTransportSessionOptionsTemplateRefreshTimeoutに対応することに注意してください。

templateLifePacket, optionsTemplateLifePacket: If templateLifePacket is configured, Templates defined in a UDP Transport Session become invalid if they are neither included in a sequence of more than this number of IPFIX Messages nor received again within the period of time specified by templateLifeTime. Similarly, if optionsTemplateLifePacket is configured, Options Templates become invalid if they are neither included in a sequence of more than this number of IPFIX Messages nor received again within the period of time specified by optionsTemplateLifeTime. If not configured, Templates and Options Templates only become invalid according to the lifetimes specified by templateLifeTime and optionsTemplateLifeTime, respectively. Note that these parameters correspond to ipfixTransportSessionTemplateRefreshPacket and ipfixTransportSessionOptionsTemplateRefreshPacket in the IPFIX MIB module [RFC6615].

templateLifePacket、optionsTemplateLifePacket:templateLifePacketが設定されている場合、UDPトランスポートセッションで定義されたテンプレートは、この数を超えるIPFIXメッセージのシーケンスに含まれていなかったり、templateLifeTimeで指定された期間内に再度受信されなかったりすると無効になります。同様に、optionsTemplateLifePacketが設定されている場合、オプションテンプレートがこの数を超えるIPFIXメッセージのシーケンスに含まれていなかったり、optionsTemplateLifeTimeで指定された期間内に再度受信されなかったりすると、無効になります。構成されていない場合、テンプレートおよびオプションテンプレートは、それぞれtemplateLifeTimeおよびoptionsTemplateLifeTimeで指定された有効期間に従ってのみ無効になります。これらのパラメーターは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionTemplateRefreshPacketおよびipfixTransportSessionOptionsTemplateRefreshPacketに対応することに注意してください。

Using the TransportLayerSecurity class described in Section 4.6, DTLS is enabled and configured for this receiving socket.

セクション4.6で説明されているTransportLayerSecurityクラスを使用すると、DTLSが有効になり、この受信ソケットに対して構成されます。

As state data, the UdpCollector class contains the list of currently established Transport Sessions that terminate at the given UDP socket of the Collecting Process. The TransportSession class is specified in Section 4.7.

状態データとして、UdpCollectorクラスには、収集プロセスの特定のUDPソケットで終了する、現在確立されているトランスポートセッションのリストが含まれています。 TransportSessionクラスはセクション4.7で指定されています。

4.5.3. TcpCollector Class
4.5.3. TcpCollectorクラス
      +--------------------------+
      | TcpCollector             |
      +--------------------------+    0..1 +------------------------+
      | name                     |<>-------| TransportLayerSecurity |
      | localIPAddress[0..*]     |         +------------------------+
      | localPort = 4739|4740    |
      |                          |    0..* +------------------------+
      |                          |<>-------| TransportSession       |
      +--------------------------+         +------------------------+
        

Figure 25: TcpCollector class

図25:TcpCollectorクラス

The TcpCollector class contains the configuration parameters of a listening TCP socket at a Collecting Process. The parameters have the same meaning as in the UdpCollector class (see Section 4.5.2).

TcpCollectorクラスには、収集プロセスで待機するTCPソケットの構成パラメーターが含まれています。パラメータは、UdpCollectorクラスと同じ意味を持っています(セクション4.5.2を参照)。

Using the TransportLayerSecurity class described in Section 4.6, TLS is enabled and configured for this receiving socket.

セクション4.6で説明されているTransportLayerSecurityクラスを使用すると、TLSが有効になり、この受信ソケットに対して構成されます。

As state data, the TcpCollector class contains the list of currently established Transport Sessions that terminate at the given TCP socket of the Collecting Process. The TransportSession class is specified in Section 4.7.

TcpCollectorクラスには、状態データとして、収集プロセスの特定のTCPソケットで終了する、現在確立されているトランスポートセッションのリストが含まれています。 TransportSessionクラスはセクション4.7で指定されています。

4.5.4. FileReader Class
4.5.4. FileReaderクラス
      +-----------------------------------------+
      | FileReader                              |
      +-----------------------------------------+    0..* +----------+
      | name                                    |<>-------| Template |
      | file                                    |         +----------+
      | bytes {readOnly}                        |
      | messages {readOnly}                     |
      | records {readOnly}                      |
      | templates {readOnly}                    |
      | optionsTemplates {readOnly}             |
      | fileReaderDiscontinuityTime {readOnly}  |
      +-----------------------------------------+
        

Figure 26: FileReader classes

図26:FileReaderクラス

The Collecting Process may import IPFIX Messages from a file as specified in [RFC5655]. The FileReader class defines the following configuration parameter:

収集プロセスは、[RFC5655]で指定されているファイルからIPFIXメッセージをインポートする場合があります。 FileReaderクラスは、次の構成パラメーターを定義します。

file: File name and location specified as URI.

file:URIとして指定されたファイル名と場所。

The state parameters of the FileReader class are:

FileReaderクラスの状態パラメーターは次のとおりです。

bytes, messages, records, templates, optionsTemplates: The number of bytes, IPFIX Messages, Data Records, Template Records, and Options Template Records read by the File Reader. Discontinuities in the values of these counters can occur at re-initialization of the management system, and at other times as indicated by the value of fileReaderDiscontinuityTime.

バイト、メッセージ、レコード、テンプレート、optionsTemplates:ファイルリーダーによって読み取られたバイト数、IPFIXメッセージ、データレコード、テンプレートレコード、およびオプションテンプレートレコード。これらのカウンターの値の不連続は、管理システムの再初期化時に発生する可能性があります。また、fileReaderDiscontinuityTimeの値によって示される他の場合にも発生する可能性があります。

fileReaderDiscontinuityTime: Timestamp of the most recent occasion at which one or more File Reader counters suffered a discontinuity. In contrast to discontinuity times in the IPFIX MIB module, the time is absolute and not relative to sysUpTime.

fileReaderDiscontinuityTime:1つ以上のファイルリーダーカウンターが不連続になった最新のタイムスタンプ。 IPFIX MIBモジュールの不連続時間とは対照的に、時間は絶対値であり、sysUpTimeに対するものではありません。

Each object of the FileReader class includes a list of objects of the Template class with information and statistics about the Templates read from the file. The Template class is specified in Section 4.8.

FileReaderクラスの各オブジェクトには、テンプレートクラスのオブジェクトのリストと、ファイルから読み取られたテンプレートに関する情報と統計が含まれます。 Templateクラスはセクション4.8で指定されています。

4.6. Transport Layer Security Class
4.6. トランスポート層セキュリティクラス
                  +--------------------------------------+
                  | TransportLayerSecurity               |
                  +--------------------------------------+
                  | localCertificationAuthorityDN[0..*]  |
                  | localSubjectDN[0..*]                 |
                  | localSubjectFQDN[0..*]               |
                  | remoteCertificationAuthorityDN[0..*] |
                  | remoteSubjectDN[0..*]                |
                  | remoteSubjectFQDN[0..*]              |
                  +--------------------------------------+
        

Figure 27: TransportLayerSecurity class

図27:TransportLayerSecurityクラス

The TransportLayerSecurity class is used in the Exporting Process's SctpExporter, UdpExporter, and TcpExporter classes, and the Collecting Process's SctpCollector, UdpCollector, and TcpCollector classes to enable and configure TLS/DTLS for IPFIX. TLS/DTLS can be enabled without configuring any additional parameters. In this case, an empty XML element <transportLayerSecurity /> appears in the configuration. If TLS/DTLS is enabled, the endpoint must use DTLS [RFC6347] if the transport protocol is SCTP or UDP, and TLS [RFC5246] if the transport protocol is TCP.

TransportLayerSecurityクラスは、エクスポートプロセスのSctpExporter、UdpExporter、およびTcpExporterクラス、および収集プロセスのSctpCollector、UdpCollector、およびTcpCollectorクラスで使用され、IPFIXのTLS / DTLSを有効にして構成します。追加のパラメーターを構成せずにTLS / DTLSを有効にできます。この場合、空のXML要素<transportLayerSecurity />が構成に表示されます。 TLS / DTLSが有効になっている場合、トランスポートプロトコルがSCTPまたはUDPの場合、エンドポイントはDTLS [RFC6347]を使用し、トランスポートプロトコルがTCPの場合、TLS [RFC5246]を使用する必要があります。

[RFC5101] mandates strong mutual authentication of Exporting Processes and Collecting Process as follows. Note this text cites [RFC3280], which was obsoleted by [RFC5280].

[RFC5101]は、エクスポートプロセスと収集プロセスの強力な相互認証を次のように義務付けています。このテキストは[RFC5280]によって廃止された[RFC3280]を引用していることに注意してください。

IPFIX Exporting Processes and IPFIX Collecting Processes are identified by the fully qualified domain name (FQDN) of the interface on which IPFIX Messages are sent or received, for purposes of X.509 client and server certificates as in [RFC3280]. To prevent man-in-the-middle attacks from impostor Exporting or Collecting Processes, the acceptance of data from an unauthorized Exporting Process, or the export of data to an unauthorized Collecting Process, strong mutual authentication via asymmetric keys MUST be used for both TLS and DTLS. Each of the IPFIX Exporting and Collecting Processes MUST verify the identity of its peer against its authorized certificates, and MUST verify that the peer's certificate matches its fully qualified domain name, or, in the case of SCTP, the fully qualified domain name of one of its endpoints. The fully qualified domain name used to identify an IPFIX Collecting Process or Exporting Process may be stored either in a subjectAltName extension of type dNSName, or in the most specific Common Name field of the Subject field of the X.509 certificate.

IPFIXエクスポートプロセスとIPFIX収集プロセスは、[RFC3280]のようなX.509クライアントとサーバー証明書の目的で、IPFIXメッセージが送受信されるインターフェイスの完全修飾ドメイン名(FQDN)によって識別されます。なりすましのエクスポートまたは収集プロセスによる中間者攻撃、無許可のエクスポートプロセスからのデータの受け入れ、または無許可の収集プロセスへのデータのエクスポートを防ぐには、非対称キーによる強力な相互認証を両方のTLSに使用する必要がありますおよびDTLS。各IPFIXエクスポートおよび収集プロセスは、許可された証明書に対してピアのIDを検証する必要があり、ピアの証明書が完全修飾ドメイン名、またはSCTPの場合はいずれかの完全修飾ドメイン名と一致することを検証する必要があります。そのエンドポイント。 IPFIX収集プロセスまたはエクスポートプロセスを識別するために使用される完全修飾ドメイン名は、dNSNameタイプのsubjectAltName拡張、またはX.509証明書のSubjectフィールドの最も具体的なCommon Nameフィールドに格納されます。

If both are present, the subjectAltName extension is given preference.

両方が存在する場合、subjectAltName拡張が優先されます。

In order to use TLS/DTLS, appropriate certificates and keys have to be previously installed on the Monitoring Devices. For security reasons, the configuration data model does not offer the possibility to upload any certificates or keys on a Monitoring Device. If TLS/ DTLS is enabled on a Monitoring Device that does not dispose of appropriate certificates and keys, the configuration MUST be rejected with an error.

TLS / DTLSを使用するには、事前に適切な証明書とキーを監視デバイスにインストールしておく必要があります。セキュリティ上の理由から、構成データモデルでは、監視デバイスに証明書やキーをアップロードすることはできません。適切な証明書とキーを破棄しない監視デバイスでTLS / DTLSが有効になっている場合、構成はエラーで拒否される必要があります。

The configuration data model allows restricting the authorization of remote endpoints to certificates issued by specific certification authorities or identifying specific FQDNs for authorization. Furthermore, the configuration data model allows restricting the utilization of certificates identifying the local endpoint. This is useful if the Monitoring Device disposes of more than one certificate for the given local endpoint.

構成データモデルにより、リモートエンドポイントの承認を特定の証明機関が発行した証明書に制限したり、承認のために特定のFQDNを識別したりできます。さらに、構成データモデルでは、ローカルエンドポイントを識別する証明書の使用を制限できます。これは、監視デバイスが指定されたローカルエンドポイントの複数の証明書を破棄する場合に役立ちます。

The configuration parameters are defined as follows:

構成パラメーターは次のように定義されます。

localCertificationAuthorityDN: This parameter MAY appear one or more times to restrict the identification of the local endpoint during the TLS/DTLS handshake to certificates issued by the configured certification authorities. Each occurrence of this parameter contains the distinguished name of one certification authority. To identify the local endpoint, the Exporting Process or Collecting Process MUST use a certificate issued by one of the configured certification authorities. Certificates issued by any other certification authority MUST NOT be sent to the remote peer during TLS/DTLS handshake. If none of the certificates installed on the Monitoring Device fulfills the specified restrictions, the configuration MUST be rejected with an error. If localCertificationAuthorityDN is not configured, the choice of certificates identifying the local endpoint is not restricted with respect to the issuing certification authority.

localCertificationAuthorityDN:TLS / DTLSハンドシェイク中のローカルエンドポイントの識別を、構成された証明機関が発行した証明書に制限するために、このパラメーターが1回以上現れる場合があります。このパラメーターの各出現には、1つの証明機関の識別名が含まれます。ローカルエンドポイントを識別するために、エクスポートプロセスまたは収集プロセスは、構成された証明機関のいずれかによって発行された証明書を使用する必要があります。他の認証局によって発行された証明書は、TLS / DTLSハンドシェイク中にリモートピアに送信してはなりません。監視デバイスにインストールされている証明書がいずれも指定された制限を満たさない場合、構成はエラーで拒否される必要があります。 localCertificationAuthorityDNが構成されていない場合、ローカルエンドポイントを識別する証明書の選択は、発行元の証明機関に関して制限されません。

localSubjectDN, localSubjectFQDN: Each of these parameters MAY appear one or more times to restrict the identification of the local endpoint during the TLS/DTLS handshake to certificates issued for specific subjects or for specific FQDNs. Each occurrence of localSubjectDN contains a distinguished name identifying the local endpoint. Each occurrence of localSubjectFQDN contains a FQDN which is assigned to the local endpoint. To identify the local endpoint, the Exporting Process or Collecting Process MUST use a certificate that contains either one of the configured distinguished names in the subject field or at least one of the configured FQDNs in a dNSName component of the subject alternative extension field or in the most specific commonName component of the subject field. If none of the certificates installed on the Monitoring Device fulfills the specified restrictions, the configuration MUST be rejected with an error. If any of the parameters localSubjectDN and localSubjectFQDN is configured at the same time as the localCertificationAuthorityDN parameter, certificates MUST also fulfill the specified restrictions regarding the certification authority. If localSubjectDN and localSubjectFQDN are not configured, the choice of certificates identifying the local endpoint is not restricted with respect to the subject's distinguished name or FQDN.

localSubjectDN、localSubjectFQDN:これらの各パラメータは、TLS / DTLSハンドシェイク中にローカルエンドポイントの識別を特定のサブジェクトまたは特定のFQDNに対して発行された証明書に制限するために、1回以上現れる場合があります。 localSubjectDNの各オカレンスには、ローカルエンドポイントを識別する識別名が含まれています。 localSubjectFQDNの各オカレンスには、ローカルエンドポイントに割り当てられたFQDNが含まれています。ローカルエンドポイントを識別するには、エクスポートプロセスまたは収集プロセスで、サブジェクトフィールドに構成済みの識別名の1つ、またはサブジェクトの代替拡張フィールドのdNSNameコンポーネントまたはサブジェクトに構成済みのFQDNの少なくとも1つを含む証明書を使用する必要があります件名フィールドの最も具体的なcommonNameコンポーネント。監視デバイスにインストールされている証明書がいずれも指定された制限を満たさない場合、構成はエラーで拒否される必要があります。パラメータlocalSubjectDNおよびlocalSubjectFQDNのいずれかがlocalCertificationAuthorityDNパラメータと同時に構成されている場合、証明書は証明機関に関する指定された制限も満たさなければなりません(MUST)。 localSubjectDNおよびlocalSubjectFQDNが構成されていない場合、ローカルエンドポイントを識別する証明書の選択は、サブジェクトの識別名またはFQDNに関して制限されません。

remoteCertificationAuthorityDN: This parameter MAY appear one or more times to restrict the authentication of remote endpoints during the TLS/DTLS handshake to certificates issued by the configured certification authorities. Each occurrence of this parameter contains the distinguished name of one certification authority. To authenticate the remote endpoint, the remote Exporting Process or Collecting Process MUST provide a certificate issued by one of the configured certification authorities. Certificates issued by any other certification authority MUST be rejected during TLS/DTLS handshake. If the Monitoring Device is not able to validate certificates issued by the configured certification authorities (e.g., because of missing public keys), the configuration must be rejected with an error. If remoteCertificationAuthorityDN is not configured, the authorization of remote endpoints is not restricted with respect to the issuing certification authority of the delivered certificate.

remoteCertificationAuthorityDN:このパラメーターは、構成された証明機関が発行した証明書へのTLS / DTLSハンドシェイク中にリモートエンドポイントの認証を制限するために1回以上表示される場合があります。このパラメーターの各出現には、1つの証明機関の識別名が含まれます。リモートエンドポイントを認証するには、リモートのエクスポートプロセスまたは収集プロセスが、構成された証明機関のいずれかによって発行された証明書を提供する必要があります。他の証明機関が発行した証明書は、TLS / DTLSハンドシェイク中に拒否する必要があります。監視デバイスが、構成された証明機関によって発行された証明書を検証できない場合(たとえば、公開キーがないため)、構成をエラーで拒否する必要があります。 remoteCertificationAuthorityDNが構成されていない場合、リモートエンドポイントの承認は、配信された証明書の発行証明機関に関して制限されません。

remoteSubjectDN, remoteSubjectFQDN: Each of these parameters MAY appear one or more times to restrict the authentication of remote endpoints during the TLS/DTLS handshake to certificates issued for specific subjects or for specific FQDNs. Each occurrence of remoteSubjectDN contains a distinguished name identifying a remote endpoint. Each occurrence of remoteSubjectFQDN contains a FQDN that is assigned to a remote endpoint. To authenticate a remote endpoint, the remote Exporting Process or Collecting Process MUST provide a certificate that contains either one of the configured distinguished names in the subject field or at least one of the configured FQDNs in a dNSName component of the subject alternative extension field or in the most specific commonName component of the subject field. Certificates not fulfilling this condition MUST be rejected during TLS/DTLS handshake. If any of the parameters remoteSubjectDN and remoteSubjectFQDN is configured at the same time as the remoteCertificationAuthorityDN parameter, certificates MUST also fulfill the specified restrictions regarding the certification authority in order to be accepted. If remoteSubjectDN and remoteSubjectFQDN are not configured, the authorization of remote endpoints is not restricted with respect to the subject's distinguished name or FQDN of the delivered certificate.

remoteSubjectDN、remoteSubjectFQDN:これらの各パラメーターは、特定のサブジェクトまたは特定のFQDNに対して発行された証明書へのTLS / DTLSハンドシェイク中のリモートエンドポイントの認証を制限するために、1回以上現れる場合があります。 remoteSubjectDNの各オカレンスには、リモートエンドポイントを識別する識別名が含まれています。 remoteSubjectFQDNの各オカレンスには、リモートエンドポイントに割り当てられたFQDNが含まれています。リモートエンドポイントを認証するには、リモートのエクスポートプロセスまたは収集プロセスが、サブジェクトフィールドに構成された識別名の1つ、またはサブジェクトの代替拡張フィールドのdNSNameコンポーネントまたは構成されたFQDNの少なくとも1つを含む証明書を提供する必要があります。件名フィールドの最も具体的なcommonNameコンポーネント。この条件を満たさない証明書は、TLS / DTLSハンドシェイク中に拒否する必要があります。パラメーターremoteSubjectDNおよびremoteSubjectFQDNがremoteCertificationAuthorityDNパラメーターと同時に構成されている場合、証明書は、受け入れられるために認証局に関する指定された制限も満たさなければなりません(MUST)。 remoteSubjectDNおよびremoteSubjectFQDNが構成されていない場合、リモートエンドポイントの承認は、サブジェクトの識別名または配信された証明書のFQDNに関して制限されません。

4.7. Transport Session Class
4.7. トランスポートセッションクラス
   +----------------------------------------------+
   | TransportSession                             |
   +----------------------------------------------+    0..* +----------+
   | ipfixVersion {readOnly}                      |<>-------| Template |
   | sourceAddress {readOnly}                     |         +----------+
   | destinationAddress {readOnly}                |
   | sourcePort {readOnly}                        |
   | destinationPort {readOnly}                   |
   | sctpAssocId {readOnly} {SCTP only}           |
   | status {readOnly}                            |
   | rate {readOnly}                              |
   | bytes {readOnly}                             |
   | messages {readOnly}                          |
   | discardedMessages {readOnly}                 |
   | records {readOnly}                           |
   | templates {readOnly}                         |
   | optionsTemplates {readOnly}                  |
   | transportSessionStartTime {readOnly}         |
   | transportSessionDiscontinuityTime {readOnly} |
   +----------------------------------------------+
        

Figure 28: TransportSession class

図28:TransportSessionクラス

The TransportSession class contains state data about Transport Sessions originating from an Exporting Process or terminating at a Collecting Process. In general, the state parameters correspond to the managed objects in the ipfixTransportSessionTable and ipfixTransportSessionStatsTable of the IPFIX MIB module [RFC6615]. An exception is the usage of the parameters sourceAddress and destinationAddress. If SCTP is the transport protocol, the Exporter or Collector MAY be multihomed SCTP endpoints (see [RFC4960], Section 6.4) and use more than one IP address. In the IPFIX MIB module, ipfixTransportSessionSctpAssocId is used instead of ipfixTransportSessionSourceAddress and ipfixTransportSessionDestinationAddress to point to an entry in the sctpAssocTable defined in the SCTP MIB module [RFC3871]. Since we cannot assume that an SNMP agent offering access to the SCTP MIB module exists on the Monitoring Device, the configuration data model cannot rely on this parameter. Therefore, the state parameters sourceAddress and destinationAddress are used for SCTP as well, containing one of the potentially many Exporter and Collector IP addresses in the SCTP association. Preferably, the IP addresses of the path that is usually selected by the Exporter to send IPFIX Messages to the Collector SHOULD be contained.

TransportSessionクラスには、エクスポートプロセスから発生した、または収集プロセスで終了したトランスポートセッションに関する状態データが含まれます。一般に、状態パラメータは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionTableおよびipfixTransportSessionStatsTableの管理対象オブジェクトに対応しています。例外は、パラメーターsourceAddressおよびdestinationAddressの使用です。 SCTPがトランスポートプロトコルである場合、エクスポーターまたはコレクターはマルチホームSCTPエンドポイント([RFC4960]、セクション6.4を参照)であり、複数のIPアドレスを使用する場合があります。 IPFIX MIBモジュールでは、ipfixTransportSessionSourceAddressおよびipfixTransportSessionDestinationAddressの代わりにipfixTransportSessionSctpAssocIdを使用して、SCTP MIBモジュール[RFC3871]で定義されているsctpAssocTableのエントリをポイントします。 SCTP MIBモジュールへのアクセスを提供するSNMPエージェントが監視デバイス上に存在するとは想定できないため、構成データモデルはこのパラメーターに依存できません。したがって、状態パラメーターsourceAddressおよびdestinationAddressはSCTPにも使用され、SCTPアソシエーション内の潜在的に多数のエクスポーターおよびコレクターIPアドレスの1つを含みます。コレクタにIPFIXメッセージを送信するためにエクスポータによって通常選択されるパスのIPアドレスが含まれている必要があります。

Several MIB objects of the ipfixTransportSessionTable are omitted in the TransportSession class. The MIB object ipfixTransportSessionDeviceMode is not included because its value can be derived from the context in which a TransportSession object appears: exporting(1) if it belongs to an Exporting Process, collecting(2) if it belongs to a Collecting Process. Similarly, the MIB object ipfixTransportSessionProtocol is not included as the transport protocol is known from the context as well. The MIB objects ipfixTransportSessionTemplateRefreshTimeout, ipfixTransportSessionOptionsTemplateRefreshTimeout, ipfixTransportSessionTemplateRefreshPacket, and ipfixTransportSessionOptionsTemplateRefreshPacket are not included since they correspond to configuration parameters of the UdpExporter class (templateRefreshTimeout, optionsTemplateRefreshTimeout, templateRefreshPacket, optionsTemplateRefreshPacket) and the UdpCollector class (templateLifeTime, optionsTemplateLifeTime, templateLifePacket, optionsTemplateLifePacket).

ipfixTransportSessionTableのいくつかのMIBオブジェクトは、TransportSessionクラスでは省略されています。 MIBオブジェクトipfixTransportSessionDeviceModeは、その値がTransportSessionオブジェクトが表示されるコンテキストから導出できるため含まれていません。エクスポートプロセスに属している場合はexporting(1)、収集プロセスに属している場合はCollecting(2)。同様に、トランスポートプロトコルもコンテキストから認識されるため、MIBオブジェクトipfixTransportSessionProtocolは含まれていません。 MIBオブジェクトipfixTransportSessionTemplateRefreshTimeout、ipfixTransportSessionOptionsTemplateRefreshTimeout、ipfixTransportSessionTemplateRefreshPacket、およびipfixTransportSessionOptionsTemplateRefreshPacketは、UdpExporterクラスの構成パラメーター(templateRefreshTimeout、optionsTemplateRefreshTimeout、templateRefreshPacket、optionsTemplateRefreshPacket、PacketOptionTemplatePacket)に含まれていないため、含まれていません。

ipfixVersion: Used for Exporting Processes, this parameter contains the version number of the IPFIX protocol that the Exporter uses to export its data in this Transport Session. Hence, it is identical to the value of the configuration parameter ipfixVersion of the outer SctpExporter, UdpExporter, or TcpExporter object. Used for Collecting Processes, this parameter contains the version number of the IPFIX protocol it receives for this Transport Session. If IPFIX Messages of different IPFIX protocol versions are received, this parameter contains the maximum version number. This state parameter is identical to ipfixTransportSessionIpfixVersion in the IPFIX MIB module [RFC6615].

ipfixVersion:プロセスのエクスポートに使用されるこのパラメーターには、エクスポーターがこのトランスポートセッションでデータをエクスポートするために使用するIPFIXプロトコルのバージョン番号が含まれます。したがって、外部のSctpExporter、UdpExporter、またはTcpExporterオブジェクトの構成パラメーターipfixVersionの値と同じです。プロセスの収集に使用されるこのパラメーターには、このトランスポートセッションで受信するIPFIXプロトコルのバージョン番号が含まれます。異なるIPFIXプロトコルバージョンのIPFIXメッセージを受信した場合、このパラメーターには最大バージョン番号が含まれます。この状態パラメータは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionIpfixVersionと同じです。

sourceAddress, destinationAddress: If TCP or UDP is the transport protocol, sourceAddress contains the IP address of the Exporter, and destinationAddress contains the IP addresses of the Collector. Hence, the two parameters have identical values as ipfixTransportSessionSourceAddress and ipfixTransportSessionDestinationAddress in the IPFIX MIB module [RFC6615]. If SCTP is the transport protocol, sourceAddress contains one of the IP addresses of the Exporter and destinationAddress one of the IP addresses of the Collector. Preferably, the IP addresses of the path that is usually selected by the Exporter to send IPFIX Messages to the Collector SHOULD be contained.

sourceAddress、destinationAddress:TCPまたはUDPがトランスポートプロトコルの場合、sourceAddressにはエクスポーターのIPアドレスが含まれ、destinationAddressにはコレクターのIPアドレスが含まれます。したがって、2つのパラメーターは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionSourceAddressおよびipfixTransportSessionDestinationAddressと同じ値を持っています。 SCTPがトランスポートプロトコルの場合、sourceAddressにはエクスポーターのIPアドレスの1つが含まれ、destinationAddressにはコレクターのIPアドレスの1つが含まれます。コレクタにIPFIXメッセージを送信するためにエクスポータによって通常選択されるパスのIPアドレスが含まれている必要があります。

sourcePort, destinationPort: These state parameters contain the transport-protocol port numbers of the Exporter and the Collector of the Transport Session and thus are identical to ipfixTransportSessionSourcePort and ipfixTransportSessionDestinationPort in the IPFIX MIB module [RFC6615].

sourcePort、destinationPort:これらの状態パラメータには、エクスポータとトランスポートセッションのコレクタのトランスポートプロトコルポート番号が含まれているため、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionSourcePortおよびipfixTransportSessionDestinationPortと同じです。

sctpAssocId: The association ID used for the SCTP session between the Exporter and the Collector of the Transport Session. It is equal to the sctpAssocId entry in the sctpAssocTable defined in the SCTP-MIB [RFC3871]. This parameter is only available if the transport protocol is SCTP and if an SNMP agent on the same Monitoring Device enables access to the corresponding MIB objects in the sctpAssocTable. This state parameter is identical to ipfixTransportSessionSctpAssocId in the IPFIX MIB module [RFC6615].

sctpAssocId:トランスポートセッションのエクスポーターとコレクター間のSCTPセッションに使用される関連付けID。これは、SCTP-MIB [RFC3871]で定義されているsctpAssocTableのsctpAssocIdエントリと同じです。このパラメーターは、トランスポートプロトコルがSCTPであり、同じ監視デバイス上のSNMPエージェントがsctpAssocTable内の対応するMIBオブジェクトへのアクセスを有効にしている場合にのみ使用できます。この状態パラメータは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionSctpAssocIdと同じです。

status: Status of the Transport Session, which can be one of the following: * inactive: Transport Session is established, but no IPFIX Messages are currently transferred (e.g., because this is a backup (secondary) session) * active: Transport Session is established and transfers IPFIX Messages * unknown: Transport Session status cannot be determined This state parameter is identical to ipfixTransportSessionStatus in the IPFIX MIB module [RFC6615].

status:トランスポートセッションのステータス。次のいずれかになります。*非アクティブ:トランスポートセッションは確立されていますが、IPFIXメッセージは現在転送されていません(たとえば、これはバックアップ(セカンダリ)セッションであるため)*アクティブ:トランスポートセッションは確立され、IPFIXメッセージを転送します*不明:トランスポートセッションステータスを判別できませんこの状態パラメータは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionStatusと同じです。

rate: The number of bytes per second transmitted by the Exporting Process or received by the Collecting Process. This parameter is updated every second. This state parameter is identical to ipfixTransportSessionRate in the IPFIX MIB module [RFC6615].

レート:エクスポートプロセスによって送信された、または収集プロセスによって受信された1秒あたりのバイト数。このパラメーターは毎秒更新されます。この状態パラメータは、IPFIX MIBモジュール[RFC6615]のipfixTransportSessionRateと同じです。

bytes, messages, records, templates, optionsTemplates: The number of bytes, IPFIX Messages, Data Records, Template Records, and Options Template Records transmitted by the Exporting Process or received by the Collecting Process. Discontinuities in the values of these counters can occur at re-initialization of the management system, and at other times as indicated by the value of transportSessionDiscontinuityTime.

バイト、メッセージ、レコード、テンプレート、optionsTemplates:エクスポートプロセスによって送信された、または収集プロセスによって受信されたバイト数、IPFIXメッセージ、データレコード、テンプレートレコード、およびオプションテンプレートレコード。これらのカウンターの値の不連続は、管理システムの再初期化時に発生する可能性があります。また、transportSessionDiscontinuityTimeの値によって示される他の場合にも発生する可能性があります。

discardedMessages: Used for Exporting Processes, this parameter indicates the number of messages that could not be sent due to internal buffer overflows, network congestion, routing issues, etc. Used for Collecting Process, this parameter indicates the number of received IPFIX Messages that are malformed, cannot be decoded, are received in the wrong order or are missing according to the sequence number. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of transportSessionDiscontinuityTime.

捨てられたメッセージ:このパラメータは、プロセスのエクスポートに使用されます。このパラメータは、内部バッファオーバーフロー、ネットワークの輻輳、ルーティングの問題などが原因で送信できなかったメッセージの数を示します。収集プロセスに使用され、このパラメータは、不正な形式の受信IPFIXメッセージの数を示します、デコードできない、間違った順序で受信される、またはシーケンス番号に従って欠落しています。このカウンターの値の不連続は、管理システムの再初期化時に発生する可能性があります。また、transportSessionDiscontinuityTimeの値によって示される他の場合にも発生する可能性があります。

transportSessionStartTime: Timestamp of the start of the given Transport Session. This state parameter does not correspond to any object in the IPFIX MIB module.

transportSessionStartTime:特定のトランスポートセッションの開始のタイムスタンプ。この状態パラメーターは、IPFIX MIBモジュール内のどのオブジェクトにも対応していません。

transportSessionDiscontinuityTime: Timestamp of the most recent occasion at which one or more of the Transport Session counters suffered a discontinuity. In contrast to ipfixTransportSessionDiscontinuityTime, the time is absolute and not relative to sysUpTime.

transportSessionDiscontinuityTime:1つ以上のトランスポートセッションカウンターが不連続になった最新のタイムスタンプ。 ipfixTransportSessionDiscontinuityTimeとは対照的に、時間は絶対時間であり、sysUpTimeを基準とするものではありません。

Note that, if used for Exporting Processes, the values of the state parameters destinationAddress and destinationPort match the values of the configuration parameters destinationIPAddress and destinationPort of the outer SctpExporter, TcpExporter, and UdpExporter objects (in the case of SctpExporter, one of the configured destinationIPAddress values); if the transport protocol is UDP or SCTP and if the parameter sourceIPAddress is configured in the outer UdpExporter or SctpExporter object, the value of sourceAddress equals the configured value or one of the configured values. Used for Collecting Processes, the value of destinationAddress equals the value (or one of the values) of the parameter localIPAddress if this parameter is configured in the outer UdpCollector, TcpCollector, or SctpCollector object; destinationPort equals the value of the configuration parameter localPort.

エクスポートプロセスに使用する場合、状態パラメーターのdestinationAddressおよびdestinationPortの値は、外部のSctpExporter、TcpExporter、およびUdpExporterオブジェクト(SctpExporterの場合は、構成済みのdestinationIPAddressの1つ)の構成パラメーターdestinationIPAddressおよびdestinationPortの値と一致することに注意してください。値);トランスポートプロトコルがUDPまたはSCTPであり、パラメーターsourceIPAddressが外部UdpExporterまたはSctpExporterオブジェクトで構成されている場合、sourceAddressの値は、構成された値または構成された値の1つと等しくなります。プロセスの収集に使用される場合、destinationAddressの値は、パラメーターlocalIPAddressの値(または値の1つ)と等しくなります(このパラメーターが外部UdpCollector、TcpCollector、またはSctpCollectorオブジェクトで構成されている場合)。 destinationPortは、構成パラメーターlocalPortの値と同じです。

Each object of the TransportSession class includes a list of objects of the Template class with information and statistics about the Templates transmitted or received on the given Transport Session. The Template class is specified in Section 4.8.

TransportSessionクラスの各オブジェクトには、テンプレートクラスのオブジェクトのリストと、特定のトランスポートセッションで送信または受信されたテンプレートに関する情報と統計が含まれます。 Templateクラスはセクション4.8で指定されています。

4.8. Template Class
4.8. テンプレートクラス
     +--------------------------------------+
     | Template                             |
     +--------------------------------------+
     | observationDomainId {readOnly}       |<>---+ 0..*
     | templateId {readOnly}                |     |
     | setId {readOnly}                     |     |
     | accessTime {readOnly}                |     |
     | templateDataRecords {readOnly}       |     |
     | templateDiscontinuityTime {readOnly} |     |
     +--------------------------------------+     |
                                                  |
                              +--------------------------------------+
                              | Field                                |
                              +--------------------------------------+
                              | ieId {readOnly}                      |
                              | ieLength {readOnly}                  |
                              | ieEnterpriseNumber {readOnly}        |
                              | isFlowKey {readOnly} {non-Options    |
                              |   Template only}                     |
                              | isScope {readOnly} {Options Template |
                              |   only}                              |
                              +--------------------------------------+
        

Figure 29: Template class

図29:テンプレートクラス

The Template class contains state data about Templates used by an Exporting Process or received by a Collecting Process in a specific Transport Session. The Field class defines one field of the Template. The names and semantics of the state parameters correspond to the managed objects in the ipfixTemplateTable, ipfixTemplateDefinitionTable, and ipfixTemplateStatsTable of the IPFIX MIB module [RFC6615]:

テンプレートクラスには、エクスポートプロセスで使用される、または特定のトランスポートセッションの収集プロセスで受信されるテンプレートに関する状態データが含まれます。 Fieldクラスは、テンプレートの1つのフィールドを定義します。状態パラメーターの名前とセマンティクスは、IPFIX MIBモジュール[RFC6615]のipfixTemplateTable、ipfixTemplateDefinitionTable、およびipfixTemplateStatsTableの管理対象オブジェクトに対応します。

observationDomainId: The ID of the Observation Domain for which this Template is defined.

ObservationDomainId:このテンプレートが定義されている観測ドメインのID。

templateId: This number indicates the Template ID in the IPFIX Message.

templateId:この番号は、IPFIXメッセージのテンプレートIDを示します。

setId: This number indicates the Set ID of the Template. Currently, there are two values defined [RFC5101]. The value 2 is used for Sets containing Template definitions. The value 3 is used for Sets containing Options Template definitions.

setId:この番号は、テンプレートのセットIDを示します。現在、2つの値が定義されています[RFC5101]。値2は、テンプレート定義を含むセットに使用されます。値3は、オプションテンプレート定義を含むセットに使用されます。

accessTime: Used for Exporting Processes, this parameter contains the time when this (Options) Template was last sent to the Collector or written to the file. Used for Collecting Processes, this parameter contains the time when this (Options) Template was last received from the Exporter or read from the file.

accessTime:プロセスのエクスポートに使用されるこのパラメーターには、この(オプション)テンプレートが最後にコレクターに送信された時刻、またはファイルに書き込まれた時刻が含まれます。プロセスの収集に使用されるこのパラメーターには、この(オプション)テンプレートがエクスポーターから最後に受信された時刻、またはファイルから読み取られた時刻が含まれます。

templateDataRecords: The number of transmitted or received Data Records defined by this (Options) Template since the point in time indicated by templateDefinitionTime.

templateDataRecords:templateDefinitionTimeで示された時点以降に、この(オプション)テンプレートによって定義された送信または受信されたデータレコードの数。

templateDiscontinuityTime: Timestamp of the most recent occasion at which the counter templateDataRecords suffered a discontinuity. In contrast to ipfixTemplateDiscontinuityTime, the time is absolute and not relative to sysUpTime.

templateDiscontinuityTime:カウンターtemplateDataRecordsが不連続になった最新の機会のタイムスタンプ。 ipfixTemplateDiscontinuityTimeとは対照的に、時間は絶対時間であり、sysUpTimeを基準とするものではありません。

ieId, ieLength, ieEnterpriseNumber: Information Element identifier, length, and enterprise number of a field in the Template. If this is not an enterprise-specific Information Element, ieEnterpriseNumber is zero. These state parameters are identical to ipfixTemplateDefinitionIeId, ipfixTemplateDefinitionIeLength, and ipfixTemplateDefinitionIeEnterpriseNumber in the IPFIX MIB module [RFC6615].

ieId、ieLength、ieEnterpriseNumber:テンプレート内のフィールドの情報要素識別子、長さ、およびエンタープライズ番号。これが企業固有の情報要素でない場合、すなわちEnterpriseNumberはゼロです。これらの状態パラメータは、IPFIX MIBモジュール[RFC6615]のipfixTemplateDefinitionIeId、ipfixTemplateDefinitionIeLength、およびipfixTemplateDefinitionIeEnterpriseNumberと同じです。

isFlowKey: If this state parameter is present, this is a Flow Key field. This parameter is only available for non-Options Templates (i.e., if setId is 2).

isFlowKey:この状態パラメーターが存在する場合、これはフローキーフィールドです。このパラメーターは、オプションテンプレート以外でのみ使用できます(つまり、setIdが2の場合)。

isFlowKey: If this state parameter is present, this is a scope field. This parameter is only available for Options Templates (i.e., if setId is 3).

isFlowKey:この状態パラメーターが存在する場合、これはスコープフィールドです。このパラメーターはオプションテンプレートでのみ使用できます(つまり、setIdが3の場合)。

5. Adaptation to Device Capabilities
5. デバイス機能への適応

The configuration data model standardizes a superset of common IPFIX and PSAMP configuration parameters. A typical Monitoring Device implementation will not support the entire range of possible configurations. Certain functions may not be supported, such as the Collecting Process that does not exist on a Monitoring Device that is conceived as Exporter only. The configuration of other functions may be subject to resource limitations or functional restrictions. For example, the Cache size is typically limited according to the available memory on the device. It is also possible that a Monitoring Device implementation requires the configuration of additional parameters that are not part of the configuration data model in order to function properly.

構成データモデルは、一般的なIPFIXおよびPSAMP構成パラメーターのスーパーセットを標準化します。一般的な監視デバイスの実装では、可能な構成の全範囲がサポートされるわけではありません。エクスポーターとしてのみ認識される監視デバイスに存在しない収集プロセスなど、特定の機能がサポートされない場合があります。他の機能の構成は、リソース制限または機能制限の対象となる場合があります。たとえば、キャッシュサイズは通常、デバイスで使用可能なメモリに応じて制限されます。監視デバイスの実装では、正しく機能するために、構成データモデルの一部ではない追加のパラメーターの構成が必要になる場合もあります。

YANG [RFC6020] offers several possibilities to restrict and adapt a configuration data model. The current version of YANG defines the concepts of features, deviations, and extensions.

YANG [RFC6020]は、構成データモデルを制限および適合させるいくつかの可能性を提供します。現在のバージョンのYANGは、機能、逸脱、および拡張の概念を定義しています。

The feature concept allows the author of a configuration data model to make proportions of the model conditional in a manner that is controlled by the device. Devices do not have to support these conditional parts to conform to the model. If the NETCONF protocol is used, features which are supported by the device are announced in the <hello> message [RFC6241].

機能の概念により、構成データモデルの作成者は、デバイスによって制御される方法でモデルの比率を条件付きにすることができます。デバイスは、モデルに準拠するためにこれらの条件付きパーツをサポートする必要はありません。 NETCONFプロトコルが使用されている場合、デバイスがサポートする機能は<hello>メッセージ[RFC6241]で通知されます。

The configuration data model for IPFIX and PSAMP covers the configuration of Exporters, Collectors, and devices that may act as both. As Exporters and Collectors implement different functions, the corresponding proportions of the model are conditional on the following features:

IPFIXとPSAMPの構成データモデルは、エクスポーター、コレクター、および両方として機能するデバイスの構成をカバーしています。エクスポーターとコレクターは異なる機能を実装するため、モデルの対応する比率は次の機能を条件とします。

exporter: If this feature is supported, Exporting Processes can be configured.

エクスポーター:この機能がサポートされている場合、エクスポートプロセスを構成できます。

collector: If this feature is supported, Collecting Processes can be configured.

コレクター:この機能がサポートされている場合、収集プロセスを構成できます。

Exporters do not necessarily implement any Selection Processes, Caches, or even Observation Points in particular cases. Therefore, the corresponding proportions of the model are conditional on the following feature:

特定の場合、エクスポーターは必ずしも選択プロセス、キャッシュ、または観測ポイントを実装する必要はありません。したがって、モデルの対応する比率は、次の機能を条件としています。

meter: If this feature is supported, Observation Points, Selection Processes, and Caches can be configured.

メーター:この機能がサポートされている場合、観測ポイント、選択プロセス、およびキャッシュを構成できます。

Additional features refer to different PSAMP Sampling and Filtering methods as well as to the supported types of Caches:

追加機能は、さまざまなPSAMPサンプリングとフィルタリングの方法、およびサポートされているタイプのキャッシュを参照します。

psampSampCountBased: If this feature is supported, Sampling method sampCountBased can be configured.

psampSampCountBased:この機能がサポートされている場合、サンプリングメソッドsampCountBasedを構成できます。

psampSampTimeBased: If this feature is supported, Sampling method sampTimeBased can be configured.

psampSampTimeBased:この機能がサポートされている場合、サンプリングメソッドsampTimeBasedを構成できます。

psampSampRandOutOfN: If this feature is supported, Sampling method sampRandOutOfN can be configured.

psampSampRandOutOfN:この機能がサポートされている場合、サンプリングメソッドsampRandOutOfNを構成できます。

psampSampUniProb: If this feature is supported, Sampling method sampUniProb can be configured.

psampSampUniProb:この機能がサポートされている場合、サンプリングメソッドsampUniProbを構成できます。

psampFilterMatch: If this feature is supported, Filtering method filterMatch can be configured.

psampFilterMatch:この機能がサポートされている場合、フィルタリングメソッドfilterMatchを構成できます。

psampFilterHash: If this feature is supported, Filtering method filterHash can be configured.

psampFilterHash:この機能がサポートされている場合、フィルタリングメソッドfilterHashを構成できます。

immediateCache: If this feature is supported, a Cache generating PSAMP Packet Reports can be configured using the ImmediateCache class.

immediateCache:この機能がサポートされている場合、PSAMPパケットレポートを生成するキャッシュは、ImmediateCacheクラスを使用して構成できます。

timeoutCache: If this feature is supported, a Cache generating IPFIX Flow Records can be configured using the TimeoutCache class.

timeoutCache:この機能がサポートされている場合は、TimeoutCacheクラスを使用して、キャッシュを生成するIPFIXフローレコードを構成できます。

naturalCache: If this feature is supported, a Cache generating IPFIX Flow Records can be configured using the NaturalCache class.

naturalCache:この機能がサポートされている場合、IPフローレコードを生成するキャッシュは、NaturalCacheクラスを使用して構成できます。

permanentCache: If this feature is supported, a Cache generating IPFIX Flow Records can be configured using the PermanentCache class.

persistentCache:この機能がサポートされている場合、IPFIXフローレコードを生成するキャッシュは、PermanentCacheクラスを使用して構成できます。

The following features concern the support of UDP and TCP as transport protocols and the support of File Readers and File Writers:

次の機能は、トランスポートプロトコルとしてのUDPおよびTCPのサポートと、ファイルリーダーおよびファイルライターのサポートに関係しています。

udpTransport: If this feature is supported, UDP can be used as transport protocol by Exporting Processes and Collecting Processes.

udpTransport:この機能がサポートされている場合、プロセスのエクスポートおよびプロセスの収集により、UDPをトランスポートプロトコルとして使用できます。

tcpTransport: If this feature is supported, TCP can be used as transport protocol by Exporting Processes and Collecting Processes.

tcpTransport:この機能がサポートされている場合、プロセスのエクスポートとプロセスの収集により、TCPをトランスポートプロトコルとして使用できます。

fileReader: If this feature is supported, File Readers can be configured as part of Collecting Processes.

fileReader:この機能がサポートされている場合、ファイルリーダーは収集プロセスの一部として構成できます。

fileWriter: If this feature is supported, File Writers can be configured as part of Exporting Processes.

fileWriter:この機能がサポートされている場合、エクスポートプロセスの一部としてファイルライターを構成できます。

The deviation concept enables a device to announce deviations from the standard model using the "deviation" statement. For example, it is possible to restrict the value range of a specific parameter or to define that the configuration of a certain parameter is not supported at all. Hence, deviations are typically used to specify limitations due to resource constraints or functional restrictions. Deviations concern existing parameters of the original configuration data model and must not be confused with model extensions. Model extensions are specified with the "augment" statement and allow adding new parameters to the original configuration data model.

偏差の概念により、デバイスは「偏差」ステートメントを使用して標準モデルからの偏差を通知できます。たとえば、特定のパラメーターの値の範囲を制限したり、特定のパラメーターの構成がまったくサポートされないように定義したりすることができます。したがって、偏差は通常、リソースの制約または機能の制限による制限を指定するために使用されます。偏差は、元の構成データモデルの既存のパラメーターに関係しており、モデル拡張と混同しないでください。モデル拡張は「augment」ステートメントで指定され、新しいパラメーターを元の構成データモデルに追加できます。

If certain device-specific constraints cannot be formally specified with YANG, they MUST be expressed with human-readable text using the "description" statement. The provided information MUST enable the user to define a configuration that is entirely supported by the Monitoring Device. On the other hand, if a Monitoring Device is configured, it MUST notify the user about any part of the configuration that is not supported. The Monitoring Device MUST NOT silently accept configuration data that cannot be completely enforced. If the NETCONF protocol is used to send configuration data to the Monitoring Device, the error handling is specified in the NETCONF protocol specification [RFC6241].

特定のデバイス固有の制約をYANGで正式に指定できない場合は、「description」ステートメントを使用して、人間が読めるテキストで表現する必要があります。提供される情報は、ユーザーが監視デバイスによって完全にサポートされる構成を定義できるようにする必要があります。一方、監視デバイスが構成されている場合、構成のサポートされていない部分についてユーザーに通知する必要があります。監視デバイスは、完全に実施できない構成データを黙って受け入れてはなりません。 NETCONFプロトコルを使用して構成データを監視デバイスに送信する場合、エラー処理はNETCONFプロトコル仕様[RFC6241]で指定されています。

Just like features, deviations and model extensions are announced in NETCONF's <hello> message. A usage example of deviations is given in Section 7.5.

機能と同様に、偏差とモデル拡張はNETCONFの<hello>メッセージで発表されます。偏差の使用例は、セクション7.5に記載されています。

6. YANG Module of the IPFIX/PSAMP Configuration Data Model
6. IPFIX / PSAMP構成データモデルのYANGモジュール

The YANG module specification of the configuration data model is listed below. It makes use of the common YANG types defined in the modules urn:ietf:params:xml:ns:yang:ietf-yang-types and urn:ietf:params:xml:ns:yang:ietf-inet-types [RFC6021].

構成データモデルのYANGモジュール仕様を以下に示します。モジュールurn:ietf:params:xml:ns:yang:ietf-yang-typesおよびurn:ietf:params:xml:ns:yang:ietf-inet-types [RFC6021]で定義されている一般的なYANGタイプを利用します。 。

  <CODE BEGINS> file "ietf-ipfix-psamp@2012-09-05.yang"
  module ietf-ipfix-psamp {
    namespace "urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp";
    prefix ipfix;
        
    import ietf-yang-types { prefix yang; }
    import ietf-inet-types { prefix inet; }
        

organization "IETF IPFIX Working Group";

組織「IETF IPFIXワーキンググループ」;

    contact
      "WG Web:  <http://tools.ietf.org/wg/ipfix/>
      WG List:  <ipfix@ietf.org>
        
      WG Chair: Nevil Brownlee
                <n.brownlee@auckland.ac.nz>
        
      WG Chair: Juergen Quittek
                <quittek@neclab.eu>
        
      Editor:   Gerhard Muenz
                <muenz@net.in.tum.de>";
        

description "IPFIX/PSAMP Configuration Data Model

説明 "IPFIX / PSAMP構成データモデル

Copyright (c) 2012 IETF Trust and the persons identified as the document authors. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info).";

Copyright(c)2012 IETF Trustおよびドキュメントの作成者として特定された人物。全著作権所有。ソースおよびバイナリ形式での再配布および使用は、変更の有無にかかわらず、IETF文書に関連するIETFトラストの法的規定のセクション4.cに記載されているSimplified BSD Licenseに従い、それに含まれるライセンス条項に従って許可されます( http://trustee.ietf.org/license-info) ";

    revision 2012-09-05 {
      description "Initial version";
      reference "RFC 6728: Configuration Data Model for the IP Flow
        Information Export (IPFIX) and Packet Sampling (PSAMP)
        Protocols";
    }
        
    /*****************************************************************
    * Features
    *****************************************************************/
        
    feature exporter {
      description "If supported, the Monitoring Device can be used as
        an Exporter.  Exporting Processes can be configured.";
    }
        
    feature collector {
      description "If supported, the Monitoring Device can be used as
        a Collector.  Collecting Processes can be configured.";
    }
        
    feature meter {
      description "If supported, Observation Points, Selection
        Processes, and Caches can be configured.";
    }
        
    feature psampSampCountBased {
      description "If supported, the Monitoring Device supports
        count-based Sampling.  The Selector method sampCountBased can
        be configured.";
        

}

    feature psampSampTimeBased {
      description "If supported, the Monitoring Device supports
        time-based Sampling.  The Selector method sampTimeBased can
        be configured.";
    }
        
    feature psampSampRandOutOfN {
      description "If supported, the Monitoring Device supports
        random n-out-of-N Sampling.  The Selector method
        sampRandOutOfN can be configured.";
    }
        
    feature psampSampUniProb {
      description "If supported, the Monitoring Device supports
        uniform probabilistic Sampling.  The Selector method
        sampUniProb can be configured.";
    }
        
    feature psampFilterMatch {
      description "If supported, the Monitoring Device supports
        property match Filtering.  The Selector method filterMatch
        can be configured.";
    }
        
    feature psampFilterHash {
      description "If supported, the Monitoring Device supports
        hash-based Filtering.  The Selector method filterHash can be
        configured.";
    }
        
    feature immediateCache {
      description "If supported, the Monitoring Device supports
        Caches generating PSAMP Packet Reports by configuration with
        immediateCache.";
    }
        
    feature timeoutCache {
      description "If supported, the Monitoring Device supports
        Caches generating IPFIX Flow Records by configuration with
        timeoutCache.";
    }
        
    feature naturalCache {
      description "If supported, the Monitoring Device supports
        Caches generating IPFIX Flow Records by configuration with
        naturalCache.";
        

}

    feature permanentCache {
      description "If supported, the Monitoring Device supports
        Caches generating IPFIX Flow Records by configuration with
        permanentCache.";
    }
        
    feature udpTransport {
      description "If supported, the Monitoring Device supports UDP
        as the transport protocol.";
    }
        
    feature tcpTransport {
      description "If supported, the Monitoring Device supports TCP
        as the transport protocol.";
    }
        
    feature fileReader {
      description "If supported, the Monitoring Device supports the
        configuration of Collecting Processes as File Readers.";
    }
        
    feature fileWriter {
      description "If supported, the Monitoring Device supports the
        configuration of Exporting Processes as File Writers.";
    }
        
    /*****************************************************************
    * Identities
    *****************************************************************/
        
    /*** Hash function identities ***/
    identity hashFunction {
      description "Base identity for all hash functions used for
        hash-based packet Filtering.  Identities derived from
        this base are used by the leaf
        /ipfix/selectionProcess/selector/filterHash/hashFunction.";
    }
    identity BOB {
      base "hashFunction";
      description "BOB hash function";
      reference "RFC 5475, Section 6.2.4.1.";
    }
    identity IPSX {
      base "hashFunction";
      description "IPSX hash function";
      reference "RFC 5475, Section 6.2.4.1.";
        
    }
    identity CRC {
      base "hashFunction";
      description "CRC hash function";
      reference "RFC 5475, Section 6.2.4.1.";
    }
        
    /*** Export mode identities ***/
    identity exportMode {
      description "Base identity for different usages of export
        destinations configured for an Exporting Process.
        Identities derived from this base are used by the leaf
        /ipfix/exportingProcess/exportMode.";
    }
    identity parallel {
      base "exportMode";
      description "Parallel export of Data Records to all
        destinations configured for the Exporting Process.";
    }
    identity loadBalancing {
      base "exportMode";
      description "Load-balancing between the different destinations
        configured for the Exporting Process.";
    }
    identity fallback {
      base "exportMode";
      description "Export to the primary destination (i.e., the first
        SCTP, UDP, TCP, or file destination configured for the
        Exporting Process).  If the export to the primary destination
        fails, the Exporting Process tries to export to the secondary
        destination.  If the secondary destination fails as well, it
        continues with the tertiary, etc.";
    }
        
    /*** Options type identities ***/
    identity optionsType {
      description "Base identity for report types exported with
        options.  Identities derived from this base are used by the leaf
        /ipfix/exportingProcess/options/optionsType.";
    }
    identity meteringStatistics {
      base "optionsType";
      description "Metering Process Statistics.";
      reference "RFC 5101, Section 4.1.";
    }
    identity meteringReliability {
      base "optionsType";
      description "Metering Process Reliability Statistics.";
        
      reference "RFC 5101, Section 4.2.";
    }
    identity exportingReliability {
      base "optionsType";
      description "Exporting Process Reliability
        Statistics.";
      reference "RFC 5101, Section 4.3.";
    }
    identity flowKeys {
      base "optionsType";
      description "Flow Keys.";
      reference "RFC 5101, Section 4.4.";
    }
    identity selectionSequence {
      base "optionsType";
      description "Selection Sequence and Selector Reports.";
      reference "RFC 5476, Sections 6.5.1 and 6.5.2.";
    }
    identity selectionStatistics {
      base "optionsType";
      description "Selection Sequence Statistics Report.";
      reference "RFC 5476, Sections 6.5.3.";
    }
    identity accuracy {
      base "optionsType";
      description "Accuracy Report.";
      reference "RFC 5476, Section 6.5.4.";
    }
    identity reducingRedundancy {
      base "optionsType";
      description "Enables the utilization of Options Templates to
        reduce redundancy in the exported Data Records.";
      reference "RFC 5473.";
    }
    identity extendedTypeInformation {
      base "optionsType";
      description "Export of extended type information for
        enterprise-specific Information Elements used in the
        exported Templates.";
      reference "RFC 5610.";
    }
        
    /*****************************************************************
    * Type definitions
    *****************************************************************/
        
    typedef ieNameType {
      type string {
        
        length "1..max";
        pattern "\S+";
      }
      description "Type for Information Element names.  Whitespaces
        are not allowed.";
    }
        
    typedef ieIdType {
      type uint16 {
        range "1..32767" {
          description "Valid range of Information Element
              identifiers.";
          reference "RFC 5102, Section 4.";
        }
      }
      description "Type for Information Element identifiers.";
    }
        
    typedef nameType {
      type string {
        length "1..max";
        pattern "\S(.*\S)?";
      }
      description "Type for 'name' leafs, which are used to identify
        specific instances within lists, etc.
        Leading and trailing whitespaces are not allowed.";
    }
        
    typedef ifNameType {
      type string {
        length "1..255";
      }
      description "This corresponds to the DisplayString textual
        convention of SNMPv2-TC, which is used for ifName in the IF
        MIB module.";
      reference "RFC 2863 (ifName).";
    }
        
    typedef direction {
      type enumeration {
        enum ingress {
          description "This value is used for monitoring incoming
            packets.";
        }
        enum egress {
          description "This value is used for monitoring outgoing
            packets.";
        }
        enum both {
          description "This value is used for monitoring incoming and
            outgoing packets.";
        }
      }
      description "Direction of packets going through an interface or
        linecard.";
    }
        
    typedef transportSessionStatus {
      type enumeration {
        enum inactive {
          description "This value MUST be used for Transport Sessions
            that are specified in the system but currently not active.
            The value can be used for Transport Sessions that are
            backup (secondary) sessions.";
        }
        enum active {
          description "This value MUST be used for Transport Sessions
            that are currently active and transmitting or receiving
            data.";
        }
        enum unknown {
          description "This value MUST be used if the status of the
            Transport Sessions cannot be detected by the device.  This
            value should be avoided as far as possible.";
        }
      }
      description "Status of a Transport Session.";
      reference "RFC 6615, Section 8 (ipfixTransportSessionStatus).";
    }
        
    /*****************************************************************
    * Groupings
    *****************************************************************/
        
    grouping observationPointParameters {
      description "Interface as input to Observation Point.";
      leaf observationPointId {
        type uint32;
        config false;
        description "Observation Point ID (i.e., the value of the
          Information Element observationPointId) assigned by the
          Monitoring Device.";
        reference "IANA registry for IPFIX Entities,
          http://www.iana.org/assignments/ipfix.";
      }
      leaf observationDomainId {
        
        type uint32;
        mandatory true;
        description "The Observation Domain ID associates the
          Observation Point to an Observation Domain.  Observation
          Points with identical Observation Domain IDs belong to the
          same Observation Domain.
          Note that this parameter corresponds to
          ipfixObservationPointObservationDomainId in the IPFIX MIB
          module.";
        reference "RFC 5101; RFC 6615, Section 8
          (ipfixObservationPointObservationDomainId).";
      }
      leaf-list ifName {
        type ifNameType;
        description "List of names identifying interfaces of the
          Monitoring Device.  The Observation Point observes packets at
          the specified interfaces.";
      }
      leaf-list ifIndex {
        type uint32;
        description "List of ifIndex values pointing to entries in the
          ifTable of the IF-MIB module maintained by the Monitoring
          Device.  The Observation Point observes packets at the
          specified interfaces.
          This parameter SHOULD only be used if an SNMP agent enables
          access to the ifTable.
          Note that this parameter corresponds to
          ipfixObservationPointPhysicalInterface in the IPFIX MIB
          module.";
        reference "RFC 2863; RFC 6615, Section 8
          (ipfixObservationPointPhysicalInterface).";
      }
      leaf-list entPhysicalName {
        type string;
        description "List of names identifying physical entities of the
          Monitoring Device.  The Observation Point observes packets at
          the specified entities.";
      }
      leaf-list entPhysicalIndex {
        type uint32;
        description "List of entPhysicalIndex values pointing to
          entries in the entPhysicalTable of the ENTITY-MIB module
          maintained by the Monitoring Device.  The Observation Point
          observes packets at the specified entities.
          This parameter SHOULD only be used if an SNMP agent enables
          access to the entPhysicalTable.
          Note that this parameter corresponds to
          ipfixObservationPointPhysicalEntity in the IPFIX MIB
          module.";
        reference "RFC 4133; RFC 6615, Section 8
          (ipfixObservationPointPhysicalInterface).";
      }
      leaf direction {
        type direction;
        default both;
        description "Direction of packets.  If not applicable (e.g., in
          the case of a sniffing interface in promiscuous mode), this
          parameter is ignored.";
      }
    }
        
    grouping sampCountBasedParameters {
      description "Configuration parameters of a Selector applying
        systematic count-based packet Sampling to the packet
        stream.";
      reference "RFC 5475, Section 5.1; RFC 5476, Section 6.5.2.1.";
      leaf packetInterval {
        type uint32;
        units packets;
        mandatory true;
        description "The number of packets that are consecutively
          sampled between gaps of length packetSpace.
          This parameter corresponds to the Information Element
          samplingPacketInterval and to psampSampCountBasedInterval
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.2.2; RFC 6727, Section 6
          (psampSampCountBasedInterval).";
      }
      leaf packetSpace {
        type uint32;
        units packets;
        mandatory true;
        description "The number of unsampled packets between two
          Sampling intervals.
          This parameter corresponds to the Information Element
          samplingPacketSpace and to psampSampCountBasedSpace
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.2.3; RFC 6727, Section 6
          (psampSampCountBasedSpace).";
      }
    }
        
    grouping sampTimeBasedParameters {
      description "Configuration parameters of a Selector applying
        systematic time-based packet Sampling to the packet
        stream.";
        
      reference "RFC 5475, Section 5.1; RFC 5476, Section 6.5.2.2.";
      leaf timeInterval {
        type uint32;
        units microseconds;
        mandatory true;
        description "The time interval in microseconds during
          which all arriving packets are sampled between gaps
          of length timeSpace.
          This parameter corresponds to the Information Element
          samplingTimeInterval and to psampSampTimeBasedInterval
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.2.4; RFC 6727, Section 6
          (psampSampTimeBasedInterval).";
      }
      leaf timeSpace {
        type uint32;
        units microseconds;
        mandatory true;
        description "The time interval in microseconds during
          which no packets are sampled between two Sampling
          intervals specified by timeInterval.
          This parameter corresponds to the Information Element
          samplingTimeInterval and to psampSampTimeBasedSpace
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.2.5; RFC 6727, Section 6
          (psampSampTimeBasedSpace).";
      }
    }
        
    grouping sampRandOutOfNParameters {
      description "Configuration parameters of a Selector applying
        n-out-of-N packet Sampling to the packet stream.";
      reference "RFC 5475, Section 5.2.1; RFC 5476, Section 6.5.2.3.";
      leaf size {
        type uint32;
        units packets;
        mandatory true;
        description "The number of elements taken from the parent
          population.
          This parameter corresponds to the Information Element
          samplingSize and to psampSampRandOutOfNSize in the PSAMP
          MIB module.";
        reference "RFC 5477, Section 8.2.6; RFC 6727, Section 6
          (psampSampRandOutOfNSize).";
      }
      leaf population {
        type uint32;
        units packets;
        
        mandatory true;
        description "The number of elements in the parent
          population.
          This parameter corresponds to the Information Element
          samplingPopulation and to psampSampRandOutOfNPopulation
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.2.7; RFC 6727, Section 6
          (psampSampRandOutOfNPopulation).";
      }
    }
        
    grouping sampUniProbParameters {
      description "Configuration parameters of a Selector applying
        uniform probabilistic packet Sampling (with equal
        probability per packet) to the packet stream.";
      reference "RFC 5475, Section 5.2.2.1;
        RFC 5476, Section 6.5.2.4.";
      leaf probability {
        type decimal64 {
          fraction-digits 18;
          range "0..1";
        }
        mandatory true;
        description "Probability that a packet is sampled,
          expressed as a value between 0 and 1.  The probability
          is equal for every packet.
          This parameter corresponds to the Information Element
          samplingProbability and to psampSampUniProbProbability
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.2.8; RFC 6727, Section 6
          (psampSampUniProbProbability).";
      }
    }
        
    grouping filterMatchParameters {
      description "Configuration parameters of a Selector applying
        property match Filtering to the packet stream.
        The field to be matched is specified as an Information
        Element.";
      reference "RFC 5475, Section 6.1; RFC 5476, Section 6.5.2.5.";
      choice nameOrId {
        mandatory true;
        description "The field to be matched is specified by
          either the name or the identifier of the Information
          Element.";
        leaf ieName {
          type ieNameType;
          description "Name of the Information Element.";
        
        }
        leaf ieId {
          type ieIdType;
          description "Identifier of the Information Element.";
        }
      }
      leaf ieEnterpriseNumber {
        type uint32;
        default 0;
        description "If this parameter is zero, the Information
          Element is registered in the IANA registry of IPFIX
          Information Elements.
          If this parameter is configured with a non-zero private
          enterprise number, the Information Element is
          enterprise-specific.";
        reference "IANA registry for Private Enterprise Numbers,
          http://www.iana.org/assignments/enterprise-numbers;
          IANA registry for IPFIX Entities,
          http://www.iana.org/assignments/ipfix.";
      }
      leaf value {
        type string;
        mandatory true;
        description "Matching value of the Information Element.";
      }
    }
        
    grouping filterHashParameters {
      description "Configuration parameters of a Selector applying
        hash-based Filtering to the packet stream.";
      reference "RFC 5475, Section 6.2; RFC 5476, Section 6.5.2.6.";
      leaf hashFunction {
        type identityref {
          base "hashFunction";
        }
        default BOB;
        description "Hash function to be applied.  According to
          RFC 5475, Section 6.2.4.1, 'BOB' must be used in order to
          be compliant with PSAMP.
          This parameter functionally corresponds to
          psampFiltHashFunction in the PSAMP MIB module.";
        reference "RFC 6727, Section 6 (psampFiltHashFunction)";
      }
      leaf initializerValue {
        type uint64;
        description "Initializer value to the hash function.
          If not configured by the user, the Monitoring Device
          arbitrarily chooses an initializer value.
        
          This parameter corresponds to the Information Element
          hashInitialiserValue and to psampFiltHashInitializerValue
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.3.9; RFC 6727, Section 6
          (psampFiltHashInitializerValue).";
      }
      leaf ipPayloadOffset {
        type uint64;
        units octets;
        default 0;
        description "IP payload offset indicating the position of
          the first payload byte considered as input to the hash
          function.
          Default value 0 corresponds to the minimum offset that
          must be configurable according to RFC 5476, Section 
          6.5.2.6.
          This parameter corresponds to the Information Element
          hashIPPayloadOffset and to psampFiltHashIpPayloadOffset
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.3.2; RFC 6727, Section 6
          (psampFiltHashIpPayloadOffset).";
      }
      leaf ipPayloadSize {
        type uint64;
        units octets;
        default 8;
        description "Number of IP payload bytes used as input to
          the hash function, counted from the payload offset.
          If the IP payload is shorter than the payload range,
          all available payload octets are used as input.
          Default value 8 corresponds to the minimum IP payload
          size that must be configurable according to RFC 5476,
          Section 6.5.2.6.
          This parameter corresponds to the Information Element
          hashIPPayloadSize and to psampFiltHashIpPayloadSize
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.3.3; RFC 6727, Section 6
          (psampFiltHashIpPayloadSize).";
      }
      leaf digestOutput {
        type boolean;
        default false;
        description "If true, the output from this Selector is
          included in the Packet Report as a packet digest.
          Therefore, the configured Cache Layout needs to contain
          a digestHashValue field.
          This parameter corresponds to the Information Element
          hashDigestOutput.";
        
        reference "RFC 5477, Section 8.3.8.";
      }
      leaf outputRangeMin {
        type uint64;
        config false;
        description "Beginning of the hash function's potential
          range.
          This parameter corresponds to the Information Element
          hashOutputRangeMin and to psampFiltHashOutputRangeMin
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.3.4; RFC 6727, Section 6
          (psampFiltHashOutputRangeMin).";
      }
      leaf outputRangeMax {
        type uint64;
        config false;
        description "End of the hash function's potential range.
          This parameter corresponds to the Information Element
          hashOutputRangeMax and to psampFiltHashOutputRangeMax
          in the PSAMP MIB module.";
        reference "RFC 5477, Section 8.3.5; RFC 6727, Section 6
          (psampFiltHashOutputRangeMax).";
      }
      list selectedRange {
        key name;
        min-elements 1;
        description "List of hash function return ranges for
          which packets are selected.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        leaf min {
          type uint64;
          description "Beginning of the hash function's selected
            range.
            This parameter corresponds to the Information Element
            hashSelectedRangeMin and to psampFiltHashSelectedRangeMin
            in the PSAMP MIB module.";
          reference "RFC 5477, Section 8.3.6; RFC 6727, Section 6
          (psampFiltHashSelectedRangeMin).";
        }
        leaf max {
          type uint64;
          description "End of the hash function's selected range.
            This parameter corresponds to the Information Element
            hashSelectedRangeMax and to psampFiltHashSelectedRangeMax
            in the PSAMP MIB module.";
        
          reference "RFC 5477, Section 8.3.7; RFC 6727, Section 6
          (psampFiltHashSelectedRangeMax).";
        }
      }
    }
        
    grouping selectorParameters {
      description "Configuration and state parameters of a Selector.";
      choice Method {
        mandatory true;
        description "Packet selection method applied by the Selector.";
        leaf selectAll {
          type empty;
          description "Method that selects all packets.";
        }
        container sampCountBased {
          if-feature psampSampCountBased;
          description "Systematic count-based packet Sampling.";
          uses sampCountBasedParameters;
        }
        container sampTimeBased {
          if-feature psampSampTimeBased;
          description "Systematic time-based packet Sampling.";
          uses sampTimeBasedParameters;
        }
        container sampRandOutOfN {
          if-feature psampSampRandOutOfN;
          description "n-out-of-N packet Sampling.";
          uses sampRandOutOfNParameters;
        }
        container sampUniProb {
          if-feature psampSampUniProb;
          description "Uniform probabilistic packet Sampling.";
          uses sampUniProbParameters;
        }
        container filterMatch {
          if-feature psampFilterMatch;
          description "Property match Filtering.";
          uses filterMatchParameters;
        }
        container filterHash {
          if-feature psampFilterHash;
          description "Hash-based Filtering.";
          uses filterHashParameters;
        }
      }
      leaf packetsObserved {
        type yang:counter64;
        
        config false;
        description "The number of packets observed at the input of
          the Selector.
          If this is the first Selector in the Selection Process,
          this counter corresponds to the total number of packets in
          all Observed Packet Streams at the input of the Selection
          Process.  Otherwise, the counter corresponds to the total
          number of packets at the output of the preceding Selector.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          selectorDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixSelectorStatsPacketsObserved in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixSelectorStatsPacketsObserved).";
      }
      leaf packetsDropped {
        type yang:counter64;
        config false;
        description "The total number of packets discarded by the
          Selector.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          selectorDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixSelectorStatsPacketsDropped in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixSelectorStatsPacketsDropped).";
      }
      leaf selectorDiscontinuityTime {
        type yang:date-and-time;
        config false;
        description "Timestamp of the most recent occasion at which
          one or more of the Selector counters suffered a
          discontinuity.
          Note that this parameter functionally corresponds to
          ipfixSelectionProcessStatsDiscontinuityTime in the IPFIX
          MIB module.  In contrast to
          ipfixSelectionProcessStatsDiscontinuityTime, the time is
          absolute and not relative to sysUpTime.";
        reference "RFC 6615, Section 8
          (ipfixSelectionProcessStatsDiscontinuityTime).";
      }
    }
    grouping cacheLayoutParameters {
      description "Cache Layout parameters used by immediateCache,
        timeoutCache, naturalCache, and permanentCache.";
      container cacheLayout {
        description "Cache Layout parameters.";
        list cacheField {
          key name;
          min-elements 1;
          description "Superset of fields that are included in the
            Packet Reports or Flow Records generated by the Cache.";
          leaf name {
            type nameType;
            description "Key of this list.";
          }
          choice nameOrId {
            mandatory true;
            description "Name or identifier of the Information
              Element.";
            reference "RFC 5102, Section 2; IANA registry for IPFIX
              Entities, http://www.iana.org/assignments/ipfix.";
            leaf ieName {
              type ieNameType;
              description "Name of the Information Element.";
            }
            leaf ieId {
              type ieIdType;
              description "Identifier of the Information Element.";
            }
          }
          leaf ieLength {
            type uint16;
            units octets;
            description "Length of the field in which the Information
              Element is encoded.  A value of 65535 specifies a
              variable-length Information Element.  For Information
              Elements of integer and float type, the field length MAY
              be set to a smaller value than the standard length of
              the abstract data type if the rules of reduced size
              encoding are fulfilled.
              If not configured by the user, this parameter is set by
              the Monitoring Device.";
            reference "RFC 5101, Section 6.2.";
          }
          leaf ieEnterpriseNumber {
            type uint32;
            default 0;
            description "If this parameter is zero, the Information
              Element is registered in the IANA registry of IPFIX
              Information Elements.
              If this parameter is configured with a non-zero private
              enterprise number, the Information Element is
              enterprise-specific.
              If the enterprise number is set to 29305, this field
              contains a Reverse Information Element.  In this case,
              the Cache MUST generate Data Records in accordance to
              RFC 5103.";
            reference "RFC 5101; RFC 5103;
              IANA registry for Private Enterprise Numbers,
              http://www.iana.org/assignments/enterprise-numbers;
              IANA registry for IPFIX Entities,
              http://www.iana.org/assignments/ipfix.";
          }
          leaf isFlowKey {
            when "(name(../../..) != 'immediateCache')
              and
              ((count(../ieEnterpriseNumber) = 0)
              or
              (../ieEnterpriseNumber != 29305))" {
              description "This parameter is not available for
                Reverse Information Elements (which have enterprise
                number 29305).  It is also not available for
                immediateCache.";
            }
            type empty;
            description "If present, this is a flow key.";
          }
        }
      }
    }
        
    grouping flowCacheParameters {
      description "Configuration and state parameters of a Cache
        generating Flow Records.";
      leaf maxFlows {
        type uint32;
        units flows;
        description "This parameter configures the maximum number of
          Flows in the Cache, which is the maximum number of Flows
          that can be measured simultaneously.
          The Monitoring Device MUST ensure that sufficient resources
          are available to store the configured maximum number of
          Flows.
          If the maximum number of Flows is measured, an additional
          Flow can be measured only if an existing entry is removed.
          However, traffic that pertains to existing Flows can
          continue to be measured.";
        
      }
      leaf activeTimeout {
        when "(name(..) = 'timeoutCache') or
          (name(..) = 'naturalCache')" {
          description "This parameter is only available for
            timeoutCache and naturalCache.";
        }
        type uint32;
        units seconds;
        description "This parameter configures the time in
          seconds after which a Flow is expired even though packets
          matching this Flow are still received by the Cache.
          The parameter value zero indicates infinity, meaning that
          there is no active timeout.
          If not configured by the user, the Monitoring Device sets
          this parameter.
          Note that this parameter corresponds to
          ipfixMeteringProcessCacheActiveTimeout in the IPFIX
          MIB module.";
        reference "RFC 6615, Section 8
          (ipfixMeteringProcessCacheActiveTimeout).";
      }
      leaf idleTimeout {
        when "(name(..) = 'timeoutCache') or
          (name(..) = 'naturalCache')" {
          description "This parameter is only available for
            timeoutCache and naturalCache.";
        }
        type uint32;
        units seconds;
        description "This parameter configures the time in
          seconds after which a Flow is expired if no more packets
          matching this Flow are received by the Cache.
          The parameter value zero indicates infinity, meaning that
          there is no idle timeout.
          If not configured by the user, the Monitoring Device sets
          this parameter.
          Note that this parameter corresponds to
          ipfixMeteringProcessCacheIdleTimeout in the IPFIX
          MIB module.";
        reference "RFC 6615, Section 8
          (ipfixMeteringProcessCacheIdleTimeout).";
      }
      leaf exportInterval {
        when "name(..) = 'permanentCache'" {
          description "This parameter is only available for
            permanentCache.";
        }
        type uint32;
        units seconds;
        description "This parameter configures the interval (in
          seconds) for periodical export of Flow Records.
          If not configured by the user, the Monitoring Device sets
          this parameter.";
      }
      leaf activeFlows {
        type yang:gauge32;
        units flows;
        config false;
        description "The number of Flows currently active in this
          Cache.
          Note that this parameter corresponds to
          ipfixMeteringProcessCacheActiveFlows in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixMeteringProcessCacheActiveFlows).";
      }
      leaf unusedCacheEntries {
        type yang:gauge32;
        units flows;
        config false;
        description "The number of unused Cache entries in this
          Cache.
          Note that this parameter corresponds to
          ipfixMeteringProcessCacheUnusedCacheEntries in the IPFIX
          MIB module.";
        reference "RFC 6615, Section 8
          (ipfixMeteringProcessCacheUnusedCacheEntries).";
      }
    }
        
    grouping exportingProcessParameters {
      description "Parameters of an Exporting Process.";
      leaf exportingProcessId {
        type uint32;
        config false;
        description "The identifier of the Exporting Process.
          This parameter corresponds to the Information Element
          exportingProcessId.  Its occurrence helps to associate
          Exporting Process parameters with Exporing Process
          statistics exported by the Monitoring Device using the
          Exporting Process Reliability Statistics Template as
          defined by the IPFIX protocol specification.";
        reference "RFC 5101, Section 4.3; IANA registry for IPFIX
          Entities, http://www.iana.org/assignments/ipfix.";
      }
      leaf exportMode {
        type identityref {
          base "exportMode";
        }
        default parallel;
        description "This parameter determines to which configured
          destination(s) the incoming Data Records are exported.";
      }
      list destination {
        key name;
        min-elements 1;
        description "List of export destinations.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        choice DestinationParameters {
          mandatory true;
          description "Configuration parameters depend on whether
            SCTP, UDP, or TCP is used as transport protocol, and
            whether the destination is a file.";
          container sctpExporter {
            description "SCTP parameters.";
            uses sctpExporterParameters;
          }
          container udpExporter {
            if-feature udpTransport;
            description "UDP parameters.";
            uses udpExporterParameters;
          }
          container tcpExporter {
            if-feature tcpTransport;
            description "TCP parameters.";
            uses tcpExporterParameters;
          }
          container fileWriter {
            if-feature fileWriter;
            description "File Writer parameters.";
            uses fileWriterParameters;
          }
        }
      }
      list options {
        key name;
        description "List of options reported by the Exporting
          Process.";
        leaf name {
          type nameType;
        
          description "Key of this list.";
        }
        uses optionsParameters;
      }
    }
        
    grouping commonExporterParameters {
      description "Parameters of en export destination that are
        common to all transport protocols.";
      leaf ipfixVersion {
        type uint16;
        default 10;
        description "IPFIX version number.";
        reference "RFC 5101.";
      }
      leaf destinationPort {
        type inet:port-number;
        description "If not configured by the user, the Monitoring
          Device uses the default port number for IPFIX, which is
          4739 without TLS or DTLS and 4740 if TLS or DTLS is
          activated.";
      }
      choice indexOrName {
        description "Index or name of the interface as stored in the
          ifTable of IF-MIB.
          If configured, the Exporting Process MUST use the given
          interface to export IPFIX Messages to the export
          destination.
          If omitted, the Exporting Process selects the outgoing
          interface based on local routing decision and accepts
          return traffic, such as transport-layer acknowledgments,
          on all available interfaces.";
        reference "RFC 2863.";
        leaf ifIndex {
          type uint32;
          description "Index of an interface as stored in the ifTable
            of IF-MIB.";
          reference "RFC 2863.";
        }
        leaf ifName {
          type string;
          description "Name of an interface as stored in the ifTable
            of IF-MIB.";
          reference "RFC 2863.";
        }
      }
      leaf sendBufferSize {
        type uint32;
        
        units bytes;
        description "Size of the socket send buffer.
          If not configured by the user, this parameter is set by
          the Monitoring Device.";
      }
      leaf rateLimit {
        type uint32;
        units "bytes per second";
        description "Maximum number of bytes per second the Exporting
          Process may export to the given destination.  The number of
          bytes is calculated from the lengths of the IPFIX Messages
          exported.  If not configured, no rate limiting is performed.";
        reference "RFC 5476, Section 6.3.";
      }
      container transportLayerSecurity {
        presence "If transportLayerSecurity is present, DTLS is
          enabled if the transport protocol is SCTP or UDP, and TLS
          is enabled if the transport protocol is TCP.";
        description "TLS or DTLS configuration.";
        uses transportLayerSecurityParameters;
      }
      container transportSession {
        config false;
        description "State parameters of the Transport Session
          directed to the given destination.";
        uses transportSessionParameters;
      }
    }
        
    grouping sctpExporterParameters {
      description "SCTP-specific export destination parameters.";
      uses commonExporterParameters;
      leaf-list sourceIPAddress {
        type inet:ip-address;
        description "List of source IP addresses used by the
          Exporting Process.
          If configured, the specified addresses are eligible local
          IP addresses of the multihomed SCTP endpoint.
          If not configured, all locally assigned IP addresses are
          eligible local IP addresses.";
        reference "RFC 4960, Section 6.4.";
      }
      leaf-list destinationIPAddress {
        type inet:ip-address;
        min-elements 1;
        description "One or more IP addresses of the Collecting
          Process to which IPFIX Messages are sent.
          The user MUST ensure that all configured IP addresses
          belong to the same Collecting Process.
          The Exporting Process tries to establish an SCTP
          association to any of the configured destination IP
          addresses.";
        reference "RFC 4960, Section 6.4.";
      }
      leaf timedReliability {
        type uint32;
        units milliseconds;
        default 0;
        description "Lifetime in milliseconds until an IPFIX
          Message containing Data Sets only is 'abandoned' due to
          the timed reliability mechanism of PR-SCTP.
          If this parameter is set to zero, reliable SCTP
          transport is used for all Data Records.
          Regardless of the value of this parameter, the Exporting
          Process MAY use reliable SCTP transport for Data Sets
          associated with Options Templates.";
        reference "RFC 3758; RFC 4960.";
      }
    }
        
    grouping udpExporterParameters {
      description "Parameters of a UDP export destination.";
      uses commonExporterParameters;
      leaf sourceIPAddress {
        type inet:ip-address;
        description "Source IP address used by the Exporting Process.
        If not configured, the IP address assigned to the outgoing
        interface is used as source IP address.";
      }
      leaf destinationIPAddress {
        type inet:ip-address;
        mandatory true;
        description "IP address of the Collection Process to which
          IPFIX Messages are sent.";
      }
      leaf maxPacketSize {
        type uint16;
        units octets;
        description "This parameter specifies the maximum size of
          IP packets sent to the Collector.  If set to zero, the
          Exporting Device MUST derive the maximum packet size
          from path MTU discovery mechanisms.
          If not configured by the user, this parameter is set by
          the Monitoring Device.";
      }
      leaf templateRefreshTimeout {
        
        type uint32;
        units seconds;
        default 600;
        description "Sets time after which Templates are resent in the
          UDP Transport Session.
          Note that the configured lifetime MUST be adapted to the
          templateLifeTime parameter value at the receiving Collecting
          Process.
          Note that this parameter corresponds to
          ipfixTransportSessionTemplateRefreshTimeout in the IPFIX
          MIB module.";
        reference "RFC 5101, Section 10.3.6; RFC 6615, Section 8
          (ipfixTransportSessionTemplateRefreshTimeout).";
      }
      leaf optionsTemplateRefreshTimeout {
        type uint32;
        units seconds;
        default 600;
        description "Sets time after which Options Templates are
          resent in the UDP Transport Session.
          Note that the configured lifetime MUST be adapted to the
          optionsTemplateLifeTime parameter value at the receiving
          Collecting Process.
          Note that this parameter corresponds to
          ipfixTransportSessionOptionsTemplateRefreshTimeout in the
          IPFIX MIB module.";
        reference "RFC 5101, Section 10.3.6; RFC 6615, Section 8
          (ipfixTransportSessionOptionsTemplateRefreshTimeout).";
      }
      leaf templateRefreshPacket {
        type uint32;
        units "IPFIX Messages";
        description "Sets number of IPFIX Messages after which
          Templates are resent in the UDP Transport Session.
          Note that this parameter corresponds to
          ipfixTransportSessionTemplateRefreshPacket in the IPFIX
          MIB module.
          If omitted, Templates are only resent after timeout.";
        reference "RFC 5101, Section 10.3.6; RFC 6615, Section 8
          (ipfixTransportSessionTemplateRefreshPacket).";
      }
      leaf optionsTemplateRefreshPacket {
        type uint32;
        units "IPFIX Messages";
        description "Sets number of IPFIX Messages after which
          Options Templates are resent in the UDP Transport Session
          protocol.
          Note that this parameter corresponds to
          ipfixTransportSessionOptionsTemplateRefreshPacket in the
          IPFIX MIB module.
          If omitted, Templates are only resent after timeout.";
        reference "RFC 5101, Section 10.3.6; RFC 6615, Section 8
          (ipfixTransportSessionOptionsTemplateRefreshPacket).";
      }
    }
        
    grouping tcpExporterParameters {
      description "Parameters of a TCP export destination.";
      uses commonExporterParameters;
      leaf sourceIPAddress {
        type inet:ip-address;
        description "Source IP address used by the Exporting Process.
          If not configured by the user, this parameter is set by
          the Monitoring Device to an IP address assigned to the
          outgoing interface.";
      }
      leaf destinationIPAddress {
        type inet:ip-address;
        mandatory true;
        description "IP address of the Collection Process to which
          IPFIX Messages are sent.";
      }
    }
        
    grouping fileWriterParameters {
      description "File Writer parameters.";
      leaf ipfixVersion {
        type uint16;
        default 10;
        description "IPFIX version number.";
        reference "RFC 5101.";
      }
      leaf file {
        type inet:uri;
        mandatory true;
        description "URI specifying the location of the file.";
      }
      leaf bytes {
        type yang:counter64;
        units octets;
        config false;
        description "The number of bytes written by the File Writer.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileWriterDiscontinuityTime.";
        
      }
      leaf messages {
        type yang:counter64;
        units "IPFIX Messages";
        config false;
        description "The number of IPFIX Messages written by the File
          Writer.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileWriterDiscontinuityTime.";
      }
      leaf discardedMessages {
        type yang:counter64;
        units "IPFIX Messages";
        config false;
        description "The number of IPFIX Messages that could not be
          written by the File Writer due to internal buffer
          overflows, limited storage capacity, etc.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileWriterDiscontinuityTime.";
      }
      leaf records {
        type yang:counter64;
        units "Data Records";
        config false;
        description "The number of Data Records written by the File
          Writer.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileWriterDiscontinuityTime.";
      }
      leaf templates {
        type yang:counter32;
        units "Templates";
        config false;
        description "The number of Template Records (excluding
          Options Template Records) written by the File Writer.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileWriterDiscontinuityTime.";
      }
      leaf optionsTemplates {
        type yang:counter32;
        
        units "Options Templates";
        config false;
        description "The number of Options Template Records written
          by the File Writer.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileWriterDiscontinuityTime.";
      }
      leaf fileWriterDiscontinuityTime {
        type yang:date-and-time;
        config false;
        description "Timestamp of the most recent occasion at which
          one or more File Writer counters suffered a discontinuity.
          In contrast to discontinuity times in the IPFIX MIB module,
          the time is absolute and not relative to sysUpTime.";
      }
      list template {
        config false;
        description "This list contains the Templates and Options
          Templates that have been written by the File Reader.
          Withdrawn or invalidated (Options) Templates MUST be removed
          from this list.";
        uses templateParameters;
      }
    }
        
    grouping optionsParameters {
      description "Parameters specifying the data export using an
        Options Template.";
      leaf optionsType {
        type identityref {
          base "optionsType";
        }
        mandatory true;
        description "Type of the exported options data.";
      }
      leaf optionsTimeout {
        type uint32;
        units milliseconds;
        description "Time interval for periodic export of the options
          data.  If set to zero, the export is triggered when the
          options data has changed.
          If not configured by the user, this parameter is set by the
          Monitoring Device.";
      }
    }
    grouping collectingProcessParameters {
      description "Parameters of a Collecting Process.";
      list sctpCollector {
        key name;
        description "List of SCTP receivers (sockets) on which the
          Collecting Process receives IPFIX Messages.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        uses sctpCollectorParameters;
      }
      list udpCollector {
        if-feature udpTransport;
        key name;
        description "List of UDP receivers (sockets) on which the
          Collecting Process receives IPFIX Messages.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        uses udpCollectorParameters;
      }
      list tcpCollector {
        if-feature tcpTransport;
        key name;
        description "List of TCP receivers (sockets) on which the
          Collecting Process receives IPFIX Messages.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        uses tcpCollectorParameters;
      }
      list fileReader {
        if-feature fileReader;
        key name;
        description "List of File Readers from which the Collecting
          Process reads IPFIX Messages.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        uses fileReaderParameters;
      }
    }
        

grouping commonCollectorParameters {

commonCollectorParametersのグループ化{

      description "Parameters of a Collecting Process that are
        common to all transport protocols.";
      leaf localPort {
        type inet:port-number;
        description "If not configured, the Monitoring Device uses the
          default port number for IPFIX, which is 4739 without
          TLS or DTLS and 4740 if TLS or DTLS is activated.";
      }
      container transportLayerSecurity {
        presence "If transportLayerSecurity is present, DTLS is enabled
          if the transport protocol is SCTP or UDP, and TLS is enabled
          if the transport protocol is TCP.";
        description "TLS or DTLS configuration.";
        uses transportLayerSecurityParameters;
      }
      list transportSession {
        config false;
        description "This list contains the currently established
          Transport Sessions terminating at the given socket.";
        uses transportSessionParameters;
      }
    }
        
    grouping sctpCollectorParameters {
      description "Parameters of a listening SCTP socket at a
        Collecting Process.";
      uses commonCollectorParameters;
      leaf-list localIPAddress {
        type inet:ip-address;
        description "List of local IP addresses on which the
          Collecting Process listens for IPFIX Messages.  The IP
          addresses are used as eligible local IP addresses of the
          multihomed SCTP endpoint.";
        reference "RFC 4960, Section 6.4.";
      }
    }
        
    grouping udpCollectorParameters {
      description "Parameters of a listening UDP socket at a
        Collecting Process.";
      uses commonCollectorParameters;
      leaf-list localIPAddress {
        type inet:ip-address;
        description "List of local IP addresses on which the Collecting
          Process listens for IPFIX Messages.";
      }
      leaf templateLifeTime {
        type uint32;
        
        units seconds;
        default 1800;
        description "Sets the lifetime of Templates for all UDP
          Transport Sessions terminating at this UDP socket.
          Templates that are not received again within the configured
          lifetime become invalid at the Collecting Process.
          As specified in RFC 5101, the Template lifetime MUST be at
          least three times higher than the templateRefreshTimeout
          parameter value configured on the corresponding Exporting
          Processes.
          Note that this parameter corresponds to
          ipfixTransportSessionTemplateRefreshTimeout in the IPFIX
          MIB module.";
        reference "RFC 5101, Section 10.3.7; RFC 6615, Section 8
          (ipfixTransportSessionTemplateRefreshTimeout).";
      }
      leaf optionsTemplateLifeTime {
        type uint32;
        units seconds;
        default 1800;
        description "Sets the lifetime of Options Templates for all
          UDP Transport Sessions terminating at this UDP socket.
          Options Templates that are not received again within the
          configured lifetime become invalid at the Collecting
          Process.
          As specified in RFC 5101, the Options Template lifetime MUST
          be at least three times higher than the
          optionsTemplateRefreshTimeout parameter value configured on
          the corresponding Exporting Processes.
          Note that this parameter corresponds to
          ipfixTransportSessionOptionsTemplateRefreshTimeout in the
          IPFIX MIB module.";
        reference "RFC 5101, Section 10.3.7; RFC 6615, Section 8
          (ipfixTransportSessionOptionsTemplateRefreshTimeout).";
      }
      leaf templateLifePacket {
        type uint32;
        units "IPFIX Messages";
        description "If this parameter is configured, Templates
          defined in a UDP Transport Session become invalid if they
          are neither included in a sequence of more than this number
          of IPFIX Messages nor received again within the period of
          time specified by templateLifeTime.
          Note that this parameter corresponds to
          ipfixTransportSessionTemplateRefreshPacket in the IPFIX
          MIB module.";
        reference "RFC 5101, Section 10.3.7; RFC 6615, Section 8
          (ipfixTransportSessionTemplateRefreshPacket).";
        
      }
      leaf optionsTemplateLifePacket {
        type uint32;
        units "IPFIX Messages";
        description "If this parameter is configured, Options
          Templates defined in a UDP Transport Session become
          invalid if they are neither included in a sequence of more
          than this number of IPFIX Messages nor received again
          within the period of time specified by
          optionsTemplateLifeTime.
          Note that this parameter corresponds to
          ipfixTransportSessionOptionsTemplateRefreshPacket in the
          IPFIX MIB module.";
        reference "RFC 5101, Section 10.3.7; RFC 6615, Section 8
          (ipfixTransportSessionOptionsTemplateRefreshPacket).";
      }
    }
        
    grouping tcpCollectorParameters {
      description "Parameters of a listening TCP socket at a
        Collecting Process.";
      uses commonCollectorParameters;
      leaf-list localIPAddress {
        type inet:ip-address;
        description "List of local IP addresses on which the Collecting
          Process listens for IPFIX Messages.";
      }
    }
        
    grouping fileReaderParameters {
      description "File Reader parameters.";
      leaf file {
        type inet:uri;
        mandatory true;
        description "URI specifying the location of the file.";
      }
      leaf bytes {
        type yang:counter64;
        units octets;
        config false;
        description "The number of bytes read by the File Reader.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileReaderDiscontinuityTime.";
      }
      leaf messages {
        type yang:counter64;
        
        units "IPFIX Messages";
        config false;
        description "The number of IPFIX Messages read by the File
          Reader.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileReaderDiscontinuityTime.";
      }
      leaf records {
        type yang:counter64;
        units "Data Records";
        config false;
        description "The number of Data Records read by the File
          Reader.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileReaderDiscontinuityTime.";
      }
      leaf templates {
        type yang:counter32;
        units "Templates";
        config false;
        description "The number of Template Records (excluding
          Options Template Records) read by the File Reader.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileReaderDiscontinuityTime.";
      }
      leaf optionsTemplates {
        type yang:counter32;
        units "Options Templates";
        config false;
        description "The number of Options Template Records read by
          the File Reader.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          fileReaderDiscontinuityTime.";
      }
      leaf fileReaderDiscontinuityTime {
        type yang:date-and-time;
        config false;
        description "Timestamp of the most recent occasion at which
          one or more File Reader counters suffered a discontinuity.
          In contrast to discontinuity times in the IPFIX MIB module,
          the time is absolute and not relative to sysUpTime.";
      }
      list template {
        config false;
        description "This list contains the Templates and Options
          Templates that have been read by the File Reader.
          Withdrawn or invalidated (Options) Template MUST be removed
          from this list.";
        uses templateParameters;
      }
    }
        
    grouping transportLayerSecurityParameters {
      description "TLS or DTLS parameters.";
      leaf-list localCertificationAuthorityDN {
        type string;
        description "Distinguished names of certification authorities
          whose certificates may be used to identify the local
          endpoint.";
        reference "RFC 5280.";
      }
      leaf-list localSubjectDN {
        type string;
        description "Distinguished names that may be used in the
          certificates to identify the local endpoint.";
        reference "RFC 5280.";
      }
      leaf-list localSubjectFQDN {
        type inet:domain-name;
        description "Fully qualified domain names that may be used to
          in the certificates to identify the local endpoint.";
        reference "RFC 5280.";
      }
      leaf-list remoteCertificationAuthorityDN {
        type string;
        description "Distinguished names of certification authorities
          whose certificates are accepted to authorize remote
          endpoints.";
        reference "RFC 5280.";
      }
      leaf-list remoteSubjectDN {
        type string;
        description "Distinguished names which are accepted in
          certificates to authorize remote endpoints.";
        reference "RFC 5280.";
      }
      leaf-list remoteSubjectFQDN {
        type inet:domain-name;
        
        description "Fully qualified domain names that are accepted in
          certificates to authorize remote endpoints.";
        reference "RFC 5280.";
      }
    }
        
    grouping templateParameters {
      description "State parameters of a Template used by an Exporting
        Process or received by a Collecting Process in a specific
        Transport Session.  Parameter names and semantics correspond to
        the managed objects in IPFIX-MIB";
      reference "RFC 5101; RFC 6615, Section 8 (ipfixTemplateEntry,
        ipfixTemplateDefinitionEntry, ipfixTemplateStatsEntry)";
      leaf observationDomainId {
        type uint32;
        description "The ID of the Observation Domain for which this
          Template is defined.
          Note that this parameter corresponds to
          ipfixTemplateObservationDomainId in the IPFIX MIB module.";
        reference "RFC 6615, Section 8
          (ipfixTemplateObservationDomainId).";
      }
      leaf templateId {
        type uint16 {
          range "256..65535" {
            description "Valid range of Template IDs.";
            reference "RFC 5101";
          }
        }
        description "This number indicates the Template ID in the IPFIX
          message.
          Note that this parameter corresponds to ipfixTemplateId in
          the IPFIX MIB module.";
        reference "RFC 6615, Section 8 (ipfixTemplateId).";
      }
      leaf setId {
        type uint16;
        description "This number indicates the Set ID of the Template.
          Currently, there are two values defined.  The value 2 is used
          for Sets containing Template definitions.  The value 3 is
          used for Sets containing Options Template definitions.
          Note that this parameter corresponds to ipfixTemplateSetId
          in the IPFIX MIB module.";
        reference "RFC 6615, Section 8 (ipfixTemplateSetId).";
      }
      leaf accessTime {
        type yang:date-and-time;
        description "Used for Exporting Processes, this parameter
        
          contains the time when this (Options) Template was last
          sent to the Collector(s) or written to the file.
          Used for Collecting Processes, this parameter contains the
          time when this (Options) Template was last received from the
          Exporter or read from the file.
          Note that this parameter corresponds to
          ipfixTemplateAccessTime in the IPFIX MIB module.";
        reference "RFC 6615, Section 8 (ipfixTemplateAccessTime).";
      }
      leaf templateDataRecords {
        type yang:counter64;
        description "The number of transmitted or received Data
          Records defined by this (Options) Template.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          templateDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixTemplateDataRecords in the IPFIX MIB module.";
        reference "RFC 6615, Section 8 (ipfixTemplateDataRecords).";
      }
      leaf templateDiscontinuityTime {
        type yang:date-and-time;
        description "Timestamp of the most recent occasion at which
          the counter templateDataRecords suffered a discontinuity.
          Note that this parameter functionally corresponds to
          ipfixTemplateDiscontinuityTime in the IPFIX MIB module.
          In contrast to ipfixTemplateDiscontinuityTime, the time
          is absolute and not relative to sysUpTime.";
        reference "RFC 6615, Section 8
          (ipfixTemplateDiscontinuityTime).";
      }
      list field {
        description "This list contains the (Options) Template
          fields of which the (Options) Template is defined.
          The order of the list corresponds to the order of the fields
          in the (Option) Template Record.";
        leaf ieId {
          type ieIdType;
          description "This parameter indicates the Information
            Element identifier of the field.
            Note that this parameter corresponds to
            ipfixTemplateDefinitionIeId in the IPFIX MIB module.";
          reference "RFC 5101; RFC 6615, Section 8
            (ipfixTemplateDefinitionIeId).";
        }
        leaf ieLength {
          type uint16;
        
          units octets;
          description "This parameter indicates the length of the
            Information Element of the field.
            Note that this parameter corresponds to
            ipfixTemplateDefinitionIeLength in the IPFIX MIB
            module.";
          reference "RFC 5101; RFC 6615, Section 8
            (ipfixTemplateDefinitionIeLength).";
        }
        leaf ieEnterpriseNumber {
          type uint32;
          description "This parameter indicates the IANA enterprise
            number of the authority defining the Information Element
            identifier.
            If the Information Element is not enterprise-specific,
            this state parameter is zero.
            Note that this parameter corresponds to
            ipfixTemplateDefinitionIeEnterpriseNumber in the IPFIX
            MIB module.";
          reference "RFC 6615, Section 8
            (ipfixTemplateDefinitionIeEnterpriseNumber);
            IANA registry for Private Enterprise Numbers,
            http://www.iana.org/assignments/enterprise-numbers.";
        }
        leaf isFlowKey {
          when "../../setId = 2" {
            description "This parameter is available for non-Options
              Templates (Set ID is 2).";
          }
          type empty;
          description "If present, this is a Flow Key field.
            Note that this corresponds to flowKey(1) being set in
            ipfixTemplateDefinitionFlags.";
          reference "RFC 6615, Section 8
            (ipfixTemplateDefinitionFlags).";
        }
        leaf isScope {
          when "../../setId = 3" {
            description "This parameter is available for Options
              Templates (Set ID is 3).";
          }
          type empty;
          description "If present, this is a scope field.
            Note that this corresponds to scope(0) being set in
            ipfixTemplateDefinitionFlags.";
          reference "RFC 6615, Section 8
            (ipfixTemplateDefinitionFlags).";
        }
        
      }
    }
        
    grouping transportSessionParameters {
      description "State parameters of a Transport Session originating
        from an Exporting Process or terminating at a Collecting
        Process.  Parameter names and semantics correspond to the
        managed objects in IPFIX-MIB.";
      reference "RFC 5101; RFC 6615, Section 8
        (ipfixTransportSessionEntry,
         ipfixTransportSessionStatsEntry).";
      leaf ipfixVersion {
        type uint16;
        description "Used for Exporting Processes, this parameter
          contains the version number of the IPFIX protocol that the
          Exporter uses to export its data in this Transport Session.
          Hence, it is identical to the value of the configuration
          parameter ipfixVersion of the outer SctpExporter,
          UdpExporter, or TcpExporter node.
          Used for Collecting Processes, this parameter contains the
          version number of the IPFIX protocol it receives for
          this Transport Session.  If IPFIX Messages of different
          IPFIX protocol versions are received, this parameter
          contains the maximum version number.
          Note that this parameter corresponds to
          ipfixTransportSessionIpfixVersion in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionIpfixVersion).";
      }
      leaf sourceAddress {
        type inet:ip-address;
        description "The source address of the Exporter of the
          IPFIX Transport Session.
          If the transport protocol is SCTP, this is one of the
          potentially many IP addresses of the Exporter.
          Preferably, the source IP address of the path that is
          usually selected by the Exporter to send IPFIX Messages to
          the Collector SHOULD be used.
          Note that this parameter functionally corresponds to
          ipfixTransportSessionSourceAddressType and
          ipfixTransportSessionSourceAddress in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionSourceAddressType,
          ipfixTransportSessionSourceAddress);
          RFC 4960, Section 6.4.";
      }
      leaf destinationAddress {
        type inet:ip-address;
        description "The destination address of the Collector of
          the IPFIX Transport Session.
          If the transport protocol is SCTP, this is one of the
          potentially many IP addresses of the Collector.
          Preferably, the destination IP address of the path that is
          usually selected by the Exporter to send IPFIX Messages to
          the Collector SHOULD be used.
          Note that this parameter functionally corresponds to
          ipfixTransportSessionDestinationAddressType and
          ipfixTransportSessionDestinationAddress in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionDestinationAddressType,
          ipfixTransportSessionDestinationAddress);
          RFC 4960, Section 6.4.";
      }
      leaf sourcePort {
        type inet:port-number;
        description "The transport-protocol port number of the
          Exporter of the IPFIX Transport Session.
          Note that this parameter corresponds to
          ipfixTransportSessionSourcePort in the IPFIX MIB module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionSourcePort).";
      }
      leaf destinationPort {
        type inet:port-number;
        description "The transport-protocol port number of the
          Collector of the IPFIX Transport Session.
          Note that this parameter corresponds to
          ipfixTransportSessionDestinationPort in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionDestinationPort).";
      }
      leaf sctpAssocId {
        type uint32;
        description "The association ID used for the SCTP session
          between the Exporter and the Collector of the IPFIX
          Transport Session.  It is equal to the sctpAssocId entry
          in the sctpAssocTable defined in the SCTP-MIB.
          This parameter is only available if the transport protocol
          is SCTP and if an SNMP agent on the same Monitoring Device
          enables access to the corresponding MIB objects in the
          sctpAssocTable.
          Note that this parameter corresponds to
          ipfixTransportSessionSctpAssocId in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionSctpAssocId);
          RFC 3871";
      }
      leaf status {
        type transportSessionStatus;
        description "Status of the Transport Session.
          Note that this parameter corresponds to
          ipfixTransportSessionStatus in the IPFIX MIB module.";
        reference "RFC 6615, Section 8 (ipfixTransportSessionStatus).";
      }
      leaf rate {
        type yang:gauge32;
        units "bytes per second";
        description "The number of bytes per second transmitted by the
          Exporting Process or received by the Collecting Process.
          This parameter is updated every second.
          Note that this parameter corresponds to
          ipfixTransportSessionRate in the IPFIX MIB module.";
        reference "RFC 6615, Section 8 (ipfixTransportSessionRate).";
      }
      leaf bytes {
        type yang:counter64;
        units bytes;
        description "The number of bytes transmitted by the
          Exporting Process or received by the Collecting Process.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          transportSessionDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixTransportSessionBytes in the IPFIX MIB module.";
        reference "RFC 6615, Section 8 (ipfixTransportSessionBytes).";
      }
      leaf messages {
        type yang:counter64;
        units "IPFIX Messages";
        description "The number of messages transmitted by the
          Exporting Process or received by the Collecting Process.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          transportSessionDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixTransportSessionMessages in the IPFIX MIB module.";
        reference "RFC 6615, Section 8
        
          (ipfixTransportSessionMessages).";
      }
      leaf discardedMessages {
        type yang:counter64;
        units "IPFIX Messages";
        description "Used for Exporting Processes, this parameter
          indicates the number of messages that could not be sent due
          to internal buffer overflows, network congestion, routing
          issues, etc.  Used for Collecting Process, this parameter
          indicates the number of received IPFIX Message that are
          malformed, cannot be decoded, are received in the wrong
          order or are missing according to the sequence number.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          transportSessionDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixTransportSessionDiscardedMessages in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionDiscardedMessages).";
      }
      leaf records {
        type yang:counter64;
        units "Data Records";
        description "The number of Data Records transmitted by the
          Exporting Process or received by the Collecting Process.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          transportSessionDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixTransportSessionRecords in the IPFIX MIB module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionRecords).";
      }
      leaf templates {
        type yang:counter32;
        units "Templates";
        description "The number of Templates transmitted by the
          Exporting Process or received by the Collecting Process.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          transportSessionDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixTransportSessionTemplates in the IPFIX MIB module.";
        reference "RFC 6615, Section 8
        
          (ipfixTransportSessionTemplates).";
      }
      leaf optionsTemplates {
        type yang:counter32;
        units "Options Templates";
        description "The number of Option Templates transmitted by the
          Exporting Process or received by the Collecting Process.
          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other
          times as indicated by the value of
          transportSessionDiscontinuityTime.
          Note that this parameter corresponds to
          ipfixTransportSessionOptionsTemplates in the IPFIX MIB
          module.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionOptionsTemplates).";
      }
      leaf transportSessionStartTime {
        type yang:date-and-time;
        description "Timestamp of the start of the given Transport
          Session.
          This state parameter does not correspond to any object in
          the IPFIX MIB module.";
      }
      leaf transportSessionDiscontinuityTime {
        type yang:date-and-time;
        description "Timestamp of the most recent occasion at which
          one or more of the Transport Session counters suffered a
          discontinuity.
          Note that this parameter functionally corresponds to
          ipfixTransportSessionDiscontinuityTime in the IPFIX MIB
          module.  In contrast to
          ipfixTransportSessionDiscontinuityTime, the time is
          absolute and not relative to sysUpTime.";
        reference "RFC 6615, Section 8
          (ipfixTransportSessionDiscontinuityTime).";
      }
      list template {
        description "This list contains the Templates and Options
          Templates that are transmitted by the Exporting Process
          or received by the Collecting Process.
          Withdrawn or invalidated (Options) Templates MUST be removed
          from this list.";
        uses templateParameters;
      }
    }
        
    /*****************************************************************
    * Main container
    *****************************************************************/
        
    container ipfix {
      description "Top-level node of the IPFIX/PSAMP configuration
        data model.";
      list collectingProcess {
        if-feature collector;
        key name;
        description "Collecting Process of the Monitoring Device.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        uses collectingProcessParameters;
        leaf-list exportingProcess {
          if-feature exporter;
          type leafref { path "/ipfix/exportingProcess/name"; }
          description "Export of received records without any
            modifications.  Records are processed by all Exporting
            Processes in the list.";
        }
      }
        
      list observationPoint {
        if-feature meter;
        key name;
        description "Observation Point of the Monitoring Device.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        uses observationPointParameters;
        leaf-list selectionProcess {
          type leafref { path "/ipfix/selectionProcess/name"; }
          description "Selection Processes in this list process
            packets in parallel.";
        }
      }
        
      list selectionProcess {
        if-feature meter;
        key name;
        description "Selection Process of the Monitoring Device.";
        leaf name {
          type nameType;
          description "Key of this list.";
        
        }
        list selector {
          key name;
          min-elements 1;
          ordered-by user;
          description "List of Selectors that define the action of the
            Selection Process on a single packet.  The Selectors are
            serially invoked in the same order as they appear in this
            list.";
          leaf name {
            type nameType;
            description "Key of this list.";
          }
          uses selectorParameters;
        }
        list selectionSequence {
          config false;
          description "This list contains the Selection Sequence IDs
            that are assigned by the Monitoring Device to distinguish
            different Selection Sequences passing through the
            Selection Process.
            As Selection Sequence IDs are unique per Observation
            Domain, the corresponding Observation Domain IDs are
            included as well.
            With this information, it is possible to associate
            Selection Sequence (Statistics) Report Interpretations
            exported according to the PSAMP protocol with a Selection
            Process in the configuration data.";
          reference "RFC 5476.";
          leaf observationDomainId {
            type uint32;
            description "Observation Domain ID for which the
              Selection Sequence ID is assigned.";
          }
          leaf selectionSequenceId {
            type uint64;
            description "Selection Sequence ID used in the Selection
              Sequence (Statistics) Report Interpretation.";
          }
        }
        leaf cache {
          type leafref { path "/ipfix/cache/name"; }
          description "Cache that receives the output of the
            Selection Process.";
        }
      }
        

list cache {

リストキャッシュ{

        if-feature meter;
        key name;
        description "Cache of the Monitoring Device.";
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        leaf meteringProcessId {
          type uint32;
          config false;
          description "The identifier of the Metering Process this
            Cache belongs to.
            This parameter corresponds to the Information Element
            meteringProcessId.  Its occurrence helps to associate
            Cache parameters with Metering Process statistics
            exported by the Monitoring Device using the Metering
            Process (Reliability) Statistics Template as
            defined by the IPFIX protocol specification.";
          reference "RFC 5101, Sections 4.1 and 4.2;
            IANA registry for IPFIX Entities,
            http://www.iana.org/assignments/ipfix.";
        }
        leaf dataRecords {
          type yang:counter64;
          units "Data Records";
          config false;
          description "The number of Data Records generated by this
            Cache.
            Discontinuities in the value of this counter can occur at
            re-initialization of the management system, and at other
            times as indicated by the value of
            cacheDiscontinuityTime.
            Note that this parameter corresponds to
            ipfixMeteringProcessDataRecords in the IPFIX MIB
            module.";
          reference "RFC 6615, Section 8
            (ipfixMeteringProcessDataRecords).";
        }
        leaf cacheDiscontinuityTime {
          type yang:date-and-time;
          config false;
          description "Timestamp of the most recent occasion at which
            the counter dataRecords suffered a discontinuity.
            Note that this parameter functionally corresponds to
            ipfixMeteringProcessDiscontinuityTime in the IPFIX MIB
            module.  In contrast to
            ipfixMeteringProcessDiscontinuityTime, the time is
            absolute and not relative to sysUpTime.";
        
          reference "RFC 6615, Section 8
            (ipfixMeteringProcessDiscontinuityTime).";
        }
        choice CacheType {
          mandatory true;
          description "Type of Cache and specific parameters.";
          container immediateCache {
            if-feature immediateCache;
            description "Flow expiration after the first packet;
              generation of Packet Records.";
            uses cacheLayoutParameters;
          }
          container timeoutCache {
            if-feature timeoutCache;
            description "Flow expiration after active and idle
              timeout; generation of Flow Records.";
            uses flowCacheParameters;
            uses cacheLayoutParameters;
          }
          container naturalCache {
            if-feature naturalCache;
            description "Flow expiration after active and idle
              timeout, or on natural termination (e.g., TCP FIN or
              TCP RST) of the Flow; generation of Flow Records.";
            uses flowCacheParameters;
            uses cacheLayoutParameters;
          }
          container permanentCache {
            if-feature permanentCache;
            description "No flow expiration, periodical export with
              time interval exportInterval; generation of Flow
              Records.";
            uses flowCacheParameters;
            uses cacheLayoutParameters;
          }
        }
        leaf-list exportingProcess {
          if-feature exporter;
          type leafref { path "/ipfix/exportingProcess/name"; }
          description "Records are exported by all Exporting Processes
            in the list.";
        }
      }
        
      list exportingProcess {
        if-feature exporter;
        key name;
        description "Exporting Process of the Monitoring Device.";
        
        leaf name {
          type nameType;
          description "Key of this list.";
        }
        uses exportingProcessParameters;
      }
    }
  }
  <CODE ENDS>
        
7. Examples
7. 例

This section shows example configurations conforming to the YANG module specified in Section 6.

このセクションでは、セクション6で指定したYANGモジュールに準拠した構成例を示します。

7.1. PSAMP Device
7.1. PSAMPデバイス

This configuration example configures two Observation Points capturing ingress traffic at eth0 and all traffic at eth1. Both Observed Packet Streams enter two different Selection Processes. The first Selection Process implements a Composite Selector of a filter for UDP packets and a random sampler. The second Selection Process implements a Primitive Selector of an ICMP filter. The Selected Packet Streams of both Selection Processes enter the same Cache. The Cache generates a PSAMP Packet Report for every selected packet.

この構成例では、eth0での入力トラフィックとeth1でのすべてのトラフィックをキャプチャする2つの監視ポイントを構成します。両方の観測されたパケットストリームは、2つの異なる選択プロセスに入ります。最初の選択プロセスは、UDPパケット用のフィルターの複合セレクターとランダムサンプラーを実装します。 2番目の選択プロセスは、ICMPフィルターのプリミティブセレクターを実装します。両方の選択プロセスの選択されたパケットストリームは、同じキャッシュに入ります。キャッシュは、選択されたパケットごとにPSAMPパケットレポートを生成します。

The associated Exporting Process exports to a Collector using PR-SCTP and DTLS. The TLS/DTLS parameters specify that the collector must supply a certificate for the FQDN collector.example.net. Valid certificates from any certification authority will be accepted. As the destination transport port is omitted, the standard IPFIX-over-DTLS port 4740 is used.

関連するエクスポートプロセスは、PR-SCTPおよびDTLSを使用してコレクタにエクスポートします。 TLS / DTLSパラメーターは、コレクターがFQDN collector.example.netの証明書を提供する必要があることを指定します。任意の証明機関からの有効な証明書が受け入れられます。宛先トランスポートポートが省略されているため、標準のIPFIX-over-DTLSポート4740が使用されます。

The parameters of the Selection Processes are reported as Selection Sequence Report Interpretations and Selector Report Interpretations [RFC5476]. There will be two Selection Sequence Report Interpretations per Selection Process, one for each Observation Point. Selection Sequence Statistics Report Interpretations are exported every 30 seconds (30000 milliseconds).

選択プロセスのパラメーターは、選択シーケンスレポートの解釈とセレクターレポートの解釈[RFC5476]として報告されます。選択プロセスごとに、観測ポイントごとに1つずつ、2つの選択シーケンスレポートの解釈があります。選択シーケンス統計レポートの解釈は30秒(30000ミリ秒)ごとにエクスポートされます。

   <ipfix xmlns="urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp">
        
     <observationPoint>
       <name>OP at eth0 (ingress)</name>
       <observationDomainId>123</observationDomainId>
       <ifName>eth0</ifName>
       <direction>ingress</direction>
       <selectionProcess>Sampled UDP packets</selectionProcess>
        
       <selectionProcess>ICMP packets</selectionProcess>
     </observationPoint>
        
     <observationPoint>
       <name>OP at eth1</name>
       <observationDomainId>123</observationDomainId>
       <ifName>eth1</ifName>
       <selectionProcess>Sampled UDP packets</selectionProcess>
       <selectionProcess>ICMP packets</selectionProcess>
     </observationPoint>
        
     <selectionProcess>
       <name>Sampled UDP packets</name>
       <selector>
         <name>UDP filter</name>
         <filterMatch>
           <ieId>4</ieId>
           <value>17</value>
         </filterMatch>
       </selector>
       <selector>
         <name>10-out-of-100 sampler</name>
         <sampRandOutOfN>
           <size>10</size>
           <population>100</population>
         </sampRandOutOfN>
       </selector>
       <cache>PSAMP cache</cache>
     </selectionProcess>
        
     <selectionProcess>
       <name>ICMP packets</name>
       <selector>
         <name>ICMP filter</name>
         <filterMatch>
           <ieId>4</ieId>
           <value>1</value>
         </filterMatch>
       </selector>
       <cache>PSAMP cache</cache>
     </selectionProcess>
        
     <cache>
       <name>PSAMP cache</name>
       <immediateCache>
         <cacheLayout>
           <cacheField>
             <name>Field 1: ipHeaderPacketSection</name>
        
             <ieId>313</ieId>
             <ieLength>64</ieLength>
           </cacheField>
           <cacheField>
             <name>Field 2: observationTimeMilliseconds</name>
             <ieId>322</ieId>
           </cacheField>
         </cacheLayout>
       </immediateCache>
       <exportingProcess>The only exporter</exportingProcess>
     </cache>
        
     <exportingProcess>
       <name>The only exporter</name>
       <destination>
         <name>PR-SCTP collector</name>
         <sctpExporter>
           <destinationIPAddress>192.0.2.1</destinationIPAddress>
           <rateLimit>1000000</rateLimit>
           <timedReliability>500</timedReliability>
           <transportLayerSecurity>
             <remoteSubjectFQDN>coll-1.example.net</remoteSubjectFQDN>
           </transportLayerSecurity>
         </sctpExporter>
       </destination>
       <options>
         <name>Options 1</name>
         <optionsType>selectionSequence</optionsType>
         <optionsTimeout>0</optionsTimeout>
       </options>
       <options>
         <name>Options 2</name>
         <optionsType>selectionStatistics</optionsType>
         <optionsTimeout>30000</optionsTimeout>
       </options>
     </exportingProcess>
        
   </ipfix>
        

The above configuration results in one Template and six Options Templates. For the remainder of the example, we assume Template ID 256 for the Template and Template IDs 257 to 262 for the Options Templates. The Template is used to export the Packet Reports and has the following fields:

上記の設定により、1つのテンプレートと6つのオプションテンプレートが作成されます。残りの例では、テンプレートにはテンプレートID 256を、オプションテンプレートにはテンプレートID 257〜262を想定しています。テンプレートはパケットレポートのエクスポートに使用され、次のフィールドがあります。

      Template ID: 256
      ipHeaderPacketSection (elementId = 313, length = 64)
      observationTimeMilliseconds (elementId = 322, length = 8)
        

Two Options Templates are used for the Selection Sequence Report Interpretations. The first one has one selectorId field and is used for the Selection Process "ICMP packets". The second one has two selectorId fields to describe the two selectors of the Selection Process "Sampled UDP packets".

選択シーケンスレポートの解釈には、2つのオプションテンプレートが使用されます。最初のものは1つのselectorIdフィールドを持ち、選択プロセス「ICMPパケット」に使用されます。 2番目のセレクターには、選択プロセス「サンプルUDPパケット」の2つのセレクターを説明する2つのselectorIdフィールドがあります。

      Template ID: 257
      Scope: selectionSequenceId (elementId = 301, length = 8)
      observationPointId (elementId = 138, length = 4)
      selectorId (elementId = 302, length = 4)
        
      Template ID: 258
      Scope: selectionSequenceId (elementId = 301, length = 8)
      observationPointId (elementId = 138, length = 4)
      selectorId (elementId = 302, length = 4)
      selectorId (elementId = 302, length = 4)
        

Another Options Template is used to carry the Property Match Filtering Selector Report Interpretation for the Selectors "UDP filter" and "ICMP filter":

別のオプションテンプレートを使用して、セレクター「UDPフィルター」および「ICMPフィルター」のプロパティマッチフィルタリングセレクターレポートの解釈を実行します。

      Template ID: 259
      Scope: selectorId (elementId = 302, length = 4)
      selectorAlgorithm (elementId = 304, length = 2)
      protocolIdentifier (elementId = 4, length = 1)
        

Yet another Options Template is used to carry the Random n-out-of-N Sampling Selector Report Interpretation for the Selector "10-out-of-100 sampler":

さらに別のオプションテンプレートを使用して、セレクター「10-out-of-100サンプラー」のランダムn-out-of-Nサンプリングセレクターレポート解釈を実行します。

      Template ID: 260
      Scope: selectorId (elementId = 302, length = 4)
      selectorAlgorithm (elementId = 304, length = 2)
      samplingSize (elementId = 319, length = 4)
      samplingPopulation (elementId = 310, length = 4)
        

The last two Options Template are used to carry the Selection Sequence Statistics Report Interpretation for the Selection Processes, containing the statistics for one and two Selectors, respectively:

最後の2つのオプションテンプレートは、それぞれ1つと2つのセレクターの統計を含む、選択プロセスの選択シーケンス統計レポート解釈を実行するために使用されます。

      Template ID: 261
      Scope: selectionSequenceId (elementId = 301, length = 8)
      selectorIdTotalPktsObserved (elementId = 318, length = 8)
      selectorIdTotalPktsSelected (elementId = 319, length = 8)
      Template ID: 262
      Scope: selectionSequenceId (elementId = 301, length = 8)
      selectorIdTotalPktsObserved (elementId = 318, length = 8)
      selectorIdTotalPktsSelected (elementId = 319, length = 8)
      selectorIdTotalPktsObserved (elementId = 318, length = 8)
      selectorIdTotalPktsSelected (elementId = 319, length = 8)
        

After a short runtime, 100 packets have been observed at the two Observation Points, including 20 UDP and 5 ICMP packets. 3 of the UDP packets are selected by the random sampler, which results in a total of 8 Packet Reports generated by the Cache. Under these circumstances, the complete configuration and state data of the PSAMP Device may look as follows:

短時間の実行後、2つの観測ポイントで100個のパケットが観測されました。これには、20個のUDPパケットと5個のICMPパケットが含まれます。 UDPパケットのうち3つがランダムサンプラーによって選択され、キャッシュによって合計8つのパケットレポートが生成されます。これらの状況では、PSAMPデバイスの完全な構成および状態データは次のようになります。

   <ipfix xmlns="urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp">
        
     <observationPoint>
       <name>OP at eth0 (ingress)</name>
       <observationPointId>1</observationPointId>
       <observationDomainId>123</observationDomainId>
       <ifName>eth0</ifName>
       <direction>ingress</direction>
       <selectionProcess>Sampled UDP packets</selectionProcess>
       <selectionProcess>ICMP packets</selectionProcess>
     </observationPoint>
        
     <observationPoint>
       <name>OP at eth1</name>
       <observationPointId>2</observationPointId>
       <observationDomainId>123</observationDomainId>
       <ifName>eth1</ifName>
       <direction>both</direction>
       <selectionProcess>Sampled UDP packets</selectionProcess>
       <selectionProcess>ICMP packets</selectionProcess>
     </observationPoint>
        
     <selectionProcess>
       <name>Sampled UDP packets</name>
       <selector>
         <name>UDP filter</name>
         <filterMatch>
           <ieId>4</ieId>
           <value>17</value>
         </filterMatch>
         <packetsObserved>100</packetsObserved>
         <packetsDropped>80</packetsDropped>
         <selectorDiscontinuityTime>2010-03-15T00:00:00.00Z
             </selectorDiscontinuityTime>
        
       </selector>
       <selector>
         <name>10-out-of-100 sampler</name>
         <sampRandOutOfN>
           <size>10</size>
           <population>100</population>
         </sampRandOutOfN>
         <packetsObserved>20</packetsObserved>
         <packetsDropped>17</packetsDropped>
         <selectorDiscontinuityTime>2010-03-15T00:00:00.00Z
             </selectorDiscontinuityTime>
       </selector>
       <selectionSequence>
           <observationDomainId>123</observationDomainId>
           <selectionSequenceId>1</selectionSequenceId>
       </selectionSequence>
       <selectionSequence>
           <observationDomainId>123</observationDomainId>
           <selectionSequenceId>2</selectionSequenceId>
       </selectionSequence>
       <cache>PSAMP cache</cache>
     </selectionProcess>
        
     <selectionProcess>
       <name>ICMP packets</name>
       <selector>
         <name>ICMP filter</name>
         <filterMatch>
           <ieId>4</ieId>
           <value>1</value>
         </filterMatch>
         <packetsObserved>100</packetsObserved>
         <packetsDropped>95</packetsDropped>
         <selectorDiscontinuityTime>2010-03-15T00:00:00.00Z
             </selectorDiscontinuityTime>
       </selector>
       <selectionSequence>
           <observationDomainId>123</observationDomainId>
           <selectionSequenceId>3</selectionSequenceId>
       </selectionSequence>
       <selectionSequence>
           <observationDomainId>123</observationDomainId>
           <selectionSequenceId>4</selectionSequenceId>
       </selectionSequence>
       <cache>PSAMP cache</cache>
     </selectionProcess>
        

<cache>

<キャッシュ>

       <name>PSAMP cache</name>
       <meteringProcessId>1</meteringProcessId>
       <immediateCache>
         <cacheLayout>
           <cacheField>
             <name>Field 1: ipHeaderPacketSection</name>
             <ieId>313</ieId>
             <ieLength>64</ieLength>
           </cacheField>
           <cacheField>
             <name>Field 2: observationTimeMilliseconds</name>
             <ieId>322</ieId>
           </cacheField>
         </cacheLayout>
       </immediateCache>
       <dataRecords>8</dataRecords>
       <cacheDiscontinuityTime>2010-03-15T00:00:00.00Z
           </cacheDiscontinuityTime>
       <exportingProcess>The only exporter</exportingProcess>
     </cache>
        
     <exportingProcess>
       <name>The only exporter</name>
       <exportingProcessId>1</exportingProcessId>
       <exportMode>parallel</exportMode>
       <destination>
         <name>PR-SCTP collector</name>
         <sctpExporter>
           <ipfixVersion>10</ipfixVersion>
           <destinationIPAddress>192.0.2.1</destinationIPAddress>
           <destinationPort>4740</destinationPort>
           <sendBufferSize>32768</sendBufferSize>
           <rateLimit>1000000</rateLimit>
           <timedReliability>500</timedReliability>
           <transportLayerSecurity>
             <remoteSubjectFQDN>coll-1.example.net</remoteSubjectFQDN>
           </transportLayerSecurity>
           <transportSession>
             <ipfixVersion>10</ipfixVersion>
             <sourceAddress>192.0.2.100</sourceAddress>
             <destinationAddress>192.0.2.1</destinationAddress>
             <sourcePort>45687</sourcePort>
             <destinationPort>4740</destinationPort>
             <sctpAssocId>1</sctpAssocId>
             <status>active</status>
             <rate>230</rate>
             <bytes>978</bytes>
             <messages>3</messages>
        
             <records>19</records>
             <templates>1</templates>
             <optionsTemplates>6</optionsTemplates>
             <transportSessionStartTime>2010-03-15T00:00:00.50Z
                 </transportSessionStartTime>
             <template>
               <observationDomainId>123</observationDomainId>
               <templateId>256</templateId>
               <setId>2</setId>
               <accessTime>2010-03-15T00:00:02.15Z</accessTime>
               <templateDataRecords>8</templateDataRecords>
               <templateDiscontinuityTime>2010-03-15T00:00:01.10Z
                   </templateDiscontinuityTime>
               <field>
                 <ieId>313</ieId>
                 <ieLength>64</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>154</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
             </template>
             <template>
               <observationDomainId>123</observationDomainId>
               <templateId>257</templateId>
               <setId>3</setId>
               <accessTime>2010-03-15T00:00:02.15Z</accessTime>
               <templateDataRecords>2</templateDataRecords>
               <templateDiscontinuityTime>2010-03-15T00:00:01.10Z
                   </templateDiscontinuityTime>
               <field>
                 <ieId>301</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
                 <isScope/>
               </field>
               <field>
                 <ieId>138</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>302</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
        
             </template>
             <template>
               <observationDomainId>123</observationDomainId>
               <templateId>258</templateId>
               <setId>3</setId>
               <accessTime>2010-03-15T00:00:02.15Z</accessTime>
               <templateDataRecords>2</templateDataRecords>
               <templateDiscontinuityTime>2010-03-15T00:00:01.10Z
                   </templateDiscontinuityTime>
               <field>
                 <ieId>301</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
                 <isScope/>
               </field>
               <field>
                 <ieId>138</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>302</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>302</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
             </template>
             <template>
               <observationDomainId>123</observationDomainId>
               <templateId>259</templateId>
               <setId>3</setId>
               <accessTime>2010-03-15T00:00:02.15Z</accessTime>
               <templateDataRecords>2</templateDataRecords>
               <templateDiscontinuityTime>2010-03-15T00:00:01.10Z
                   </templateDiscontinuityTime>
               <field>
                 <ieId>302</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
                 <isScope/>
               </field>
               <field>
                 <ieId>304</ieId>
                 <ieLength>2</ieLength>
        
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>4</ieId>
                 <ieLength>1</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
             </template>
             <template>
               <observationDomainId>123</observationDomainId>
               <templateId>260</templateId>
               <setId>3</setId>
               <accessTime>2010-03-15T00:00:02.15Z</accessTime>
               <templateDataRecords>1</templateDataRecords>
               <templateDiscontinuityTime>2010-03-15T00:00:01.10Z
                   </templateDiscontinuityTime>
               <field>
                 <ieId>302</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
                 <isScope/>
               </field>
               <field>
                 <ieId>304</ieId>
                 <ieLength>2</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>309</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>310</ieId>
                 <ieLength>4</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
             </template>
             <template>
               <observationDomainId>123</observationDomainId>
               <templateId>261</templateId>
               <setId>3</setId>
               <accessTime>2010-03-15T00:00:03.10Z</accessTime>
               <templateDataRecords>2</templateDataRecords>
               <templateDiscontinuityTime>2010-03-15T00:00:01.10Z
                   </templateDiscontinuityTime>
               <field>
                 <ieId>301</ieId>
        
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
                 <isScope/>
               </field>
               <field>
                 <ieId>318</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>319</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
             </template>
             <template>
               <observationDomainId>123</observationDomainId>
               <templateId>262</templateId>
               <setId>3</setId>
               <accessTime>2010-03-15T00:00:03.10Z</accessTime>
               <templateDataRecords>2</templateDataRecords>
               <templateDiscontinuityTime>2010-03-15T00:00:01.10Z
                   </templateDiscontinuityTime>
               <field>
                 <ieId>301</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
                 <isScope/>
               </field>
               <field>
                 <ieId>318</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>319</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>318</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
               </field>
               <field>
                 <ieId>319</ieId>
                 <ieLength>8</ieLength>
                 <ieEnterpriseNumber>0</ieEnterpriseNumber>
        
               </field>
             </template>
           </transportSession>
         </sctpExporter>
       </destination>
       <options>
         <name>Options 1</name>
         <optionsType>selectionSequence</optionsType>
         <optionsTimeout>0</optionsTimeout>
       </options>
       <options>
         <name>Options 2</name>
         <optionsType>selectionStatistics</optionsType>
         <optionsTimeout>30000</optionsTimeout>
       </options>
     </exportingProcess>
        
   </ipfix>
        
7.2. IPFIX Device
7.2. IPFIXデバイス

This configuration example demonstrates the shared usage of a Cache for maintaining Flow Records from two Observation Points belonging to different Observation Domains. Packets are selected using different Sampling techniques: count-based Sampling for the first Observation Point (eth0) and selection of all packets for the second Observation Point (eth1). The Exporting Process sends the Flow Records to a primary destination using SCTP. A UDP Collector is specified as secondary destination.

この構成例は、異なる観測ドメインに属する2つの観測ポイントからのフローレコードを維持するためのキャッシュの共有使用法を示しています。パケットは、さまざまなサンプリング手法を使用して選択されます。最初の観測ポイント(eth0)のカウントベースのサンプリングと、2番目の観測ポイント(eth1)のすべてのパケットの選択です。エクスポートプロセスは、SCTPを使用してフローレコードをプライマリ宛先に送信します。 UDPコレクターが2次宛先として指定されています。

Exporting Process reliability statistics [RFC5101] are exported periodically every minute (60000 milliseconds). Selection Sequence Report Interpretations and Selector Report Interpretations [RFC5476] are exported once after configuring the Selection Processes. In total, two Selection Sequence Report Interpretations will be exported, one for each Selection Process.

プロセスの信頼性統計のエクスポート[RFC5101]は、毎分(60000ミリ秒)定期的にエクスポートされます。選択シーケンスレポートの解釈とセレクターレポートの解釈[RFC5476]は、選択プロセスの構成後に一度エクスポートされます。合計で、選択プロセスごとに1つずつ、合計2つの選択シーケンスレポート解釈がエクスポートされます。

   <ipfix xmlns="urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp">
        
     <observationPoint>
       <name>OP at eth0 (ingress)</name>
       <observationDomainId>123</observationDomainId>
       <ifName>eth0</ifName>
       <direction>ingress</direction>
       <selectionProcess>Count-based packet selection</selectionProcess>
     </observationPoint>
        

<observationPoint>

<観察ポイント>

       <name>OP at eth1</name>
       <observationDomainId>456</observationDomainId>
       <ifName>eth1</ifName>
       <selectionProcess>All packet selection</selectionProcess>
     </observationPoint>
        
     <selectionProcess>
       <name>Count-based packet selection</name>
       <selector>
         <name>Count-based sampler</name>
         <sampCountBased>
           <packetInterval>1</packetInterval>
           <packetSpace>99</packetSpace>
         </sampCountBased>
       </selector>
       <cache>Flow cache</cache>
     </selectionProcess>
        
     <selectionProcess>
       <name>All packet selection</name>
       <selector>
         <name>Select all</name>
         <selectAll/>
       </selector>
       <cache>Flow cache</cache>
     </selectionProcess>
        
     <cache>
       <name>Flow cache</name>
       <timeoutCache>
         <maxFlows>4096</maxFlows>
         <activeTimeout>5000</activeTimeout>
         <idleTimeout>10000</idleTimeout>
         <cacheLayout>
           <cacheField>
             <name>Field 1</name>
             <ieName>sourceIPv4Address</ieName>
             <isFlowKey/>
           </cacheField>
           <cacheField>
             <name>Field 2</name>
             <ieName>destinationIPv4Address</ieName>
             <isFlowKey/>
           </cacheField>
           <cacheField>
             <name>Field 3</name>
             <ieName>protocolIdentifier</ieName>
             <isFlowKey/>
        
           </cacheField>
           <cacheField>
             <name>Field 4</name>
             <ieName>sourceTransportPort</ieName>
             <isFlowKey/>
           </cacheField>
           <cacheField>
             <name>Field 5</name>
             <ieName>destinationTransportPort</ieName>
             <isFlowKey/>
           </cacheField>
           <cacheField>
             <name>Field 6</name>
             <ieName>flowStartMilliseconds</ieName>
           </cacheField>
           <cacheField>
             <name>Field 7</name>
             <ieName>flowEndSeconds</ieName>
           </cacheField>
           <cacheField>
             <name>Field 8</name>
             <ieName>octetDeltaCount</ieName>
           </cacheField>
           <cacheField>
             <name>Field 9</name>
             <ieName>packetDeltaCount</ieName>
           </cacheField>
         </cacheLayout>
       </timeoutCache>
       <exportingProcess>SCTP export with UDP backup</exportingProcess>
     </cache>
        
     <exportingProcess>
       <name>SCTP export with UDP backup</name>
       <exportMode>fallback</exportMode>
       <destination>
         <name>SCTP destination (primary)</name>
         <sctpExporter>
           <destinationPort>4739</destinationPort>
           <destinationIPAddress>192.0.2.1</destinationIPAddress>
         </sctpExporter>
       </destination>
       <destination>
         <name>UDP destination (secondary)</name>
         <udpExporter>
           <destinationPort>4739</destinationPort>
           <destinationIPAddress>192.0.2.2</destinationIPAddress>
           <templateRefreshTimeout>300</templateRefreshTimeout>
        
           <optionsTemplateRefreshTimeout>300
               </optionsTemplateRefreshTimeout>
         </udpExporter>
       </destination>
       <options>
         <name>Options 1</name>
         <optionsType>selectionSequence</optionsType>
         <optionsTimeout>0</optionsTimeout>
       </options>
       <options>
         <name>Options 2</name>
         <optionsType>exportingReliability</optionsType>
         <optionsTimeout>60000</optionsTimeout>
       </options>
     </exportingProcess>
        
   </ipfix>
        
7.3. Export of Flow Records and Packet Reports
7.3. フローレコードとパケットレポートのエクスポート

This configuration example demonstrates the combined export of Flow Records and Packet Reports for a single Observation Point. One Selection Process applies random Sampling to the Observed Packet Stream. Its output is passed to a Cache generating Flow Records. In parallel, the Observed Packet Stream enters a second Selection Process that discards all non-ICMP packets and passes the selected packets to a second Cache for generating Packet Reports. The output of both Caches is exported to a single Collector using SCTP.

この構成例は、単一の観測ポイントのフローレコードとパケットレポートを組み合わせたエクスポートを示しています。 1つの選択プロセスでは、観測されたパケットストリームにランダムサンプリングが適用されます。その出力は、フローレコードを生成するキャッシュに渡されます。並行して、観察されたパケットストリームは、すべての非ICMPパケットを破棄し、選択したパケットをパケットレポートを生成するために2番目のキャッシュに渡す2番目の選択プロセスに入ります。両方のキャッシュの出力は、SCTPを使用して単一のコレクターにエクスポートされます。

   <ipfix xmlns="urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp">
        
     <observationPoint>
       <name>OP at linecard 3</name>
       <observationDomainId>9876</observationDomainId>
       <ifIndex>4</ifIndex>
       <direction>ingress</direction>
       <selectionProcess>Sampling</selectionProcess>
       <selectionProcess>ICMP</selectionProcess>
     </observationPoint>
        
     <selectionProcess>
       <name>Sampling</name>
       <selector>
         <name>Random sampler</name>
         <sampUniProb>
           <probability>0.01</probability>
         </sampUniProb>
       </selector>
        
       <cache>Flow cache</cache>
     </selectionProcess>
        
     <selectionProcess>
       <name>ICMP</name>
       <selector>
         <name>ICMP filter</name>
         <filterMatch>
           <ieId>4</ieId>
           <value>1</value>
         </filterMatch>
       </selector>
       <cache>Packet reporting</cache>
     </selectionProcess>
        
     <cache>
       <name>Flow cache</name>
       <timeoutCache>
         <maxFlows>4096</maxFlows>
         <activeTimeout>5</activeTimeout>
         <idleTimeout>10</idleTimeout>
         <cacheLayout>
           <cacheField>
             <name>Field 1</name>
             <ieName>sourceIPv4Address</ieName>
             <isFlowKey/>
           </cacheField>
           <cacheField>
             <name>Field 2</name>
             <ieName>destinationIPv4Address</ieName>
             <isFlowKey/>
           </cacheField>
           <cacheField>
             <name>Field 6</name>
             <ieName>flowStartMilliseconds</ieName>
           </cacheField>
           <cacheField>
             <name>Field 7</name>
             <ieName>flowEndSeconds</ieName>
           </cacheField>
           <cacheField>
             <name>Field 8</name>
             <ieName>octetDeltaCount</ieName>
           </cacheField>
           <cacheField>
             <name>Field 9</name>
             <ieName>packetDeltaCount</ieName>
           </cacheField>
        
         </cacheLayout>
       </timeoutCache>
       <exportingProcess>Export</exportingProcess>
     </cache>
        
     <cache>
       <name>Packet reporting</name>
       <immediateCache>
         <cacheLayout>
           <cacheField>
             <name>Field 1</name>
             <ieId>313</ieId>
             <ieLength>64</ieLength>
           </cacheField>
           <cacheField>
             <name>Field 2</name>
             <ieId>154</ieId>
           </cacheField>
         </cacheLayout>
       </immediateCache>
       <exportingProcess>Export</exportingProcess>
     </cache>
        
     <exportingProcess>
       <name>Export</name>
       <destination>
         <name>SCTP collector</name>
         <sctpExporter>
           <destinationIPAddress>192.0.2.1</destinationIPAddress>
           <timedReliability>0</timedReliability>
         </sctpExporter>
       </destination>
       <options>
         <name>Options 1</name>
         <optionsType>selectionSequence</optionsType>
         <optionsTimeout>0</optionsTimeout>
       </options>
     </exportingProcess>
        
   </ipfix>
        
7.4. Collector and File Writer
7.4. コレクターおよびファイルライター

This configuration example configures a Collector that writes the received data to a file.

この構成例では、受信したデータをファイルに書き込むコレクターを構成します。

   <ipfix xmlns="urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp">
        
     <collectingProcess>
       <name>SCTP collector</name>
       <sctpCollector>
         <name>Listening port 4739</name>
         <localPort>4739</localPort>
         <localIPAddress>192.0.2.1</localIPAddress>
       </sctpCollector>
       <exportingProcess>File writer</exportingProcess>
     </collectingProcess>
        
     <exportingProcess>
       <name>File writer</name>
       <destination>
         <name>Write to /tmp folder</name>
         <fileWriter>
           <file>file://tmp/collected-records.ipfix</file>
         </fileWriter>
       </destination>
     </exportingProcess>
        
   </ipfix>
        
7.5. Deviations
7.5. 偏差

Assume that a Monitoring Device has only two interfaces ifIndex=1 and ifIndex=2, which can be configured as Observation Points. The Observation Point ID is always identical to the ifIndex.

監視デバイスにはifIndex = 1とifIndex = 2の2つのインターフェイスしかなく、観測ポイントとして構成できると仮定します。観測ポイントIDは常にifIndexと同じです。

The following YANG module specifies these deviations.

次のYANGモジュールは、これらの偏差を指定します。

module my-ipfix-psamp-deviation {
  namespace "urn:my-company:xml:ns:ietf-ipfix-psamp";
  prefix my;
        
  import ietf-ipfix-psamp { prefix ipfix; }
        
  deviation /ipfix:ipfix/ipfix:observationPoint/ipfix:entPhysicalIndex {
    deviate not-supported;
  }
  deviation /ipfix:ipfix/ipfix:observationPoint/ipfix:entPhysicalName {
    deviate not-supported;
  }
  deviation /ipfix:ipfix/ipfix:observationPoint/ipfix:ifName {
    deviate not-supported;
  }
  deviation /ipfix:ipfix/ipfix:observationPoint {
    deviate add {
      must "ipfix:ifIndex=1 or ipfix:ifIndex=2";
    }
  }
  deviation
      /ipfix:ipfix/ipfix:observationPoint/ipfix:observationPointId {
    deviate add {
      must "current()=../ipfix:ifIndex";
    }
  }
}
        
8. Security Considerations
8. セキュリティに関する考慮事項

The YANG module defined in this memo is designed to be accessed via the NETCONF protocol [RFC6241]. The lowest NETCONF layer is the secure transport layer and the mandatory-to-implement secure transport is SSH [RFC6242].

このメモで定義されているYANGモジュールは、NETCONFプロトコル[RFC6241]を介してアクセスされるように設計されています。最下位のNETCONFレイヤーはセキュアなトランスポートレイヤーであり、実装に必須のセキュアなトランスポートはSSH [RFC6242]です。

There are a number of data nodes defined in this YANG module which are writable/creatable/deletable (i.e., config true, which is the default). These data nodes may be considered sensitive or vulnerable in some network environments. Write operations (e.g., edit-config) to these data nodes without proper protection can have a negative effect on network operations. These are the subtrees and data nodes and their sensitivity/vulnerability:

このYANGモジュールには、書き込み可能/作成可能/削除可能なデータノードが多数定義されています(つまり、config true、デフォルトです)。これらのデータノードは、一部のネットワーク環境では機密または脆弱であると見なされる場合があります。適切な保護なしにこれらのデータノードに書き込み操作(edit-configなど)を行うと、ネットワーク操作に悪影響を与える可能性があります。これらは、サブツリーとデータノード、およびそれらの機密性/脆弱性です。

   /ipfix/observationPoint
      The configuration parameters in this subtree specify where packets
      are observed and by which Selection Processes they will be
      processed.  Write access to this subtree allows observing packets
      at arbitrary interfaces or linecards of the Monitoring Device and
      may thus lead to the export of sensitive traffic information.
   /ipfix/selectionProcess
      The configuration parameters in this subtree specify for which
      packets information will be reported in Packet Reports or Flow
      Records.  Write access to this subtree allows changing the subset
      of packets for which information will be reported and may thus
      lead to the export of sensitive traffic information.
   /ipfix/cache
      The configuration parameters in this subtree specify the fields
      included in Packet Reports or Flow Records.  Write access to this
      subtree allows adding fields which may contain sensitive traffic
      information, such as IP addresses or parts of the packet payload.
   /ipfix/exportingProcess
      The configuration parameters in this subtree specify to which
      Collectors Packet Reports or Flow Records are exported.  Write
      access to this subtree allows exporting potentially sensitive
      traffic information to illegitimate Collectors.  Furthermore, TLS/
      DTLS parameters can be changed, which may affect the mutual
      authentication between Exporters and Collectors as well as the
      encrypted transport of the data.
   /ipfix/collectingProcess
      The configuration parameters in this subtree may specify that
      collected Packet Reports and Flow Records are reexported to
      another Collector or written to a file.  Write access to this
      subtree potentially allows reexporting or storing the sensitive
      traffic information.
        

Some of the readable data nodes in this YANG module may be considered sensitive or vulnerable in some network environments. It is thus important to control read access (e.g., via get, get-config, or notification) to these data nodes. These are the subtrees and data nodes and their sensitivity/vulnerability:

このYANGモジュールの一部の読み取り可能なデータノードは、一部のネットワーク環境では機密または脆弱であると見なされる場合があります。したがって、これらのデータノードへの読み取りアクセスを制御することが重要です(たとえば、get、get-config、または通知を介して)。これらは、サブツリーとデータノード、およびそれらの機密性/脆弱性です。

/ipfix/observationPoint Parameters in this subtree may be sensitive because they reveal information about the Monitoring Device itself and the network infrastructure.

/ ipfix / observationPointこのサブツリーのパラメーターは、監視デバイス自体とネットワークインフラストラクチャに関する情報を明らかにするため、機密性が高い場合があります。

   /ipfix/selectionProcess
      Parameters in this subtree may be sensitive because they reveal
      information about the Monitoring Device itself and the observed
      traffic.  For example, the counters packetsObserved and
      packetsDropped inferring the number of observed packets.
   /ipfix/cache
      Parameters in this subtree may be sensitive because they reveal
      information about the Monitoring Device itself and the observed
      traffic.  For example, the counters activeFlows and dataRecords
      allow inferring the number of measured Flows or packets.
   /ipfix/exportingProcess
      Parameters in this subtree may be sensitive because they reveal
      information about the network infrastructure and the outgoing
      IPFIX Transport Sessions.  For example, it discloses the IP
      addresses of Collectors as well as the deployed TLS/DTLS
      configuration, which may facilitate the interception of outgoing
      IPFIX Messages.
   /ipfix/collectingProcess
      Parameters in this subtree may be sensitive because they reveal
      information about the network infrastructure and the incoming
      IPFIX Transport Sessions.  For example, it discloses the IP
      addresses of Exporters as well as the deployed TLS/DTLS
      configuration, which may facilitate the interception of incoming
      IPFIX Messages.
        
9. IANA Considerations
9. IANAに関する考慮事項

This document registers a URI in the IETF XML registry [RFC3688]. Following the format in RFC 3688, the following registration is requested.

このドキュメントは、IETF XMLレジストリ[RFC3688]にURIを登録します。 RFC 3688の形式に従って、次の登録が要求されます。

URI: urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp Registrant Contact: The IPFIX WG of the IETF. XML: N/A, the requested URI is an XML namespace.

URI:urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp登録者の連絡先:IETFのIPFIX WG。 XML:N / A、要求されたURIはXML名前空間です。

This document registers a YANG module in the YANG Module Names registry [RFC6020].

このドキュメントは、YANGモジュール名レジストリ[RFC6020]にYANGモジュールを登録します。

      name: ietf-ipfix-psamp
      namespace: urn:ietf:params:xml:ns:yang:ietf-ipfix-psamp
      prefix: ipfix
      reference: RFC 6728
        
10. Acknowledgements
10. 謝辞

The authors thank Martin Bjorklund, Andy Bierman, and Ladislav Lhotka for helping specify the configuration data model in YANG, as well as Atsushi Kobayashi, Andrew Johnson, Lothar Braun, and Brian Trammell for their valuable reviews of this document.

著者は、YANGでの構成データモデルの指定を支援してくれたMartin Bjorklund、Andy Bierman、Ladislav Lhotkaに加え、このドキュメントの貴重なレビューを提供してくれた小林淳、Andrew Johnson、Lothar Braun、Brian Trammellに感謝します。

11. References
11. 参考文献
11.1. Normative References
11.1. 引用文献

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.

[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、1997年3月。

[RFC5101] Claise, B., "Specification of the IP Flow Information Export (IPFIX) Protocol for the Exchange of IP Traffic Flow Information", RFC 5101, January 2008.

[RFC5101] Claise、B。、「IPトラフィックフロー情報の交換のためのIPフロー情報エクスポート(IPFIX)プロトコルの仕様」、RFC 5101、2008年1月。

[RFC5102] Quittek, J., Bryant, S., Claise, B., Aitken, P., and J. Meyer, "Information Model for IP Flow Information Export", RFC 5102, January 2008.

[RFC5102] Quittek、J.、Bryant、S.、Claise、B.、Aitken、P。、およびJ. Meyer、「IPフロー情報エクスポートの情報モデル」、RFC 5102、2008年1月。

[RFC5103] Trammell, B. and E. Boschi, "Bidirectional Flow Export Using IP Flow Information Export (IPFIX)", RFC 5103, January 2008.

[RFC5103] Trammell、B。およびE. Boschi、「IP Flow Information Export(IPFIX)を使用した双方向フローエクスポート」、RFC 5103、2008年1月。

[RFC5475] Zseby, T., Molina, M., Duffield, N., Niccolini, S., and F. Raspall, "Sampling and Filtering Techniques for IP Packet Selection", RFC 5475, March 2009.

[RFC5475] Zseby、T.、Molina、M.、Duffield、N.、Niccolini、S。、およびF. Raspall、「IPパケット選択のためのサンプリングおよびフィルタリング技術」、RFC 5475、2009年3月。

[RFC5476] Claise, B., Johnson, A., and J. Quittek, "Packet Sampling (PSAMP) Protocol Specifications", RFC 5476, March 2009.

[RFC5476] Claise、B.、Johnson、A。、およびJ. Quittek、「Packet Sampling(PSAMP)Protocol Specifications」、RFC 5476、2009年3月。

[RFC5477] Dietz, T., Claise, B., Aitken, P., Dressler, F., and G. Carle, "Information Model for Packet Sampling Exports", RFC 5477, March 2009.

[RFC5477] Dietz、T.、Claise、B.、Aitken、P.、Dressler、F。、およびG. Carle、「パケットサンプリングエクスポートの情報モデル」、RFC 5477、2009年3月。

[RFC6020] Bjorklund, M., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", RFC 6020, October 2010.

[RFC6020] Bjorklund、M。、「YANG-ネットワーク構成プロトコル(NETCONF)のデータモデリング言語」、RFC 6020、2010年10月。

[RFC6021] Schoenwaelder, J., "Common YANG Data Types", RFC 6021, October 2010.

[RFC6021] Schoenwaelder、J。、「Common YANG Data Types」、RFC 6021、2010年10月。

[UML] Object Management Group, "OMG Unified Modeling Language (OMG UML), Superstructure, V2.2", OMG formal/2009-02-02, February 2009.

[UML]オブジェクト管理グループ、「OMG統一モデリング言語(OMG UML)、上部構造、V2.2」、OMG formal / 2009-02-02、2009年2月。

[IANA-IPFIX] IANA, "IP Flow Information Export (IPFIX) Entities", <http://www.iana.org/assignments/ipfix>.

[IANA-IPFIX] IANA、「IP Flow Information Export(IPFIX)Entities」、<http://www.iana.org/assignments/ipfix>。

11.2. Informative References
11.2. 参考引用

[RFC1141] Mallory, T. and A. Kullberg, "Incremental updating of the Internet checksum", RFC 1141, January 1990.

[RFC1141]マロリー、T。およびA.カルバーグ、「インターネットチェックサムの増分更新」、RFC 1141、1990年1月。

[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, June 2000.

[RFC2863] McCloghrie、K。およびF. Kastenholz、「The Interfaces Group MIB」、RFC 2863、2000年6月。

[RFC3280] Housley, R., Polk, W., Ford, W., and D. Solo, "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 3280, April 2002.

[RFC3280] Housley、R.、Polk、W.、Ford、W。、およびD. Solo、「Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List(CRL)Profile」、RFC 3280、2002年4月。

[RFC5280] Cooper, D., Santesson, S., Farrell, S., Boeyen, S., Housley, R., and W. Polk, "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 5280, May 2008.

[RFC5280] Cooper、D.、Santesson、S.、Farrell、S.、Boeyen、S.、Housley、R。、およびW. Polk、「Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List(CRL)Profile "、RFC 5280、2008年5月。

[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, January 2004.

[RFC3688] Mealling M。、「The IETF XML Registry」、BCP 81、RFC 3688、2004年1月。

[RFC3758] Stewart, R., Ramalho, M., Xie, Q., Tuexen, M., and P. Conrad, "Stream Control Transmission Protocol (SCTP) Partial Reliability Extension", RFC 3758, May 2004.

[RFC3758]スチュワート、R。、ラマーリョ、M。、シー、Q。、テューセン、M。、およびP.コンラッド、「ストリーム制御伝送プロトコル(SCTP)部分信頼性拡張」、RFC 3758、2004年5月。

[RFC3871] Jones, G., "Operational Security Requirements for Large Internet Service Provider (ISP) IP Network Infrastructure", RFC 3871, September 2004.

[RFC3871]ジョーンズ、G。、「大規模インターネットサービスプロバイダー(ISP)IPネットワークインフラストラクチャの運用セキュリティ要件」、RFC 3871、2004年9月。

[RFC3917] Quittek, J., Zseby, T., Claise, B., and S. Zander, "Requirements for IP Flow Information Export (IPFIX)", RFC 3917, October 2004.

[RFC3917] Quittek、J.、Zseby、T.、Claise、B。、およびS. Zander、「IPフロー情報エクスポート(IPFIX)の要件」、RFC 3917、2004年10月。

[RFC4133] Bierman, A. and K. McCloghrie, "Entity MIB (Version 3)", RFC 4133, August 2005.

[RFC4133] Bierman、A。およびK. McCloghrie、「Entity MIB(Version 3)」、RFC 4133、2005年8月。

[RFC6347] Rescorla, E. and N. Modadugu, "Datagram Transport Layer Security Version 1.2", RFC 6347, January 2012.

[RFC6347] Rescorla、E。およびN. Modadugu、「Datagram Transport Layer Security Version 1.2」、RFC 6347、2012年1月。

[RFC6241] Enns, R., Bjorklund, M., Schoenwaelder, J., and A. Bierman, "Network Configuration Protocol (NETCONF)", RFC 6241, June 2011.

[RFC6241] Enns, R., Bjorklund, M., Schoenwaelder, J., and A. Bierman, "Network Configuration Protocol (NETCONF)", RFC 6241, June 2011.

[RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure Shell (SSH)", RFC 6242, June 2011.

[RFC6242] Wasserman、M。、「Secure Shell(SSH)上のNETCONFプロトコルの使用」、RFC 6242、2011年6月。

[RFC4960] Stewart, R., "Stream Control Transmission Protocol", RFC 4960, September 2007.

[RFC4960] Stewart、R。、「Stream Control Transmission Protocol」、RFC 4960、2007年9月。

[RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security (TLS) Protocol Version 1.2", RFC 5246, August 2008.

[RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security (TLS) Protocol Version 1.2", RFC 5246, August 2008.

[RFC5470] Sadasivan, G., Brownlee, N., Claise, B., and J. Quittek, "Architecture for IP Flow Information Export", RFC 5470, March 2009.

[RFC5470] Sadasivan、G.、Brownlee、N.、Claise、B。、およびJ. Quittek、「Architecture for IP Flow Information Export」、RFC 5470、2009年3月。

[RFC5472] Zseby, T., Boschi, E., Brownlee, N., and B. Claise, "IP Flow Information Export (IPFIX) Applicability", RFC 5472, March 2009.

[RFC5472] Zseby、T.、Boschi、E.、Brownlee、N。、およびB. Claise、「IP Flow Information Export(IPFIX)Applicability」、RFC 5472、2009年3月。

[RFC5473] Boschi, E., Mark, L., and B. Claise, "Reducing Redundancy in IP Flow Information Export (IPFIX) and Packet Sampling (PSAMP) Reports", RFC 5473, March 2009.

[RFC5473] Boschi、E.、Mark、L。、およびB. Claise、「Reduce Redundancy in IP Flow Information Export(IPFIX)and Packet Sampling(PSAMP)Reports」、RFC 5473、2009年3月。

[RFC5474] Duffield, N., Chiou, D., Claise, B., Greenberg, A., Grossglauser, M., and J. Rexford, "A Framework for Packet Selection and Reporting", RFC 5474, March 2009.

[RFC5474] Duffield、N.、Chiou、D.、Claise、B.、Greenberg、A.、Grossglauser、M。、およびJ. Rexford、「A Framework for Packet Selection and Reporting」、RFC 5474、2009年3月。

[RFC5610] Boschi, E., Trammell, B., Mark, L., and T. Zseby, "Exporting Type Information for IP Flow Information Export (IPFIX) Information Elements", RFC 5610, July 2009.

[RFC5610] Boschi、E.、Trammell、B.、Mark、L。、およびT. Zseby、「Exporting Type Information for IP Flow Information Export(IPFIX)Information Elements」、RFC 5610、2009年7月。

[RFC5655] Trammell, B., Boschi, E., Mark, L., Zseby, T., and A. Wagner, "Specification of the IP Flow Information Export (IPFIX) File Format", RFC 5655, October 2009.

[RFC5655] Trammell、B.、Boschi、E.、Mark、L.、Zseby、T。、およびA. Wagner、「Specification of the IP Flow Information Export(IPFIX)File Format」、RFC 5655、2009年10月。

[RFC6110] Lhotka, L., "Mapping YANG to Document Schema Definition Languages and Validating NETCONF Content", RFC 6110, February 2011.

[RFC6110] Lhotka、L。、「スキーマ定義言語を文書化するためのYANGのマッピングとNETCONFコンテンツの検証」、RFC 6110、2011年2月。

[RFC6526] Claise, B., Aitken, P., Johnson, A., and G. Muenz, "IP Flow Information Export (IPFIX) Per Stream Control Transmission Protocol (SCTP) Stream", RFC 6526, March 2012.

[RFC6526] Claise、B.、Aitken、P.、Johnson、A。、およびG. Muenz、「IP Flow Information Export(IPFIX)Per Stream Control Transmission Protocol(SCTP)Stream」、RFC 6526、2012年3月。

[RFC6615] Dietz, T., Kobayashi, A., Claise, B., and G. Muenz, "Definitions of Managed Objects for IP Flow Information Export", RFC 6615, June 2012.

[RFC6615] Dietz、T。、小林、A.、Claise、B。、およびG. Muenz、「Defineions of Managed Objects for IP Flow Information Export」、RFC 6615、2012年6月。

[W3C.REC-xml-20081126] Sperberg-McQueen, C., Yergeau, F., Bray, T., Paoli, J., and E. Maler, "Extensible Markup Language (XML) 1.0 (Fifth Edition)", World Wide Web Consortium Recommendation REC-xml-20081126, November 2008, <http://www.w3.org/TR/2008/REC-xml-20081126>.

[W3C.REC-xml-20081126] Sperberg-McQueen, C., Yergeau, F., Bray, T., Paoli, J., and E. Maler, "Extensible Markup Language (XML) 1.0 (Fifth Edition)", World Wide Web Consortium Recommendation REC-xml-20081126, November 2008, <http://www.w3.org/TR/2008/REC-xml-20081126>.

[W3C.REC-xmlschema-0-20041028] Walmsley, P. and D. Fallside, "XML Schema Part 0: Primer Second Edition", World Wide Web Consortium Recommendation REC-xmlschema-0-20041028, October 2004, <http://www.w3.org/TR/2004/REC-xmlschema-0-20041028>.

[W3C.REC-xmlschema-0-20041028] Walmsley、P。およびD. Fallside、「XML Schema Part 0:Primer Second Edition」、World Wide Web Consortium Recommendation REC-xmlschema-0-20041028、2004年10月、<http: //www.w3.org/TR/2004/REC-xmlschema-0-20041028>。

[RFC6727] Dietz, T., Claise, B., and J. Quittek, "Definitions of Managed Objects for Packet Sampling", RFC 6727, October 2012.

[RFC6727] Dietz、T.、Claise、B。、およびJ. Quittek、「Definions of Managed Objects for Packet Sampling」、RFC 6727、2012年10月。

[YANG-WEB] Bjoerklund, M., "YANG WebHome", March 2011, <http://www.yang-central.org/>.

[YANG-WEB] Bjoerklund、M。、「YANG WebHome」、2011年3月、<http://www.yang-central.org/>。

[IANA-ENTERPRISE-NUMBERS] IANA, "Private Enterprise Numbers", <http://www.iana.org/assignments/enterprise-numbers>.

[IANA-ENTERPRISE-NUMBERS] IANA, "Private Enterprise Numbers", <http://www.iana.org/assignments/enterprise-numbers>.

Authors' Addresses

Authors' Addresses

Gerhard Muenz Technische Universitaet Muenchen Department of Informatics Chair for Network Architectures and Services (I8) Boltzmannstr. 3 85748 Garching Germany

Gerhard Muenz Technische Universitaet Muenchen情報学科ネットワークアーキテクチャおよびサービス(I8)Boltzmannstr。 3 85748ドイツGarching

   EMail: muenz@net.in.tum.de
   URI:   http://www.net.in.tum.de/~muenz
        

Benoit Claise Cisco Systems, Inc. De Kleetlaan 6a b1 1831 Diegem Belgium

Benoit Claise Cisco Systems、Inc. De Kleetlaan 6a b1 1831 Diegem Belgium

   Phone: +32 2 704 5622
   EMail: bclaise@cisco.com
        

Paul Aitken Cisco Systems, Inc. 96 Commercial Quay Commercial Street Edinburgh EH6 6LX United Kingdom

Paul Aitken Cisco Systems、Inc. 96 Commercial Quay Commercial StreetエディンバラEH6 6LXイギリス

   Phone: +44 131 561 3616
   EMail: paitken@cisco.com