程序包 ohos.hiviewdfx

类 FaultLogger

java.lang.Object

ohos.hiviewdfx.FaultLogger

public final class FaultLogger
extends Object

Manages the logging of application faults. Applications can use this class to query their fault records.

Applications may become unavailable due to code defects or runtime exceptions. Such situations are considered application faults. When a fault occurs, the fault information is recorded for locating the cause and fixing the fault. Sample code for querying fault records is as follows:

    Optional<FaultLogger.FaultLogQueryResult> resultOpt = FaultLogger.querySelfFaultLog(FaultLogger.FAULT_TYPE_NO_SPECIFIC, 10);
    if (resultOpt.isPresent()) {
        FaultLogger.FaultLogQueryResult result = resultOpt.get();
        while (result.hasNext()) {
            Optional<FaultLogger.FaultLogInfo> infoOpt = result.next();
            infoOpt.ifPresent((info) -> {
                // Obtain detailed fault information.
            });
        }
        // Destroy the query result.
        result.destroy();
    }
 

A fault query may be time-consuming. Do not query fault records in the main thread or in performance-sensitive scenarios, for example, during application startup.

从以下版本开始:

5

另请参阅:

FaultLogger.FaultLogInfo, FaultLogger.FaultLogQueryResult

嵌套类概要

嵌套类

限定符和类型	类	说明
static class	FaultLogger.FaultLogInfo	Represents an application fault record.
static class	FaultLogger.FaultLogQueryResult	Represents the query result of application fault records.

字段概要

字段

限定符和类型	字段	说明
static int	FAULT_TYPE_APP_FREEZE	Indicates application freezing fault records are queried.
static int	FAULT_TYPE_CPP_CRASH	Indicates that crash fault records in the C/C++ code are queried.
static int	FAULT_TYPE_JAVA_CRASH	Indicates that crash fault records in the Java code are queried.
static int	FAULT_TYPE_JS_CRASH	Indicates that crash fault records in the JavaScript code are queried.
static int	FAULT_TYPE_NO_SPECIFIC	Indicates that no fault type is specified, that is, records for all supported fault types are queried.

构造器概要

构造器

构造器	说明
FaultLogger()

方法概要

限定符和类型	方法	说明
static Optional<FaultLogger.FaultLogQueryResult>	querySelfFaultLog(int type, int maxNum)	Queries fault records of your application.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

FAULT_TYPE_APP_FREEZE

public static final int FAULT_TYPE_APP_FREEZE

Indicates application freezing fault records are queried.

从以下版本开始:

5

另请参阅:

querySelfFaultLog(int, int), 常量字段值

FAULT_TYPE_CPP_CRASH

public static final int FAULT_TYPE_CPP_CRASH

Indicates that crash fault records in the C/C++ code are queried.

从以下版本开始:

5

另请参阅:

querySelfFaultLog(int, int), 常量字段值

FAULT_TYPE_JAVA_CRASH

public static final int FAULT_TYPE_JAVA_CRASH

Indicates that crash fault records in the Java code are queried.

从以下版本开始:

5

另请参阅:

querySelfFaultLog(int, int), 常量字段值

FAULT_TYPE_JS_CRASH

public static final int FAULT_TYPE_JS_CRASH

Indicates that crash fault records in the JavaScript code are queried.

从以下版本开始:

5

另请参阅:

querySelfFaultLog(int, int), 常量字段值

FAULT_TYPE_NO_SPECIFIC

public static final int FAULT_TYPE_NO_SPECIFIC

Indicates that no fault type is specified, that is, records for all supported fault types are queried.

从以下版本开始:

5

另请参阅:

querySelfFaultLog(int, int), 常量字段值

构造器详细资料

FaultLogger

public FaultLogger()

方法详细资料

querySelfFaultLog

public static Optional<FaultLogger.FaultLogQueryResult> querySelfFaultLog(int type,
                                                                          int maxNum)

Queries fault records of your application.

参数:

type - Indicates the fault type, which is one of the following constants:

• FaultLogger#FAULT_TYPE_NO_SPECIFIC
• FaultLogger#FAULT_TYPE_JAVA_CRASH
• FaultLogger#FAULT_TYPE_CPP_CRASH
• FaultLogger#FAULT_TYPE_JS_CRASH
• FaultLogger#FAULT_TYPE_APP_FREEZE

maxNum - Indicates the maximum number of fault records to be queried. The maximum value is 100. Any value greater than 100 will be taken as 100.

返回:

Returns the query result if obtained; returns null if the query fails or either input parameter is invalid.

从以下版本开始:

5

另请参阅:

FaultLogger.FaultLogQueryResult