Enable the OPC UA trace log
- Last UpdatedOct 29, 2026
- 2 minute read
If you are having problems with OPC UA communications during project run time, you can have the project runtime server generate an OPC UA trace log.
This trace log is in addition to the project runtime log that is displayed in the Output window and LogWin tool. It contains much of the same information as the project runtime log (assuming the project runtime log is configured to include OPC UA messages), but it is saved to an external file and it can be configured to capture even more detailed information.
To enable the OPC UA trace log:
-
Stop your project if it is running, and then exit the software.
-
Use a text editor (such as Notepad) to open your project file (<project name>.APP) and add the following properties:
[OPC]
UaLogPath=<file path and name>
UaTraceLevel=<level>
For UaLogPath, the file path is relative to your project folder. As such, if you specify only a file name (for example, opcualog.txt), the file will be saved in your project folder. Keep in mind that the file path should be appropriate for the computer or device that hosts the project runtime server, not necessarily for the computer that you are using to develop your project.
For UaTraceLevel, select one of the following values:
Level
Description
0
NoTrace – Disables the trace.
This is the default if UaLogPath is not configured.
1
Errors – Internal system errors that require bug fixing.
2
Warnings – Internal system warnings and external errors.
This is the default if UaLogPath is configured.
3
Info – More detailed information about system events.
4
InterfaceCall – Information needed for debugging.
5
CtorDtor – Information needed for debugging.
6
Program – All message content.
7
FlowData – All messages.
Note: The trace levels are cumulative, which means Level 2 includes Level 1, Level 3 includes Levels 1 and 2, and so on.
-
Save and close your project file.
The next time you run your project, the log file is saved at the specified location. The file will continue to grow as long as the project runs and the trace log is enabled, and the higher the trace level, the more quickly the file will grow.