Project

General

Profile

MeasurementStatus » History » Version 21

Davide Pesavento, 06/03/2020 05:35 PM

1 4 Ashlesh Gawande
# Measurement Status
2 1 Ashlesh Gawande
3 20 Davide Pesavento
{{>toc}}
4
5 12 Ashlesh Gawande
Measurement Status is a module of [[Management|NFD Management protocol]].
6 4 Ashlesh Gawande
It provides measurement table entries for a given name prefix.
7
8 9 Ashlesh Gawande
Measurements for a prefix is published as a [[StatusDataset|Status Dataset]] at: ndn:/localhost/nfd/measurements/query/
9 4 Ashlesh Gawande
10 11 Ashlesh Gawande
## Control Parameters
11
12
ControlParameters fields:
13
14
    Name (required)
15
16
Name is the prefix for which the measurement query is made.
17
A forwarder MAY impose a limit on the length of name prefix. The current limit in NFD is 32 name components.
18
If Name exceeds this limit, the command fails with code 414.
19 13 Ashlesh Gawande
Code 400 is returned if the command is malformed.
20 11 Ashlesh Gawande
21
## Measurement Entry Dataset
22
23 21 Davide Pesavento
Each measurement entry is represented by **MeasurementEntry** element:
24 11 Ashlesh Gawande
25 21 Davide Pesavento
    MeasurementEntry = MEASUREMENT-ENTRY-TYPE TLV-LENGTH
26
                         Name
27
                         StrategyInfo
28 11 Ashlesh Gawande
29 18 Ashlesh Gawande
* **Name** is the prefix for which the query was made
30 1 Ashlesh Gawande
* **StrategyInfo** is the measurement info provided by the strategy responsible for the given name
31 12 Ashlesh Gawande
32
Strategy returns a boost::property_tree when queried and managements formats that as JSON string for StrategyInfo.
33 19 Ashlesh Gawande
Code 501 is returned if the strategy responsible for the prefix does not support measurement queries.
34 3 Ashlesh Gawande
35 2 Ashlesh Gawande
## TLV-TYPE assignments
36
37
Type                                        | Assigned number   | Assigned number (hex)
38
------------------------------------------- | ----------------- | ---------------------
39
MeasurementEntry                            | 128               | 0x80
40
StrategyInfo                                | 129               | 0x81