提供通SMTP协议连接服务器并将日志以邮件形式推送到指定邮箱的追加器,需要开发者自行申请
ohos.permission.INTERNET
及ohos.permission.GET_WIFI_INFO
权限
constructor(config)
#
config
SMTPAppenderConfigname
string - 追加器名称level
Level - 日志等级connectOptions
ConnectProperties - 服务器连接信息minimumCount
number? - 一次发送的最少日志条数seendInterval
number? - 最短发送间隔debug
boolean? - 是否打印调试信息,默认不打印recipients
string[] - 收件人邮箱地址ccRecipients
string[]? - 抄送人邮箱地址bccRecipients
string[]? - 密送人邮箱地址
export interface SMTPAppenderConfig {
name: string;
level: Level;
connectOptions: ConnectProperties;
/**
* 单次发送最少错误日志数量
*/
minimumCount?: number;
/**
* 单次发送最短间隔
*/
sendInterval?: number;
/**
* 打印错误日志
*/
debug?: boolean;
recipients: string[];
ccRecipients?: string[];
bccRecipients?: string[];
}
新建一个SMTPAppender
onLog(level, tag, time, count, message, tempContext)
#
level
Level - 日志等级tag
string - 日志归属time
number - 时间戳count
number - 日志排序message
string - 日志内容tempContext
TemporaryLoggerContext - 一次性上下文
当被绑定的宿主Logger记录日志时会调用此方法
triggerMail(time)
#
time
number? - 当前时间戳
手动强制发送当前暂存队列中的日志,并清空当前暂存日志队列
setRecipients(recipients)
#
recipients
string[] - 收件人
设置此追加器收件人
setCCRecipients(recipients)
#
recipients
string[] - 收件人
设置此追加器抄送人
setBCCRecipients(recipients)
#
recipients
string[] - 收件人
设置此追加器密送人
setMailLayout(newLayout)
#
newLayout
MailLayout - 邮件格式subject
string - 邮件主题bodyPattern
string - 邮件正文格式
onTerminate()
#
终止此Appender的所有日志记录活动