Skip to content

Troubleshooting

This section provides procedures for diagnosing and resolving common issues encountered with the OPC UA plugin.

Logging

The primary source for diagnostic information is the Zabbix Agent 2 log file. To obtain detailed information regarding plugin operations, increase the DebugLevel in the zabbix_agent2.conf file and restart the agent service.

Common Issues

Security Policy and Certificate Validation

If connection fails due to security settings or certificate validation errors, verify that CertFile and KeyFile paths are correctly pointed to valid X.509 client certificate and RSA key files in your session configuration, and ensure that SecurityMode and SecurityPolicy match the requirements of the OPC UA server endpoint.

Connection Refused / Server Unreachable

Verify that the target OPC UA server is active, accessible over the network, and accepting connections on the specified port (default 4840 using the opc.tcp protocol).

RavenLayer is an independent software provider and is not affiliated with, sponsored by, or endorsed by Zabbix SIA or SAP SE. Zabbix is a trademark of Zabbix SIA. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE in Germany and other countries. The software is provided "as is", without warranty of any kind.