Integration Broker Logging

Integration Broker logging can be very useful for troubleshooting messaging issues. This article goes through how to enable and view integration broker logs.

Integration Broker Gateway Properties

Integration broker logging settings are configured under: PeopleTools > Integration Broker > Configuration > Gateways.

Open your local Gateway (usually called LOCAL) and click on the Gateway Setup Properties.

Login to the gateway properties using the default user ID and password (they are provided on the page). You may need to ask your system administrator for the appropriate credentials if the default values do not work.

Once you login, click on the Advanced Properties Page link. This will open the integrationGateway.properties file and allow you to edit it.

Logging Settings

Scroll through the integrationGateway.properties file until you find the logging section. The following line is what sets the logging level (2 is the default):

ig.log.level=2

The logging levels are:

Level Value
-100 Suppress any logging
-1 Language Exception
1 Standard Gateway Exception
2 Errors and Warnings
3 Important information, errors and warnings
4 Standard and important information, errors and warnings
5 Low importance, standard, and important information, errors and warnings

The default log level of 2 should be sufficient for troubleshooting. You may want to turn up the logging in a test environment once you can replicate an issue for more detailed investigation.

Viewing the Logs

You can view the message and error logs using your browsing by pointing to:

If you are having trouble determining the URL for these, look at your local gateway URL or ping it and use the same URL up to the PSIGW/ and then enter the appropriate message log page name. Note that the names of the HTML files are case sensitive! So errorlog.html may not be found but errorLog.html (capital L in log) will be found.

Note that if there have been no messages or errors logged then these files won't exist. Their locations/names may also have been changed in the integrationGateway.properties file. Check the values of:

  • ig.messageLog.filename
  • ig.errorLog.filename
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License