DemandFlow Support Centre

ENVSENSOR: Environmental Sensor

A physical environmental monitoring sensor tracking temperature, humidity, airflow, or leak at a specific location.

Entity properties

Use cases

Environmental Sensor represents a physical monitoring device deployed at a specific location in the infrastructure hierarchy. Sensors can be placed at room level (ambient monitoring), on a rack (inlet/exhaust temperature), on a floor tile (underfloor airflow), or standalone in a corridor. The location model uses an objectLookup to ROOM as the mandatory parent, with optional rack and tile references to pinpoint exact placement - this avoids duplicating the sensor under multiple parent entities and keeps the hierarchy flat. sensorType uses an indexedSelect rather than a lookup entity because the list of sensor types is stable and well-known in the DCIM domain (temperature, humidity, differential pressure, airflow, water leak, power, vibration, smoke/particulate). Each sensor has a measurement configuration section (unit, polling interval, min/max range) that defines what the sensor measures and how often. The Current Readings panel provides readonly fields designed for integration with BMS, SNMP, or IoT platforms - the system would patch these values via API. Threshold fields (warning/critical high/low) drive alerting logic. The calibration and maintenance panel tracks sensor health and accuracy over time, which is essential for compliance in certified data centres. The entity deliberately does NOT store historical time-series data - that belongs in a time-series database or monitoring platform. This entity tracks the sensor asset, its location, configuration, current state, and maintenance lifecycle.

Fields

Sensor Identification

Location

Hardware Details

Current Readings

Alarm State

Statistics (24hr)

Temperature Thresholds

Humidity Thresholds

Calibration

Installation & Maintenance

Relationships

• Lookup: room (reference → ROOM).
• Lookup: rack (reference → RACK).
• Lookup: tile (reference → TILE).
• Lookup: manufacturer (reference → VEN).

Creating a Environmental Sensor via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "ENVSENSOR",
  "level":    276,
  "comboKey": "SUB:<your-sub-id>|ENT:",
  "name": "Example name",
  "sensorType": "1",
  "status": "1",
  "room": ""
}

Listing Environmental Sensors records

GET /v1/entities/ENVSENSOR/SUB:<your-sub-id>

See also

• The DemandFlow Object Model
• System Fields
• comboKey: Hierarchical Relationships