远程日志 API_移动研发平台(EMAS)-阿里云帮助中心

本文档介绍移动监控 iOS SDK 提供的远程日志 API，包括记录日志、调整日志级别等接口。

1. 获取日志实例

通过EAPMRemoteLogFactory工厂方法创建日志实例。

接口定义

Object C

#import "AlicloudApmRemoteLog/EAPMRemoteLog.h"

+ (EAPMRemoteLog *)createLogForModuleName:(NSString*)moduleName;

Swift

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

class func createLog(moduleName: String)

代码示例

Object C

#import "AlicloudApmRemoteLog/EAPMRemoteLog.h"

EAPMRemoteLog *log = [EAPMRemoteLogFactory createLogForModuleName:@"YourModuleName"];

Swift

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

let log = RemoteLogFactory.createLog(moduleName: "YourModuleName")

2. 记录日志

通过EAPMRemoteLog实例接口，记录不同日志级别的日志。

接口定义

Object C

#import "AlicloudApmRemoteLog/EAPMRemoteLog.h"

/**
 * 记录debug级别日志
 *
 * @param message 要记录的日志内容
 */
- (void)debug:(NSString *)message;

/**
 * 记录debug级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
- (void)debug:(NSString *)message exception:(NSException *)exception;

/**
 * 记录info级别日志
 *
 * @param message 要记录的日志内容
 */
- (void)info:(NSString *)message;

/**
 * 记录info级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
- (void)info:(NSString *)message exception:(NSException *)exception;

/**
 * 记录warn级别日志
 *
 * @param message 要记录的日志内容
 */
- (void)warn:(NSString *)message;

/**
 * 记录warn级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
- (void)warn:(NSString *)message exception:(NSException *)exception;

/**
 * 记录error级别日志
 *
 * @param message 要记录的日志内容
 */
- (void)error:(NSString *)message;

/**
 * 记录error级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
- (void)error:(NSString *)message exception:(NSException *)exception;

Swift

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

/**
 * 记录debug级别日志
 *
 * @param message 要记录的日志内容
 */
func debug(message: String)

/**
 * 记录debug级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
func debug(message: String, exception: NSException)

/**
 * 记录info级别日志
 *
 * @param message 要记录的日志内容
 */
func info(message: String)

/**
 * 记录info级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
func info(message: String, exception: NSException)

/**
 * 记录warn级别日志
 *
 * @param message 要记录的日志内容
 */
func warn(message: String)

/**
 * 记录warn级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
func warn(message: String, exception: NSException)

/**
 * 记录error级别日志
 *
 * @param message 要记录的日志内容
 */
func error(message: String)

/**
 * 记录error级别日志，附带异常对象
 *
 * @param message 要记录的日志内容
 * @param exception 异常对象
 */
func error(message: String, exception: NSException)

自定义日志参数说明

参数	类型	是否必填	说明
message	NSString	是	记录日志消息
exception	NSException	否	异常对象，仅记录其description属性

代码示例

Object C

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

EAPMRemoteLog *log = [EAPMRemoteLogFactory createLogForModuleName:@"BazingaModule"];
[log error:@"error message"];
[log warn:@"warn message"];
[log debug:@"debug message"];
[log info:@"info message"];

Swift

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

let log = RemoteLogFactory.createLog(moduleName: "YourModuleName")
log.error("error message")
log.warn("warn message")
log.debug("debug message")
log.info("info message")

3. 调整日志级别

通过EAPMRemoteLog类接口，调整日志记录级别，默认是调试级别。

接口定义

Object C

#import "AlicloudApmRemoteLog/EAPMRemoteLog.h"

+ (EAPMRemoteLogLevel)updateLogLevel:(EAPMRemoteLogLevel)logLevel;

Swift

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

class func updateLogLevel(logLevel: EAPMRemoteLogLevel) -> EAPMRemoteLogLevel

EAPMRemoteLogLevel枚举说明

参数	说明
EAPMRemoteLogLevelOFF	关闭级别
EAPMRemoteLogLevelError	错误级别
EAPMRemoteLogLevelWarn	警告级别
EAPMRemoteLogLevelInfo	信息级别
EAPMRemoteLogLevelDebug	调试级别

代码示例

Object C

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

[EAPMRemoteLog updateLogLevel:EAPMRemoteLogLevelError];

Swift

#import "AlicloudApmRemoteLog/AlicloudApmRemoteLog.h"

RemoteLog.updateLogLevel(EAPMRemoteLogLevel.error)