Changes between Version 11 and Version 12 of OperationalMonitoring/DataSchema20
- Timestamp:
- 08/28/14 10:11:20 (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
OperationalMonitoring/DataSchema20
v11 v12 28 28 https://datastore.instageni.gpolab.bbn.com/info/aggregate/gpo-ig 29 29 }}} 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 31 The 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]. 31 32 {{{ 32 33 { … … 62 63 ==== Node call and response ==== 63 64 65 Retrieves information about a node. 66 67 General form of the REST call: 68 {{{ 69 https://<datastore-host>/info/node/<node object id> 70 }}} 71 64 72 Example REST call for gpo-ig node pc1: 65 73 {{{ 66 74 https://datastore.instageni.gpolab.bbn.com/info/node/instageni.gpolab.bbn.com_node_pc1 67 75 }}} 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 77 The 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]. 69 78 {{{ 70 79 { … … 100 109 ==== Link call and response ==== 101 110 102 Example REST call: 111 Retrieves information about a link. 112 113 General form of the REST call: 114 {{{ 115 https://<datastore-host>/info/link/<link object id> 116 }}} 117 118 Example REST call for arbitrary_id_001: 103 119 {{{ 104 120 https://datastore.grnoc.iu.edu/info/link/arbitrary_id_001 105 121 }}} 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 123 The 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]. 107 124 {{{ 108 125 { … … 129 146 Retrieves information about a network interface, a.k.a. port. 130 147 131 Example REST call for pc1 eth0 (control) at gpo-ig: 148 General form of the REST call: 149 {{{ 150 https://<datastore-host>/info/interface/<interface object id> 151 }}} 152 153 Example REST call for pc1 eth0 at gpo-ig: 132 154 {{{ 133 155 https://datastore.instageni.gpolab.bbn.com/info/interface/instageni.gpolab.bbn.com_interface_pc1:eth0 134 156 }}} 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 158 The 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]. 136 159 {{{ 137 160 { … … 158 181 }}} 159 182 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 authority164 165 Example REST call for authority of ch.geni.net:166 {{{167 https://datastore.ch.geni.net/info/authority/ch.geni.net168 }}}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 193 183 ==== Interface-VLAN call and response ==== 194 184 195 data about a tagged VLAN subinterface of a network interface 185 Retrieves information about a tagged VLAN subinterface of a network interface. 186 187 General form of the REST call: 188 {{{ 189 https://<datastore-host>/info/interfacevlan/<interfacevlan object id> 190 }}} 196 191 197 192 Example REST call for VLAN 1750 on pc1 eth1: … … 199 194 https://datastore.instageni.gpolab.bbn.com/info/interfacevlan/instageni.gpolab.bbn.com_interface_pc1:eth1:1750 200 195 }}} 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 197 The 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]. 202 198 {{{ 203 199 { … … 215 211 }}} 216 212 213 ==== Slice authority call and response ==== 214 215 Retrieves information about a slice authority. 216 217 General form of the REST call: 218 {{{ 219 https://<datastore-host>/info/slice/<slice object id> 220 }}} 221 222 Example REST call for authority of ch.geni.net: 223 {{{ 224 https://datastore.ch.geni.net/info/authority/ch.geni.net 225 }}} 226 227 The 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 217 250 218 251 ==== User call and response ==== 219 252 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 253 Retrieves information about a GENI user. 254 255 General form of the REST call: 256 {{{ 257 https://<datastore-host>/info/user/<user object id> 258 }}} 222 259 223 260 Example REST call for user tupty at ch.geni.net: … … 225 262 https://datastore.ch.geni.net/info/user/tupty 226 263 }}} 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 265 The 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]. 228 266 {{{ 229 267 { … … 244 282 ==== Slice call and response ==== 245 283 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 284 Retrieves information about a slice at an authority. 285 286 General form of the REST call: 287 {{{ 288 https://<datastore-host>/info/slice/<slice object id> 289 }}} 248 290 249 291 Example REST call for tuptyexclusive slice: … … 251 293 https://datastore.ch.geni.net/info/slice/ch.geni.net_gpo-infra_slice_tuptyexclusive 252 294 }}} 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 296 The 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]. 254 297 {{{ 255 298 { … … 278 321 ==== Sliver call and response ==== 279 322 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] 323 Retrieves information about a sliver. 324 325 General form of the REST call: 326 {{{ 327 https://<datastore-host>/info/sliver/<sliver object id> 328 }}} 282 329 283 330 Example REST call for tuptyexclusive instageni sliver: … … 285 332 https://datastore.instageni.gpolab.bbn.com/info/sliver/instageni.gpolab.bbn.com_sliver_26947 286 333 }}} 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 335 The 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]. 288 336 {{{ 289 337 { … … 313 361 ==== External check datastore call and response ==== 314 362 315 Example REST call: 363 Retrieves information about a sliver. 364 365 General form of the REST call: 366 {{{ 367 https://<datastore-host>/info/externalcheck/<extchk-id> 368 }}} 369 370 Example REST call for GPO externalcheck store: 316 371 {{{ 317 372 https://externalcheckstore.gpolab.bbn.com/info/externalcheck/gpo 318 373 }}} 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 375 The 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]. 320 376 {{{ 321 377 { … … 345 401 ==== Experiment call and response ==== 346 402 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 403 Retrieves information data about an operational monitoring experiment for monitoring the dataplane between aggregates. 404 405 General form of the REST call: 406 {{{ 407 https://<datastore-host>/info/experiment/<experiment id> 408 }}} 409 349 410 Example REST call for missouri-ig to gpo-ig experiment: 350 411 {{{ 351 412 https://datastore.externalchecks.geni.net/info/experiment/missouri-ig_to_gpo-ig_rtt 352 413 }}} 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 415 The 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]. 354 416 {{{ 355 417 { … … 372 434 373 435 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 438 Retrieve time series measurements, a.k.a. simply "data" or "events." 439 440 General form of the REST call: 441 {{{ 442 https://<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.) 449 If <list of object ids> is "*", it means "all objects known to the datastore of type <object type name>." 450 451 The 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]. 452 Each element of the list applies to one (eventType, object id) pair. 453 378 454 Example REST call for CPU utilization metric on pc1: 379 455 {{{ 380 456 https://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"]}}} 381 457 }}} 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 459 Response: 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 401 481 Example REST call for percentage of swap available on pc1: 402 482 {{{ … … 404 484 405 485 }}} 486 406 487 Response: 407 488 {{{ 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 425 509 Example REST call for memory in active use on pc1: 426 510 {{{ 427 511 https://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"]}}} 428 512 }}} 513 429 514 Response: 430 515 {{{ 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 536 Example REST call for bytes per second received by `pc1:eth0`: 449 537 {{{ 450 538 https://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"]}}} 451 539 }}} 540 452 541 Response: 453 542 {{{ 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 471 563 Example REST call for boolean metric indicating whether pc1 is available for use according to the aggregate responsible for it: 472 564 {{{ 473 565 https://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"]}}} 474 566 }}} 567 475 568 Response: 476 569 {{{ 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 590 XXX check Here is the format for [wiki:OperationalMonitoring/DatastorePolling#DataQueries Timestamp filters] . 591 592 Example REST call requesting multiple eventTypes and object ids: 500 593 {{{ 501 594 https://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"]}}}} 502 595 }}} 503 596 597 Response: 504 598 {{{ 505 599 [ … … 576 670 ==== Operational monitoring configuration (opsconfig) call and response ==== 577 671 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: 672 Retrieves 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 678 Example REST call for geni-prod, a hypothetical config datastore listing production aggregates and authorities: 583 679 {{{ 584 680 https://datastore.geni.net/info/opsconfig/geni-prod 585 681 }}} 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 683 The 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]. 587 684 {{{ 588 685 {