| Table of Contents |
|---|
Latest Data API
This opCharts API provides access to the Latest Data collection in a JSON format. This The latest_data collection holds the raw values collected in the "data" section and all "stats" data in the "derived_data" section, the properties found in these sections are dynamic and are defined by the model used for the node. Each document in the collection has a link 's to its associated inventory_id and a subconcept array. Each entry in the suboncepts subconcepts array holds a document with the subconcept name as well as a data and derived_data sub documents. There is a single record per inventory_id and the record holds the most recent readings/calculations for that piece of inventory.
...
Query Parameter | Possible Values |
|---|---|
properties | Array of property names. If provided only the properties specified will be returned (instead of the whole document). eg: By default the nodes UUID is returned by default if no properties are given |
page | (int) Which page of the requested document to return, defaults to 1 |
limit | (int) How many results to return per page, defaults to 25 |
filter | Array of key=value pairs, but coded in an array. Applied to the list of results in the order they are given. If an application key is provided that will be applied first. eg: |
sort | -1 | 1 : sort the response with id ascending or descending. |
...
HTTP Status | Body | Description |
|---|---|---|
| 200 OK | Possibly empty JSON array of strings | Each array element is a JSON string object with the subconcept name |
...
GET /omk/opCharts/v2/latest_data/id
You will get a single objects object for the given id in your database.
...
| Panel |
|---|
{ "cluster_id": "2f4e78ab-3b96-4540-9184-e71b48fa8120", "configuration": { "group": "DC_Network" }, "id": "64194dc7da587f6374d0396b", "inventory_id": "64194dabda587f6374cfcdc2", "node_uuid": "9ce8e534-25f7-4b0d-ba8d-49cc921952c4", "subconcepts": [ { "data": { "ifInOctets": 0, "ifInOctets_raw": 0, "ifOperStatus": 100, "ifOutOctets": 716817, "ifOutOctets_raw": 33901301339 }, "derived_data": { "availability": 100, "inputBits": 0, "inputUtil": 0, "outputBits": 22215.42, "outputUtil": 0.02, "totalUtil": 0.01 } }, {}, { "data": { "ifInBcastPkts": 0, "ifInBcastPkts_raw": 0, "ifInDiscards": 0, "ifInDiscards_raw": 0, "ifInErrors": 0, "ifInErrors_raw": 0, "ifInMcastPkts": 0, "ifInMcastPkts_raw": 0, "ifInOctets": 0, "ifInOctets_raw": 0, "ifInUcastPkts": 0, "ifInUcastPkts_raw": 0, "ifOutBcastPkts": 1823, "ifOutBcastPkts_raw": 320360615, "ifOutDiscards": 0, "ifOutDiscards_raw": 0, "ifOutErrors": 0, "ifOutErrors_raw": 0, "ifOutMcastPkts": 6713, "ifOutMcastPkts_raw": 135566792, "ifOutOctets": 716817, "ifOutOctets_raw": 33901301339, "ifOutUcastPkts": 120, "ifOutUcastPkts_raw": 2944557 }, "derived_data": { "ifInDiscards": 0, "ifInDiscardsProc": null, "ifInErrors": 0, "ifInErrorsProc": null, "ifInNUcastPkts": 0, "ifInUcastPkts": 0, "ifOutDiscards": 0, "ifOutDiscardsProc": 0, "ifOutErrors": 0, "ifOutErrorsProc": 0, "ifOutNUcastPkts": 11.7, "ifOutUcastPkts": 0.32414 }"subconcept": "pkts_hc" } ], "time": 1731625953.55326} |
Property | Description | Example |
| A globally unique ID | "63576103ad794974594a1f11" |
| The | "6678b17aca40037e1139cace" |
| The | |
| The | "8da86248-40f3-4c92-90b6-736bb66814aa" |
| Array of documents per subconcept, each array entry contains a document with the | |
time | The unix timestamp that the record was made. | 1687213025 |
...