SAP PI PO Monitor

Monitors the amount of PI messages of status type system error, canceled , to be delivered, delivering and holding as summary and optionally per receiver interface component.

General

Executable	SAP_PI_PO_Monitor.exe
Connection method	HTTP
Ports	5$$13 (http) 5$$14 (https) ($$ = instance number)
Lookup files	itesys.sappipomonitor.certstatus.ovl

Default parameters

Parameter name	Possible values	Default	Description
Host	<ip> | <hostname>	empty	Hostname or IP of the target system. If you use a virtual hostname on your SAP servers, please use also the virtual host to connect.
SAPInstance	number (2) | 00 - 99	empty	Instance number of the SAP system
SAPUsername	string	empty	SAP user
SAPPassword	string	empty	Password of the SAP user

Sensor-specific parameters

Parameter name	Possible values	Default	Description
Url	<url>	http://<hostname>:5<SAPInstance>00/AdapterMessageMonitoring/basic?style=document	WSDL URL of AdapterMessageMonitoring You can overwrite the web service URL if a different binding has to be used EXAMPLES: https://<hostname>:5<SAPInstance>01/AdapterMessageMonitoring/ssl?style=document https://<hostname>:5<SAPInstance>01/AdapterMessageMonitoring/clientCert?style=document
Minutes		60	Past minutes to check
ReceiverInterfaceComponent		empty	name(s) of the receiver interface component (comma separated)
CheckCertificates	false | true	false	Defines whether the status of certificates should be checked or not.
KeyStores	<KeyStore1>,<KeyStore2>,…	*	Comma separated list of keystores to be checked.
WarningLimit	number | 0 - n	30	Number of days until certificate expiration to set the sensor to a warning state.
ErrorLimit	number | 0 - (<WarningLimit> - 1)	7	Number of days until certificate expiration to set the sensor to an error state.
DeliveringThreshold	number | 1 - 1440 (max. 24h)	60	Defines the threshold in minutes to be reached for the duration of a message in status delivering. Only messages with a higher duration will be counted in the channel Total messages status delivering

Channels

Channel name	Description	Lookup file
Total messages status systemError	Total number of messages in status systemError
Total messages status canceled	Total number of messages in status canceled
Total messages status toBeDelivered	Total number of messages in status toBeDelivered
Total messages status holding	Total number of messages in status holding
Total messages status delivering	Total number of messages in status delivering (messages are only counted if duration reaches the defined threshold in parameter DeliveringThreshold)
<receiver interface component> – Messages status systemError	Number of messages in status systemError for <receiver interface component>
<receiver interface component> – Messages status canceled	Number of messages in status canceled for <receiver interface component>
<receiver interface component> – Messages status toBeDelivered	Number of messages in status toBeDelivered for <receiver interface component>
<receiver interface component> – Messages status holding	Number of messages in status holding for <receiver interface component>
<receiver interface component> – Messages status delivering	Number of messages in status delivering for <receiver interface component> (messages are only counted if duration reaches the defined threshold in parameter DeliveringThreshold)
Keystore <name of keystore>	Status of the certificates belonging to the defined keystore

Lookup values

Values, states and texts defined in the lookup files of this sensor.

Lookup file: itesys.sappipomonitor.certstatus.ovl

Value	State	Description
0	OK	Certificates valid
1	Warning	Certificates will expire soon
2	Error	Certificates will expire very soon
3	Error	Certificates have expired

Important notes

warning

Only the first 10.000 messages in the last “Minutes” are collected.

warning

Please check the channel limits in PRTG if they fit for your alerting.

Troubleshooting

Error Code	Error Message	Possible Solution
[SCN-072-000]	The following parameters has not been provided: <parameters> Please read the sensor documentation for further information!	Specify the listed parameters in the profile or in the sensor-specific parameters.
[SCN-072-051]	Parameter "Minutes" is not a correct integer value!	Specify a number between 1 and 1440 in the parameter Minutes.
[SCN-072-052]	Parameter "Minutes" cannot be more than 1440 (24h)!	Specify a number between 1 and 1440 in the parameter Minutes.
[SCN-072-053]	Parameter "DeliveringThreshold" has to be a valid integer!	Specify an integer in the parameter DeliveringThreshold.
[SCN-072-054]	Parameter "WarningLimit" has to be a valid integer!	Specify an integer in the parameter WarningLimit.
[SCN-072-055]	Parameter "ErrorLimit" has to be a valid integer!	Specify an integer in the parameter ErrorLimit.
[SCN-072-056]	Parameter "ErrorLimit" should be less than "WarningLimit"!	Adjust the parameters ErrorLimit and WarningLimit.
-	Sensor does not show all faulty messages	The value for parameter Minutes is too small The value of the sensor interval is bigger than the value of the parameter Minutes The limit of collected messages (10.000) has been reached

Changelog

Version	Changes
2024.04	Added new channels for messages in status toBeDelivered and delivering Added new parameter DeliveringThreshold to define a threshold for messages in status delivering
2023.06	Added new functionality to check the status of certificates belonging to defined keystores Added new parameters CheckCertificates, KeyStores, WarningLimit and ErrorLimit
2020.06	Added new parameter ReceiverInterfaceComponent Added new channels holding messages & message status per receiver interface component The WSDL URL of AdapterMessageMonitoring is created automatically
1.3.6.0	First stable release