Logging
- Last UpdatedJul 08, 2025
- 2 minute read
The S7TCP driver can log combinations of trace levels across different categories. This is achieved by setting the following INI parameters.
[S7TCP]DebugLevel
This parameter allows you to define the trace level. The options include:
|
WARN |
Output warning messages. |
|
ERROR |
Output error messages. |
|
TRACE |
Output trace messages. |
|
DEBUG |
Output debug messages. |
|
ALL |
All of the above. |
You can use a combination of these options separated by a pipe character ( | ).
|
|
|
Setting [S7TCP]DebugLevel to DEBUG or ALL will cause the driver to log a large amount of debugging information (for example, sent and received protocol messages in binary format). This information is typically unnecessary for driver diagnostics and may result in multiple wraparounds that write over data. |
Example
[S7TCP]
DebugLevel=WARN|ERROR|TRACE
[S7TCP]DebugCategory
This parameter allows you to enable logging for a particular category of trace. The options include:
|
PROT |
Operations related to the OPC protocol interface |
|
DCB |
Front end driver trace |
|
MISC |
Miscellaneous operations |
|
ALL |
All of the above |
You can use ALL or a combination of these options separated by a pipe character ( | ).
Example
[S7TCP]
DebugLevel=WARN|ERROR|TRACE
DebugCategory=ALL
Note: These parameters do not have a value specified by default. To enable logging for this driver, you need to manually configure these parameters in your INI file.
The events generated by the S7TCP driver are logged in the following Plant SCADA syslog file:
syslog.IOServer.<Cluster name>.<IO Server name>.dat
This file is located in the directory specified by the Citect.ini parameter [CtEdit]Logs. By default, this location will be:
%PROGRAMDATA%\AVEVA Plant SCADA <VersionNumber>\Logs
The size of the syslog file and its rollover process is configured via the [Debug]SysLogSize and [Debug]SysLogArchive INI parameters. For more information, see the topic Debug Parameters in the Plant SCADA documentation.
Note: If the number of messages being processed for a driver exceeds the value specified by the Plant SCADA parameter [Kernel]ErrorBuffers, the pending messages will not be logged. If this occurs, you can increase the value of this parameter so that all the messages generated by the driver are reported. The number of messages that are not logged can be monitored via the Kernel's General window under the item "Lost Errors". If you adjust [Kernel]ErrorBuffers and Lost Errors are still occurring, you may need to adjust the level of system logging.