生成首次故障数据捕获 (FFDC) 记录

FFDC 记录包含代码捕捉到意外异常时所记录的异常堆栈及其他可选数据。com.ibm.ws.ffdc.FFDCFilter 类上的方法用来生成这些记录,并且有一些方法可能促使捕获各种数据。

示例

FFDCFilter 类的典型用法如下所示:
try{
            // … do something
    } catch (Exception e) {
            FFDCFilter.processException(e, getClass().getName(), unique-probe-id);
            if (TraceComponent.isAnyTracingEnabled() && tc.isDebugEnabled()) {
                Tr.debug(tc, "Exception when doing something; " + e);
            }
            return;
    }

其中,源标识(本示例中的类名)和唯一探测器标识(通常为原代码行号)会组合,以提供生成结果记录的源代码中的确切位置。缺省情况下,记录会写入 ${server.output.dir}/logs/ffdc 目录。

持续发生异常的情况下,FFDC 记录所使用的文件空间受重复记录自动过滤功能限制。对于任何匹配源标识、探测器标识和异常名称,每天最多写入带独有消息的 10 个异常。

功能部件代码可以通过向 FFDC 类注册 com.ibm.ws.ffdc.DiagnosticModule 实现,将数据提供给 FFDC 记录。功能部件代码也可以通过向 FFDC 类注册 com.ibm.wsspi.logging.IncidentForwarder 实现来拦截 FFDC 记录。


用于指示主题类型的图标 任务主题

文件名:twlp_feat_ffdc.html