崩溃分析相关接口-阿里云帮助中心

此文档介绍Android崩溃分析SDK提供的接口。

自定义异常

崩溃信息SDK提供了上报自定义异常的API，方便您上报自定义异常。每次上报最多携带8条自定义异常。

`recordException`

上报自定义异常。

接口定义

void recordException(@NonNull Throwable throwable)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
throwable	Throwable	是	异常

代码示例

ApmCrashAnalysis.getInstance().recordException(new RuntimeException("This is an non-fatal"));

添加日志信息

崩溃信息SDK提供了添加日志信息的API，以便您添加额外的日志信息。

`log`

添加日志信息。

说明

单次崩溃可多次调用log接口添加日志，但是单次崩溃最大携带的日志是64K。如果超过64K，会按时间顺序删除最早的日志。

接口定义

void log(@NonNull String message)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
message	String	是	日志信息

添加自定义维度

崩溃分析SDK提供了一系列API，以便您可以自定义维度数据。

说明

单次崩溃最多携带64条key/value对。

`setCustomKey`

添加值是boolean类型的数据。

接口定义

void setCustomKey(@NonNull String key, boolean value)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	boolean	是	值

`setCustomKey`

添加值是double类型的数据。

接口定义

void setCustomKey(@NonNull String key, double value)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	double	是	值

`setCustomKey`

添加值是float类型的数据。

接口定义

void setCustomKey(@NonNull String key, float value)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	float	是	值

`setCustomKey`

添加值是int类型的数据。

接口定义

void setCustomKey(@NonNull String key, int value)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	int	是	值

`setCustomKey`

添加值是long类型的数据。

接口定义

void setCustomKey(@NonNull String key, long value)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	long	是	值

`setCustomKey`

添加值是String类型的数据。

接口定义

void setCustomKey(@NonNull String key, @NonNull String value)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	String	是	值，最长1024位，超过会截断。

`setCustomKeys`

添加一批键值对。

接口定义

void setCustomKeys(@NonNull CustomKeysAndValues keysAndValues)

所属类

ApmCrashAnalysis

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
keysAndValues	CustomKeysAndValues	是	一批键值对。

CustomKeysAndValues

CustomKeysAndValues可以包含一组自定义的键值对。

`putString`

添加值是String类型的数据。

接口定义

CustomKeysAndValues.Builder putString(@NonNull String key, @NonNull String value)

所属类

CustomKeysAndValues.Builder

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	String	是	值，最长1024位，超过会截断。

`putBoolean`

添加值是boolean类型的数据。

接口定义

CustomKeysAndValues.Builder putBoolean(@NonNull String key, boolean value)

所属类

CustomKeysAndValues.Builder

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	boolean	是	值

`putDouble`

添加值是double类型的数据。

接口定义

CustomKeysAndValues.Builder putDouble(@NonNull String key, double value)

所属类

CustomKeysAndValues.Builder

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	double	是	值

`putFloat`

添加值是float类型的数据。

接口定义

CustomKeysAndValues.Builder putFloat(@NonNull String key, float value)

所属类

CustomKeysAndValues.Builder

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	float	是	值

`putLong`

添加值是long类型的数据。

接口定义

CustomKeysAndValues.Builder putLong(@NonNull String key, long value)

所属类

CustomKeysAndValues.Builder

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	long	是	值

`putInt`

添加值是int类型的数据。

接口定义

CustomKeysAndValues.Builder putInt(@NonNull String key, int value)

所属类

CustomKeysAndValues.Builder

参数说明

参数	类型	是否必填	说明

参数	类型	是否必填	说明
key	String	是	键，最长1024位，超过会截断。
value	int	是	值

`build`

构建CustomKeysAndValues实例。

接口定义

CustomKeysAndValues build()

所属类

CustomKeysAndValues.Builder

返回值说明

类型	说明

类型	说明
CustomKeysAndValues	CustomKeysAndValues实例