Skip to content

Fields


Definition of Fields

Fields represent data tracked by the system for a company. They are categorized by purpose and can be used for both monitoring and configuration. Fields are also used for data presentation on dashboards, bulk or individual configuration, alerts, and other features.

How Fields Work

Fields are a core building block for customizing views in both the Company Dashboard and Device Dashboard. They allow users to tailor displayed information to their operational needs.

  • When a field is added to a dashboard, it appears as a widget or as a column in a table, providing real-time or aggregated data.
  • Editable fields can be modified directly from the dashboard using the edit (pencil) icon.

In the example below, fields are displayed as columns in the Company Dashboard table, and editable values can be changed inline:

Fields

Field Categories

On the Fields page, fields can be filtered by their reporting behavior (Never, Always, or On Change), as well as by name, reset period, or description.

Fields

Fields are grouped into categories to simplify management and usage.

Static Fields

Static fields contain information that typically does not change over time. Some static fields (such as Name or Description) can be edited, but their values remain constant until changed manually.

Examples include:

  • Device ID
  • MAC Address
  • Name
  • Description
  • Serial Number
  • IMEI
  • VPN IP Address (if VPN is initialized)
  • VPN Proxy Link (if VPN is initialized)
  • VPN Subnet (if VPN is initialized)

Monitoring Fields

Monitoring fields provide real-time or periodically updated information about a device’s status and performance.

Examples include:

  • Connection Status
  • Data Downloaded (recent)
  • Data Uploaded (recent)
  • DMP Client Version
  • Firmware Version
  • Mobile Operator
  • CPU Usage
    Note: CPU usage uses the same units as the Linux top command. For example, 391 % means full utilization of approximately four CPU cores.
  • WAN Interface Name

Cumulative Fields

Cumulative fields aggregate monitoring data over time to provide long-term insight. A periodic reset can be configured for this type of field.

Examples include:

  • Data Downloaded (cumulative)
  • Data Uploaded (cumulative)
  • Data Up+Down (cumulative)
  • Reconnects Count
  • VPN Connected (if VPN is initialized)

Configuration Fields

Configuration fields define device settings and desired configuration values.

Examples include:

  • Configuration Profile
  • Unique Script
  • User Password
  • Other device-specific configuration parameters

Configuration Fields

Default Fields

A set of default fields is available by default in the Fields section of the side menu.
Additional fields can be explored via the Create Field dialog by clicking + Create on the Fields page.

Name of graph/widgetDescription
Claimed DateDate when the device was claimed.
Configuration ProfileAssigned configuration profile.
Connection StatusCurrent device connection status.
Data Downloaded (recent)Amount of data downloaded during the last monitoring period.
Data Up+Down (cumulative)Total amount of uploaded and downloaded data.
Data Up+Down (recent)Uploaded and downloaded data during the last monitoring period.
Data Uploaded (recent)Amount of data uploaded during the last monitoring period.
Date CreatedDate when the device was created on the server (typically the manufacture date).
DescriptionDevice description.
Device IDUnique device identifier.
Device TypeDevice model/type.
DMP Client VersionVersion of the DMP client installed on the device.
Firmware VersionFirmware version installed on the device.
IMEIDevice IMEI (if applicable).
MAC AddressMAC address of the primary LAN interface.
Mobile OperatorName of the mobile operator.
Mobile TechnologyMobile technology (e.g., GSM, UMTS, LTE); N/A if no SIM is present.
NameDevice name.
Online/Offline SinceTimestamp of the last connection or disconnection event.
Reconnects CountNumber of times the device transitioned from offline to online.
Serial NumberDevice serial number.
SIM CardActive SIM card.
Synchronization StatusCurrent device synchronization status.
VPN ConnectedIndicates whether the device is connected to the VPN hub (if initialized).
VPN IP AddressVPN IP address (if VPN is initialized).
VPN Proxy LinkLink to access the router UI via VPN (if VPN is initialized).
VPN SubnetVPN subnet (if VPN is initialized).
WAN Interface NameName of the WAN interface.

Creating and Removing Fields

Creating Fields

  1. Click + Create on the Fields page, or enter Edit View mode on a dashboard.

Creating Fields

  1. Click + Create Field to open the field selection panel.
  2. Select the desired field from the available categories.
  3. Specify a display name.
  4. Click Save to add the field.

Creating Fields

Removing Fields

  1. In the side menu, open Fields and locate the field you want to remove.
  2. Click the Delete (trash) icon next to the field.

Note: Some fields, such as certain Static fields, cannot be removed.

Removing Fields

  1. Confirm the removal.