[要約] RFC 8193は、大規模な測定プラットフォーム（LMAPs）の情報モデルに関するものであり、その目的は、ネットワークの測定データを効果的に収集、管理、分析するための共通のフレームワークを提供することです。
Internet Engineering Task Force (IETF) T. Burbridge
Request for Comments: 8193 P. Eardley
Category: Standards Track BT
ISSN: 2070-1721 M. Bagnulo
Universidad Carlos III de Madrid
J. Schoenwaelder
Jacobs University Bremen
August 2017
Information Model for Large-Scale Measurement Platforms (LMAPs)
大規模測定プラットフォーム（LMAP）の情報モデル
Abstract
概要
This Information Model applies to the Measurement Agent within an LMAP framework. As such, it outlines the information that is configured or preconfigured on the Measurement Agent or exists in communications with a Controller or Collector within an LMAP framework. The purpose of such an Information Model is to provide a protocol- and device-independent view of the Measurement Agent that can be implemented via one or more Control and Report Protocols.
この情報モデルは、LMAPフレームワーク内の測定エージェントに適用されます。そのため、測定エージェントで構成または事前構成された情報、またはLMAPフレームワーク内のコントローラーまたはコレクターとの通信に存在する情報の概要を示します。このような情報モデルの目的は、1つ以上の制御およびレポートプロトコルを介して実装できる、測定エージェントのプロトコルおよびデバイスに依存しないビューを提供することです。
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 7841.
このドキュメントは、IETF（Internet Engineering Task Force）の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ（IESG）による公開が承認されました。インターネット標準の詳細については、RFC 7841のセクション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/rfc8193.
このドキュメントの現在のステータス、エラータ、およびフィードバックの提供方法に関する情報は、http：//www.rfc-editor.org/info/rfc8193で入手できます。
Copyright Notice
著作権表示
Copyright (c) 2017 IETF Trust and the persons identified as the document authors. All rights reserved.
Copyright（c）2017 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に記載されているように保証なしで提供されます。
Table of Contents
目次
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Requirements Language . . . . . . . . . . . . . . . . . . . . 4
3. Notation . . . . . . . . . . . . . . . . . . . . . . . . . . 5
4. LMAP Information Model . . . . . . . . . . . . . . . . . . . 6
4.1. Preconfiguration Information . . . . . . . . . . . . . . 10
4.1.1. Definition of ma-preconfig-obj . . . . . . . . . . . 11
4.2. Configuration Information . . . . . . . . . . . . . . . . 12
4.2.1. Definition of ma-config-obj . . . . . . . . . . . . . 13
4.3. Instruction Information . . . . . . . . . . . . . . . . . 14
4.3.1. Definition of ma-instruction-obj . . . . . . . . . . 17
4.3.2. Definition of ma-suppression-obj . . . . . . . . . . 17
4.4. Logging Information . . . . . . . . . . . . . . . . . . . 19
4.4.1. Definition of ma-log-obj . . . . . . . . . . . . . . 20
4.5. Capability and Status Information . . . . . . . . . . . . 21
4.5.1. Definition of ma-capability-obj . . . . . . . . . . . 21
4.5.2. Definition of ma-capability-task-obj . . . . . . . . 21
4.5.3. Definition of ma-status-obj . . . . . . . . . . . . . 22
4.5.4. Definition of ma-status-schedule-obj . . . . . . . . 23
4.5.5. Definition of ma-status-action-obj . . . . . . . . . 24
4.5.6. Definition of ma-status-suppression-obj . . . . . . . 26
4.5.7. Definition of ma-status-interface-obj . . . . . . . . 27
4.6. Reporting Information . . . . . . . . . . . . . . . . . . 28
4.6.1. Definition of ma-report-obj . . . . . . . . . . . . . 29
4.6.2. Definition of ma-report-result-obj . . . . . . . . . 30
4.6.3. Definition of ma-report-conflict-obj . . . . . . . . 32
4.6.4. Definition of ma-report-table-obj . . . . . . . . . . 32
4.6.5. Definition of ma-report-row-obj . . . . . . . . . . . 33
4.7. Common Objects: Schedules . . . . . . . . . . . . . . . . 33
4.7.1. Definition of ma-schedule-obj . . . . . . . . . . . . 35
4.7.2. Definition of ma-action-obj . . . . . . . . . . . . . 36
4.8. Common Objects: Channels . . . . . . . . . . . . . . . . 37
4.8.1. Definition of ma-channel-obj . . . . . . . . . . . . 38
4.9. Common Objects: Task Configurations . . . . . . . . . . . 38
4.9.1. Definition of ma-task-obj . . . . . . . . . . . . . . 40
4.9.2. Definition of ma-option-obj . . . . . . . . . . . . . 40
4.10. Common Objects: Registry Information . . . . . . . . . . 41
4.10.1. Definition of ma-registry-obj . . . . . . . . . . . 41
4.11. Common Objects: Event Information . . . . . . . . . . . . 41
4.11.1. Definition of ma-event-obj . . . . . . . . . . . . . 42
4.11.2. Definition of ma-periodic-obj . . . . . . . . . . . 44
4.11.3. Definition of ma-calendar-obj . . . . . . . . . . . 44
4.11.4. Definition of ma-one-off-obj . . . . . . . . . . . . 46
4.11.5. Definition of ma-immediate-obj . . . . . . . . . . . 47
4.11.6. Definition of ma-startup-obj . . . . . . . . . . . . 47
4.11.7. Definition of ma-controller-lost-obj . . . . . . . . 47
4.11.8. Definition of ma-controller-connected-obj . . . . . 47
5. Example Execution . . . . . . . . . . . . . . . . . . . . . . 48
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 49
7. Security Considerations . . . . . . . . . . . . . . . . . . . 50
8. References . . . . . . . . . . . . . . . . . . . . . . . . . 50
8.1. Normative References . . . . . . . . . . . . . . . . . . 50
8.2. Informative References . . . . . . . . . . . . . . . . . 51
Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 52
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 53
A large-scale measurement platform is a collection of components that work in a coordinated fashion to perform measurements from a large number of vantage points. A typical use case is the execution of broadband measurements [RFC7536]. The main components of a large-scale measurement platform are the Measurement Agents (MAs), the Controller(s), and the Collector(s).
大規模測定プラットフォームは、多数の視点から測定を実行するために調整された方法で機能するコンポーネントのコレクションです。典型的なユースケースは、ブロードバンド測定の実行です[RFC7536]。大規模測定プラットフォームの主なコンポーネントは、測定エージェント（MA）、コントローラー、およびコレクターです。
The MAs are the elements actually performing the measurements. The MAs are controlled by exactly one Controller at a time, and the Collectors gather the results generated by the MAs. In a nutshell, the normal operation of a large-scale measurement platform starts with the Controller instructing a set of one or more MAs to perform a set of one or more Measurement Tasks at a certain point in time. The MAs execute the instructions from a Controller, and once they have done so, they report the results of the measurements to one or more Collectors. The overall framework for a large-scale measurement platform as used in this document is described in detail in [RFC7594].
MAは、実際に測定を実行する要素です。 MAは一度に1つのコントローラーによって制御され、コレクターはMAによって生成された結果を収集します。簡単に言えば、大規模な測定プラットフォームの通常の動作は、コントローラが1つ以上のMAのセットに、特定の時点で1つ以上の測定タスクのセットを実行するように指示することから始まります。 MAはコントローラーからの命令を実行し、実行すると、測定結果を1つ以上のコレクターに報告します。このドキュメントで使用される大規模測定プラットフォームの全体的なフレームワークは、[RFC7594]で詳細に説明されています。
A large-scale measurement platform involves basically three types of protocols, namely, a Control Protocol (or Protocols) between a Controller and the MAs, a Report Protocol (or Protocols) between the MAs and the Collector(s), and several measurement protocols between the MAs and Measurement Peers (MPs), used to actually perform the measurements. In addition, some information is required to be configured on the MA prior to any communication with a Controller.
大規模な測定プラットフォームには、基本的に3つのタイプのプロトコルが含まれます。つまり、コントローラーとMA間の制御プロトコル（またはプロトコル）、MAとコレクター間のレポートプロトコル（またはプロトコル）、およびいくつかの測定プロトコルです。 MAとMeasurement Peer（MP）の間で、実際に測定を実行するために使用されます。さらに、コントローラと通信する前に、MAでいくつかの情報を設定する必要があります。
This document defines the Information Model for both the Control and Report Protocols along with Preconfiguration Information that is required on the MA before communicating with the Controller, broadly named as the LMAP Information Model. The measurement protocols are out of the scope of this document.
このドキュメントでは、コントローラと通信する前にMAで必要な事前設定情報とともに、制御プロトコルとレポートプロトコルの両方の情報モデルを定義します。LMAP情報モデルと広く呼ばれています。測定プロトコルは、このドキュメントの範囲外です。
As defined in [RFC3444], the LMAP Information Model defines the concepts involved in a large-scale measurement platform at a high level of abstraction, independent of any specific implementation or actual protocol used to exchange the information. It is expected that the proposed Information Model can be used with different protocols in different measurement platform architectures and across different types of MA devices (e.g., home gateway, smartphone, PC, or router). A YANG data model implementing the Information Model can be found in [RFC8194].
[RFC3444]で定義されているように、LMAP情報モデルは、情報の交換に使用される特定の実装や実際のプロトコルに関係なく、大規模な抽象化で大規模測定プラットフォームに関連する概念を定義します。提案された情報モデルは、さまざまな測定プラットフォームアーキテクチャのさまざまなプロトコルで、さまざまな種類のMAデバイス（ホームゲートウェイ、スマートフォン、PC、ルーターなど）で使用できることが期待されます。情報モデルを実装するYANGデータモデルは、[RFC8194]にあります。
The definition of an Information Model serves a number of purposes:
情報モデルの定義には、いくつかの目的があります。
1. To guide the standardization of one or more Control and Report protocols and data models
1. 1つ以上の制御およびレポートプロトコルとデータモデルの標準化を導く
2. To enable high-level interoperability between different Control and Report Protocols by facilitating translation between their respective data models such that a Controller could instruct sub-populations of MAs using different protocols
2. コントローラが異なるプロトコルを使用してMAのサブ母集団に指示できるように、それぞれのデータモデル間の変換を容易にすることにより、異なる制御プロトコルとレポートプロトコル間の高レベルの相互運用性を有効にする
3. To form agreement of what information needs to be held by an MA and passed over the Control and Report interfaces and support the functionality described in the LMAP framework
3. MAが保持し、コントロールおよびレポートインターフェイスを介して渡す必要のある情報について合意を形成し、LMAPフレームワークで説明されている機能をサポートする
4. To enable existing protocols and data models to be assessed for their suitability as part of a large-scale measurement system
4. 大規模測定システムの一部として、既存のプロトコルとデータモデルの適合性を評価できるようにするため
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
キーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「NOT RECOMMENDED」、「MAY」、「OPTIONALこのドキュメントの「」は、BCP 14 [RFC2119] [RFC8174]で説明されているように解釈されます。
This document uses a notation similar to a programming language to define the properties of the objects of the Information Model. An optional property is enclosed by square brackets, [ ], and a list property is indicated by two numbers in angle brackets, <m..n>, where m indicates the minimal number of values, and n is the maximum. The symbol * for n means no upper bound.
このドキュメントでは、プログラミング言語と同様の表記法を使用して、情報モデルのオブジェクトのプロパティを定義しています。オプションプロパティは角かっこ[]で囲まれ、リストプロパティは山かっこで囲まれた2つの数値<m..n>で示されます。ここで、mは値の最小数を示し、nは最大値です。 nの記号*は、上限がないことを意味します。
The object definitions use several base types that are defined as follows:
オブジェクト定義では、次のように定義されているいくつかの基本タイプを使用します。
int A type representing signed or unsigned integer numbers. This Information Model does not define a precision nor does it make a distinction between signed and unsigned number ranges. This type is also used to represent enumerations.
int符号付きまたは符号なし整数を表す型。この情報モデルは精度を定義せず、符号付きと符号なしの数値範囲を区別しません。このタイプは、列挙を表すためにも使用されます。
boolean A type representing a boolean value.
booleanブール値を表すタイプ。
string A type representing a human-readable string consisting of a (possibly restricted) subset of Unicode and ISO/IEC 10646 [ISO.10646] characters.
文字列UnicodeおよびISO / IEC 10646 [ISO.10646]文字の（制限されている可能性がある）サブセットで構成される人間が読める文字列を表す型。
datetime A type representing a date and time using the Gregorian calendar. The datetime format MUST conform to RFC 3339 [RFC3339].
datetimeグレゴリオ暦を使用して日付と時刻を表すタイプ。日時形式はRFC 3339 [RFC3339]に準拠する必要があります。
uuid A type representing a Universally Unique IDentifier (UUID) as defined in RFC 4122 [RFC4122]. The UUID values are expected to be unique within an installation of a large-scale measurement system.
uuid RFC 4122 [RFC4122]で定義されているUniversally Unique IDentifier（UUID）を表すタイプ。 UUID値は、大規模な測定システムのインストール内で一意であることが期待されます。
uri A type representing a Uniform Resource Identifier as defined in STD 66 [RFC3986].
uri STD 66 [RFC3986]で定義されているUniform Resource Identifierを表す型。
ip-address A type representing an IP address. This type supports both IPv4 and IPv6 addresses.
ip-address IPアドレスを表すタイプ。このタイプは、IPv4アドレスとIPv6アドレスの両方をサポートします。
counter A non-negative integer that monotonically increases. Counters may have discontinuities, and they are not expected to persist across restarts.
カウンター単調に増加する非負の整数。カウンターは不連続である可能性があり、再起動後も持続することは想定されていません。
credentials An opaque type representing credentials needed by a cryptographic mechanism to secure communication. Data models must expand this opaque type as needed and required by the security protocols utilized.
クレデンシャル通信を保護するために暗号メカニズムが必要とするクレデンシャルを表す不透明なタイプ。データモデルは、必要に応じて、使用するセキュリティプロトコルで必要とされるように、この不透明なタイプを拡張する必要があります。
data An opaque type representing data obtained from measurements.
data測定から得られたデータを表す不透明なタイプ。
Names of objects are generally assumed to be unique within an implementation.
オブジェクトの名前は通常、実装内で一意であると想定されます。
The information described herein relates to the information stored, received, or transmitted by a Measurement Agent as described within the LMAP framework [RFC7594]. As such, some subsets of this Information Model are applicable to the measurement Controller and Collector and to any device management system that preconfigures the Measurement Agent. The information described in these models will be transmitted by protocols using interfaces between the Measurement Agent and such systems according to a data model.
ここで説明する情報は、LMAPフレームワーク[RFC7594]で説明されているように、測定エージェントによって格納、受信、または送信される情報に関連しています。そのため、この情報モデルの一部のサブセットは、測定コントローラーとコレクター、および測定エージェントを事前構成するデバイス管理システムに適用できます。これらのモデルで記述された情報は、データモデルに従って、Measurement Agentとそのようなシステム間のインターフェイスを使用するプロトコルによって送信されます。
The Information Model is divided into six aspects. Firstly, the grouping of information facilitates reader understanding. Secondly, the particular groupings chosen are expected to map to different protocols or different transmissions within those protocols.
情報モデルは6つの側面に分かれています。まず、情報をグループ化すると、読者の理解が容易になります。第二に、選択された特定のグループは、異なるプロトコルまたはそれらのプロトコル内の異なる伝送にマッピングされることが期待されます。
1. Preconfiguration Information. Information preconfigured on the Measurement Agent prior to any communication with other components of the LMAP architecture (i.e., the Controller, the Collector, and Measurement Peers), specifically detailing how to communicate with a Controller and whether the device is enabled to participate as an MA.
1. 事前設定情報。 LMAPアーキテクチャの他のコンポーネント（つまり、コントローラー、コレクター、および測定ピア）との通信の前に測定エージェントで事前構成された情報、特にコントローラーとの通信方法、およびデバイスがMAとして参加できるかどうかの詳細。
2. Configuration Information. Update of the Preconfiguration Information during the registration of the MA or subsequent communication with the Controller, along with the configuration of further parameters about the MA (rather than the Measurement Tasks it should perform) that were not mandatory for the initial communication between the MA and a Controller.
2. 構成情報。 MAの登録中の事前設定情報の更新、またはコントローラーとのその後の通信、およびMAとの最初の通信に必須ではなかった（実行する必要のある測定タスクではなく）MAに関するその他のパラメーターの構成コントローラ。
3. Instruction Information. Information that is received by the MA from the Controller pertaining to the Measurement Tasks that should be executed. This includes the Task execution Schedules (other than the Controller communication Schedule supplied as Configuration or Preconfiguration Information) and related information such as the Task Configuration, communication Channels to Collectors, and Event information. It also includes Task Suppression information that is used to override normal Task execution.
3. 指示情報。実行する必要がある測定タスクに関連する、コントローラーからMAが受信する情報。これには、タスク実行スケジュール（構成または事前構成情報として提供されるコントローラー通信スケジュール以外）と、タスク構成、コレクターへの通信チャネル、イベント情報などの関連情報が含まれます。また、通常のタスク実行を上書きするために使用されるタスク抑制情報も含まれています。
4. Logging Information. Information transmitted from the MA to the Controller detailing the results of any configuration operations along with error and Status Information from the operation of the MA.
4. ロギング情報。 MAからコントローラーに送信された情報で、構成操作の結果、およびエラーとMAの操作からのステータス情報を詳述します。
5. Capability and Status Information. Information on the general status and capabilities of the MA. For example, the set of measurements that are supported on the device.
5. 機能とステータス情報。 MAの一般的なステータスと機能に関する情報。たとえば、デバイスでサポートされている測定値のセット。
6. Reporting Information. Information transmitted from the MA to one or more Collectors, including measurement results and the context in which they were conducted.
6. レポート情報。 MAから1つ以上のコレクターに送信された情報。測定結果とそれらが実行されたコンテキストを含みます。
In addition, the MA may hold further information not described herein, which may be optionally transferred to or from other systems including the Controller and Collector. One example of information in this category is subscriber or line information that may be extracted by a Task and reported by the MA in the reporting communication to a Collector.
さらに、MAは、ここに記載されていない追加の情報を保持することもできます。この情報は、コントローラーやコレクターを含む他のシステムとの間で任意に転送できます。このカテゴリの情報の一例は、タスクによって抽出され、コレクターへのレポート通信でMAによってレポートされるサブスクライバーまたは回線情報です。
It should also be noted that the MA may be in communication with other management systems that may be responsible for configuring and retrieving information from the MA device. Such systems, where available, can perform an important role in transferring the Preconfiguration Information to the MA or enabling/disabling the measurement functionality of the MA.
また、MAは、MAデバイスからの情報の構成と取得を担当する可能性がある他の管理システムと通信している可能性があることにも注意してください。このようなシステムは、利用可能な場合、事前設定情報をMAに転送したり、MAの測定機能を有効または無効にしたりする上で重要な役割を果たすことができます。
The granularity of data transmitted in each operation of the Control and Report Protocols is not dictated by the Information Model. For example, the Instruction object may be delivered in a single operation. Alternatively, Schedules and Task Configurations may be separated or even each Schedule/Task Configuration may be delivered individually. Similarly, the Information Model does not dictate whether data is read, write, or read/write. For example, some Control Protocols may have the ability to read back Configuration and Instruction Information that has been previously set on the MA. Lastly, while some protocols may simply overwrite information (for example, refreshing the entire Instruction Information), other protocols may have the ability to update or delete selected items of information.
制御およびレポートプロトコルの各操作で送信されるデータの細分性は、情報モデルでは規定されていません。たとえば、命令オブジェクトは単一の操作で配信できます。あるいは、スケジュールとタスク構成を分離するか、各スケジュール/タスク構成を個別に配信することもできます。同様に、情報モデルは、データが読み取り、書き込み、または読み取り/書き込みのどちらであるかを示しません。たとえば、一部の制御プロトコルは、以前にMAで設定された構成および命令情報を読み戻す機能を備えている場合があります。最後に、一部のプロトコルは単に情報を上書きする場合があります（たとえば、命令情報全体を更新する）が、他のプロトコルは、選択した情報項目を更新または削除する機能を備えている場合があります。
The information modeled by the six aspects of the Information Model is supported by a number of common information objects. These objects are also described later in this document and are comprised of:
情報モデルの6つの側面によってモデル化された情報は、多くの一般的な情報オブジェクトによってサポートされています。これらのオブジェクトは、このドキュメントの後半でも説明されており、次のもので構成されています。
a. Schedules. A set of Schedules tells the MA to execute Actions. An Action of a Schedule leads to the execution of a Task. Without a Schedule, no Task (including measurements or reporting or communicating with the Controller) is ever executed. Schedules are used within the Instruction to specify what Tasks should be performed, when, and how to direct their results. A Schedule is also used within the Preconfiguration and Configuration Information in order to execute the Task or Tasks required to communicate with the Controller. A specific Schedule can only be active once. Attempts to start a Schedule while the same Schedule is still running will fail.
a. スケジュール。一連のスケジュールは、MAにアクションを実行するように指示します。スケジュールのアクションは、タスクの実行につながります。スケジュールがないと、タスク（測定、レポート、またはコントローラーとの通信を含む）は実行されません。スケジュールは、どのタスクをいつ、どのように実行するかを指定するために、命令内で使用されます。スケジュールは、コントローラーとの通信に必要なタスクを実行するために、事前設定および設定情報内でも使用されます。特定のスケジュールは一度だけアクティブにできます。同じスケジュールがまだ実行されている間にスケジュールを開始しようとすると失敗します。
b. Channels. A set of Channel objects are used to communicate with a number of endpoints (i.e., the Controller and Collectors). Each Channel object contains the information required for the communication with a single endpoint such as the target location and security details.
b. チャンネル。一連のChannelオブジェクトを使用して、多数のエンドポイント（つまり、コントローラーとコレクター）と通信します。各Channelオブジェクトには、ターゲットの場所やセキュリティの詳細など、単一のエンドポイントとの通信に必要な情報が含まれています。
c. Task Configurations. A set of Task Configurations is used to configure the Tasks that are run by the MA. This includes the registry entries for the Task and any configuration parameters, represented as Task Options. Task Configurations are referenced from a Schedule in order to specify what Tasks the MA should execute.
c. タスク構成。タスク構成のセットは、MAによって実行されるタスクを構成するために使用されます。これには、タスクのレジストリエントリと、タスクオプションとして表される構成パラメータが含まれます。 MAが実行するタスクを指定するために、タスク構成はスケジュールから参照されます。
d. Events. A set of Event objects that can be referenced from the Schedules. Each Schedule always references exactly one Event object that determines when the Schedule is executed. An Event object specifies either a singleton or a series of Events that indicate when Tasks should be executed. A commonly used kind of Event object is the Timing object. For Event objects specifying a series of Events, it is generally a good idea to configure an end time and to refresh the end time as needed to ensure that MAs that lose connectivity to their Controller do not continue executing Schedules forever.
d. イベント。スケジュールから参照できる一連のイベントオブジェクト。各スケジュールは常に、スケジュールがいつ実行されるかを決定する正確に1つのイベントオブジェクトを参照します。イベントオブジェクトは、タスクを実行するタイミングを示すシングルトンまたは一連のイベントを指定します。一般的に使用される種類のイベントオブジェクトは、タイミングオブジェクトです。一連のイベントを指定するイベントオブジェクトの場合、通常、終了時刻を構成し、必要に応じて終了時刻を更新して、コントローラーへの接続を失ったMAがスケジュールの実行を継続しないようにすることをお勧めします。
Figure 1 illustrates the structure in which these common information objects are referenced. The references are achieved by each object (Task Configuration, Event) being given a short textual name that is used by other objects. The objects shown in parenthesis are part of the internal object structure of a Schedule. Channels are not shown in the diagram since they are only used as an option by selected Task Configurations but are similarly referenced using a short text name.
図1は、これらの共通情報オブジェクトが参照される構造を示しています。参照は、他のオブジェクトが使用する短いテキスト名が付けられた各オブジェクト（タスク構成、イベント）によって実現されます。括弧内に示されているオブジェクトは、スケジュールの内部オブジェクト構造の一部です。チャネルは、選択されたタスク構成でオプションとしてのみ使用され、短いテキスト名を使用して同様に参照されるため、図には表示されていません。
Schedule
|-- triggered by --> Event
|
|-- executes --> Action 1
| |-- using --> Task Configuration
| |
| `-- feeding to --> Destination Schedule
:
:
`-- executes --> Action N
|-- using --> Task Configuration
|
`-- feeding to --> Destination Schedule
Figure 1: Relationship between Schedules, Events, Actions, Task Configurations, and Destination Schedules
図1：スケジュール、イベント、アクション、タスク構成、および宛先スケジュールの関係
The primary function of an MA is to execute Schedules. A Schedule, which is triggered by an Event, executes a number of Actions. An Action refers to a configured Task, and it may feed results to a Destination Schedule. Both Actions and configured Tasks can provide parameters, represented as Action Options and Task Options.
MAの主な機能は、スケジュールを実行することです。イベントによってトリガーされるスケジュールは、いくつかのアクションを実行します。アクションは設定されたタスクを参照し、結果を宛先スケジュールにフィードする場合があります。アクションと構成済みタスクの両方で、アクションオプションとタスクオプションとして表されるパラメーターを提供できます。
Tasks can implement a variety of different functions. While in terms of the Information Model, all Tasks have the same structure, it can help conceptually to think of different Task categories:
タスクはさまざまな異なる機能を実装できます。情報モデルの観点では、すべてのタスクは同じ構造を持っていますが、概念的にはさまざまなタスクカテゴリを考えるのに役立ちます。
1. Measurement Tasks measure some aspect of network performance or traffic. They may also capture contextual information from the MA device or network interfaces such as the device type or interface speed.
1. 測定タスクは、ネットワークパフォーマンスまたはトラフィックのいくつかの側面を測定します。また、デバイスタイプやインターフェイス速度などのMAデバイスまたはネットワークインターフェイスからコンテキスト情報を取得する場合もあります。
2. Data Transfer Tasks support the communication with a Controller and Collectors:
2. データ転送タスクは、コントローラーおよびコレクターとの通信をサポートします。
A. Reporting Tasks report the results of Measurement Tasks to Collectors
A.レポートタスクは、測定タスクの結果をコレクターに報告します。
B. One or more Control Tasks implement the Control Protocol and communicate with the Controller
B. 1つ以上の制御タスクが制御プロトコルを実装し、コントローラーと通信する
3. Data Analysis Tasks can exist to analyze data from other Measurement Tasks locally on the MA.
3. データ分析タスクは、他の測定タスクからのデータをMAでローカルに分析するために存在できます。
4. Data Management Tasks may exist to cleanup, filter, or compress data on the MA such as Measurement Task results.
4. 測定タスクの結果など、MAのデータをクリーンアップ、フィルタリング、または圧縮するためのデータ管理タスクが存在する場合があります。
Figure 1 indicates that Actions can produce data that is fed into Destination Schedules. This can by used by Actions implementing Measurement Tasks to feed measurement results to a Schedule that triggers Actions implementing Reporting Tasks. Data fed to a Destination Schedule is consumed by the first Action of the Destination Schedule if the Destination Schedule is using the sequential or pipelined execution mode, and it is consumed by all Actions of the Destination Schedule if the Destination Schedule is using parallel execution mode.
図1は、アクションが宛先スケジュールにフィードされるデータを生成できることを示しています。これは、測定タスクを実装するアクションによって使用され、レポートタスクを実装するアクションをトリガーするスケジュールに測定結果をフィードします。宛先スケジュールにフィードされたデータは、宛先スケジュールが順次実行モードまたはパイプライン実行モードを使用している場合は宛先スケジュールの最初のアクションによって消費され、宛先スケジュールが並列実行モードを使用している場合は宛先スケジュールのすべてのアクションによって消費されます。
This information is the minimal information that needs to be preconfigured to the MA in order for it to successfully communicate with a Controller during the registration process. Some of the Preconfiguration Information elements are repeated in the Configuration Information in order to allow an LMAP Controller to update these items. The Preconfiguration Information also contains some elements that are not under the control of the LMAP framework (such as the device identifier and device security credentials).
この情報は、MAが登録プロセス中にコントローラーと正常に通信するためにMAに事前構成する必要がある最小限の情報です。 LMAPコントローラーがこれらの項目を更新できるようにするために、いくつかの事前構成情報要素が構成情報で繰り返されています。事前設定情報には、LMAPフレームワークの制御下にない要素（デバイス識別子やデバイスセキュリティ資格情報など）も含まれています。
This Preconfiguration Information needs to include a URL of the initial Controller from where Configuration Information can be communicated along with the security information required for the communication, including the certificate of the Controller (or the certificate of the Certification Authority that was used to issue the certificate for the Controller). All this is expressed as a Channel. While multiple Channels may be provided in the Preconfiguration Information, they must all be associated with a single Controller (e.g., over different interfaces or network protocols).
この事前構成情報には、構成情報を通信できる最初のコントローラーのURLと、コントローラーの証明書（または証明書の発行に使用された証明機関の証明書）を含む、通信に必要なセキュリティ情報を含める必要があります。コントローラ用）。これらはすべてチャネルとして表現されます。複数のチャネルが事前構成情報で提供される場合がありますが、それらはすべて（たとえば、異なるインターフェイスまたはネットワークプロトコルを介して）1つのコントローラーに関連付けられている必要があります。
Where the MA pulls information from the Controller, the Preconfiguration Information also needs to contain the timing of the communication with the Controller as well as the nature of the communication itself (such as the protocol and data to be transferred). The timing is represented as an Event that invokes a Schedule that executes the Task(s) responsible for communication with the Controller. It is this Task (or Tasks) that implements the Control Protocol between the MA and the Controller and utilizes the Channel information. The Task(s) may take additional parameters, as defined by a Task Configuration.
MAがコントローラーから情報を取得する場合、事前構成情報には、コントローラーとの通信のタイミングと、通信自体の性質（転送されるプロトコルやデータなど）も含める必要があります。タイミングは、コントローラーとの通信を担当するタスクを実行するスケジュールを呼び出すイベントとして表されます。 MAとコントローラーの間に制御プロトコルを実装し、チャネル情報を利用するのは、このタスクです。タスクは、タスク構成で定義されている追加のパラメーターを取る場合があります。
Even where information is pushed to the MA from the Controller (rather than pulled by the MA), a Schedule still needs to be supplied. In this case, the Schedule will simply execute a Controller listener Task when the MA is started. A Channel is still required for the MA to establish secure communication with the Controller.
情報が（MAによってプルされるのではなく）コントローラーからMAにプッシュされる場合でも、スケジュールを提供する必要があります。この場合、MAが開始されると、スケジュールは単にコントローラーリスナータスクを実行します。 MAがコントローラーとの安全な通信を確立するには、チャネルが引き続き必要です。
It can be seen that these Channels, Schedules, and Task Configurations for the initial communication between the MA and its Controller are no different in terms of the Information Model to any other Channel, Schedule, or Task Configuration that might execute a Measurement Task or report the measurement results (as described later).
MAとそのコントローラー間の初期通信用のこれらのチャネル、スケジュール、およびタスク構成は、情報モデルの点で、測定タスクまたはレポートを実行する可能性がある他のチャネル、スケジュール、またはタスク構成と同じであることがわかります。測定結果（後述）。
The MA may be preconfigured with an MA-ID or may use a Device ID in the first Controller contact before it is assigned an MA-ID. The Device ID may be a Media Access Control (MAC) address or some other device identifier expressed as a URI. If the MA-ID is not provided at this stage, then it must be provided by the Controller during Configuration.
MAはMA-IDで事前設定されているか、MA-IDが割り当てられる前の最初のコントローラーコンタクトでデバイスIDを使用できます。デバイスIDは、メディアアクセスコントロール（MAC）アドレス、またはURIで表現された他のデバイスIDです。この段階でMA-IDが提供されない場合は、構成時にコントローラーによって提供される必要があります。
object {
[uuid ma-preconfig-agent-id;]
ma-task-obj ma-preconfig-control-tasks<1..*>;
ma-channel-obj ma-preconfig-control-channels<1..*>;
ma-schedule-obj ma-preconfig-control-schedules<1..*>;
[uri ma-preconfig-device-id;]
credentials ma-preconfig-credentials;
} ma-preconfig-obj;
The ma-preconfig-obj describes information that needs to be available to the MA in order to bootstrap communication with a Controller. The ma-preconfig-obj consists of the following elements:
ma-preconfig-objは、コントローラーとの通信をブートストラップするためにMAが利用できる必要がある情報を記述します。 ma-preconfig-objは、次の要素で構成されています。
ma-preconfig-agent-id: An optional UUID uniquely identifying the Measurement Agent.
ma-preconfig-agent-id：測定エージェントを一意に識別するオプションのUUID。
ma-preconfig-control-tasks: An unordered set of Task objects.
ma-preconfig-control-tasks：順序付けされていないTaskオブジェクトのセット。
ma-preconfig-control-channels: An unordered set of Channel objects.
ma-preconfig-control-channels：順不同のChannelオブジェクトのセット。
ma-preconfig-control-schedules: An unordered set of scheduling objects.
ma-preconfig-control-schedules：順序付けされていないスケジューリングオブジェクトのセット。
ma-preconfig-device-id: An optional identifier for the device.
ma-preconfig-device-id：デバイスのオプションの識別子。
ma-preconfig-credentials: The security credentials used by the Measurement Agent.
ma-preconfig-credentials：Measurement Agentが使用するセキュリティ認証情報。
During registration or at any later point at which the MA contacts the Controller (or vice versa), the choice of Controller, details for the timing of communication with the Controller, or parameters for the communication Task(s) can be changed (as captured by the Channels, Schedules, and Task Configurations objects). For example, the preconfigured Controller (specified as a Channel or Channels) may be overridden with a specific Controller that is more appropriate to the MA device type, location, or characteristics of the network (e.g., access technology type or broadband product). The initial communication Schedule may be overridden with one more relevant to routine communications between the MA and the Controller.
登録中、またはMAがコントローラーに連絡する（またはその逆の）後の時点で、コントローラーの選択、コントローラーとの通信タイミングの詳細、または通信タスクのパラメーターを（キャプチャーに応じて）変更できます。チャネル、スケジュール、およびタスク構成オブジェクト）。たとえば、事前に構成されたコントローラー（1つまたは複数のチャネルとして指定）は、ネットワークのMAデバイスの種類、場所、または特性（アクセステクノロジの種類やブロードバンド製品など）により適した特定のコントローラーで上書きされる場合があります。最初の通信スケジュールは、MAとコントローラー間の定期的な通信に関連する1つで上書きされる場合があります。
While some Control Protocols may only use a single Schedule, other protocols may use several Schedules (and related Data Transfer Tasks) to update the Configuration Information, transfer the Instruction Information, transfer Capability and Status Information, and send other information to the Controller such as log or error notifications. Multiple Channels may be used to communicate with the same Controller over multiple interfaces (e.g., to send Logging Information over a different network).
一部の制御プロトコルは単一のスケジュールのみを使用できますが、他のプロトコルは複数のスケジュール（および関連するデータ転送タスク）を使用して、構成情報を更新し、指示情報を転送し、機能とステータス情報を転送し、その他の情報をコントローラーに送信します。ログまたはエラー通知。複数のチャネルを使用して、複数のインターフェースを介して同じコントローラと通信することができます（たとえば、異なるネットワークを介してログ情報を送信するため）。
In addition, the MA will be given further items of information that relate specifically to the MA rather than the measurements it is to conduct or how to report results. The assignment of an identifier to the Measurement Agent is mandatory. If the Measurement Agent Identifier was not optionally provided during the preconfiguration, then one must be provided by the Controller during Configuration. Optionally, a Group-ID may also be given that identifies a group of interest to which that MA belongs. For example, the group could represent an ISP, broadband product, technology, market classification, geographic region, or a combination of multiple such characteristics. Additional flags control whether the MA-ID or the Group-ID are included in Reports. The reporting of a Group-ID without the MA-ID may allow the MA to remain anonymous, which may be particularly useful to prevent tracking of mobile MA devices.
さらに、MAには、測定や結果の報告方法ではなく、MAに特に関連する情報がさらに提供されます。測定エージェントへの識別子の割り当ては必須です。事前構成中にMeasurement Agent Identifierがオプションで提供されなかった場合は、構成中にコントローラーによって1つ提供される必要があります。オプションで、そのMAが属する対象のグループを識別するグループIDも指定できます。たとえば、グループは、ISP、ブロードバンド製品、テクノロジー、市場分類、地理的地域、またはそのような複数の特性の組み合わせを表すことができます。追加のフラグは、MA-IDまたはグループIDをレポートに含めるかどうかを制御します。 MA-IDのないグループIDの報告により、MAを匿名のままにすることができます。これは、モバイルMAデバイスの追跡を防ぐのに特に役立ちます。
Optionally, an MA can also be configured to stop executing any Instruction Schedule if the Controller is unreachable. This can be used as a fail-safe to stop Measurement and other Tasks from being conducted when there is doubt that the Instruction Information is still valid. This is simply represented as a time window in seconds since the last communication with the Controller, after which an Event is generated that can trigger the suspension of Instruction Schedules. The appropriate value of the time window will depend on the specified communication Schedule with the Controller and the duration for which the system is willing to tolerate continued operation with potentially stale Instruction Information.
必要に応じて、MAは、コントローラーに到達できない場合に命令スケジュールの実行を停止するように構成することもできます。これは、指示情報がまだ有効である疑いがある場合に、測定や他のタスクの実行を停止するためのフェイルセーフとして使用できます。これは、コントローラとの最後の通信からの秒単位の時間ウィンドウとして単純に表されます。その後、命令スケジュールの一時停止をトリガーするイベントが生成されます。時間枠の適切な値は、指定されたコントローラーとの通信スケジュール、およびシステムが潜在的に陳腐化した指示情報による継続した操作を許容できる期間に依存します。
While Preconfiguration Information is persistent upon a device reset or power cycle, the persistency of the Configuration Information may be device dependent. Some devices may revert back to their preconfiguration state upon reboot or factory reset, while other devices may store all Configuration and Instruction Information in persistent storage. A Controller can check whether an MA has the latest Configuration and Instruction Information by examining the Capability and Status Information for the MA.
事前設定情報はデバイスのリセットまたは電源の再投入後も保持されますが、設定情報の保持はデバイスに依存する場合があります。一部のデバイスは、再起動または工場出荷時のリセット時に構成前の状態に戻る場合がありますが、他のデバイスはすべての構成情報と指示情報を永続的なストレージに保存する場合があります。コントローラは、MAの機能とステータス情報を調べることにより、MAが最新の構成情報と指示情報を持っているかどうかを確認できます。
object {
uuid ma-config-agent-id;
ma-task-obj ma-config-control-tasks<1..*>;
ma-channel-obj ma-config-control-channels<1..*>;
ma-schedule-obj ma-config-control-schedules<1..*>;
credentials ma-config-credentials;
[string ma-config-group-id;]
[string ma-config-measurement-point;]
[boolean ma-config-report-agent-id;]
[boolean ma-config-report-group-id;]
[boolean ma-config-report-measurement-point;]
[int ma-config-controller-timeout;]
} ma-config-obj;
The ma-config-obj consists of the following elements:
ma-config-objは、次の要素で構成されています。
ma-config-agent-id: A UUID uniquely identifying the Measurement Agent.
ma-config-agent-id：Measurement Agentを一意に識別するUUID。
ma-config-control-tasks: An unordered set of Task objects.
ma-config-control-tasks：タスクオブジェクトの順不同のセット。
ma-config-control-channels: An unordered set of Channel objects.
ma-config-control-channels：順不同のChannelオブジェクトのセット。
ma-config-control-schedules: An unordered set of scheduling objects.
ma-config-control-schedules：順序付けされていないスケジューリングオブジェクトのセット。
ma-config-credentials: The security credentials used by the Measurement Agent.
ma-config-credentials：Measurement Agentが使用するセキュリティ認証情報。
ma-config-group-id: An optional identifier of the group of Measurement Agents this Measurement Agent belongs to.
ma-config-group-id：この測定エージェントが属する測定エージェントのグループのオプションの識別子。
ma-config-measurement-point: An optional identifier for the measurement point indicating where the Measurement Agent is located on a path (see [RFC7398] for further details).
ma-config-measurement-point：パス上の測定エージェントが配置されている場所を示す測定ポイントのオプションの識別子（詳細については、[RFC7398]を参照してください）。
ma-config-report-agent-id: An optional flag indicating whether the Agent Identifier (ma-config-agent-id) is included in reports. The default value is true.
ma-config-report-agent-id：エージェント識別子（ma-config-agent-id）がレポートに含まれているかどうかを示すオプションのフラグ。デフォルト値はtrueです。
ma-config-report-group-id: An optional flag indicating whether the Group-ID (ma-config-group-id) is included in reports. The default value is false.
ma-config-report-group-id：グループID（ma-config-group-id）がレポートに含まれているかどうかを示すオプションのフラグ。デフォルト値はfalseです。
ma-config-report-measurement-point: An optional flag indicating whether the measurement point (ma-config-measurement-point) should be included in reports. The default value is false.
ma-config-report-measurement-point：測定ポイント（ma-config-measurement-point）をレポートに含めるかどうかを示すオプションのフラグ。デフォルト値はfalseです。
ma-config-controller-timeout: A timer is started after each successful contact with a Controller. When the timer reaches the controller-timeout (measured in seconds), an Event is raised indicating that connectivity to the Controller has been lost (see ma-controller-lost-obj).
ma-config-controller-timeout：コントローラーとの接続が成功するたびにタイマーが開始されます。タイマーがコントローラーのタイムアウト（秒単位で計測）に達すると、コントローラーへの接続が失われたことを示すイベントが発生します（ma-controller-lost-objを参照）。
The Instruction Information Model has four sub-elements:
指示情報モデルには、4つのサブ要素があります。
1. Instruction Task Configurations
1. 指示タスクの構成
2. Report Channels
2. レポートチャネル
3. Instruction Schedules
3. 指導スケジュール
4. Suppression The Instruction supports the execution of all Tasks on the MA except those that deal with communication with the Controller (specified in Configuration or Preconfiguration Information). The Tasks are configured in Instruction Task Configurations and included by reference in the Actions of Instruction Schedules that specify when to execute them. The results can be communicated to other Schedules, or a Task may implement a Reporting Protocol and communicate results over Report Channels. Suppression is used to temporarily stop the execution of new Tasks as specified by the Instruction Schedules (and optionally to stop ongoing Tasks).
4.抑制命令は、コントローラーとの通信を処理するタスク（構成または事前構成情報で指定）を除く、MA上のすべてのタスクの実行をサポートします。タスクは、命令タスク構成で構成され、いつ実行するかを指定する命令スケジュールのアクションに参照として含まれます。結果は他のスケジュールと通信できます。または、タスクはレポートプロトコルを実装し、レポートチャネルを介して結果を通信できます。抑制は、指示スケジュールによって指定された新しいタスクの実行を一時的に停止するために使用されます（オプションで、進行中のタスクを停止するためにも使用されます）。
A Task Configuration is used to configure the mandatory and optional parameters of a Task. It also serves to instruct the MA about the Task including the ability to resolve the Task to an executable and to specify the schema for the Task parameters.
タスク構成は、タスクの必須およびオプションのパラメーターを構成するために使用されます。また、タスクを実行可能ファイルに解決する機能やタスクパラメータのスキーマを指定する機能など、タスクについてMAに指示する役割も果たします。
A Report Channel defines how to communicate with a single remote system specified by a URL. A Report Channel is used to send results to a single Collector but is no different in terms of the Information Model to the Control Channel used to transfer information between the MA and the Controller. Several Report Channels can be defined to enable results to be split or duplicated across different destinations. A single Channel can be used by multiple (reporting) Task Configurations to transfer data to the same Collector. A single Reporting Task Configuration can also be included in multiple Schedules. For example, a single Collector may receive data at three different cycle rates, with one Schedule reporting hourly, another reporting daily, and a third specifying that results should be sent immediately for on-demand Measurement Tasks. Alternatively, multiple Report Channels can be used to send Measurement Task results to different Collectors. The details of the Channel element is described later as it is common to several objects.
レポートチャネルは、URLで指定された単一のリモートシステムと通信する方法を定義します。レポートチャネルは、結果を単一のコレクタに送信するために使用されますが、情報モデルの点で、MAとコントローラの間で情報を転送するために使用される制御チャネルと同じです。複数のレポートチャネルを定義して、結果を異なる宛先間で分割または複製することができます。 1つのチャネルを複数の（レポート）タスク構成で使用して、同じコレクターにデータを転送できます。単一のレポートタスク構成を複数のスケジュールに含めることもできます。たとえば、1つのコレクタが3つの異なるサイクルレートでデータを受信する場合があります。1つのスケジュールは1時間ごとにレポートし、もう1つは毎日レポートし、3番目はオンデマンド測定タスクの結果をすぐに送信するように指定します。または、複数のレポートチャネルを使用して、測定タスクの結果を異なるコレクターに送信できます。 Channelエレメントの詳細は、いくつかのオブジェクトに共通であるため、後で説明します。
Instruction Schedules specify which Actions to execute according to a given triggering Event. An Action extends a configured Task with additional specific parameters. An Event can trigger the execution of a single Action, or it can trigger a repeated series of Actions. The Schedule also specifies how to link output data from Tasks to other Schedules.
命令スケジュールは、特定のトリガーイベントに従って実行するアクションを指定します。アクションは、構成されたタスクを追加の特定のパラメーターで拡張します。イベントは、単一のアクションの実行をトリガーしたり、一連のアクションを繰り返しトリガーしたりできます。スケジュールは、タスクからの出力データを他のスケジュールにリンクする方法も指定します。
Measurement Suppression information is used to override the Instruction Schedule and temporarily stop measurements or other Tasks from running on the MA for a defined or indefinite period. While conceptually measurements can be stopped by simply removing them from the Measurement Schedule, splitting out separate information on Measurement Suppression allows this information to be updated on the MA on a different timing cycle or protocol implementation to the Measurement Schedule. It is also considered that it will be easier for a human operator to implement a temporary explicit Suppression rather than having to move to a reduced Schedule and then roll back at a later time.
測定抑制情報は、命令スケジュールを上書きし、定義された期間または無期限に測定または他のタスクがMAで実行されるのを一時的に停止するために使用されます。概念的には測定を測定スケジュールから削除するだけで測定を停止できますが、測定抑制に関する個別の情報を分割することで、MAでこの情報を別のタイミングサイクルまたはプロトコル実装で測定スケジュールに更新できます。また、人間のオペレーターは、削減されたスケジュールに移動して後でロールバックするよりも、一時的な明示的な抑制を実装する方が簡単だと考えられています。
It should be noted that Control Schedules and Tasks cannot be suppressed as evidenced by the lack of Suppression information in the Configuration. The Control Schedule must only reference Tasks listed as Control Tasks (i.e., within the Configuration Information).
構成に抑制情報がないため、制御スケジュールとタスクを抑制できないことに注意してください。制御スケジュールは、制御タスクとして（つまり、構成情報内で）リストされているタスクのみを参照する必要があります。
A single Suppression object is able to enable/disable a set of Instruction Tasks that are tagged for Suppression. This enables fine-grained control on which Tasks are suppressed. Suppression of both matching Actions and Measurement Schedules is supported. Support for disabling specific Actions allows malfunctioning or misconfigured Tasks or Actions that have an impact on a particular part of the network infrastructure (e.g., a particular Measurement Peer) to be targeted. Support for disabling specific Schedules allows for particularly heavy cycles or sets of less essential Measurement Tasks to be suppressed quickly and effectively. Note that Suppression has no effect on either Controller Tasks or Controller Schedules.
単一の抑制オブジェクトは、抑制のタグが付けられた一連の指示タスクを有効/無効にすることができます。これにより、タスクを抑制するきめ細かい制御が可能になります。一致するアクションと測定スケジュールの両方の抑制がサポートされています。特定のアクションの無効化のサポートにより、ネットワークインフラストラクチャの特定の部分（特定の測定ピアなど）に影響を与える誤動作または誤設定されたタスクまたはアクションをターゲットにすることができます。特定のスケジュールの無効化のサポートにより、特に重いサイクルや重要性の低い測定タスクのセットをすばやく効果的に抑制できます。抑制は、コントローラータスクまたはコントローラースケジュールには影響しません。
Suppression stops new Tasks from executing. In addition, the Suppression information also supports an additional boolean that is used to select whether ongoing Tasks are also to be terminated.
抑制により、新しいタスクの実行が停止します。さらに、抑制情報は、進行中のタスクも終了するかどうかを選択するために使用される追加のブール値もサポートします。
Unsuppression is achieved through either overwriting the Measurement Suppression information (e.g., changing 'enabled' to False) or through the use of an end time such that the Measurement Suppression will no longer be in effect beyond this time.
抑制解除は、測定抑制情報を上書きする（「有効」をFalseに変更するなど）か、終了時間を使用して、測定抑制がこの時間を超えて有効にならないようにすることによって実現されます。
The goal when defining these four different elements is to allow each part of the Information Model to change without affecting the other three elements. For example, it is envisaged that the Report Channels and the set of Task Configurations will be relatively static. The Instruction Schedule, on the other hand, is likely to be more dynamic, as the measurement panel and test frequency are changed for various business goals. Another example is that measurements can be suppressed with a Suppression command without removing the existing Instruction Schedules that would continue to apply after the Suppression expires or is removed. In terms of the communication between the MA and its Controller, this can reduce the data overhead. It also encourages the reuse of the same standard Task Configurations and Reporting Channels to help ensure consistency and reduce errors.
これらの4つの異なる要素を定義するときの目標は、他の3つの要素に影響を与えることなく、情報モデルの各部分を変更できるようにすることです。たとえば、レポートチャネルとタスク構成のセットは比較的静的であることが想定されています。一方、インストラクションスケジュールは、測定パネルとテスト頻度がさまざまなビジネス目標に合わせて変更されるため、より動的になる可能性があります。別の例は、抑制が期限切れになるか削除された後も引き続き適用される既存の命令スケジュールを削除せずに、抑制コマンドで測定を抑制できることです。 MAとそのコントローラー間の通信に関しては、これによりデータのオーバーヘッドを削減できます。また、同じ標準のタスク構成とレポートチャネルを再利用して、一貫性を確保し、エラーを減らすこともできます。
object {
ma-task-obj ma-instruction-tasks<0..*>;
ma-channel-obj ma-instruction-channels<0..*>;
ma-schedule-obj ma-instruction-schedules<0..*>;
[ma-suppression-obj ma-instruction-suppressions<0..*>;]
} ma-instruction-obj;
An ma-instruction-obj consists of the following elements:
ma-instruction-objは、次の要素で構成されています。
ma-instruction-tasks: A possibly empty unordered set of Task objects.
ma-instruction-tasks：おそらく空の順序付けられていないTaskオブジェクトのセット。
ma-instruction-channels: A possibly empty unordered set of Channel objects.
ma-instruction-channels：おそらく空の順序付けられていないChannelオブジェクトのセット。
ma-instruction-schedules: A possibly empty unordered set of Schedule objects.
ma-instruction-schedules：おそらく空の順序付けされていないScheduleオブジェクトのセット。
ma-instruction-suppressions: An optional possibly empty unordered set of Suppression objects.
ma-instruction-suppressions：Suppressionオブジェクトのオプションの空の順序なしのセット。
object {
string ma-suppression-name;
[ma-event-obj ma-suppression-start;]
[ma-event-obj ma-suppression-end;]
[string ma-suppression-match<0..*>;]
[boolean ma-suppression-stop-running;]
} ma-suppression-obj;
The ma-suppression-obj controls the Suppression of Schedules or Actions and consists of the following elements:
ma-suppression-objは、スケジュールまたはアクションの抑制を制御し、次の要素で構成されます。
ma-suppression-name: A name uniquely identifying a Suppression.
ma-suppression-name：抑制を一意に識別する名前。
ma-suppression-start: The optional Event indicating when Suppression starts. If not present, the Suppression starts immediately, i.e., as if the value would be 'immediate'.
ma-suppression-start：抑制の開始時期を示すオプションのイベント。存在しない場合、抑制は直ちに開始されます。つまり、値が「即時」であるかのように抑制されます。
ma-suppression-end: The optional Event indicating when Suppression ends. If not present, the Suppression does not have a defined end, i.e., the Suppression remains for an indefinite period of time.
ma-suppression-end：抑制がいつ終了するかを示すオプションのイベント。存在しない場合、抑制には定義された終了がありません。つまり、抑制は無期限に残ります。
ma-suppression-match: An optional and possibly empty unordered set of match patterns. The Suppression will apply to all Schedules (and their Actions) that have a matching value in their ma-schedule-suppression-tags and all Actions that have a matching value in their ma-action-suppression-tags. Pattern matching is done using a glob style pattern (see below).
ma-suppression-match：オプションの、場合によっては空の順序付けされていない一致パターンのセット。抑制は、ma-schedule-suppression-tagsに一致する値を持つすべてのスケジュール（およびそのアクション）と、ma-action-suppression-tagsに一致する値を持つすべてのアクションに適用されます。パターンマッチングは、globスタイルのパターンを使用して行われます（以下を参照）。
ma-suppression-stop-running: An optional boolean indicating whether Suppression will stop any running matching Schedules or Actions. The default value for this boolean is false.
ma-suppression-stop-running：抑制が実行中の一致するスケジュールまたはアクションを停止するかどうかを示すオプションのブール。このブール値のデフォルト値はfalseです。
Glob style pattern matching is following POSIX.2 fnmatch() [POSIX.2] without special treatment of file paths:
Globスタイルのパターンマッチングは、POSIX.2 fnmatch()[POSIX.2]に従っており、ファイルパスの特別な処理はありません。
* matches a sequence of characters ? matches a single character [seq] matches any character in seq [!seq] matches any character not in seq
* 文字のシーケンスに一致しますか？単一の文字に一致[seq]はseq内の任意の文字に一致[！seq]はseq内にない任意の文字に一致
A backslash followed by a character matches the following character. In particular:
バックスラッシュとそれに続く文字は、次の文字と一致します。特に：
\* matches * \? matches ? \\ matches \
\ *は* \？と一致します一致しますか？ \\は\に一致
A sequence seq may be a sequence of characters (e.g., [abc]) or a range of characters (e.g., [a-c]).
シーケンスseqは、文字のシーケンス（[abc]など）または文字の範囲（[a-c]など）です。
The MA may report on the success or failure of Configuration or Instruction communications from the Controller. In addition, further operational logs may be produced during the operation of the MA, and updates to Capabilities may also be reported. Reporting this information is achieved in exactly the same manner as scheduling any other Task. We make no distinction between a Measurement Task conducting an active or passive network measurement and one that solely retrieves static or dynamic information from the MA such as Capabilities or Logging Information. One or more logging Tasks can be programmed or configured to capture subsets of the Logging Information. These logging Tasks are then executed by Schedules, which also specify that the resultant data is to be transferred over the Controller Channels.
MAは、コントローラーからの構成または命令通信の成功または失敗について報告する場合があります。さらに、MAの操作中にさらに操作ログが作成され、機能の更新も報告される場合があります。この情報の報告は、他のタスクのスケジュールとまったく同じ方法で実現されます。アクティブまたはパッシブネットワーク測定を実行する測定タスクと、ケイパビリティやログ情報などのMAから静的または動的な情報のみを取得する測定タスクは区別されません。 1つ以上のロギングタスクをプログラミングまたは設定して、ロギング情報のサブセットをキャプチャできます。これらのロギングタスクは、スケジュールによって実行されます。これにより、結果のデータがコントローラーチャネルを介して転送されることも指定されます。
The type of Logging Information will fall into three different categories:
ロギング情報のタイプは、3つの異なるカテゴリに分類されます。
1. Success/failure/warning messages in response to information updates from the Controller. Failure messages could be produced due to some inability to receive or parse the Controller communication or if the MA is not able to act as instructed. For example:
1. コントローラーからの情報の更新に応答する成功/失敗/警告メッセージ。コントローラ通信を受信または解析できないため、またはMAが指示どおりに動作できない場合、失敗メッセージが生成される可能性があります。例えば：
* "Measurement Schedules updated OK"
* 「測定スケジュールは更新されましたOK」
* "Unable to parse JSON"
* 「JSONを解析できません」
* "Missing mandatory element: Measurement Timing"
* 「必須要素がありません：測定タイミング」
* "'Start' does not conform to schema - expected datetime"
* 「「開始」はスキーマに準拠していません-予想される日時」
* "Date specified is in the past"
* 「指定された日付は過去です」
* "'Hour' must be in the range 1..24"
* 「「時間」は1..24の範囲でなければなりません。」
* "Schedule A refers to non-existent Measurement Task Configuration"
* 「スケジュールAは、存在しない測定タスク構成を参照しています」
* "Measurement Task Configuration X registry, entry Y not found"
* 「測定タスク構成Xレジストリ、エントリYが見つかりません」
* "Updated Measurement Task Configurations do not include M used by Measurement Schedule N"
* 「更新された測定タスク構成には、測定スケジュールNで使用されるMが含まれていません」
2. Operational updates from the MA. For example:
2. MAからの操作上の更新。例えば：
* "Out of memory: cannot record result"
* 「メモリ不足：結果を記録できません」
* "Collector 'collector.example.com' not responding"
* 「コレクター 'collector.example.com'が応答していません」
* "Unexpected restart"
* 「予期しない再起動」
* "Suppression timeout"
* 「抑制タイムアウト」
* "Failed to execute Measurement Task Configuration H"
* 「計測タスク設定Hの実行に失敗しました」
3. Status updates from the MA. For example:
3. MAからのステータスの更新。例えば：
* "Device interface added: eth3"
* 「追加されたデバイスインターフェイス：eth3」
* "Supported measurements updated"
* 「サポートされている測定値が更新されました」
* "New IP address on eth0: xxx.xxx.xxx.xxx"
* 「eth0の新しいIPアドレス：xxx.xxx.xxx.xxx」
This Information Model document does not detail the precise format of Logging Information since it is to a large extent protocol and MA specific. However, some common information can be identified.
この情報モデルのドキュメントは、大部分がプロトコルおよびMA固有であるため、ロギング情報の正確なフォーマットについては詳しく説明していません。ただし、いくつかの一般的な情報は識別できます。
object {
uuid ma-log-agent-id;
datetime ma-log-event-time;
int ma-log-code;
string ma-log-description;
} ma-log-obj;
The ma-log-obj models the generic aspects of a logging object and consists of the following elements:
ma-log-objは、ロギングオブジェクトの一般的な側面をモデル化し、次の要素で構成されています。
ma-log-agent-id: A uuid uniquely identifying the Measurement Agent.
ma-log-agent-id：測定エージェントを一意に識別するuuid。
ma-log-event-time: The date and time of the Event reported in the logging object.
ma-log-event-time：ロギングオブジェクトで報告されたイベントの日時。
ma-log-code: A machine-readable code describing the Event.
ma-log-code：イベントを説明する機械可読コード。
ma-log-description: A human-readable description of the Event.
ma-log-description：人間が読めるイベントの説明。
The MA will hold Capability Information that can be retrieved by a Controller. Capabilities include the device interface details available to Measurement Tasks as well as the set of Measurement Tasks/Roles (specified by registry entries) that are actually installed or available on the MA. Status Information includes the times that operations were last performed such as contacting the Controller or producing Reports.
MAは、コントローラーが取得できる機能情報を保持します。機能には、測定タスクで使用可能なデバイスインターフェイスの詳細、および実際にMAにインストールされているか、MAで使用可能な測定タスク/ロール（レジストリエントリで指定）のセットが含まれます。ステータス情報には、コントローラへの接続やレポートの作成など、操作が最後に実行された時間が含まれます。
object {
string ma-capability-hardware;
string ma-capability-firmware;
string ma-capability-version;
[string ma-capability-tags<0..*>;]
[ma-capability-task-obj ma-capability-tasks<0..*>;]
} ma-capability-obj;
The ma-capability-obj provides information about the Capabilities of the Measurement Agent and consists of the following elements:
ma-capability-objは、測定エージェントの機能に関する情報を提供し、次の要素で構成されます。
ma-capability-hardware: A description of the hardware of the device the Measurement Agent is running on.
ma-capability-hardware：Measurement Agentが実行されているデバイスのハードウェアの説明。
ma-capability-firmware: A description of the firmware of the device the Measurement Agent is running on.
ma-capability-firmware：Measurement Agentが実行されているデバイスのファームウェアの説明。
ma-capability-version: The version of the Measurement Agent.
ma-capability-version：測定エージェントのバージョン。
ma-capability-tags: An optional unordered set of tags that provide additional information about the Capabilities of the Measurement Agent.
ma-capability-tags：測定エージェントの機能に関する追加情報を提供するオプションの順序付けされていないタグのセット。
ma-capability-tasks: An optional unordered set of capability objects for each supported Task.
ma-capability-tasks：サポートされている各タスクのオプションの順序付けされていない機能オブジェクトのセット。
object {
string ma-capability-task-name;
ma-registry-obj ma-capability-task-functions<0..*>;
string ma-capability-task-version;
} ma-capability-task-obj;
The ma-capability-task-obj provides information about the capability of a Task and consists of the following elements:
ma-capability-task-objは、タスクの機能に関する情報を提供し、次の要素で構成されます。
ma-capability-task-name: A name uniquely identifying a Task.
ma-capability-task-name：タスクを一意に識別する名前。
ma-capability-task-functions: A possibly empty unordered set of registry entries identifying functions this Task implements.
ma-capability-task-functions：このタスクが実装する関数を識別する、おそらく空の順序付けされていないレジストリエントリのセット。
ma-capability-task-version: The version of the Measurement Task.
ma-capability-task-version：測定タスクのバージョン。
object {
uuid ma-status-agent-id;
[uri ma-status-device-id;]
datetime ma-status-last-started;
ma-status-interface-obj ma-status-interfaces<0..*>;
[ma-status-schedule-obj ma-status-schedules<0..*>;]
[ma-status-suppression-obj ma-status-suppressions<0..*>;]
} ma-status-obj;
The ma-status-obj provides Status Information about the Measurement Agent and consists of the following elements:
ma-status-objは、測定エージェントに関するステータス情報を提供し、次の要素で構成されます。
ma-status-agent-id: A uuid uniquely identifying the Measurement Agent.
ma-status-agent-id：測定エージェントを一意に識別するuuid。
ma-status-device-id: A URI identifying the device.
ma-status-device-id：デバイスを識別するURI。
ma-status-last-started: The date and time the Measurement Agent last started.
ma-status-last-started：測定エージェントが最後に開始された日時。
ma-status-interfaces: An unordered set of network interfaces available on the device.
ma-status-interfaces：デバイスで使用可能な、順序付けされていないネットワークインターフェイスのセット。
ma-status-schedules: An optional unordered set of status objects for each Schedule.
ma-status-schedules：各スケジュールのオプションの順序付けされていないステータスオブジェクトのセット。
ma-status-suppressions: An optional unordered set of status objects for each Suppression.
ma-status-suppressions：各抑制のオプションの順序付けされていないステータスオブジェクトのセット。
object {
string ma-status-schedule-name;
string ma-status-schedule-state;
int ma-status-schedule-storage;
counter ma-status-schedule-invocations;
counter ma-status-schedule-suppressions;
counter ma-status-schedule-overlaps;
counter ma-status-schedule-failures;
datetime ma-status-schedule-last-invocation;
[ma-status-action-obj ma-status-schedule-actions<0..*>;]
} ma-status-schedule-obj;
The ma-status-schedule-obj provides Status Information about the status of a Schedule and consists of the following elements:
ma-status-schedule-objは、スケジュールのステータスに関するステータス情報を提供し、次の要素で構成されます。
ma-status-schedule-name: The name of the Schedule this status object refers to.
ma-status-schedule-name：このステータスオブジェクトが参照するスケジュールの名前。
ma-status-schedule-state: The state of the Schedule. The value 'enabled' indicates that the Schedule is currently enabled. The value 'suppressed' indicates that the Schedule is currently suppressed. The value 'disabled' indicates that the Schedule is currently disabled. The value 'running' indicates that the Schedule is currently running.
ma-status-schedule-state：スケジュールの状態。値「有効」は、スケジュールが現在有効であることを示します。値「抑制」は、スケジュールが現在抑制されていることを示します。値「無効」は、スケジュールが現在無効であることを示します。値「running」は、スケジュールが現在実行されていることを示します。
ma-status-schedule-storage: The amount of secondary storage (e.g., allocated in a file system) holding temporary data allocated to the Schedule in bytes. This object reports the amount of allocated physical storage and not the storage used by logical data records. Data models should use a 64-bit integer type.
ma-status-schedule-storage：スケジュールに割り当てられた一時データをバイト単位で保持する（たとえば、ファイルシステムに割り当てられた）セカンダリストレージの量。このオブジェクトは、論理データレコードが使用するストレージではなく、割り当てられた物理ストレージの量を報告します。データモデルは64ビット整数型を使用する必要があります。
ma-status-schedule-invocations Number of invocations of this Schedule. This counter does not include suppressed invocations or invocations that were prevented due to an overlap with a previous invocation of this Schedule.
ma-status-schedule-invocationsこのスケジュールの呼び出しの数。このカウンターには、抑制された呼び出しや、このスケジュールの以前の呼び出しとの重複が原因で防止された呼び出しは含まれません。
ma-status-schedule-suppressions Number of suppressed executions of this Schedule.
ma-status-schedule-suppressionsこのスケジュールの抑制された実行の数。
ma-status-schedule-overlaps Number of executions prevented due to overlaps with a previous invocation of this Schedule.
ma-status-schedule-overlapsこのスケジュールの以前の呼び出しとの重複のために防止された実行の数。
ma-status-schedule-failures Number of failed executions of this Schedule. A failed execution is an execution where at least one Action failed.
ma-status-schedule-failuresこのスケジュールの失敗した実行の数。失敗した実行は、少なくとも1つのアクションが失敗した実行です。
ma-status-schedule-last-invocation: The date and time of the last invocation of this Schedule.
ma-status-schedule-last-invocation：このスケジュールが最後に呼び出された日時。
ma-status-schedule-actions: An optional ordered list of status objects for each Action of the Schedule.
ma-status-schedule-actions：スケジュールの各アクションのステータスオブジェクトのオプションの順序付きリスト。
object {
string ma-status-action-name;
string ma-status-action-state;
int ma-status-action-storage;
counter ma-status-action-invocations;
counter ma-status-action-suppressions;
counter ma-status-action-overlaps;
counter ma-status-action-failures;
datetime ma-status-action-last-invocation;
datetime ma-status-action-last-completion;
int ma-status-action-last-status;
string ma-status-action-last-message;
datetime ma-status-action-last-failed-completion;
int ma-status-action-last-failed-status;
string ma-status-action-last-failed-message;
} ma-status-action-obj;
The ma-status-action-obj provides Status Information about an Action of a Schedule and consists of the following elements:
ma-status-action-objは、スケジュールのアクションに関するステータス情報を提供し、次の要素で構成されます。
ma-status-action-name: The name of the Action of a Schedule this status object refers to.
ma-status-action-name：このステータスオブジェクトが参照するスケジュールのアクションの名前。
ma-status-action-state: The state of the Action. The value 'enabled' indicates that the Action is currently enabled. The value 'suppressed' indicates that the Action is currently suppressed. The value 'disabled' indicates that the Action is currently disabled. The value 'running' indicates that the Action is currently running.
ma-status-action-state：アクションの状態。値 'enabled'は、アクションが現在有効であることを示します。値 'suppressed'は、アクションが現在抑制されていることを示します。値「disabled」は、アクションが現在無効であることを示します。値「running」は、アクションが現在実行中であることを示します。
ma-status-action-storage: The amount of secondary storage (e.g., allocated in a file system) holding temporary data allocated to the Action in bytes. This object reports the amount of allocated physical storage and not the storage used by logical data records. Data models should use a 64-bit integer type.
ma-status-action-storage：アクションに割り当てられた一時データをバイト単位で保持する（たとえば、ファイルシステムに割り当てられた）二次ストレージの量。このオブジェクトは、論理データレコードが使用するストレージではなく、割り当てられた物理ストレージの量を報告します。データモデルは64ビット整数型を使用する必要があります。
ma-status-action-invocations Number of invocations of this Action. This counter does not include suppressed invocations or invocations that were prevented due to an overlap with a previous invocation of this Action.
ma-status-action-invocationsこのアクションの呼び出しの数。このカウンターには、抑制された呼び出しや、このアクションの以前の呼び出しとの重複が原因で防止された呼び出しは含まれません。
ma-status-action-suppressions Number of suppressed executions of this Action.
ma-status-action-suppressionsこのアクションの抑制された実行の数。
ma-status-action-overlaps Number of executions prevented due to overlaps with a previous invocation of this Action.
ma-status-action-overlapsこのアクションの以前の呼び出しとのオーバーラップのために防止された実行の数。
ma-status-action-failures Number of failed executions of this Action.
ma-status-action-failuresこのアクションの失敗した実行の数。
ma-status-action-last-invocation: The date and time of the last invocation of this Action.
ma-status-action-last-invocation：このアクションの最後の呼び出しの日時。
ma-status-action-last-completion: The date and time of the last completion of this Action.
ma-status-action-last-completion：このアクションが最後に完了した日時。
ma-status-action-last-status: The status code returned by the last execution of this Action.
ma-status-action-last-status：このアクションの最後の実行によって返されたステータスコード。
ma-status-action-last-message: The status message produced by the last execution of this Action.
ma-status-action-last-message：このアクションの最後の実行によって生成されたステータスメッセージ。
ma-status-action-last-failed-completion: The date and time of the last failed completion of this Action.
ma-status-action-last-failed-completion：このアクションが最後に失敗した完了の日時。
ma-status-action-last-failed-status: The status code returned by the last failed execution of this Action.
ma-status-action-last-failed-status：このアクションの最後の失敗した実行によって返されたステータスコード。
ma-status-action-last-failed-message: The status message produced by the last failed execution of this Action.
ma-status-action-last-failed-message：このアクションの最後の失敗した実行によって生成されたステータスメッセージ。
object {
string ma-status-suppression-name;
string ma-status-suppression-state;
} ma-status-suppression-obj;
The ma-status-suppression-obj provides Status Information about the status of a Suppression and consists of the following elements:
ma-status-suppression-objは、抑制のステータスに関するステータス情報を提供し、次の要素で構成されます。
ma-status-suppression-name: The name of the Suppression this status object refers to.
ma-status-suppression-name：このステータスオブジェクトが参照する抑制の名前。
ma-status-suppression-state: The state of the Suppression. The value 'enabled' indicates that the Suppression is currently enabled. The value 'active' indicates that the Suppression is currently active. The value 'disabled' indicates that the Suppression is currently disabled.
ma-status-suppression-state：抑制の状態。値「有効」は、抑制が現在有効であることを示します。値「アクティブ」は、抑制が現在アクティブであることを示します。値「disabled」は、抑制が現在無効になっていることを示します。
object {
string ma-status-interface-name;
string ma-status-interface-type;
[int ma-status-interface-speed;]
[string ma-status-interface-link-layer-address;]
[ip-address ma-status-interface-ip-addresses<0..*>;]
[ip-address ma-status-interface-gateways<0..*>;]
[ip-address ma-status-interface-dns-servers<0..*>;]
} ma-status-interface-obj;
The ma-status-interface-obj provides Status Information about network interfaces and consists of the following elements:
ma-status-interface-objは、ネットワークインターフェースに関するステータス情報を提供し、次の要素で構成されます。
ma-status-interface-name: A name uniquely identifying a network interface.
ma-status-interface-name：ネットワークインターフェイスを一意に識別する名前。
ma-status-interface-type: The type of the network interface.
ma-status-interface-type：ネットワークインターフェースのタイプ。
ma-status-interface-speed: An optional indication of the speed of the interface (measured in bits per second).
ma-status-interface-speed：インターフェースの速度のオプションの指標（ビット/秒で測定）。
ma-status-interface-link-layer-address: An optional link-layer address of the interface.
ma-status-interface-link-layer-address：インターフェースのオプションのリンク層アドレス。
ma-status-interface-ip-addresses: An optional ordered list of IP addresses assigned to the interface.
ma-status-interface-ip-addresses：インターフェースに割り当てられたIPアドレスのオプションの順序付きリスト。
ma-status-interface-gateways: An optional ordered list of gateways assigned to the interface.
ma-status-interface-gateways：インターフェースに割り当てられたゲートウェイのオプションの順序付きリスト。
ma-status-interface-dns-servers: An optional ordered list of DNS servers assigned to the interface.
ma-status-interface-dns-servers：インターフェースに割り当てられたDNSサーバーのオプションの順序付きリスト。
At a point in time specified by a Schedule, the MA will execute Tasks that communicate a set of measurement results to the Collector. These Reporting Tasks will be configured to transmit Task results over a specified Report Channel to a Collector.
スケジュールで指定された時点で、MAは一連の測定結果をコレクターに伝達するタスクを実行します。これらのレポートタスクは、指定されたレポートチャネルを介してコレクタにタスクの結果を送信するように構成されます。
It should be noted that the output from Tasks does not need to be sent to communication Channels. It can alternatively, or additionally, be sent to other Tasks on the MA. This facilitates using a first Measurement Task to control the operation of a later Measurement Task (such as first probing available line speed and then adjusting the operation of a video testing measurement) and also to allow local processing of data to output alarms (e.g., when performance drops from earlier levels). Of course, subsequent Tasks also include Tasks that implement the Reporting Protocol(s) and transfer data to one or more Collectors.
タスクからの出力を通信チャネルに送信する必要がないことに注意してください。代替的または追加的に、MAの他のタスクに送信できます。これにより、最初の測定タスクを使用して後の測定タスクの動作を制御し（最初に利用可能な回線速度をプローブしてからビデオテスト測定の動作を調整するなど）、データをローカルで処理してアラームを出力することができます（例：パフォーマンスは以前のレベルから低下します）。もちろん、後続のタスクには、レポートプロトコルを実装して1つ以上のコレクタにデータを転送するタスクも含まれます。
The Report generated by a Reporting Task is structured hierarchically to avoid repetition of report header and Measurement Task Configuration information. The report starts with the timestamp of the report generation on the MA and details about the MA including the optional Measurement Agent Identifier and Group-ID (controlled by the Configuration Information).
レポートタスクによって生成されたレポートは、レポートヘッダーと測定タスク構成情報の繰り返しを避けるために階層的に構造化されています。レポートは、MAでのレポート生成のタイムスタンプと、オプションのMeasurement Agent IdentifierおよびGroup-ID（構成情報によって制御される）を含むMAの詳細で始まります。
Much of the report information is optional and will depend on the implementation of the Reporting Task and any parameters defined in the Task Configuration for the Reporting Task. For example, some Reporting Tasks may choose not to include the Measurement Task Configuration or Action parameters, while others may do so dependent on the Controller setting a configurable parameter in the Task Configuration.
レポート情報の多くはオプションであり、レポートタスクの実装と、レポートタスクのタスク構成で定義されているパラメータに依存します。たとえば、一部のレポートタスクは、測定タスク構成またはアクションパラメータを含めないことを選択できますが、タスク構成で構成可能なパラメータを設定するコントローラに依存する場合もあります。
It is possible for a Reporting Task to send just the report header (datetime and optional Agent Identifier and/or Group-ID) if no measurement data is available. Whether to send such empty reports again is dependent on the implementation of the Reporting Task and potential Task Configuration parameter.
使用可能な測定データがない場合、レポートタスクはレポートヘッダー（日時およびオプションのエージェントIDやグループID）のみを送信できます。そのような空のレポートを再度送信するかどうかは、レポートタスクの実装と潜在的なタスク構成パラメーターによって異なります。
The handling of measurement data on the MA before generating a Report and transfer from the MA to the Collector is dependent on the implementation of the device, MA, and/or scheduled Tasks and not defined by the LMAP standards. Such decisions may include limits to the measurement data storage and what to do when such available storage becomes depleted. It is generally suggested that implementations running out of storage stop executing new Measurement Tasks and retain old measurement data.
レポートを生成してMAからコレクターに転送する前のMAの測定データの処理は、デバイス、MA、および/またはスケジュールされたタスクの実装に依存し、LMAP標準では定義されていません。そのような決定には、測定データストレージの制限、および使用可能なストレージが枯渇した場合の対処法が含まれる場合があります。ストレージが不足している実装では、新しい測定タスクの実行を停止し、古い測定データを保持することをお勧めします。
No context information, such as line speed or broadband product are included within the report header information as this data is reported by individual Tasks at the time they execute. Either a Measurement Task can report contextual parameters that are relevant to that particular measurement or specific Tasks can be used to gather a set of contextual and environmental data at certain times independent of the Reporting Schedule.
回線速度やブロードバンド製品などのコンテキスト情報は、レポートヘッダー情報に含まれません。このデータは、実行時に個々のタスクによって報告されるためです。測定タスクは、特定の測定に関連するコンテキストパラメータをレポートできます。または特定のタスクを使用して、レポートスケジュールとは関係なく、特定の時間にコンテキストデータと環境データのセットを収集できます。
After the report header information, the results are reported grouped according to different Measurement Task Configurations. Each Task section optionally starts with replicating the Measurement Task Configuration information before the result headers (titles for data columns) and the result data rows. The Options reported are those used for the scheduled execution of the Measurement Task and therefore include the Options specified in the Task Configuration as well as additional Options specified in the Action. The Action Options are appended to the Task Configuration Options in exactly the same order as they were provided to the Task during execution.
レポートヘッダー情報の後、結果はさまざまな測定タスク構成に従ってグループ化されて報告されます。各タスクセクションは、オプションで、結果ヘッダー（データ列のタイトル）と結果データ行の前に測定タスク構成情報を複製することから始まります。報告されるオプションは、測定タスクのスケジュールされた実行に使用されるオプションであるため、タスク構成で指定されたオプションと、アクションで指定された追加のオプションが含まれます。アクションオプションは、実行中にタスクに提供されたのとまったく同じ順序でタスク構成オプションに追加されます。
The result row data includes a time for the start of the measurement and optionally an end time where the duration also needs to be considered in the data analysis.
結果の行データには、測定の開始時刻と、オプションで終了時刻が含まれ、データ分析で期間も考慮する必要があります。
Some Measurement Tasks may optionally include an indication of the cross-traffic although the definition of cross-traffic is left up to each individual Measurement Task. Some Measurement Tasks may also output other environmental measures in addition to cross-traffic such as CPU utilization or interface speed.
一部の測定タスクには、必要に応じてクロストラフィックの表示を含めることができますが、クロストラフィックの定義は個々の測定タスクに任されています。一部の測定タスクは、CPU使用率やインターフェース速度などのクロストラフィックに加えて、他の環境測定も出力する場合があります。
Whereas the Configuration and Instruction Information represent information transmitted via the Control Protocol, the Report represents the information that is transmitted via the Report Protocol. It is constructed at the time of sending a report and represents the inherent structure of the information that is sent to the Collector.
構成および指示情報は、制御プロトコルを介して送信される情報を表しますが、レポートは、レポートプロトコルを介して送信される情報を表します。これは、レポートの送信時に作成され、コレクタに送信される情報の固有の構造を表します。
object {
datetime ma-report-date;
[uuid ma-report-agent-id;]
[string ma-report-group-id;]
[string ma-report-measurement-point;]
[ma-report-result-obj ma-report-results<0..*>;]
} ma-report-obj;
The ma-report-obj provides the metadata of a single report and consists of the following elements:
ma-report-objは単一のレポートのメタデータを提供し、次の要素で構成されます。
ma-report-date: The date and time when the report was sent to a Collector.
ma-report-date：レポートがコレクターに送信された日時。
ma-report-agent-id: An optional uuid uniquely identifying the Measurement Agent.
ma-report-agent-id：Measurement Agentを一意に識別するオプションのuuid。
ma-report-group-id: An optional identifier of the group of Measurement Agents this Measurement Agent belongs to.
ma-report-group-id：この測定エージェントが属する測定エージェントのグループのオプションの識別子。
ma-report-measurement-point: An optional identifier for the measurement point indicating where the Measurement Agent is located on a path (see [RFC7398] for further details).
ma-report-measurement-point：パス上のMeasurement Agentの場所を示す測定ポイントのオプションの識別子（詳細については、[RFC7398]を参照してください）。
ma-report-results: An optional and possibly empty unordered set of result objects.
ma-report-results：オプションの、場合によっては空の順序付けられていない結果オブジェクトのセット。
object {
string ma-report-result-schedule-name;
string ma-report-result-action-name;
string ma-report-result-task-name;
[ma-option-obj ma-report-result-options<0..*>;]
[string ma-report-result-tags<0..*>;]
datetime ma-report-result-event-time;
datetime ma-report-result-start-time;
[datetime ma-report-result-end-time;]
[string ma-report-result-cycle-number;]
int ma-report-result-status;
[ma-report-conflict-obj ma-report-result-conflicts<0..*>;]
[ma-report-table-obj ma-report-result-tables<0..*>;]
} ma-report-result-obj;
The ma-report-result-obj provides the metadata of a result report of a single executed Action. It consists of the following elements:
ma-report-result-objは、単一の実行されたアクションの結果レポートのメタデータを提供します。次の要素で構成されています。
ma-report-result-schedule-name: The name of the Schedule that produced the result.
ma-report-result-schedule-name：結果を生成したスケジュールの名前。
ma-report-result-action-name: The name of the Action in the Schedule that produced the result.
ma-report-result-action-name：結果を生成したスケジュール内のアクションの名前。
ma-report-result-task-name: The name of the Task that produced the result.
ma-report-result-task-name：結果を生成したタスクの名前。
ma-report-result-options: An optional ordered joined list of options provided by the Task object and the Action object when the Action was started.
ma-report-result-options：アクションが開始されたときにタスクオブジェクトとアクションオブジェクトによって提供されるオプションのオプションの順序付き結合リスト。
ma-report-result-tags: An optional unordered set of tags. This is the joined set of tags provided by the Task object, Action object, and Schedule object when the Action was started.
ma-report-result-tags：オプションの順序付けされていないタグのセット。これは、アクションが開始されたときにタスクオブジェクト、アクションオブジェクト、およびスケジュールオブジェクトによって提供される結合されたタグのセットです。
ma-report-result-event-time: The date and time of the Event that triggered the Schedule of the Action that produced the reported result values. The date and time does not include any added randomization.
ma-report-result-event-time：レポートされた結果値を生成したアクションのスケジュールをトリガーしたイベントの日時。日付と時刻には、追加のランダム化は含まれていません。
ma-report-result-start-time: The date and time of the start of the Action that produced the reported result values.
ma-report-result-start-time：レポートされた結果値を生成したアクションの開始日時。
ma-report-result-end-time: An optional date and time indicating when the Action finished.
ma-report-result-end-time：アクションがいつ終了したかを示すオプションの日時。
ma-report-result-cycle-number: An optional cycle number derived from ma-report-result-event-time. It is the time closest to ma-report-result-event-time that is a multiple of the ma-event-cycle-interval of the Event that triggered the execution of the Schedule. The value is only present in an ma-report-result-obj if the Event that triggered the execution of the Schedule has a defined ma-event-cycle-interval. The cycle number is represented in the format YYYYMMDD.HHMMSS where YYYY represents the year, MM the month (1..12), DD the day of the months (01..31), HH the hour (00..23), MM the minute (00..59), and SS the second (00..59). The cycle number is using Coordinated Universal Time (UTC).
ma-report-result-cycle-number：ma-report-result-event-timeから派生したオプションのサイクル番号。スケジュールの実行をトリガーしたイベントのma-event-cycle-intervalの倍数は、ma-report-result-event-timeに最も近い時間です。この値は、スケジュールの実行をトリガーしたイベントにma-event-cycle-intervalが定義されている場合にのみ、ma-report-result-objに存在します。サイクル番号は、YYYYMMDD.HHMMSSという形式で表されます。YYYYは年、MMは月（1..12）、DDは月の日（01..31）、HHは時間（00..23）を表します。 MM分（00..59）、SS秒（00..59）。サイクル数は協定世界時（UTC）を使用しています。
ma-report-result-status: The status code returned by the execution of the Action.
ma-report-result-status：アクションの実行によって返されるステータスコード。
ma-report-result-conflicts: A possibly empty set of conflict Actions that might have impacted the measurement results being reported.
ma-report-result-conflicts：報告される測定結果に影響を与えた可能性のある、空の一連の競合アクション。
ma-report-result-tables: An optional and possibly empty unordered set of result tables.
ma-report-result-tables：オプションの、場合によっては空の、順序付けられていない結果テーブルのセット。
object {
string ma-report-conflict-schedule-name;
string ma-report-conflict-action-name;
string ma-report-conflict-task-name;
} ma-report-conflict-obj;
The ma-report-conflict-obj provides the information about a conflicting Action that might have impacted the measurement results. It consists of the following elements:
ma-report-conflict-objは、測定結果に影響を与えた可能性がある競合するアクションに関する情報を提供します。次の要素で構成されています。
ma-report-result-schedule-name: The name of the Schedule that may have impacted the result.
ma-report-result-schedule-name：結果に影響を与えた可能性があるスケジュールの名前。
ma-report-result-action-name: The name of the Action in the Schedule that may have impacted the result.
ma-report-result-action-name：結果に影響を与えた可能性があるスケジュール内のアクションの名前。
ma-report-result-task-name: The name of the Task that may have impacted the result.
ma-report-result-task-name：結果に影響を与えた可能性のあるタスクの名前。
object {
[ma-registry-obj ma-report-table-functions<0..*>;]
[string] ma-report-table-column-labels<0..*>;]
[ma-report-row-obj ma-report-table-rows<0..*>;]
} ma-report-table-obj;
The ma-report-table-obj represents a result table and consists of the following elements:
ma-report-table-objは結果テーブルを表し、次の要素で構成されています。
ma-report-table-functions: An optional and possibly empty unordered set of registry entries identifying the functions for which results are reported.
ma-report-table-functions：結果が報告される関数を識別するオプションの、場合によっては空の順序付けされていないレジストリエントリのセット。
ma-report-table-column-labels: An optional and possibly empty ordered list of column labels.
ma-report-table-column-labels：列ラベルのオプションの、場合によっては空の順序付きリスト。
ma-report-table-rows: A possibly empty ordered list of result rows.
ma-report-table-rows：おそらく空の結果行の順序付きリスト。
object {
data ma-report-row-values<0..*>;
} ma-report-row-obj;
The ma-report-row-obj represents a result row and consists of the following elements:
ma-report-row-objは結果行を表し、次の要素で構成されています。
ma-report-row-values: A possibly empty ordered list of result values. When present, it contains an ordered list of values that align to the set of column labels for the report.
ma-report-row-values：結果値のおそらく空の順序付きリスト。存在する場合、レポートの列ラベルのセットに合わせて並べられた値のリストが含まれます。
A Schedule specifies the execution of a single or repeated series of Actions. An Action extends a configured Task with additional specific parameters. Each Schedule contains basically two elements: an ordered list of Actions to be executed and an Event object triggering the execution of the Schedule. The Schedule states what Actions to run (with what configuration) and when to run the Actions. A Schedule may optionally have an Event that stops the execution of the Schedule or a maximum duration after which a Schedule is stopped.
スケジュールは、単一または繰り返しの一連のアクションの実行を指定します。アクションは、追加の特定のパラメーターで構成済みタスクを拡張します。各スケジュールには基本的に2つの要素が含まれています。実行されるアクションの順序付きリストと、スケジュールの実行をトリガーするイベントオブジェクトです。スケジュールには、実行するアクション（構成）とアクションを実行するタイミングが記載されています。スケジュールには、オプションで、スケジュールの実行を停止するイベント、またはスケジュールが停止した後の最大期間を含めることができます。
Multiple Actions contained as an ordered list of a single Measurement Schedule will be executed according to the execution mode of the Schedule. In sequential mode, Actions will be executed sequentially and in parallel mode, all Actions will be executed concurrently. In pipelined mode, data produced by one Action is passed to the subsequent Action. Actions contained in different Schedules execute in parallel with such conflicts being reported in the Reporting Information where necessary. If two or more Schedules have the same start time, then the two will execute in parallel. There is no mechanism to prioritize one Schedule over another or to mutex scheduled Tasks.
単一の測定スケジュールの順序付きリストとして含まれる複数のアクションは、スケジュールの実行モードに従って実行されます。順次モードでは、アクションは順次実行され、並列モードでは、すべてのアクションが同時に実行されます。パイプラインモードでは、1つのアクションによって生成されたデータが後続のアクションに渡されます。異なるスケジュールに含まれるアクションは、必要に応じてレポート情報で報告されるそのような競合と並行して実行されます。 2つ以上のスケジュールが同じ開始時間を持っている場合、2つは並行して実行されます。あるスケジュールを別のスケジュールよりも優先したり、スケジュールされたタスクをミューテックスしたりするメカニズムはありません。
As well as specifying which Actions to execute, the Schedule also specifies how to link the data outputs from each Action to other Schedules. Specifying this within the Schedule allows the highest level of flexibility since it is even possible to send the output from different executions of the same Task Configuration to different destinations. A single Task producing multiple different outputs is expected to properly tag the different results. An Action receiving the output can then filter the results based on the tag if necessary. For example, a Measurement Task might report routine results to a data Reporting Task in a Schedule that communicates hourly via the broadband interface, but it also outputs emergency conditions via an alarm Reporting Task in a different Schedule communicating immediately over a General Packet Radio Service (GPRS) Channel. Note that Task-to-Task data transfer is always specified in association with the scheduled execution of the sending Task -- there is no need for a corresponding input specification for the receiving Task. While it is likely that an MA implementation will use a queue mechanism between the Schedules or Actions, this Information Model does not mandate or define a queue. The Information Model, however, reports the storage allocated to Schedules and Actions so that storage usage can be monitored. Furthermore, it is recommended that MA implementations by default retain old data and stop the execution of new Measurement Tasks if the MA runs out of storage capacity.
スケジュールでは、実行するアクションを指定するだけでなく、各アクションからのデータ出力を他のスケジュールにリンクする方法も指定します。これをスケジュール内で指定すると、同じタスク構成の異なる実行からの出力を別の宛先に送信することもできるため、最高レベルの柔軟性が得られます。複数の異なる出力を生成する単一のタスクは、異なる結果に適切にタグを付けることが期待されます。出力を受け取ったアクションは、必要に応じてタグに基づいて結果をフィルタリングできます。たとえば、測定タスクは、ブロードバンドインターフェースを介して1時間ごとに通信するスケジュールのデータレポートタスクにルーチンの結果を報告しますが、一般パケット無線サービス（ GPRS）チャネル。タスク間データ転送は常に、送信タスクのスケジュールされた実行に関連して指定されることに注意してください。受信タスクに対応する入力仕様は必要ありません。 MA実装はスケジュールまたはアクション間でキューメカニズムを使用する可能性が高いですが、この情報モデルはキューを強制または定義しません。ただし、情報モデルは、スケジュールとアクションに割り当てられたストレージを報告するため、ストレージの使用状況を監視できます。さらに、MAの実装がデフォルトで古いデータを保持し、MAのストレージ容量が不足した場合に新しい測定タスクの実行を停止することをお勧めします。
When specifying the Task to execute within the Schedule, i.e., creating an Action, it is possible to add to the Option parameters. This allows the Task Configuration to determine the common characteristics of a Task, while selected parameters (e.g., the test target URL) are defined within as Option parameters of the Action in the Schedule. A single Task's Configuration can even be used multiple times in the same Schedule with different additional parameters. This allows for efficiency in creating and transferring the Instruction. Note that the semantics of what happens if an Option is defined multiple times (in either the Task Configuration, the Action, or both) is not standardized and will depend upon the Task. For example, some Tasks may legitimately take multiple values for a single parameter.
スケジュール内で実行するタスクを指定するとき、つまりアクションを作成するときに、オプションパラメータに追加できます。これにより、タスク構成がタスクの共通の特性を決定できるようになりますが、選択されたパラメーター（たとえば、テストターゲットURL）は、スケジュール内のアクションのオプションパラメーターとして定義されます。単一のタスクの構成は、異なる追加パラメーターを使用して、同じスケジュールで複数回使用することもできます。これにより、命令の作成と転送が効率的になります。オプションが複数回（タスク構成、アクション、またはその両方で）定義された場合の動作のセマンティクスは標準化されておらず、タスクに依存することに注意してください。たとえば、一部のタスクでは、1つのパラメータに対して複数の値を合法的に取る場合があります。
Where Options are specified in both the Action and the Task Configuration, the Action Options are appended to those specified in the Task Configuration.
アクションとタスク構成の両方でオプションが指定されている場合、アクションオプションはタスク構成で指定されたオプションに追加されます。
Example: An Action of a Schedule references a single Measurement Task Configuration for measuring UDP latency. It specifies that results are to be sent to a Schedule with a Reporting Action. This Reporting Task of the Reporting Action is executed by a separate Schedule that specifies that it should run hourly at 5 minutes past the hour. When run, this Reporting Action takes the data generated by the UDP latency Measurement Task as well as any other data to be included in the hourly report and transfers it to the Collector over the Report Channel specified within its own Schedule.
例：スケジュールのアクションは、UDPレイテンシを測定するための単一の測定タスク構成を参照します。結果は、レポートアクションを含むスケジュールに送信されることを指定します。レポートアクションのこのレポートタスクは、毎時5分に実行するように指定する別のスケジュールによって実行されます。このレポートアクションを実行すると、UDPレイテンシ測定タスクによって生成されたデータと、時間別レポートに含まれるその他のデータが取得され、独自のスケジュール内で指定されたレポートチャネルを介してコレクタに転送されます。
Schedules and Actions may optionally also be given tags that are included in result reports sent to a Collector. In addition, Schedules can be given Suppression tags that may be used to select Schedules and Actions for Suppression.
スケジュールとアクションには、オプションで、コレクターに送信される結果レポートに含まれるタグを付けることもできます。さらに、スケジュールには、抑制のためのスケジュールとアクションを選択するために使用できる抑制タグを与えることができます。
object {
string ma-schedule-name;
ma-event-obj ma-schedule-start;
[ma-event-obj ma-schedule-end;]
[int ma-schedule-duration;]
ma-action-obj ma-schedule-actions<0..*>;
string ma-schedule-execution-mode;
[string ma-schedule-tags<0..*>;]
[string ma-schedule-suppression-tags<0..*>;]
} ma-schedule-obj;
The ma-schedule-obj is the main scheduling object. It consists of the following elements:
ma-schedule-objはメインのスケジューリングオブジェクトです。次の要素で構成されています。
ma-schedule-name: A name uniquely identifying a scheduling object.
ma-schedule-name：スケジューリングオブジェクトを一意に識別する名前。
ma-schedule-start: An Event object indicating when the Schedule starts.
ma-schedule-start：スケジュールがいつ開始するかを示すイベントオブジェクト。
ma-schedule-end: An optional Event object controlling the forceful termination of scheduled Actions. When the Event occurs, all Actions of the Schedule will be forced to terminate gracefully.
ma-schedule-end：スケジュールされたアクションの強制終了を制御するオプションのイベントオブジェクト。イベントが発生すると、スケジュールのすべてのアクションが強制終了されます。
ma-schedule-duration: An optional duration in seconds for the Schedule. All Actions of the Schedule will be forced to terminate gracefully after the duration number of seconds past the start of the Schedule.
ma-schedule-duration：スケジュールの秒単位のオプションの期間。スケジュールのすべてのアクションは、スケジュールの開始を過ぎてからの秒数が経過すると、正常に終了します。
ma-schedule-actions: A possibly empty ordered list of Actions to invoke when the Schedule starts.
ma-schedule-actions：スケジュールの開始時に呼び出すアクションの空の順序付きリスト。
ma-schedule-execution-mode: Indicates whether the Actions should be executed sequentially, in parallel, or in a pipelined mode (where data produced by one Action is passed to the subsequent Action). The default execution mode is pipelined.
ma-schedule-execution-mode：アクションを順次、並列、またはパイプラインモードで実行する必要があるかどうかを示します（1つのアクションによって生成されたデータが後続のアクションに渡される）。デフォルトの実行モードはパイプライン化されています。
ma-schedule-tags: An optional unordered set of tags that are reported together with the measurement results to a Collector.
ma-schedule-tags：測定結果とともにコレクターに報告される、オプションの順序付けされていないタグのセット。
ma-schedule-suppression-tags: An optional unordered set of Suppression tags that are used to select Schedules to be suppressed.
ma-schedule-suppression-tags：抑制されるスケジュールを選択するために使用される省略可能な順序付けられていない抑制タグのセット。
object {
string ma-action-name;
string ma-action-config-task-name;
[ma-option-obj ma-action-task-options<0..*>;]
[string ma-action-destinations<0..*>;]
[string ma-action-tags<0..*>;]
[string ma-action-suppression-tags<0..*>;]
} ma-action-obj;
The ma-action-obj models a Task together with its Schedule-specific Task Options and Destination Schedules. It consists of the following elements:
ma-action-objは、タスクをそのスケジュール固有のタスクオプションおよび宛先スケジュールとともにモデル化します。次の要素で構成されています。
ma-action-name: A name uniquely identifying an Action of a scheduling object.
ma-action-name：スケジューリングオブジェクトのアクションを一意に識別する名前。
ma-action-config-task-name: A name identifying the configured Task to be invoked by the Action.
ma-action-config-task-name：アクションによって呼び出される構成済みタスクを識別する名前。
ma-action-task-options: An optional and possibly empty ordered list of options (name-value pairs) that are passed to the Task by appending them to the options configured for the Task object.
ma-action-task-options：オプションで、場合によっては空の順序付けされたオプションのリスト（名前と値のペア）。これらは、タスクオブジェクトに構成されたオプションに追加することによってタスクに渡されます。
ma-action-destinations: An optional and possibly empty unordered set of names of Destination Schedules that consume output produced by this Action.
ma-action-destinations：このアクションによって生成された出力を使用する宛先スケジュールのオプションの、場合によっては空の順序なしの名前のセット。
ma-action-tags: An optional unordered set of tags that are reported together with the measurement results to a Collector.
ma-action-tags：測定結果とともにコレクターに報告される、オプションの順序付けされていないタグのセット。
ma-action-suppression-tags: An optional unordered set of Suppression tags that are used to select Actions to be suppressed.
ma-action-suppression-tags：抑制されるアクションを選択するために使用される省略可能な順序付けられていない抑制タグのセット。
A Channel defines a bidirectional communication mechanism between the MA and a Controller or Collector. Multiple Channels can be defined to enable results to be split or duplicated across different Collectors.
チャネルは、MAとコントローラーまたはコレクター間の双方向通信メカニズムを定義します。複数のチャネルを定義して、結果を異なるコレクタ間で分割または複製できます。
Each Channel contains the details of the remote endpoint (including location and security credential information such as a certificate). The timing of when to communicate over a Channel is specified by the Schedule, which executes the corresponding Control or Reporting Task. The certificate can be the digital certificate associated to the Fully Qualified Domain Name (FQDN) in the URL, or it can be the certificate of the Certification Authority that was used to issue the certificate for the FQDN of the target URL (which will be retrieved later on using a communication protocol such as Transport Layer Security (TLS)). In order to establish a secure Channel, the MA will use its own security credentials (in the Configuration Information) and the given credentials for the individual Channel endpoint.
各チャネルには、リモートエンドポイントの詳細（場所など、証明書などのセキュリティ資格情報が含まれます）が含まれています。チャネルを介して通信するタイミングのタイミングは、対応する制御またはレポートタスクを実行するスケジュールによって指定されます。証明書は、URLの完全修飾ドメイン名（FQDN）に関連付けられたデジタル証明書にすることも、ターゲットURLのFQDN（取得される）の証明書を発行するために使用された認証局の証明書にすることもできます。後でトランスポート層セキュリティ（TLS）などの通信プロトコルを使用します。安全なチャネルを確立するために、MAは独自のセキュリティ資格情報（構成情報内）と、個々のチャネルエンドポイントに与えられた資格情報を使用します。
As with the Task Configurations, each Channel is also given a text name by which it can be referenced as a Task Option.
タスク構成と同様に、各チャネルには、タスクオプションとして参照できるテキスト名も付けられます。
Although the same in terms of information, Channels used for communication with the Controller are referred to as Control Channels whereas Channels to Collectors are referred to as Report Channels. Hence, Control Channels will be referenced from Control Tasks executed by a Control Schedule, whereas Report Channels will be referenced from within Reporting Tasks executed by an Instruction Schedule.
情報に関しては同じですが、コントローラーとの通信に使用されるチャネルは制御チャネルと呼ばれ、コレクターへのチャネルはレポートチャネルと呼ばれます。したがって、制御チャネルは、制御スケジュールによって実行される制御タスクから参照されますが、レポートチャネルは、命令スケジュールによって実行されるレポートタスク内から参照されます。
Multiple interfaces are also supported. For example, the Reporting Task could be configured to send some results over GPRS. This is especially useful when such results indicate the loss of connectivity on a different network interface.
複数のインターフェースもサポートされています。たとえば、GPRSを介して一部の結果を送信するようにレポートタスクを構成できます。これは、このような結果が別のネットワークインターフェイスでの接続の喪失を示している場合に特に役立ちます。
Example: A Channel used for reporting results may specify that results are to be sent to the URL (https://collector.example.org/ report/), using the appropriate digital certificate to establish a secure Channel.
例：結果の報告に使用されるチャネルは、適切なデジタル証明書を使用して安全なチャネルを確立し、結果がURL（https://collector.example.org/ report /）に送信されるように指定できます。
object {
string ma-channel-name;
url ma-channel-target;
credentials ma-channel-credentials;
[string ma-channel-interface-name;]
} ma-channel-obj;
The ma-channel-obj consists of the following elements:
ma-channel-objは、次の要素で構成されています。
ma-channel-name: A unique name identifying the Channel object.
ma-channel-name：Channelオブジェクトを識別する一意の名前。
ma-channel-target: A URL identifying the target Channel endpoint.
ma-channel-target：ターゲットチャネルエンドポイントを識別するURL。
ma-channel-credentials: The security credentials needed to establish a secure Channel.
ma-channel-credentials：安全なチャネルを確立するために必要なセキュリティ資格情報。
ma-channel-interface-name: An optional name of the network interface to be used. If not present, the IP protocol stack will select a suitable interface.
ma-channel-interface-name：使用するネットワークインターフェイスのオプションの名前。存在しない場合、IPプロトコルスタックは適切なインターフェイスを選択します。
Conceptually, each Task Configuration defines the parameters of a Task that the MA may perform at some point in time. It does not by itself actually instruct the MA to perform them at any particular time (this is done by a Schedule). Tasks can be Measurement Tasks (i.e., those Tasks actually performing some type of passive or active measurement) or any other scheduled activity performed by the MA such as transferring information to or from the Controller and Collectors. Other examples of Tasks may include data manipulation or processing Tasks conducted on the MA.
概念的には、各タスク構成は、MAがある時点で実行できるタスクのパラメーターを定義します。それ自体が実際にMAに特定の時間にそれらを実行するように指示することはありません（これはスケジュールによって行われます）。タスクは、測定タスク（つまり、実際に何らかのパッシブまたはアクティブ測定を実行するタスク）や、コントローラーやコレクターとの間で情報を転送するなど、MAによって実行されるその他のスケジュールされたアクティビティです。タスクの他の例には、MAで実行されるデータ操作または処理タスクが含まれます。
A Measurement Task Configuration is the same in information terms to any other Task Configuration. Both Measurement and non-Measurement Tasks may have registry entries to enable the MA to uniquely identify the Task it should execute and retrieve the schema for any parameters that may be passed to the Task. Registry entries are specified as a URI and can therefore be used to identify the Task within a namespace or point to a web or local file location for the Task information. As mentioned previously, these URIs may be used to identify the Measurement Task in a public namespace such as the to-be-created IPPM registry described in [IPPM-REG].
測定タスク構成は、情報に関して他のすべてのタスク構成と同じです。測定タスクと非測定タスクの両方にレジストリエントリがあり、MAが実行するタスクを一意に識別し、タスクに渡される可能性のあるパラメータのスキーマを取得できるようにすることができます。レジストリエントリはURIとして指定されるため、名前空間内のタスクを識別したり、タスク情報のWebまたはローカルファイルの場所を指定したりするために使用できます。前述のように、これらのURIは、[IPPM-REG]で説明されている、作成されるIPPMレジストリなどのパブリック名前空間で測定タスクを識別するために使用できます。
Example: A Measurement Task Configuration may configure a single Measurement Task for measuring UDP latency. The Measurement Task Configuration could define the destination port and address for the measurement as well as the duration, internal packet timing strategy, and other parameters (for example, a stream for one hour and sending one packet every 500 ms). It may also define the output type and possible parameters (for example, the output type can be the 95th percentile mean) where the Measurement Task accepts such parameters. It does not define when the Task starts (this is defined by the Schedule element), so it does not by itself instruct the MA to actually perform this Measurement Task.
例：測定タスク構成では、UDPレイテンシを測定するための単一の測定タスクを構成できます。 Measurement Task Configurationは、測定の宛先ポートとアドレス、および期間、内部パケットタイミング戦略、およびその他のパラメーター（たとえば、1時間のストリームと500ミリ秒ごとに1つのパケットを送信する）を定義できます。また、測定タスクがそのようなパラメーターを受け入れる出力タイプと可能なパラメーターを定義することもできます（たとえば、出力タイプは95パーセンタイル平均にすることができます）。タスクがいつ開始するかは定義されていません（これは、Schedule要素によって定義されます）。したがって、MAが実際にこの測定タスクを実行するように指示することはありません。
The Task Configuration will include a local short name for reference by a Schedule. Task Configurations may also refer to registry entries as described above. In addition, the Task can be configured through a set of configuration Options. The nature and number of these Options will depend upon the Task. These Options are expressed as name-value pairs, although the 'value' may be a structured object instead of a simple string or numeric value. The implementation of these name-value pairs will vary between data models.
タスク構成には、スケジュールで参照するためのローカルの短い名前が含まれます。上記のように、タスク構成はレジストリエントリを参照する場合もあります。さらに、一連の構成オプションを使用してタスクを構成できます。これらのオプションの性質と数はタスクによって異なります。これらのオプションは名前と値のペアとして表されますが、「値」は単純な文字列や数値ではなく構造化オブジェクトの場合があります。これらの名前と値のペアの実装は、データモデルによって異なります。
An Option that must be present for Reporting Tasks is the Channel reference specifying how to communicate with a Collector. This is included in the Task Options and will have a value that matches a Channel name that has been defined in the Instruction. Similarly, Control Tasks will have a similar Option with the value set to a specified Control Channel.
レポートタスクに必要なオプションは、コレクターとの通信方法を指定するチャネル参照です。これはタスクオプションに含まれ、指示で定義されたチャネル名と一致する値を持ちます。同様に、制御タスクには、指定された制御チャネルに値が設定された同様のオプションがあります。
A Reporting Task might also have a flag parameter, defined as an Option, to indicate whether to send a report without measurement results if there is no measurement result data pending to be transferred to the Collector. In addition, many Tasks will receive (as a parameter) information about which interface to use.
レポートタスクには、オプションとして定義されたフラグパラメータがあり、コレクタへの転送が保留されている測定結果データがない場合に、測定結果なしでレポートを送信するかどうかを示します。さらに、多くのタスクは、使用するインターフェースに関する情報を（パラメーターとして）受け取ります。
In addition, the Task Configuration may optionally also be given tags that can carry a Measurement Cycle ID. The purpose of this ID is to easily identify a set of measurement results that have been produced by Measurement Tasks with comparable Options. This ID could be manually incremented or otherwise changed when an Option change is implemented, which could mean that two sets of results should not be directly compared.
さらに、タスク構成にはオプションで、測定サイクルIDを保持できるタグを付けることもできます。このIDの目的は、同等のオプションを持つ測定タスクによって生成された測定結果のセットを簡単に識別することです。このIDは、オプションの変更が実装されたときに、手動でインクリメントするか、別の方法で変更することができます。つまり、2つの結果セットを直接比較してはなりません。
object {
string ma-task-name;
ma-registry-obj ma-task-functions<0..*>;
[ma-option-obj ma-task-options<0..*>;]
[string ma-task-tags<0..*>;]
} ma-task-obj;
The ma-task-obj defines a configured Task that can be invoked as part of an Action. A configured Task can be referenced by its name, and it contains a possibly empty set of URIs to link to registry entries. Options allow the configuration of Task parameters (in the form of name-value pairs). The ma-task-obj consists of the following elements:
ma-task-objは、アクションの一部として呼び出すことができる構成済みタスクを定義します。構成されたタスクはその名前で参照でき、レジストリエントリにリンクするための空のURIセットが含まれている可能性があります。オプションでは、タスクのパラメーターを（名前と値のペアの形式で）構成できます。 ma-task-objは、次の要素で構成されています。
ma-task-name: A name uniquely identifying a configured Task object.
ma-task-name：構成されたタスクオブジェクトを一意に識別する名前。
ma-task-functions: A possibly empty unordered set of registry entries identifying the functions of the configured Task.
ma-task-functions：構成されたタスクの機能を識別する、おそらく空の順序付けされていないレジストリエントリのセット。
ma-task-options: An optional and possibly empty ordered list of options (name-value pairs) that are passed to the configured Task.
ma-task-options：構成されたタスクに渡されるオプション（名前と値のペア）のオプションの、場合によっては空の順序付きリスト。
ma-task-tags: An optional unordered set of tags that are reported together with the measurement results to a Collector.
ma-task-tags：測定結果とともにコレクターに報告される、オプションの順序付けされていないタグのセット。
object {
string ma-option-name;
[object ma-option-value;]
} ma-option-obj;
The ma-option-obj models a name-value pair and consists of the following elements:
ma-option-objは名前と値のペアをモデル化し、次の要素で構成されています。
ma-option-name: The name of the option.
ma-option-name：オプションの名前。
ma-option-value: The optional value of the option.
ma-option-value：オプションのオプションの値。
The ma-option-obj is used to define Task Configuration Options. Task Configuration Options are generally Task specific. For Tasks associated with an entry in a registry, the registry may define well- known option names (e.g., the so-called parameters in the to-be-created IPPM metric registry described in [IPPM-REG]). Control and Reporting Tasks need to know the Channel they are going to use. The common option name for specifying the Channel is "channel" where the option's value refers to the name of an ma-channel-obj.
ma-option-objは、タスク構成オプションを定義するために使用されます。タスク構成オプションは通常、タスク固有です。レジストリのエントリに関連付けられたタスクの場合、レジストリは既知のオプション名を定義する場合があります（たとえば、[IPPM-REG]で説明される、作成されるIPPMメトリックレジストリのいわゆるパラメータ）。制御タスクとレポートタスクは、使用するチャネルを知る必要があります。チャネルを指定するための一般的なオプション名は「チャネル」で、オプションの値はma-channel-objの名前を指します。
Tasks and Actions can be associated with entries in a registry. A registry object refers to an entry in a registry (identified by a URI), and it may define a set of roles.
タスクとアクションは、レジストリのエントリに関連付けることができます。レジストリオブジェクトは、（URIで識別される）レジストリ内のエントリを参照し、一連のロールを定義する場合があります。
object {
uri ma-registry-uri;
[string ma-registry-role<0..*>;]
} ma-registry-obj;
The ma-registry-obj refers to an entry of a registry, and it defines the associated role(s). The ma-registry-obj consists of the following elements:
ma-registry-objはレジストリーのエントリーを参照し、関連する役割を定義します。 ma-registry-objは、次の要素で構成されています。
ma-registry-uri: A URI identifying an entry in a registry.
ma-registry-uri：レジストリのエントリを識別するURI。
ma-registry-role: An optional and possibly empty unordered set of roles for the identified registry entry.
ma-registry-role：識別されたレジストリエントリのオプションの、場合によっては空の順序付けされていないロールのセット。
The Event information object used throughout the Information Models can initially take one of several different forms. Additional forms may be defined later in order to bind the execution of Schedules to additional Events. The initially defined Event forms are:
情報モデル全体で使用されるイベント情報オブジェクトは、最初はいくつかの異なる形式の1つを取ることができます。スケジュールの実行を追加のイベントにバインドするために、後で追加のフォームを定義できます。最初に定義されたイベントフォームは次のとおりです。
1. Periodic Timing: Emits multiple Events periodically according to an interval time defined in seconds
1. 定期的なタイミング：秒単位で定義された間隔時間に従って定期的に複数のイベントを発行します
2. Calendar Timing: Emits multiple Events according to a calendar-based pattern, e.g., 22 minutes past each hour of the day on weekdays
2. カレンダーのタイミング：カレンダーベースのパターンに従って複数のイベントを発生させます（例：平日の1時間の22分後）
3. One-Off Timing: Emits one Event at a specific date and time
3. 1回限りのタイミング：特定の日時に1つのイベントを発行します
4. Immediate: Emits one Event as soon as possible 5. Startup: Emits an Event whenever the MA is started (e.g., at device startup)
4.即時：できるだけ早く1つのイベントを発行します。5.スタートアップ：MAが開始されるたびに（たとえば、デバイスのスタートアップ時に）イベントを発行します。
6. Controller Lost: Emits an Event when connectivity to the Controller has been lost
6. Controller Lost：コントローラーへの接続が失われたときにイベントを発生させます
7. Controller Connected: Emits an Event when connectivity to the Controller has been established or re-established
7. Controller Connected：コントローラーへの接続が確立または再確立されたときにイベントを発行します
Optionally, each of the Event options may also specify a randomness that should be evaluated and applied separately to each indicated Event. This randomness parameter defines a uniform interval in seconds over which the start of the Task is delayed from the starting times specified by the Event object.
オプションで、各イベントオプションは、評価され、示された各イベントに個別に適用されるランダム性も指定できます。このランダム性パラメーターは、タスクの開始がイベントオブジェクトで指定された開始時間から遅延する一定の間隔を秒単位で定義します。
Both the periodic and calendar timing objects allow for a series of Actions to be executed. While both have an optional end time, it is best practice to always configure an end time and refresh the information periodically to ensure that lost MAs do not continue their Tasks forever.
定期的オブジェクトとカレンダータイミングオブジェクトの両方で、一連のアクションを実行できます。どちらにもオプションの終了時間がありますが、失われたMAがタスクを永久に継続しないように、常に終了時間を構成し、情報を定期的に更新することをお勧めします。
Startup Events are only created on device startup, not when a new Instruction is transferred to the MA. If scheduled Task execution is desired both on the transfer of the Instruction and on device restart, then both the Immediate and Startup timing needs to be used in conjunction.
起動イベントはデバイスの起動時にのみ作成され、新しい命令がMAに転送されたときは作成されません。命令の転送とデバイスの再起動の両方でスケジュールされたタスクの実行が必要な場合は、即時と起動の両方のタイミングを組み合わせて使用する必要があります。
The datetime format used for all elements in the Information Model MUST conform to RFC 3339 [RFC3339].
情報モデルのすべての要素に使用される日時形式は、RFC 3339 [RFC3339]に準拠する必要があります。
object {
string ma-event-name;
union {
ma-periodic-obj ma-event-periodic;
ma-calendar-obj ma-event-calendar;
ma-one-off-obj ma-event-one-off;
ma-immediate-obj ma-event-immediate;
ma-startup-obj ma-event-startup;
ma-controller-lost-obj ma-event-controller-lost;
ma-controller-connected-obj ma-event-controller-connected;
}
[int ma-event-random-spread;]
[int ma-event-cycle-interval;]
} ma-event-obj;
The ma-event-obj is the main Event object. Event objects are identified by a name. A generic Event object itself contains a more specific Event object. The set of specific Event objects should be extensible. The initial set of specific Event objects is further described below. The ma-event-obj also includes an optional uniform random spread that can be used to randomize the start times of Schedules triggered by an Event. The ma-event-obj consists of the following elements:
ma-event-objはメインのEventオブジェクトです。イベントオブジェクトは名前で識別されます。一般的なEventオブジェクト自体には、より具体的なEventオブジェクトが含まれています。特定のイベントオブジェクトのセットは拡張可能である必要があります。特定のイベントオブジェクトの初期セットについては、以下でさらに説明します。 ma-event-objには、イベントによってトリガーされるスケジュールの開始時間をランダム化するために使用できるオプションの均一ランダム拡散も含まれています。 ma-event-objは、次の要素で構成されています。
ma-event-name: The name uniquely identifies an Event object. Schedules refer to Event objects by this name.
ma-event-name：名前は、Eventオブジェクトを一意に識別します。スケジュールは、この名前でイベントオブジェクトを参照します。
ma-event-periodic: The ma-event-periodic is present for periodic timing objects.
ma-event-periodic：ma-event-periodicは、定期的なタイミングオブジェクトに存在します。
ma-event-calendar: The ma-event-calendar is present for calendar timing objects.
ma-event-calendar：ma-event-calendarは、カレンダータイミングオブジェクトに存在します。
ma-event-one-off: The ma-event-one-off is present for one-off timing objects.
ma-event-one-off：ma-event-one-offは、1回限りのタイミングオブジェクトに存在します。
ma-event-immediate: The ma-event-immediate is present for immediate Event objects.
ma-event-immediate：ma-event-immediateは、即時イベントオブジェクトに存在します。
ma-event-startup: The ma-event-startup is present for startup Event objects.
ma-event-startup：ma-event-startupは、起動イベントオブジェクトに存在します。
ma-event-controller-lost: The ma-event-controller-lost is present for connectivity to Controller lost Event objects.
ma-event-controller-lost：ma-event-controller-lostは、コントローラーの失われたイベントオブジェクトへの接続のために存在します。
ma-event-controller-connected: The ma-event-controller-connected is present for connectivity to Controller established Event objects.
ma-event-controller-connected：ma-event-controller-connectedは、コントローラーが確立したイベントオブジェクトへの接続のために存在します。
ma-event-random-spread: The optional ma-event-random-spread adds a random delay defined in seconds to the Event object. No random delay is added if ma-event-random-spread does not exist.
ma-event-random-spread：オプションのma-event-random-spreadは、秒単位で定義されたランダムな遅延をEventオブジェクトに追加します。 ma-event-random-spreadが存在しない場合、ランダム遅延は追加されません。
ma-event-cycle-interval: The optional ma-event-cycle-interval defines the duration of the time interval in seconds that is used to calculate cycle numbers. No cycle number is calculated if ma-event-cycle-interval does not exist.
ma-event-cycle-interval：オプションのma-event-cycle-intervalは、サイクル数の計算に使用される時間間隔を秒単位で定義します。 ma-event-cycle-intervalが存在しない場合、サイクル番号は計算されません。
object {
[datetime ma-periodic-start;]
[datetime ma-periodic-end;]
int ma-periodic-interval;
} ma-periodic-obj;
The ma-periodic-obj timing object has an optional start and an optional end time plus a periodic interval. Schedules using an ma-periodic-obj are started periodically between the start and end time. The ma-periodic-obj consists of the following elements:
ma-periodic-objタイミングオブジェクトには、オプションの開始時刻と終了時刻、および定期的な間隔があります。 ma-periodic-objを使用するスケジュールは、開始時刻と終了時刻の間で定期的に開始されます。 ma-periodic-objは、次の要素で構成されています。
ma-periodic-start: The optional date and time at which Schedules using this object are first started. If not present, it defaults to immediate.
ma-periodic-start：このオブジェクトを使用するスケジュールが最初に開始されるオプションの日時。存在しない場合、デフォルトは即時です。
ma-periodic-end: The optional date and time at which Schedules using this object are last started. If not present, it defaults to indefinite.
ma-periodic-end：このオブジェクトを使用するスケジュールが最後に開始されたオプションの日時。存在しない場合は、デフォルトで無期限になります。
ma-periodic-interval: The interval defines the time in seconds between two consecutive starts of Tasks.
ma-periodic-interval：間隔は、タスクの2つの連続した開始間の時間を秒単位で定義します。
Calendar timing supports the routine execution of Schedules at specific times and/or on specific dates. It can support more flexible timing than periodic timing since the execution of Schedules does not have to be uniformly spaced. For example, a calendar timing could support the execution of a Measurement Task every hour between 6 pm and midnight on weekdays only.
カレンダーのタイミングは、特定の時間または特定の日付、あるいはその両方でのスケジュールの定期的な実行をサポートします。スケジュールの実行間隔を均一にする必要がないため、定期的なタイミングよりも柔軟なタイミングをサポートできます。たとえば、カレンダーのタイミングでは、平日の午後6時から深夜までの1時間ごとに測定タスクの実行をサポートできます。
Calendar timing is also required to perform measurements at meaningful times in relation to network usage (e.g., at peak times). If the optional time zone offset is not supplied, then local system time is assumed. This is essential in some use cases to ensure consistent peak-time measurements as well as supporting MA devices that may be in an unknown time zone or to roam between different time zones (but know their own time zone information such as through the mobile network).
カレンダーのタイミングは、ネットワークの使用状況に関連する有意な時間（ピーク時など）に測定を実行するためにも必要です。オプションのタイムゾーンオフセットが指定されていない場合は、ローカルシステム時刻と見なされます。これは、一貫したピーク時間測定を保証し、不明なタイムゾーンにあるMAデバイスをサポートするため、または異なるタイムゾーン間をローミングするために、一部のユースケースで不可欠です（ただし、モバイルネットワークなどの独自のタイムゾーン情報を知っています）。 。
The calendar elements within the calendar timing do not have defaults in order to avoid accidental high-frequency execution of Tasks. If all possible values for an element are desired, then the wildcard * is used.
タスクの偶発的な高頻度実行を回避するために、カレンダータイミング内のカレンダー要素にはデフォルトがありません。要素のすべての可能な値が必要な場合は、ワイルドカード*が使用されます。
object {
[datetime ma-calendar-start;]
[datetime ma-calendar-end;]
[string ma-calendar-months<0..*>;]
[string ma-calendar-days-of-week<0..*>;]
[string ma-calendar-days-of-month<0..*>;]
[string ma-calendar-hours<0..*>;]
[string ma-calendar-minutes<0..*>;]
[string ma-calendar-seconds<0..*>;]
[int ma-calendar-timezone-offset;]
} ma-calendar-obj;
ma-calendar-start: The optional date and time at which Schedules using this object are first started. If not present, it defaults to immediate.
ma-calendar-start：このオブジェクトを使用するスケジュールが最初に開始されるオプションの日時。存在しない場合、デフォルトは即時です。
ma-calendar-end: The optional date and time at which Schedules using this object are last started. If not present, it defaults to indefinite.
ma-calendar-end：このオブジェクトを使用するスケジュールが最後に開始されたオプションの日時。存在しない場合は、デフォルトで無期限になります。
ma-calendar-months: The optional set of months (1-12) on which Tasks scheduled using this object are started. The wildcard * means all months. If not present, it defaults to no months.
ma-calendar-months：このオブジェクトを使用してスケジュールされたタスクが開始されるオプションの月のセット（1〜12）。ワイルドカード*はすべての月を意味します。存在しない場合、デフォルトで月はありません。
ma-calendar-days-of-week: The optional set of days of a week ("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun") on which Tasks scheduled using this object are started. The wildcard * means all days of the week. If not present, it defaults to no days.
ma-calendar-days-of-week：オプションの曜日のセット（「Mon」、「Tue」、「Wed」、「Thu」、「Fri」、「Sat」、「Sun」）。このオブジェクトを使用してスケジュールされたものが開始されます。ワイルドカード*は、すべての曜日を意味します。存在しない場合は、デフォルトで曜日なしになります。
ma-calendar-days-of-month: The optional set of days of a month (1-31) on which Tasks scheduled using this object are started. The wildcard * means all days of a month. If not present, it defaults to no days.
ma-calendar-days-of-month：このオブジェクトを使用してスケジュールされたタスクが開始されるオプションの月の日（1〜31）。ワイルドカード*は、月のすべての日を意味します。存在しない場合は、デフォルトで曜日なしになります。
ma-calendar-hours: The optional set of hours (0-23) on which Tasks scheduled using this object are started. The wildcard * means all hours of a day. If not present, it defaults to no hours.
ma-calendar-hours：このオブジェクトを使用してスケジュールされたタスクが開始されるオプションの時間セット（0〜23）。ワイルドカード*は、1日のすべての時間を意味します。存在しない場合、デフォルトで時間なしになります。
ma-calendar-minutes: The optional set of minutes (0-59) on which Tasks scheduled using this object are started. The wildcard * means all minutes of an hour. If not present, it defaults to no minutes.
ma-calendar-minutes：このオブジェクトを使用してスケジュールされたタスクが開始されるオプションの分（0〜59）。ワイルドカード*は、1時間のすべての分を意味します。存在しない場合、デフォルトで分はありません。
ma-calendar-seconds: The optional set of seconds (0-59) on which Tasks scheduled using this object are started. The wildcard * means all seconds of an hour. If not present, it defaults to no seconds.
ma-calendar-seconds：このオブジェクトを使用してスケジュールされたタスクが開始されるオプションの秒のセット（0〜59）。ワイルドカード*は、1時間のすべての秒を意味します。存在しない場合、デフォルトでno秒になります。
ma-calendar-timezone-offset: The optional time zone offset in minutes. If not present, it defaults to the system's local time zone.
ma-calendar-timezone-offset：オプションの時間帯オフセット（分単位）。存在しない場合、デフォルトでシステムのローカルタイムゾーンになります。
If a day of the month is specified that does not exist in the month (e.g., the 29th of February), then those values are ignored.
その月に存在しない日が指定されている場合（2月29日など）、これらの値は無視されます。
object {
datetime ma-one-off-time;
} ma-one-off-obj;
The ma-one-off-obj timing object specifies a fixed point in time. Schedules using an ma-one-off-obj are started once at the specified date and time. The ma-one-off-obj consists of the following elements:
ma-one-off-objタイミングオブジェクトは、固定時点を指定します。 ma-one-off-objを使用するスケジュールは、指定された日時に一度開始されます。 ma-one-off-objは、次の要素で構成されています。
ma-one-off-time: The date and time at which Schedules using this object are started.
ma-one-off-time：このオブジェクトを使用するスケジュールが開始される日時。
object {
// empty
} ma-immediate-obj;
The ma-immediate-obj Event object has no further information elements. Schedules using an ma-immediate-obj are started as soon as possible.
ma-immediate-objイベントオブジェクトには、これ以上の情報要素はありません。 ma-immediate-objを使用したスケジュールは、できるだけ早く開始されます。
object {
// empty
} ma-startup-obj;
The ma-startup-obj Event object has no further information elements. Schedules or Suppressions using an ma-startup-obj are started at MA initialization time.
ma-startup-objイベントオブジェクトには、これ以上の情報要素はありません。 ma-startup-objを使用したスケジュールまたは抑制は、MAの初期化時に開始されます。
object {
// empty
} ma-controller-lost-obj;
The ma-controller-lost-obj Event object has no further information elements. The ma-controller-lost-obj indicates that connectivity to the Controller has been lost. This is determined by a timer started after each successful contact with a Controller. When the timer reaches the controller-timeout (measured in seconds), a ma-controller-lost-obj Event is generated. This Event may be used to start a Suppression.
ma-controller-lost-objイベントオブジェクトには、それ以上の情報要素はありません。 ma-controller-lost-objは、コントローラーへの接続が失われたことを示します。これは、コントローラーとの接続が成功するたびに開始されるタイマーによって決定されます。タイマーがコントローラーのタイムアウト（秒単位で計測）に達すると、ma-controller-lost-objイベントが生成されます。このイベントは、抑制を開始するために使用できます。
object {
// empty
} ma-controller-connected-obj;
The ma-controller-connected-obj Event object has no further information elements. The ma-controller-connected-obj indicates that connectivity to the Controller has been established again after it was lost. This Event may be used to end a Suppression.
ma-controller-connected-objイベントオブジェクトには、これ以上の情報要素はありません。 ma-controller-connected-objは、コントローラーへの接続が失われた後に再度確立されたことを示します。このイベントは、抑制を終了するために使用できます。
The example execution has two Event sources, E1 and E2, and three Schedules, S1, S2, and S3. The Schedule S3 is started by Events of Event source E2 while the Schedules S1 and S2 are both started by Events of the Event source E1. The Schedules S1 and S2 have two Actions each, and Schedule S3 has a single Action. The Event source E2 has no randomization while the Event source E1 has the randomization r.
実行例には、2つのイベントソース（E1とE2）と3つのスケジュール（S1、S2、S3）があります。スケジュールS3はイベントソースE2のイベントによって開始されますが、スケジュールS1とS2はどちらもイベントソースE1のイベントによって開始されます。スケジュールS1とS2にはそれぞれ2つのアクションがあり、スケジュールS3には1つのアクションがあります。イベントソースE2にはランダム化がありませんが、イベントソースE1にはランダム化rがあります。
Figure 2 shows a possible timeline of an execution. The time T is progressing downwards. The dotted vertical line indicates progress of time while a dotted horizontal line indicates which Schedules are triggered by an Event. Lines of tildes indicate data flowing from an Action to another Schedule. Actions within a Schedule are named A1, A2, etc.
図2は、実行の可能なタイムラインを示しています。時間Tは下に向かって進んでいます。縦の点線は時間の経過を示し、横の点線はイベントによってトリガーされるスケジュールを示します。チルドの線は、アクションから別のスケジュールに流れるデータを示します。スケジュール内のアクションには、A1、A2などの名前が付けられます。
E2 E1 T S1 S2 S3
sequential parallel pipelined
:
e0 +
:
:
e0+r + .......... + .......... ++
: | A1 A1 || A2
: + |+ ~~~~~~~>
: | A2 |
: | + ~~~~~~~~>
: + ~~~~~~~~~~~~~~~~~~~~~>
:
:
e1 +
:
e1+r + .......... + .......... ++
: | A1 A1 ||
: | +|~~~~~~~>
: | | A2
: + +~~~~~~~>
: | A2
: + ~~~~~~~~~~~~~~~~~~~~>
e0 + ................................... +
: | A1
e3 + |
e3+r + .......... + .......... ++ |
: | A1 A1 || A2 |
: + ++ ~~~~~~> |
: | A2 +
: + ~~~~~~~~~~~~~~~~~~~~>
V
Figure 2: Example Execution
図2：実行例
Note that implementations must handle possible concurrency issues. In the example execution, Action A1 of Schedule S3 is consuming the data that has been forwarded to Schedule S3 while additional data is arriving from Action A2 of Schedule S2.
実装では、可能な同時実行性の問題を処理する必要があることに注意してください。実行例では、スケジュールS3のアクションA1は、スケジュールS2のアクションA2から追加のデータが到着している間に、スケジュールS3に転送されたデータを消費しています。
This document does not require any IANA actions.
このドキュメントでは、IANAアクションは必要ありません。
This Information Model deals with information about the control and reporting of the Measurement Agent. There are broadly two security considerations for such an Information Model. Firstly, the Information Model has to be sufficient to establish secure communication Channels to the Controller and Collector such that other information can be sent and received securely. Additionally, any mechanisms that the Network Operator or other device administrator employs to preconfigure the MA must also be secure to protect unauthorized parties from modifying Preconfiguration Information. These mechanisms are important to ensure that the MA cannot be hijacked, for example, to participate in a distributed denial-of-service attack.
この情報モデルは、測定エージェントの制御とレポートに関する情報を扱います。このような情報モデルには、大きく2つのセキュリティ上の考慮事項があります。まず、情報モデルは、他の情報を安全に送受信できるように、コントローラーとコレクターへの安全な通信チャネルを確立するのに十分でなければなりません。さらに、ネットワークオペレーターまたは他のデバイス管理者がMAを事前構成するために採用するメカニズムは、事前構成情報の変更から無許可の当事者を保護するために安全でなければなりません。これらのメカニズムは、分散型サービス拒否攻撃に参加するなど、MAがハイジャックされないようにするために重要です。
The second consideration is that no mandated information items should pose a risk to confidentiality or privacy given such secure communication Channels. For this latter reason, items such as the MA context and MA-ID are left optional and can be excluded from some deployments. This may, for example, allow the MA to remain anonymous and for information about location or other context that might be used to identify or track the MA to be omitted or blurred. Implementations and deployments should also be careful about exposing device-ids when this is not strictly needed.
2番目の考慮事項は、そのような安全な通信チャネルを前提として、必須の情報アイテムが機密性やプライバシーにリスクをもたらすべきではないということです。この後者の理由により、MAコンテキストやMA-IDなどの項目はオプションのままにして、一部の展開から除外できます。これにより、たとえば、MAを匿名のままにして、MAを識別または追跡するために使用される場所やその他のコンテキストに関する情報を省略したり、ぼかしたりすることができます。実装と展開では、デバイスIDが厳密に必要でない場合は、デバイスIDの公開についても注意する必要があります。
An implementation of this Information Model should support all the security and privacy requirements associated with the LMAP Framework [RFC7594]. In addition, users of this Information Model are advised to choose identifiers for Group-IDs, tags, or names of Information Model objects (e.g., configured Tasks, Schedules, or Actions) that do not reveal any sensitive information to people authorized to process measurement results but who are not authorized to know details about the Measurement Agents that were used to perform the measurement.
この情報モデルの実装は、LMAPフレームワーク[RFC7594]に関連するすべてのセキュリティおよびプライバシー要件をサポートする必要があります。さらに、この情報モデルのユーザーは、グループID、タグ、または情報モデルオブジェクトの名前（構成済みのタスク、スケジュール、アクションなど）の識別子を選択することをお勧めします。結果が、測定を実行するために使用された測定エージェントについての詳細を知る権限がありません。
[ISO.10646] International Organization for Standardization, "Information Technology - Universal Coded Character Set (UCS)", ISO Standard 10646:2014, September 2014.
[ISO.10646]国際標準化機構、「情報技術-ユニバーサルコード化文字セット（UCS）」、ISO標準10646：2014、2014年9月。
[POSIX.2] The Open Group, "Standard for Information Technology - Portable Operating System Interface (POSIX(R)) Base Specifications, Issue 7", IEEE Standard 1003.1, 2016 Edition, DOI, 10.1109/IEEESTD.2016.7582338, September 2016.
[POSIX.2] The Open Group、「Standard for Information Technology-Portable Operating System Interface（POSIX（R））Base Specifications、Issue 7」、IEEE Standard 1003.1、2016 Edition、DOI、10.1109 / IEEESTD.2016.7582338、September 2016。
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <https://www.rfc-editor.org/info/rfc2119>.
[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、DOI 10.17487 / RFC2119、1997年3月、<https://www.rfc-editor.org/info/ rfc2119>。
[RFC3339] Klyne, G. and C. Newman, "Date and Time on the Internet: Timestamps", RFC 3339, DOI 10.17487/RFC3339, July 2002, <https://www.rfc-editor.org/info/rfc3339>.
[RFC3339]クラインG.およびC.ニューマン、「インターネット上の日付と時刻：タイムスタンプ」、RFC 3339、DOI 10.17487 / RFC3339、2002年7月、<https://www.rfc-editor.org/info/rfc3339 >。
[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, DOI 10.17487/RFC3986, January 2005, <https://www.rfc-editor.org/info/rfc3986>.
[RFC3986] Berners-Lee、T.、Fielding、R。、およびL. Masinter、「Uniform Resource Identifier（URI）：Generic Syntax」、STD 66、RFC 3986、DOI 10.17487 / RFC3986、2005年1月、<https：/ /www.rfc-editor.org/info/rfc3986>。
[RFC4122] Leach, P., Mealling, M., and R. Salz, "A Universally Unique IDentifier (UUID) URN Namespace", RFC 4122, DOI 10.17487/RFC4122, July 2005, <https://www.rfc-editor.org/info/rfc4122>.
[RFC4122] Leach、P.、Mealling、M。、およびR. Salz、「Universally Unique IDentifier（UUID）URN Namespace」、RFC 4122、DOI 10.17487 / RFC4122、2005年7月、<https：//www.rfc- editor.org/info/rfc4122>。
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8174] Leiba、B。、「RFC 2119キーワードの大文字と小文字のあいまいさ」、BCP 14、RFC 8174、DOI 10.17487 / RFC8174、2017年5月、<https://www.rfc-editor.org/info/ rfc8174>。
[IPPM-REG] Bagnulo, M., Claise, B., Eardley, P., Morton, A., and A. Akhter, "Registry for Performance Metrics", Work in Progress, draft-ietf-ippm-metric-registry-12, June 2017.
[IPPM-REG] Bagnulo、M.、Claise、B.、Eardley、P.、Morton、A.、A。Akhter、「Registry for Performance Metrics」、Work in Progress、draft-ietf-ippm-metric-registry -12、2017年6月。
[RFC3444] Pras, A. and J. Schoenwaelder, "On the Difference between Information Models and Data Models", RFC 3444, DOI 10.17487/RFC3444, January 2003, <https://www.rfc-editor.org/info/rfc3444>.
[RFC3444] Pras、A。およびJ. Schoenwaelder、「情報モデルとデータモデルの違いについて」、RFC 3444、DOI 10.17487 / RFC3444、2003年1月、<https://www.rfc-editor.org/info/ rfc3444>。
[RFC7398] Bagnulo, M., Burbridge, T., Crawford, S., Eardley, P., and A. Morton, "A Reference Path and Measurement Points for Large-Scale Measurement of Broadband Performance", RFC 7398, DOI 10.17487/RFC7398, February 2015, <https://www.rfc-editor.org/info/rfc7398>.
[RFC7398] Bagnulo、M.、Burbridge、T.、Crawford、S.、Eardley、P.、and A. Morton、 "A Reference Path and Measurement Points for Large-Scale Measurement of Broadband Performance"、RFC 7398、DOI 10.17487 / RFC7398、2015年2月、<https://www.rfc-editor.org/info/rfc7398>。
[RFC7536] Linsner, M., Eardley, P., Burbridge, T., and F. Sorensen, "Large-Scale Broadband Measurement Use Cases", RFC 7536, DOI 10.17487/RFC7536, May 2015, <https://www.rfc-editor.org/info/rfc7536>.
[RFC7536] Linsner、M.、Eardley、P.、Burbridge、T。、およびF. Sorensen、「大規模ブロードバンド測定の使用例」、RFC 7536、DOI 10.17487 / RFC7536、2015年5月、<https：// www .rfc-editor.org / info / rfc7536>。
[RFC7594] Eardley, P., Morton, A., Bagnulo, M., Burbridge, T., Aitken, P., and A. Akhter, "A Framework for Large-Scale Measurement of Broadband Performance (LMAP)", RFC 7594, DOI 10.17487/RFC7594, September 2015, <https://www.rfc-editor.org/info/rfc7594>.
[RFC7594] Eardley、P.、Morton、A.、Bagnulo、M.、Burbridge、T.、Aitken、P。、およびA. Akhter、「ブロードバンドパフォーマンスの大規模測定（LMAP）のフレームワーク」、RFC 7594、DOI 10.17487 / RFC7594、2015年9月、<https://www.rfc-editor.org/info/rfc7594>。
[RFC8194] Schoenwaelder, J. and V. Bajpai, "A YANG Data Model for LMAP Measurement Agents", RFC 8194, DOI 10.17487/RFC8194, August 2017, <http://www.rfc-editor.org/info/rfc8194>.
[RFC8194] Schoenwaelder、J。およびV. Bajpai、「A LANG Measurement Model for LMAP Measurement Agents」、RFC 8194、DOI 10.17487 / RFC8194、August 2017、<http://www.rfc-editor.org/info/rfc8194 >。
Acknowledgements
謝辞
Several people contributed to this specification by reviewing early draft versions and actively participating in the LMAP Working Group (apologies to those unintentionally omitted): Vaibhav Bajpai, Michael Bugenhagen, Timothy Carey, Alissa Cooper, Kenneth Ko, Al Morton, Dan Romascanu, Henning Schulzrinne, Andrea Soppera, Barbara Stark, and Jason Weil.
初期のドラフトバージョンをレビューし、LMAPワーキンググループに積極的に参加することで、数人がこの仕様に貢献しました（意図せず省略されました）：Vaibhav Bajpai、Michael Bugenhagen、Timothy Carey、Alissa Cooper、Kenneth Ko、Al Morton、Dan Romascanu、Henning Schulzrinne 、Andrea Soppera、Barbara Stark、Jason Weil。
Marcelo Bagnulo, Trevor Burbridge, Philip Eardley, and Juergen Schoenwaelder worked in part on the Leone research project, which received funding from the European Union Seventh Framework Programme [FP7/2007-2013] under grant agreement number 317647.
Marcelo Bagnulo、Trevor Burbridge、Philip Eardley、およびJuergen Schoenwaelderは、EUの第7次フレームワークプログラム[FP7 / 2007-2013]から助成金契約番号317647で資金提供を受けたLeone研究プロジェクトに部分的に取り組みました。
Juergen Schoenwaelder was partly funded by Flamingo, a Network of Excellence project (ICT-318488) supported by the European Commission under its Seventh Framework Programme.
Juergen Schoenwaelderは、その第7フレームワークプログラムの下で欧州委員会が支援するネットワークオブエクセレンスプロジェクト（ICT-318488）であるフラミンゴから一部資金提供を受けました。
Authors' Addresses
著者のアドレス
Trevor Burbridge BT Adastral Park, Martlesham Heath Ipswich IP5 3RE United Kingdom
Trevor Burbridge BT Adastral Park、マートルシャムヒースイプスウィッチIP5 3REイギリス
Email: trevor.burbridge@bt.com
Philip Eardley BT Adastral Park, Martlesham Heath Ipswich IP5 3RE United Kingdom
Philip Eardley BT Adastral Park、Martlesham Heath Ipswich IP5 3REイギリス
Email: philip.eardley@bt.com
Marcelo Bagnulo Universidad Carlos III de Madrid Av. Universidad 30 Leganes, Madrid 28911 Spain
Marcelo Bagnulo Carlos IIIマドリード大学Av。Universidad 30 Leganes、Madrid 28911 Spain
Email: marcelo@it.uc3m.es
Juergen Schoenwaelder Jacobs University Bremen Campus Ring 1 Bremen 28759 Germany
Juergen Schoenwaelder Jacobs Universityブレーメンキャンパスリング1ブレーメン28759ドイツ
Email: j.schoenwaelder@jacobs-university.de