Who this is for: anyone starting with Nebli Environment, and anyone reading its exports.
Where your network lives
Organisation (organización). Your organisation: a city agency, a resort or a research group. Everything you see and export stays inside it.
Site (sitio). A named place in your organisation, such as a corridor or an estate, with its own time zone. Nodes and rules belong to sites. Times on screen use the site's time zone. Exports and the API carry UTC with the offset.
What reports
Node (nodo). A thing in the field that reports, such as a smart pole. A node has a name, a kind, a site, a position and a status.
Kind (tipo). What sort of node it is, which decides the channels it carries. Nebli maintains the kinds; the first is the smart pole.
Channel (canal). One measured quantity, with a fixed unit: a temperature, a noise level, a particulate reading, the pole's battery. A node reports the channels its kind carries, and may report only some of them.
Reading (lectura). One value of one channel from one node at one moment. A reading is never edited after it arrives.
Device time and arrival time. Every reading carries both: when the device recorded it and when it reached Nebli Environment. Charts use the device time, so a reading that arrives late or out of order lands in the right place.
Suspect (sospechosa). A reading Nebli Environment keeps for diagnosis but does not trust: a channel the node's kind does not have, a value that is not possible, or a device whose clock is wrong. Suspect readings are counted on the network page.
Air-quality index (índice). A value computed from the pollutant readings rather than measured. Nebli Environment shows IBOCA, with five levels, and ICA, with six categories, each by its own method and never merged. Use the index your city uses.
% valid data (% datos válidos). For a node and a period, the share of the readings it should have sent that arrived and were not suspect. When a node sent nothing in the period, it shows as empty rather than 0%.
Status
Online (En línea), stale (Sin datos recientes), offline (Fuera de línea). Set by the last reading to arrive. A node is online while readings keep arriving; stale after three reporting intervals with nothing; offline after twelve. A smart pole reports every five minutes by default, so it goes stale after fifteen minutes and offline after an hour.
Retired (Retirado). A node taken out of service by a person. It accepts no new readings, keeps its history, and is hidden from the map by default.
How readings get in
Adapter (adaptador). The way readings and nodes enter Nebli Environment, such as a TALQ gateway or a sensor box sending over MQTT or HTTP. Each adapter has its own credential and can be stopped on its own without affecting the others.
Unclaimed node (nodo sin adoptar). A node that reported under an id nobody has registered. It belongs to the organisation of the adapter that reported it and waits on the network page.
Adopt (adoptar). Give an unclaimed node a site. Until it is adopted, a node is in no rule's scope.
Alerts
Alert rule (regla de alerta). A condition on one channel that opens an alert. You choose:
- a condition and a threshold, or for an index, a category ("category or worse");
- an average: instant, 1 hour, 8 hours or 24 hours, the periods air-quality standards use (a rule on an index has no average of its own: it reads the index at the end of each hour);
- how long the condition must hold before the alert opens;
- a clear margin: how far the value must come back inside the threshold before the alert closes, so a value hovering on the line does not open and close over and over;
- a cooldown: after an alert closes, how long before the same rule can reopen on the same node;
- optional active hours, such as 22:00 to 06:00 for night-time noise;
- the scope: which nodes the rule applies to.
Status rule (regla de estado). One per organisation. It opens an alert when a node stops reporting, with a probable cause read from the node's last readings: power (the battery falling before the silence, or the mains gone), link (the signal falling, or a switch to cellular), or sensor (one channel flat or missing while the others report).
Alert (alerta). A rule firing on a node. An alert is open until its condition clears for the same period it had to hold, or until a person closes it. A person can acknowledge it to show it is being handled.
Delivery target (destino de entrega). Where alert changes are sent besides the console, such as HikCentral, where an alert becomes an alarm on the camera on the same pole.