Logging and tracing for Process Federation Server

Process Federation Server has a unified logging component that handles messages that are written by Process Federation Server and provides First Failure Data Capture (FFDC) services. Additionally, the logging component captures messages that are written to the System.out, System.err, java.util.logging, and OSGi logging files.

About this task

You can configure the trace information that is written to the log files through properties in the server.xml configuration file for Process Federation Server. The <logging> element contains the trace specifications for the Process Federation Server components:

<logging consoleLogLevel="INFO" traceFormat="ENHANCED" traceSpecification="*=info" />

For more information about logging, see Logging and trace for the WebSphere Application Server Liberty profile.

Procedure

Open the server.xml configuration file for editing.
By default, the configuration file is in the pfs_install_root/usr/servers/server_name directory on Process Federation Server.

Extend the traceSpecification property for each component that you want to trace, for example,

traceSpecification="*=info:com.ibm.bpm.federated.*=all"
 "

The following table shows the available trace specifications for Process Federation Server components:

Table 1. Trace specifications for Process Federation Server components
Trace specification	Description
`com.ibm.bpm.federated.*=all`	Traces all the Process Federation Server components.
`com.ibm.bpm.federated.query.rest.*=all`	Traces requests from the Process Federation Server REST APIs.
`com.ibm.bpm.federated.indexer.bpd.=all` `com.ibm.bpm.federated.indexer.bpel.=all`	Traces the indexing service on federated systems. You can enable tracing for BPD systems, BPEL systems, or both.
`com.ibm.bpm.federated.retriever.bpd.=all` `com.ibm.bpm.federated.retriever.bpel.=all`	Traces the retrieval service on federated systems. You can enable tracing for BPD systems, BPEL systems, or both.
`com.ibm.bpm.elasticsearch.receiver.*=all`	Traces the Elasticsearch indexing methods.
`com.ibm.wbimonitor.partitioning.*=all`	Traces the indexer partitioning service. The service coordinates the indexing services across cluster members.
`com.ibm.bpm.elasticsearch.client.*=all`	Traces the remote Elasticsearch client.
`com.ibm.bpm.query.rest.SAVED_SEARCH_PERFORMANCE_LOGGER=all`	Traces performance of saved searches