Skip to main content

i4scada Knowledge Base

i4scada Log Conditions

Abstract

Log conditions are criteria to be met in order to record the signal values of the specified signals, defined by comparison to a constant or another signal value.

Log conditions can be defined using the dedicated view, which can be found in the Studio Logging section. The Log conditions view displays a list of all existing log conditions and allows the user to add new ones.

Logging_with_UoM.jpg

Logging Area

Log conditions are criteria to be met in order to record the signal values of the specified signals. The log conditions are defined by comparison to a constant or another signal value. The user can define different logs and conditions for each server in the i4scada Studio.

Right-clicking on the Log Conditions item in the Logging tree menu will open the contextual menu. The Log Conditions contextual menu provides a single option for creating new log conditions.

Capture1621.jpg

Log Conditions contextual menu

Contextual menu of Log Conditions node

Description

New

Creates new log condition

Right-clicking on an existing log condition listed in the main panel will open the contextual menu, providing the options to edit, copy, add or delete log conditions, expand or collapse the Log Condition Details panel and refresh the log conditions list.

Capture1635.jpg

Listed Log Conditions contextual menu

UI Option

Description

Edit

Edits the cell in which the contextual menu has been opened (where the user right-clicked).

Copy

Copies the selected log condition for the desired amount of times.

Capture1639.jpg

Copy Log conditions

New

Creates new log condition.

Delete

Deletes the selected log condition.

Log Condition Details

Expand/Collapse the Log Condition Details panel.

Refresh

Reloads the list of log conditions.

The user can define a set of specific Logging condition attributes:

  • Condition Name - The name of the Log Condition.

  • Log Mode - The available Log Modes for triggering the signal value logging:

    • Time triggered: logs the signal value once per cycle (the cycle is defined by the Log Interval).

    • Time triggered, when signal value > constant value: logs the signal value once per cycle (Log Interval) if the signal value is bigger than the constant value (Log Constant).

    • Time triggered, when signal value < constant value: logs the signal value once per cycle (Log Interval) if the signal value is smaller than the constant value (Log Constant).

    • Time triggered, when signal value > signal value 2: logs the signal value once per cycle (Log Interval) if the signal value is bigger than the value of another selected signal (Signal Value 2).

    • Time triggered, when signal value < signal value 2: logs the signal value once per cycle (Log Interval) if the signal value is smaller than the value of another selected signal (Signal Value 2).

    • Time triggered, when signal value = constant value: logs the signal value once per cycle (Log Interval) if the signal value is equal to the constant value (Log Constant).

    • Time triggered, when signal value <> constant value: logs the signal value once per cycle (Log Interval) if the signal value is different from the constant value (Log Constant).

    • Only on change: logs the signal value when it changes. The minimum time interval for logging is defined by the Update Time for each connector.

    • Only on change, when signal value > constant value: logs the signal value when it changes if the signal value is bigger than the constant value (Log Constant).

    • Only on change, when signal value < constant value: logs the signal value when it changes if the signal value is smaller than the constant value (Log Constant).

    • Only on change, when signal value > signal value 2: logs the signal value when it changes if the signal value is bigger than the value of another selected signal (Signal Value 2).

    • Only on change, when signal value < signal value 2: logs the signal value when it changes if the signal value is smaller than the value of another selected signal (Signal Value 2).

    • Only on change, when signal value 2 = constant value: logs the signal value when it changes if the value of another selected signal (Signal Value 2) is equal to the constant value (Log Constant).

    • Only on change, when signal value 2 <> constant value: logs the signal value when it changes if the value of another selected signal (Signal Value 2) is different from the constant value (Log Constant).

    • Mean value: logs the average signal value once per cycle (Log Interval). The average is computed on a time span defined by the Report Interval.

    • Counter mean value: logs the total average value once per cycle (Log Interval).

    • Stored once, when the signal value 2 = constant value: logs the signal value once, when the value of another selected signal (Signal Value 2) is equal to the constant value (Log Constant).

    • Stored once, when the signal value 2 <> constant value: logs the signal value once, when the value of another selected signal (Signal Value 2) is different from the constant value (Log Constant).

    • Stored once, when the signal value 2 < constant value: logs the signal value once, when the value of another selected signal (Signal Value 2) is smaller than the constant value (Log Constant).

    • Stored once, when the signal value 2 > constant value: logs the signal value once, when the value of another selected signal (Signal Value 2) is bigger than the constant value (Log Constant).

    • Stored once, when the signal value 2 changes: logs the signal value once, when the value of another selected signal (Signal Value 2) changes.

  • Log Interval - The time interval when signal value logging triggering occurs. The interval can be selected from the drop-down list, where a set of predefined values are available:

    • N/A - not defined

    • 1, 2, 3, 4, 5, 10, 20 or, 30 Second(s)

    • 1, 2, 3, 4, 5, 10, 15, 20 or, 30 Minute(s)

    • 1, 2, 3, 6 or 12 Hour(s)

    • 1 Day(s)

  • Log Constant - The value of the Log Constant. This field becomes active upon selection of particular Log Modes.

  • Signal Value 2 - The second signal used in the log condition definition.

  • Report Interval - The time span computing average values for the signal value logging. This field becomes active only upon selection of Log Modes "Mean value" and "Counter mean value". The interval can be selected from the drop-down list, where a set of predefined values are available:

    • N/A - not defined

    • 1, 2, 3, 4, 5, 10, 20 or, 30 Second(s)

    • 1, 2, 3, 4, 5, 10, 15, 20 or, 30 Minute(s)

    • 1, 2, 3, 6 or 12 Hour(s)

    • 1 Day(s)

  • Inactivity Interval - Represents the time frame between two consecutive updates measured in milliseconds. Having the inactivity interval defined, the Signal value logging will occur each time, considering the time frame, regardless if the Signal value is changed or not.

  • Is Relative Inactivity Interval - By enabling this field, the log inactivity interval is relative. Hence, a value will be logged, within the defined inactivity interval, considering the last logged value.

    Note

    The scope of Inactivity Interval and Is Relative Inactivity Interval settings is to avoid potential Signal gaps.

Log_condition_details.jpg

Log conditions details