Ntrospect treats environmental telemetry as a first-class signal: wiring-closet heat, freezer excursions, and cooler failures are monitored under Infrastructure → Sensors, polled by a lightweight sensor agent that runs alongside the site gateway.

Add a sensor

Each sensor entry describes one probe on an SNMP-capable device (ControlByWeb-class units and similar):

  • Name — e.g. "Walk-in Freezer — Store 12"
  • Device IP and OID — the exact OID that returns the reading (e.g. 1.3.6.1.4.1.30586.46.0.12.0)
  • Class — a free-form grouping like freezer, cooler, or closet; classes drive notifications and access scoping
  • Site and Gateway — where it lives and which gateway polls it
  • Unit (e.g. °F) and Poll interval (e.g. 60s)
  • Threshold profile — see below

Sensors can be silenced individually during maintenance.

Threshold profiles

Profiles are reusable band definitions with four boundaries: Low error, Low warn, High warn, High error. A freezer profile might be error below −10°F, warn below −5°F, warn above 10°F, error above 15°F. Assign one profile to many sensors of the same class.

Notification monitors

Monitors decide who hears about excursions and when:

  • Sensor class — blank applies to all classes
  • Notify recipient group — from Settings → Recipients
  • Warning delay / Error delay (minutes) — how long a reading must stay out of band before notifying; this is your defrost-cycle filter
  • Warning channels / Error channels — route warnings to chat, errors to paging
  • Re-notify every (minutes) — 0 sends once per excursion

Agent configuration

The sensor agent reads its config from /etc/ntersect/sensor-agent.yaml on the gateway host (OTLP endpoint, poll interval, platform URL/key, and the SNMPv3 credential block: user, auth SHA/MD5, privacy AES/DES). Credentials stay local to the site — the platform never stores or returns SNMP credentials for sensors.

Scoped access

The obs:sensors role grants access to sensor views only — scoped to selected sensor classes — with no access to the rest of the platform. Useful for facilities staff who need freezer visibility and nothing else. See Managing Users, Roles, and Access.