Changes between Version 11 and Version 12 of OperationalMonitoring/DataSchema20


Ignore:
Timestamp:
08/28/14 10:11:20 (7 years ago)
Author:
dwiggins@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OperationalMonitoring/DataSchema20

    v11 v12  
    2828https://datastore.instageni.gpolab.bbn.com/info/aggregate/gpo-ig
    2929}}}
    30 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/aggregate# aggregate schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/aggregate.schema.jwc commented version of the aggregate schema].
     30
     31The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/aggregate# aggregate schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/aggregate.schema.jwc commented version of the aggregate schema].
    3132{{{
    3233{
     
    6263==== Node call and response ====
    6364
     65Retrieves information about a node.
     66
     67General form of the REST call:
     68{{{
     69https://<datastore-host>/info/node/<node object id>
     70}}}
     71
    6472Example REST call for gpo-ig node pc1:
    6573{{{
    6674https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1
    6775}}}
    68 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/node node schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/node.schema.jwc commented version of the node schema].
     76
     77The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/node node schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/node.schema.jwc commented version of the node schema].
    6978{{{
    7079{
     
    100109==== Link call and response ====
    101110
    102 Example REST call:
     111Retrieves information about a link.
     112
     113General form of the REST call:
     114{{{
     115https://<datastore-host>/info/link/<link object id>
     116}}}
     117
     118Example REST call for arbitrary_id_001:
    103119{{{
    104120https://datastore.grnoc.iu.edu/info/link/arbitrary_id_001
    105121}}}
    106 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/link# link schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/link.schema.jwc commented version of the link schema].
     122
     123The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/link# link schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/link.schema.jwc commented version of the link schema].
    107124{{{
    108125{
     
    129146Retrieves information about a network interface, a.k.a. port.
    130147
    131 Example REST call for pc1 eth0 (control) at gpo-ig:
     148General form of the REST call:
     149{{{
     150https://<datastore-host>/info/interface/<interface object id>
     151}}}
     152
     153Example REST call for pc1 eth0 at gpo-ig:
    132154{{{
    133155https://datastore.instageni.gpolab.bbn.com/info/interface/instageni.gpolab.bbn.com_interface_pc1:eth0
    134156}}}
    135 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/interface interface schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/interface.schema.jwc commented version of the interface schema].
     157
     158The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/interface interface schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/interface.schema.jwc commented version of the interface schema].
    136159{{{
    137160{
     
    158181}}}
    159182
    160 ==== Slice authority call and response ====
    161 
    162 GENI slice authorities are indexed by domain name and described using [http://www.gpolab.bbn.com/monitoring/schema/20140828/authority# the authority schema].  Examples:
    163 data about a GENI authority
    164 
    165 Example REST call for authority of ch.geni.net:
    166 {{{
    167 https://datastore.ch.geni.net/info/authority/ch.geni.net
    168 }}}
    169 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/authority authority schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/authority.schema.jwc commented version of the authority schema]
    170 {{{
    171 {
    172   "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/authority#",
    173   "id": "ch.geni.net",
    174   "selfRef": "https://datastore.ch.geni.net/info/authority/ch.geni.net",
    175   "urn": "urn:publicid:IDN+ch.geni.net+authority+ch",
    176   "ts": 1391192685740849,
    177   "users": [
    178     {
    179       "urn": "urn:publicid:IDN+ch.geni.net+user+tupty",
    180       "href": "https://datastore.ch.geni.net/info/user/tupty"
    181     }
    182   ],
    183   "slices": [
    184     {
    185       "urn": "urn:publicid:IDN+ch.geni.net:gpo-infra+slice+tuptyexclusive",
    186       "href": "https://datastore.ch.geni.net/info/slice/ch.geni.net_gpo-infra_slice_tuptyexclusive"
    187     }
    188   ]
    189 }
    190 }}}
    191 
    192 
    193183==== Interface-VLAN call and response ====
    194184
    195 data about a tagged VLAN subinterface of a network interface
     185Retrieves information about a tagged VLAN subinterface of a network interface.
     186
     187General form of the REST call:
     188{{{
     189https://<datastore-host>/info/interfacevlan/<interfacevlan object id>
     190}}}
    196191
    197192Example REST call for VLAN 1750 on pc1 eth1:
     
    199194https://datastore.instageni.gpolab.bbn.com/info/interfacevlan/instageni.gpolab.bbn.com_interface_pc1:eth1:1750
    200195}}}
    201 Response conforms to the  [http://www.gpolab.bbn.com/monitoring/schema/20140828/interfacevlan interfacevlan schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/interfacevlan.schema.jwc commented version of the interfacevlan schema].
     196
     197The response conforms to the  [http://www.gpolab.bbn.com/monitoring/schema/20140828/interfacevlan interfacevlan schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/interfacevlan.schema.jwc commented version of the interfacevlan schema].
    202198{{{
    203199{
     
    215211}}}
    216212
     213==== Slice authority call and response ====
     214
     215Retrieves information about a slice authority.
     216
     217General form of the REST call:
     218{{{
     219https://<datastore-host>/info/slice/<slice object id>
     220}}}
     221
     222Example REST call for authority of ch.geni.net:
     223{{{
     224https://datastore.ch.geni.net/info/authority/ch.geni.net
     225}}}
     226
     227The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/authority authority schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/authority.schema.jwc commented version of the authority schema].
     228{{{
     229{
     230  "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/authority#",
     231  "id": "ch.geni.net",
     232  "selfRef": "https://datastore.ch.geni.net/info/authority/ch.geni.net",
     233  "urn": "urn:publicid:IDN+ch.geni.net+authority+ch",
     234  "ts": 1391192685740849,
     235  "users": [
     236    {
     237      "urn": "urn:publicid:IDN+ch.geni.net+user+tupty",
     238      "href": "https://datastore.ch.geni.net/info/user/tupty"
     239    }
     240  ],
     241  "slices": [
     242    {
     243      "urn": "urn:publicid:IDN+ch.geni.net:gpo-infra+slice+tuptyexclusive",
     244      "href": "https://datastore.ch.geni.net/info/slice/ch.geni.net_gpo-infra_slice_tuptyexclusive"
     245    }
     246  ]
     247}
     248}}}
     249
    217250
    218251==== User call and response ====
    219252
    220 GENI users have an ID based on the username and are described using [http://www.gpolab.bbn.com/monitoring/schema/20140828/user# the GENI user schema].  Examples:
    221 data about a GENI user at an authority
     253Retrieves information about a GENI user.
     254
     255General form of the REST call:
     256{{{
     257https://<datastore-host>/info/user/<user object id>
     258}}}
    222259
    223260Example REST call for user tupty at ch.geni.net:
     
    225262https://datastore.ch.geni.net/info/user/tupty
    226263}}}
    227 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/user user schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/user.schema.jwc commented version of the user schema]
     264
     265The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/user user schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/user.schema.jwc commented version of the user schema].
    228266{{{
    229267{
     
    244282==== Slice call and response ====
    245283
    246 GENI slices have an ID based on the URN and are described using [http://www.gpolab.bbn.com/monitoring/schema/20140828/slice# the GENI slice schema].
    247 data about a slice at an authority
     284Retrieves information about  a slice at an authority.
     285
     286General form of the REST call:
     287{{{
     288https://<datastore-host>/info/slice/<slice object id>
     289}}}
    248290
    249291Example REST call for tuptyexclusive slice:
     
    251293https://datastore.ch.geni.net/info/slice/ch.geni.net_gpo-infra_slice_tuptyexclusive
    252294}}}
    253 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/slice slice schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/slice.schema.jwc commented version of the slice schema]
     295
     296The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/slice slice schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/slice.schema.jwc commented version of the slice schema].
    254297{{{
    255298{
     
    278321==== Sliver call and response ====
    279322
    280 GENI sliver have an ID based on the URN and are described using [http://www.gpolab.bbn.com/monitoring/schema/20140828/sliver# the GENI sliver schema].  Examples:
    281 data about a sliver at an aggregate [http://www.gpolab.bbn.com/monitoring/schema/20140828/sliver.schema.jwc sliver schema with comments]
     323Retrieves information about a sliver.
     324
     325General form of the REST call:
     326{{{
     327https://<datastore-host>/info/sliver/<sliver object id>
     328}}}
    282329
    283330Example REST call for tuptyexclusive instageni sliver:
     
    285332https://datastore.instageni.gpolab.bbn.com/info/sliver/instageni.gpolab.bbn.com_sliver_26947
    286333}}}
    287 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/sliver sliver schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/sliver.schema.jwc commented version of the sliver schema].
     334
     335The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/sliver sliver schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/sliver.schema.jwc commented version of the sliver schema].
    288336{{{
    289337{
     
    313361==== External check datastore call and response ====
    314362
    315 Example REST call:
     363Retrieves information about a sliver.
     364
     365General form of the REST call:
     366{{{
     367https://<datastore-host>/info/externalcheck/<extchk-id>
     368}}}
     369
     370Example REST call for GPO externalcheck store:
    316371{{{
    317372https://externalcheckstore.gpolab.bbn.com/info/externalcheck/gpo
    318373}}}
    319 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/externalcheck external check schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/externalcheck.schema.jwc commented version of the external check schema], .
     374
     375The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/externalcheck external check schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/externalcheck.schema.jwc commented version of the external check schema].
    320376{{{
    321377{
     
    345401==== Experiment call and response ====
    346402
    347 Operational monitoring measures the dataplane with a set of simple tests between aggregates described using [http://www.gpolab.bbn.com/monitoring/schema/20140828/experiment# the operational monitoring experiment schema].  Examples:
    348 data about an operational monitoring experiment for monitoring the dataplane
     403Retrieves information data about an operational monitoring experiment for monitoring the dataplane between aggregates.
     404
     405General form of the REST call:
     406{{{
     407https://<datastore-host>/info/experiment/<experiment id>
     408}}}
     409
    349410Example REST call for missouri-ig to gpo-ig experiment:
    350411{{{
    351412https://datastore.externalchecks.geni.net/info/experiment/missouri-ig_to_gpo-ig_rtt
    352413}}}
    353 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/experiment experiment schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/experiment.schema.jwc commented version of the experiment schema]
     414
     415The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/experiment experiment schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/experiment.schema.jwc commented version of the experiment schema].
    354416{{{
    355417{
     
    372434
    373435
    374 ==== Measurements used for the use cases ====
    375 
    376 Measurements have an opaque ID which is generated by the local datastore which serves them, and must be persistent, so that the caller has the option of asking for the measurement by ID.  They are described using the data schema outlined above.  Examples:
    377 [http://www.gpolab.bbn.com/monitoring/schema/20140828/data data]: data about time-series measurements.  Schema based in part on [http://unis.incntre.iu.edu/schema/20120709/metadata] [http://www.gpolab.bbn.com/monitoring/schema/20140828/data.schema.jwc data schema with comments]
     436==== Time-series measurements call and response ====
     437
     438Retrieve time series measurements, a.k.a. simply "data" or "events."
     439
     440General form of the REST call:
     441{{{
     442https://<datastore-host>/data/?q=
     443        {"filters":
     444            {"eventType":[<list of measurementNames>],
     445             "ts":{"gte":<lower bound timestamp>, "lte":<upper bound timestamp},
     446             "obj":{"type":"<object type name>", "id":[<list of object ids>]}}}
     447}}}
     448 (The above is split into multiple lines for readability; actual calls are all on one line.)
     449If <list of object ids> is "*", it means "all objects known to the datastore of type <object type name>."
     450
     451The response is a list "[...]" in which each element conforms to the  [http://www.gpolab.bbn.com/monitoring/schema/20140828/data data]: data schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/data.schema.jwc commented version of the data schema].
     452Each element of the list applies to one (eventType, object id) pair.
     453
    378454Example REST call for CPU utilization metric on pc1:
    379455{{{
    380456https://datastore.instageni.gpolab.bbn.com/data/?q={"filters":{"eventType": ["ops_monitoring:cpu_util"],"ts":{"gte":0, "lte": 1391199016651285},"obj":{"type":"node","id":["instageni.gpolab.bbn.com_node_pc1"]}}}
    381457}}}
    382 Response
    383 {{{
    384 {
    385   "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
    386   "id": "cpu_util:instageni.gpolab.bbn.com_node_pc1",
    387   "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
    388   "eventType": "ops_monitoring:cpu_util",
    389   "description": "CPU utilization percentage",
    390   "units": "percent",
    391   "tsdata": [
    392     { "ts": 1391198716651283, "v": 45 },
    393     { "ts": 1391198776651284, "v": 44 },
    394     { "ts": 1391198836651284, "v": 44 },
    395     { "ts": 1391198896651284, "v": 47 },
    396     { "ts": 1391198956651284, "v": 46 },
    397     { "ts": 1391199016651285, "v": 47 }
    398   ]
    399 }
    400 }}}
     458
     459Response:
     460{{{
     461[
     462  {
     463    "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
     464    "id": "cpu_util:instageni.gpolab.bbn.com_node_pc1",
     465    "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
     466    "eventType": "ops_monitoring:cpu_util",
     467    "description": "CPU utilization percentage",
     468    "units": "percent",
     469    "tsdata": [
     470      { "ts": 1391198716651283, "v": 45 },
     471      { "ts": 1391198776651284, "v": 44 },
     472      { "ts": 1391198836651284, "v": 44 },
     473      { "ts": 1391198896651284, "v": 47 },
     474      { "ts": 1391198956651284, "v": 46 },
     475      { "ts": 1391199016651285, "v": 47 }
     476    ]
     477  }
     478]
     479}}}
     480
    401481Example REST call for percentage of swap available on pc1:
    402482{{{
     
    404484
    405485}}}
     486
    406487Response:
    407488{{{
    408 {
    409   "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
    410   "id": "swap_free:instageni.gpolab.bbn.com_node_pc1",
    411   "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
    412   "eventType": "ops_monitoring:swap_free",
    413   "description": "Percentage of swap available",
    414   "units": "percent",
    415   "tsdata": [
    416     { "ts": 1391198716651283, "v": 95 },
    417     { "ts": 1391198776651284, "v": 95 },
    418     { "ts": 1391198836651284, "v": 95 },
    419     { "ts": 1391198896651284, "v": 95 },
    420     { "ts": 1391198956651284, "v": 95 },
    421     { "ts": 1391199016651285, "v": 95 }
    422   ]
    423 }
    424 }}}
     489[
     490  {
     491    "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
     492    "id": "swap_free:instageni.gpolab.bbn.com_node_pc1",
     493    "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
     494    "eventType": "ops_monitoring:swap_free",
     495    "description": "Percentage of swap available",
     496    "units": "percent",
     497    "tsdata": [
     498      { "ts": 1391198716651283, "v": 95 },
     499      { "ts": 1391198776651284, "v": 95 },
     500      { "ts": 1391198836651284, "v": 95 },
     501      { "ts": 1391198896651284, "v": 95 },
     502      { "ts": 1391198956651284, "v": 95 },
     503      { "ts": 1391199016651285, "v": 95 }
     504    ]
     505  }
     506]
     507}}}
     508
    425509Example REST call for memory in active use on pc1:
    426510{{{
    427511https://datastore.instageni.gpolab.bbn.com/data/?q={"filters":{"eventType": ["ops_monitoring:mem_active_kb"],"ts":{"gte":0, "lt": 1391299016651285},"obj":{"type":"node","id":["instageni.gpolab.bbn.com_node_pc1"]}}}
    428512}}}
     513
    429514Response:
    430515{{{
    431 {
    432   "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
    433   "id": "mem_active_kb:instageni.gpolab.bbn.com_node_pc1",
    434   "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
    435   "eventType": "ops_monitoring:mem_active_kb",
    436   "description": "Memory in active use",
    437   "units": "integer",
    438   "tsdata": [
    439     { "ts": 1391198716651283, "v": 20030048 },
    440     { "ts": 1391198776651284, "v": 20031148 },
    441     { "ts": 1391198836651284, "v": 20031148 },
    442     { "ts": 1391198896651284, "v": 22222222 },
    443     { "ts": 1391198956651284, "v": 22222222 },
    444     { "ts": 1391199016651285, "v": 22222222 }
    445   ]
    446 }
    447 }}}
    448  Example call for bytes per second received by `pc1:eth0`:
     516[
     517  {
     518    "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
     519    "id": "mem_active_kb:instageni.gpolab.bbn.com_node_pc1",
     520    "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
     521    "eventType": "ops_monitoring:mem_active_kb",
     522    "description": "Memory in active use",
     523    "units": "integer",
     524    "tsdata": [
     525      { "ts": 1391198716651283, "v": 20030048 },
     526      { "ts": 1391198776651284, "v": 20031148 },
     527      { "ts": 1391198836651284, "v": 20031148 },
     528      { "ts": 1391198896651284, "v": 22222222 },
     529      { "ts": 1391198956651284, "v": 22222222 },
     530      { "ts": 1391199016651285, "v": 22222222 }
     531    ]
     532  }
     533]
     534}}}
     535
     536Example REST call for bytes per second received by `pc1:eth0`:
    449537{{{
    450538https://datastore.instageni.gpolab.bbn.com/data/?q={"filters":{"eventType": ["ops_monitoring:rx_bytes"],"ts":{"gte":0, "lte":1391299016651285},"obj":{"type":"interface","id":["instageni.gpolab.bbn.com_node_pc1:eth0"]}}}
    451539}}}
     540
    452541Response:
    453542{{{
    454 {
    455   "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
    456   "id": "rx_bps:instageni.gpolab.bbn.com_interface_pc1:eth0",
    457   "subject": "https://datastore.instageni.gpolab.bbn.com/info/interface/instageni.gpolab.bbn.com_interface_pc1:eth0",
    458   "eventType": "ops_monitoring:rx_bps",
    459   "description": "bytes per second received on this interface",
    460   "units": "float",
    461   "tsdata": [
    462     { "ts": 1391198716651283, "v": 2453.64 },
    463     { "ts": 1391198776651284, "v": 800.2 },
    464     { "ts": 1391198836651284, "v": 2400.3 },
    465     { "ts": 1391198896651284, "v": 1984.3 },
    466     { "ts": 1391198956651284, "v": 0 },
    467     { "ts": 1391199016651285, "v": 0 }
    468   ]
    469 }
    470 }}}
     543[
     544  {
     545    "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
     546    "id": "rx_bps:instageni.gpolab.bbn.com_interface_pc1:eth0",
     547    "subject": "https://datastore.instageni.gpolab.bbn.com/info/interface/instageni.gpolab.bbn.com_interface_pc1:eth0",
     548    "eventType": "ops_monitoring:rx_bps",
     549    "description": "bytes per second received on this interface",
     550    "units": "float",
     551    "tsdata": [
     552      { "ts": 1391198716651283, "v": 2453.64 },
     553      { "ts": 1391198776651284, "v": 800.2 },
     554      { "ts": 1391198836651284, "v": 2400.3 },
     555      { "ts": 1391198896651284, "v": 1984.3 },
     556      { "ts": 1391198956651284, "v": 0 },
     557      { "ts": 1391199016651285, "v": 0 }
     558    ]
     559  }
     560]
     561}}}
     562
    471563Example REST call for boolean metric indicating whether pc1 is available for use according to the aggregate responsible for it:
    472564{{{
    473565https://datastore.instageni.gpolab.bbn.com/data/?q={"filters":{"eventType": ["ops_monitoring:is_available"],"ts":{"gte":0, "lte":1391299016651285},"obj":{"type":"node","id":["instageni.gpolab.bbn.com_node_pc1"]}}}
    474566}}}
     567
    475568Response:
    476569{{{
    477 {
    478   "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
    479   "id": "is_available:instageni.gpolab.bbn.com_node_pc1",
    480   "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
    481   "eventType": "ops_monitoring:is_available",
    482   "description": "is the subject node available, according to the aggregate",
    483   "units": "boolean",
    484   "tsdata": [
    485     { "ts": 1391198716651283, "v": 1 },
    486     { "ts": 1391198776651284, "v": 1 },
    487     { "ts": 1391198836651284, "v": 1 },
    488     { "ts": 1391198896651284, "v": 1 },
    489     { "ts": 1391198956651284, "v": 0 },
    490     { "ts": 1391199016651285, "v": 0 }
    491   ]
    492 }
    493 }}}
    494 
    495 ==== Bulk Data Queries ====
    496 Queries on multiple eventTypes and object ID's will be presented in a list format.  Here is an example query for event types cpu utilization and active memory utilization for nodes pc1 and pc2 of instageni-bbn.
    497 Also it is advised to provide timestamp filters with data queries.  Here is the format for [wiki:OperationalMonitoring/DatastorePolling#DataQueries timestamp filters] .
    498 
    499 Example call:
     570[
     571  {
     572    "$schema": "http://www.gpolab.bbn.com/monitoring/schema/20140828/data#",
     573    "id": "is_available:instageni.gpolab.bbn.com_node_pc1",
     574    "subject": "https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1",
     575    "eventType": "ops_monitoring:is_available",
     576    "description": "is the subject node available, according to the aggregate",
     577    "units": "boolean",
     578    "tsdata": [
     579      { "ts": 1391198716651283, "v": 1 },
     580      { "ts": 1391198776651284, "v": 1 },
     581      { "ts": 1391198836651284, "v": 1 },
     582      { "ts": 1391198896651284, "v": 1 },
     583      { "ts": 1391198956651284, "v": 0 },
     584      { "ts": 1391199016651285, "v": 0 }
     585    ]
     586  }
     587]
     588}}}
     589
     590XXX check Here is the format for [wiki:OperationalMonitoring/DatastorePolling#DataQueries Timestamp filters] .
     591
     592Example REST call requesting multiple eventTypes and object ids:
    500593{{{
    501594https://datastore.instageni.gpolab.bbn.com/data/?q={"filters":{"eventType": ["ops_monitoring:mem_used","ops_monitoring:cpu_util"],"ts":{"gte":1391192225475202,"lt":1391192225480000},"obj":{"type":"node","id":["instageni.gpolab.bbn.com_node_pc1","instageni.gpolab.bbn.com_node_pc2"]}}}}
    502595}}}
    503596
     597Response:
    504598{{{
    505599[
     
    576670==== Operational monitoring configuration (opsconfig) call and response ====
    577671
    578 Operational monitoring configuration data tells collectors where to find local datastores, and includes relevant metadata (like URNs and metadata about datastore or aggregate types) that collectors can use to decide which datastores to query.  It is described using [http://www.gpolab.bbn.com/monitoring/schema/20140828/opsconfig# the opsconfig schema].
    579  * geni-prod: a hypothetical config datastore listing production aggregates and authorities:
    580 operational configuration metadata, including locations of and information about other datastores [http://www.gpolab.bbn.com/monitoring/schema/20140828/opsconfig.schema.jwc opsconfig schema with comments]
    581 
    582 Example REST call:
     672Retrieves a variety of configuration information, including:
     673* locations (URLs) of and information about other datastores
     674* GENI authorities
     675* Database schemas used to store monitoring information
     676* A list of possible event types for time-series measurements
     677
     678Example REST call for geni-prod,  a hypothetical config datastore listing production aggregates and authorities:
    583679{{{
    584680https://datastore.geni.net/info/opsconfig/geni-prod
    585681}}}
    586 Response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/opsconfig opsconfig schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/opsconfig.schema.jwc commented version of the opsconfig schema].
     682
     683The response conforms to the [http://www.gpolab.bbn.com/monitoring/schema/20140828/opsconfig opsconfig schema], [http://www.gpolab.bbn.com/monitoring/schema/20140828/opsconfig.schema.jwc commented version of the opsconfig schema].
    587684{{{
    588685{