Kwapi

From Grid5000
Jump to: navigation, search




This page describes Kwapi monitoring internal API.

Features

Kwapi offers three main user features :

Live monitoring of your experiment

Live monitoring is available through a web interface :

Monitoring live example energy.png

Monitoring live example network.png

You can:

  • select probes directly or using the oarjob_id,
  • access timeframes of 5 minutes, 1 hour, 1 day, 1 week, 1 month and 1 year,

Retrieve data from a past experiment

List available probes

HDF5 monitoring tool stores data at high resolution during one year. List of monitorable nodes of the site site_name can be found at:

For POWER Monitoring

For instance,

available_on indicates pdu and pdu-port monitored. For example

   "0.parapide-pdu-2.rennes.grid5000.fr"

correspond to parapide-pdu-2, port 0.

You can retrieve probe uid from the timeseries location:

Terminal.png frontend:
     "uid": "parasilo-12",
     "uid": "parapide-2",
     "uid": "paravance-9",
     "uid": "paravance-8",
     "uid": "parapide-1",
     "uid": "paravance-1",
     "uid": "paravance-3",
     [...]

which correspond to this short uid (used after)

paravance-8

Retrieve data by job ID

Get your job ID (e.g. with oarstat -u). You can retrieve corresponding data by choosing:

For POWER Monitoring

Retrieve data with startime, endtime and a list of probes

For POWER Monitoring

Get your short uid (e.g. griffon-1,griffon-7).

Warning.png Warning

Please pay attention to the quotes around the URL this time because of the ampersand (&) inside it.

A json file is generated using the classical API metrics format:

{
  "items": [
    {
      "from": 1484140370,
      "links": [
        {
          "href": "/sid/sites/nancy/metrics/power/timeseries/griffon-1",
          "rel": "self",
          "type": "application/vnd.fr.grid5000.api.Timeseries+json;level=1"
        },
        {
          "href": "/sid/sites/nancy/metrics/power",
          "rel": "parent",
          "type": "application/vnd.fr.grid5000.api.Metric+json;level=1"
        }
      ],
      "resolution": 1,
      "timestamps": [
        1484140370.295889,
        1484140371.296888,
        1484140372.299474,
        1484140373.300477,
        1484140374.301494,
        1484140375.304028,
        1484140376.305344,
        1484140377.306637,
        1484140378.307476,
        1484140379.308687,
        1484140380.309691,
        1484140381.311316,
        1484140382.31152,
        1484140383.312524,
        1484140384.313524,
        1484140385.314623,
        1484140386.318852,
        1484140387.319595,
        1484140388.320619,
        1484140389.321628,
        1484140390.323389,
        1484140391.323484,
        1484140392.324473,
        1484140393.325511,
        1484140394.326725,
        1484140395.327791,
        1484140396.328923,
        1484140397.329916,
        1484140398.330901,
        1484140399.332018
      ],
      "to": 1484140400,
      "type": "timeseries",
      "uid": "griffon-1",
      "values": [
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1725,
        1725,
        1725,
        1725,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748,
        1748
      ]
    },
    {
      "from": 1484140370,
      "links": [
        {
          "href": "/sid/sites/nancy/metrics/power/timeseries/griffon-7",
          "rel": "self",
          "type": "application/vnd.fr.grid5000.api.Timeseries+json;level=1"
        },
        {
          "href": "/sid/sites/nancy/metrics/power",
          "rel": "parent",
          "type": "application/vnd.fr.grid5000.api.Metric+json;level=1"
        }
      ],
      "resolution": 1,
      "timestamps": [
        1484140370.725357,
        1484140371.727147,
        1484140372.728358,
        1484140373.729346,
        1484140374.730353,
        1484140375.731352,
        1484140376.733535,
        1484140377.734541,
        1484140378.735575,
        1484140379.738191,
        1484140380.739844,
        1484140381.740834,
        1484140382.741965,
        1484140383.742963,
        1484140384.74584,
        1484140385.746915,
        1484140386.748339,
        1484140387.749368,
        1484140388.750383,
        1484140389.752945,
        1484140390.755007,
        1484140391.757661,
        1484140392.758684,
        1484140393.759485,
        1484140394.760509,
        1484140395.761545,
        1484140396.762548,
        1484140397.763941,
        1484140398.764995,
        1484140399.76629
      ],
      "to": 1484140400,
      "type": "timeseries",
      "uid": "griffon-7",
      "values": [
        1449,
        1449,
        1449,
        1449,
        1449,
        1449,
        1449,
        1449,
        1449,
        1449,
        1403,
        1403,
        1403,
        1403,
        1426,
        1426,
        1426,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403,
        1403
      ]
    }
  ],
  "links": [
    {
      "href": "/sid/nancy",
      "rel": "self",
      "type": "application/vnd.fr.grid5000.api.Collection+json;level=1"
    },
    {
      "href": "/sid/sites/nancy",
      "rel": "parent",
      "type": "application/vnd.fr.grid5000.api.Metric+json;level=1"
    }
  ],
  "offset": 0,
  "total": 2
}

For POWER Monitoring

A specific probe can be accessed via: