Understanding Viewing Integration Gateway Logging Data in the Service Operations Monitor

This section provides an overview of viewing integration gateway logging data for service operations from the Service Operations Monitor.

Integration Gateway Logging Data

You can generate and view integration gateway logging data on an on-demand basis for outbound requests in the Service Operations Monitor.

When on-demand logging is enabled in the Service Operations Monitor, the integration gateway creates log files corresponding to the transaction IDs of outbound requests, that is <transaction ID>.html. Depending on the log level set, the standard integration gateway message log will also contain the transactional message logging data. Data logged also includes the URL of the gateway performing the logging, including the transaction ID and IP address. If you have implemented inbound load balancing using virtual application server domains, this information will help you determine the gateway that is performing the logging.

The location of the transaction logs is controlled by the integration gateway property ig.transactionLog.directory. By default the property is set to the following value:

<PIA_HOME>/peoplesoft/PSIGW.war/WEB-INF/directory

The default gateway logging data location is the same default directory for regular error and message logging. If you set the log level in the Service Operation Monitor to one of the error logging levels, the file is placed in the same directory as the errorLog.html file. If you set the log level in the Service Operation Monitor to one of the message logging levels, the file is placed in the same directory as the msgLog.html file.

As the transactional data in the Service Operations Monitor is archived or deleted, the system deletes the associated transactions gateway log file. You can also delete this file at anytime.

Integration Gateway Logging Data Access

When gateway logging is enabled, a View Gateway Logs link appears on the Asynchronous Details page for asynchronous transactions and on the Synchronous Details page for synchronous transactions to access the logs from PIA.

As described earlier, the default location for the logs is <PIA_HOME>/peoplesoft/PSIGW.war/WEB-INF/directory. Since /WEB-INF is not a public directory, the log files are not viewable from PIA by default, but they can be accessed via the file system.

To view gateway logs from PIA using the View Gateway Log links you must set the following path in the Gateway Logging URL field on the Monitor Setup Options page to a publicly accessible path, such as:

<PIA_HOME>/peoplesoft/PSIGW.war/

Important:

Before you change the write location of the gateway logging data consider potential security issues that doing so may present.