Process Variables
The
Process Variables section lists the process variables
that
Device Security discovers for the device through observed
Industrial Control System (ICS) traffic. It appears only for
devices classified as
industrial controllers, and only when your tenant
has the
Industrial vertical theme
enabled.
Process variables represent individual data points read from or written to a
controller — for example, sensor readings, setpoints, or status flags — identified
by a label and a protocol through
App-ID.
Device Security passively discovers them
from network traffic without requiring any configuration on the device itself.
If no process variables appear, verify that
Device Security has visibility
into the relevant ICS traffic for the device.
The table displays one row per discovered process variable and includes the
following columns:
- Name — The human-readable display name for the variable. You can
customize this name to reflect the variable's meaning in your environment.
- Label — The identifier assigned to the variable by the controller
or the protocol.
- Type — The data type of the variable: Numeric, Boolean, or String.
- App-ID — The protocol used to communicate with the variable
(for example, Modbus).
- Monitoring Status — Whether Device Security is actively logging
value changes for the variable. Displays Monitoring
when enabled and Not Monitoring when disabled.
- Last Activity — The timestamp of the most recent observed
read or write for the variable.
To enable or disable value logging for one or more variables, select the
corresponding rows and then click Start Monitoring or
Stop Monitoring. Only variables whose current monitoring
status matches the action are affected — selecting
Start Monitoring has no effect on variables that are
already being monitored, and vice versa.
Variable Details
Click the name of any variable to open its detail side sheet, which provides
deeper information about the selected variable and lets you manage it without
leaving the device detail page.
The Basic Information panel displays the following
fields for the variable:
- Label — The variable's protocol-assigned identifier.
- Type — The data type (Numeric, Boolean, or String).
- App-ID — The protocol used to communicate with the variable.
- Last Activity — The timestamp of the most recent observed
read or write.
- Last Function Code — The most recent protocol function code
observed for the variable.
- Number of Reads — The total count of observed read operations.
- Last Value — The most recently observed value.
- Last Change — The timestamp when the value last changed.
- Unit — The engineering unit for the value (for example, °C or bar),
if configured.
- Scale — A multiplier applied to the raw value to derive the
displayed value. For numeric variables, this can be customized.
- Offset — A value added to the scaled raw value to derive the
displayed value. For numeric variables, this can be customized.
- Number of Changes — The total count of observed value changes.
Click Edit in the Basic Information panel to open the
Edit Variable Basic Information dialog, where you can
update the variable's display name. For numeric variables, you can also set
the unit of measure, and apply a scale and offset that Device Security
uses to convert the raw value into a meaningful engineering value, such that
Output = (Raw Value x Scale) + Offset.
For Numeric and Boolean variables, the side sheet also includes
a Value Trend panel that charts the variable's observed
values over a selected time range (hour, day, week, or month). If you enable
monitoring for the variable, then you can define a time range and
Set Alert Thresholds for the variable. If monitoring is
disabled, the trend panel prompts you to start monitoring so that
Device Security begins logging values for the variable.
Click Set Alert Thresholds to open the
Configure Variable Thresholds dialog. The dialog
displays a live trend chart preview on the left, and a configuration form
on the right where you can set a high limit, a low limit, and optional
alerting parameters. When both a high and low limit are defined, the
high limit must be greater than the low limit. If you enable threshold
alerting, you can specify the alert severity (Critical, High, Medium, or Low),
the minimum duration a threshold must be exceeded before an alert is
generated, and the daily time window during which alerting is active.
For monitored variables, the side sheet also includes a
Transmission History panel that lists the individual
read and write transactions observed for the variable. Each row shows the
client device name, client IP address, timestamp, value transmitted, and the
protocol function code. Clicking a client name in the list opens that
device's detail page in a new tab.
Use the download button in the side sheet header to export the variable's
basic information and full transmission history to an Excel (.xlsx) file.
The download button is available only after the variable detail has loaded.
Copying a Variable Configuration
You can copy the configuration of a process variable — including its
name, unit, scale, offset, and threshold settings — from this device to
a matching variable on a different Industrial Controller. To copy a
variable, click . Select the target device
and then select the target variable label on that device. Both a device
and a variable label must be selected before you can confirm the copy.