Skip to main content

Data Points

Data points are the fundamental building blocks of Mango. Each data point represents a single value being collected from a data source, whether that value comes from a physical sensor (temperature, pressure, flow rate), a calculated result (meta data point), or an internal system metric.

Every data point has a name, a device name, and an Export ID (XID) that uniquely identifies it across the system. Data points are always associated with exactly one data source, which determines how and when values are collected.

Key Concepts

Data points in Mango have several configurable aspects:

  • Data type -- Numeric, Binary, Multistate, Alphanumeric, or Image. The data type controls which event detectors, renderers, and rollups are available.
  • Logging settings -- How and when point values are persisted to the database. Logging can happen on every change, at fixed intervals, on every update, or not at all.
  • Tags -- Key-value metadata that provides flexible grouping and filtering beyond the device name and point name.
  • Properties -- Units, chart color, plot type, rollup defaults, and simplify settings that control how the point is displayed throughout the UI.
  • Event detectors -- Conditions attached to a point that raise alarms when thresholds are exceeded, values go stale, or states change unexpectedly.
  • Permissions -- Read and set permissions that control which users can view the point or write values to it.

In This Section

  • Creating and Configuring Data Points -- Step-by-step guide to creating data points, including navigating the data source editor, adding points, configuring point locators, selecting data types, and enabling or disabling points.
  • Data Point Properties Reference -- Comprehensive reference for data point properties including name, XID, device name, units, text renderers, chart renderers, logging settings, purge configuration, and permissions.
  • Logging Settings -- Configure how point values are stored: all data, on change, at intervals, or not at all. Includes purge settings and cache size.
  • Tags -- Add key-value metadata to data points for flexible querying, watch list building, and organizational structure.
  • Bulk Import -- Import and export large numbers of data points using CSV files and the bulk data point edit page.