System status

System status

DESC
The status endpoint returns almost all data around the current system status, load, system health, thermal and fan sensors (if any), memory use, battery state, runtime, and more.
ROLES
readonly
URI
/system/status.json
/system/status.ekjson
/system/status.prettyjson
METHODS
GET POST
JSON
PARAMETERS

This endpoint takes additional parameters by using a `POST` request and supplying a JSON document or json form variable.

You can find more information about API parameters here.

fields field simplification OPTIONAL

Kismet can reduce the amount of information being processed and returned by an API by simplifying the fields to only return the data needed by the caller.

You can read more about the field simplification API and how to use it here.

RETURN
JSON object of system status snapshot.
RESPONSES
200
Basic success and JSON object
ERROR
On error (typically for malformed simplification)

Timestamp

DESC
Fetch the system timestamp as a second and microsecond; this can be used to synchronize timestamps with the UI or as a keep-alive check.
ROLES
readonly
URI
/system/timestamp.json
/system/timestamp.ekjson
/system/timestamp.prettyjson
METHODS
GET
RETURN
JSON object of the timestamp as second and microsecond.
RESPONSES
200
JSON object

Tracked fields

DESC

To aid in development, Kismet maintains a list of all known field names, data types, and descriptions.

This endpoint returns a human-readable HTML page of all fields.

ROLES
readonly
URI
/system/tracked_fields.html
METHODS
GET
RETURN
HTML document
RESPONSES
200
HTML document

Packet statistics

DESC

Kismet exposes the packet processing statistics as RRD (round robin database) collections for incoming packet rate, packet proessing rates, data size, and more.

The RRD format encodes long-running data as collections of decreasing accuracy, reporting the past 60 seconds, past hour as 60 second averages, and past day as 1 hour averages.

ROLES
readonly
URI
/packetchain/packet_stats.json
/packetchain/packet_stats.ekjson
/packetchain/packet_stats.prettyjson
METHODS
GET POST
JSON
PARAMETERS

This endpoint takes additional parameters by using a `POST` request and supplying a JSON document or json form variable.

You can find more information about API parameters here.

fields field simplification OPTIONAL

Kismet can reduce the amount of information being processed and returned by an API by simplifying the fields to only return the data needed by the caller.

You can read more about the field simplification API and how to use it here.

RETURN
JSON object of RRD packet stats.
RESPONSES
200
JSON object
ERROR
On error (typically for malformed simplification)

Dynamic Javascript import

DESC

Kismet creates a dynamically generated javascript file for the UI to load the core system and JS plugin modules into the global JS namespace.

This endpoint is meant to be used by a web-based UI and included as a script import, such as:

<script src="dynamic.js"></script>
ROLES
readonly
URI
/dynamic.js
METHODS
GET
RESPONSES
200
Success