IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > Adapter Toolkit > Implementing code from the IBM WebSphere Adapter Toolkit > Problem determination > Monitoring and measuring performance > First failure data capture (FFDC)

First failure data capture (FFDC) support

The adapter supports first failure data capture (FFDC), which provides persistent records of failures and significant software incidents that occur during run time in IBM BPM or WebSphere Enterprise Service Bus.

The FFDC feature runs in the background and collects events and errors that occur at run time. The feature provides a means for associating failures to one another, allowing software to link the effects of a failure to their causes, and thereby facilitate the quick location of the root cause of a failure. The data that is captured can be used to identify exception processing that occurred during the adapter run time.

When a problem occurs, the adapter writes exception messages and context data to a log file, which is in the INSTALL_ROOT/profiles/profile/logs/ffdc directory.

For more information about first-failure data capture (FFDC), see the IBM BPM or WebSphere Enterprise Service Bus documentation.

To get the FFDC (First Failure Data Capture) specific diagnostic data for the adapter that needs to implement following logutils.logffdc method (example given below) in the catch block of the exception handling.

import com.ibm.j2ca.extension.logging.LogUtils;

try{
----
----}catch (Exception e){

LogUtils.logFfdc(e, ManagedConnection.class, 
"ManagedConnection", "getWBIConnection", null);}

AFC plays as the upper classes in the call chain so it can cover inbound and cursor portion, but the following components in AFC are just interface or abstract, so custom adapters have to invoke logFfdc themselves:

logFfdc is considered to be used in runtime rather than EMD tooling time.

First failure data capture (FFDC)