Command: Configure Trace

Symbol:

Function: The command opens the Trace Configuration dialog.

Call: Context menu of the visualization element, then Trace property of the visualization element

Requirement: An element of type Trace is open in the editor.

Dialog: Trace Configuration

The tree view shows the trace configuration and allows navigation.

The top entry contains the trace name. When this entry is selected, the Record Settings group appears in the adjacent view.

An entry is located here for each variable whose data was recorded continuously. When a variable is selected, the Variable Settings group appears in the adjacent view.

Add Variable

Adds a new entry to the trace configuration

Result: A blank configuration appears next to the new variable under Variable Settings. You configure the variable there.

Delete Variable

Removes the selected variable

Recording settings

A trigger can be configured in the trace only.
Task	Task where the data is recorded
Record condition	Recording condition for which the application records data at runtime Variable (`BOOL`)
Comment	Example: `Acquiring data only when all conditions are true.`
Resolution	Unit of measure for the time stamp which is recorded per data set ms: Time stamp (in ms) µs: Time stamp (in µs) for a task cycle time of 1 ms or less
Automatic restart	: Recording starts automatically as soon as the trace has been started one time and then the controller was restarted. The trace configuration and the contents of the trace buffer are saved persistently to a file on the target system. Format: `.trace.csv`
Display	Display Settings opens.
Advanced	The Advanced Trace Settings dialog opens.
Copy from Trace	The Copy Settings from Trace Instance dialog opens. Tip If you have already created an existing trace configuration from a trace object, then you can copy the configuration data to the visualization element. To do this, select the respective object.

Variable Settings

Variable	Variable for recorded value Variable (valid data type) Property Reference Contents of a pointer Array element (base type with valid data type) Enumeration (base type with valid data type) Valid data types are all standard types, except `STRING`, `WSTRING`, and `ARRAY`.
Parameters	Parameter for the recorded value : The Input Assistant lists all valid parameters of the controller.
	Allows for toggling between Variable and Parameter
Attached y axis	Y-axis of the trace diagram for the Variable : Selection of the standard Y-axis and the additional configured Y-axes Note The additional configured Y-axes are configured in the Edit Display Settings dialog.
Display variable name	: The trace graphs are displayed in tooltip with their variable names. If a text is also specified in Description, then the text is displayed first with the variable names in parentheses. Example: `Sensor A (PLC_PRG.iSensor_A)` If Description does not contain any text, then the Display Variable Name property is enabled automatically. Then only the name is displayed (example: `PLC_PRG.iSensor_A`). : The trace graphs are displayed in tooltip without their variable names. Only the text in Description is displayed.
Description	Text for the tooltip It is displayed when a visualization user moves the cursor in the trace diagram. Example: `Sensor A` The text also is entered into the GlobalTextList object and can be localized there.
Color	Color of the graph in the diagram
Line type	Representation of the graph as a line chart Line: Values are linked to form a line. Step: Values are linked in the form of steps. None: Values are not linked.
Line width	In pixels Example: `1`
Line style	The display of the line is solid, dash, dot, dash-dot, or dash-dot-dot.
Point type	Representation of the graph as a scatter chart This configuration entry with the Line type determines the appearance of the graph. Dot: Every value as a dot Cross: Every value as a cross None Note For Dot or Cross, a "paint buffer overflow" can result from many recorded variables.
Activate minimum warning	: When below the lower limit, the visualization shows the trace graphs in the alert color.
Critical lower limit	Minimum value Example: `10`
Color	Warning color when the value falls below the limit
Activate maximum warning	: When above the upper limit, the visualization shows the trace graphs in the alert color.
Critical upper limit	Maximum value Example: `90`
Color	Warning color when the value exceeds the limit
Dynamic Display Options
Variable for visibility	Variable (`BOOL`) or as bit access for controlling the visibility of variables in the trace diagram `TRUE`: Visible `FALSE`: Invisible