Skip to content

Troubleshooting

This section provides procedures for diagnosing and resolving common issues encountered with the SAP Agent 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

TLS Certificate Validation

If certificate validation fails (e.g., when using self-signed certificates), the Plugins.SAPAGENT.Sessions.<SessionName>.TLSInsecureSkipVerify parameter may be set to true in the plugin configuration file. Note that this should be evaluated against organizational security policies.

Connection Refused

Verify the SAP Host Agent is running and listening on the configured port (default 1128/1129).

SOAP Authorization Failure

Ensure that the credentials used (typically the sapadm user) have the requisite permissions to access the SOAP interface.

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.