相信所有奮斗在一線的小伙伴，會(huì)很關(guān)心自己的系統(tǒng)的運(yùn)行情況，一般來(lái)說(shuō)，基礎(chǔ)設(shè)施齊全一點(diǎn)的公司都會(huì)有完善的報(bào)警方案，那么如果我們是一個(gè)小公司呢，不能因?yàn)榛A(chǔ)設(shè)施沒有，就失去對(duì)象的感知能力吧；如果我們的系統(tǒng)大量異常卻不能實(shí)時(shí)的觸達(dá)給我們，那么也就只會(huì)有一個(gè)結(jié)果--殺個(gè)程序猿祭天

本文簡(jiǎn)單的介紹一種實(shí)現(xiàn)思路，基于error日志來(lái)實(shí)現(xiàn)郵件的報(bào)警方案

一、項(xiàng)目環(huán)境

1. 項(xiàng)目依賴

本項(xiàng)目借助SpringBoot 2.2.1.RELEASE + maven 3.5.3 + IDEA進(jìn)行開發(fā)

開一個(gè)web服務(wù)用于測(cè)試

<dependencies>
    <!-- 郵件發(fā)送的核心依賴 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-mail</artifactId>
    </dependency>
</dependencies>

2. 配置

郵件相關(guān)配置如下，注意使用自己的用戶名 + 授權(quán)碼填充下面缺失的配置

spring:
  #郵箱配置
  mail:
    host: smtp.163.com
    from: [email protected]
    # 使用自己的發(fā)送方用戶名 + 授權(quán)碼填充
    username:
    password:
    default-encoding: UTF-8
    properties:
      mail:
        smtp:
          auth: true
          starttls:
            enable: true
            required: true

二、異常日志的郵件預(yù)警

1. 設(shè)計(jì)思路

接下來(lái)這個(gè)方案的主要出發(fā)點(diǎn)在于，當(dāng)程序出現(xiàn)大量的異常，表明應(yīng)用多半出現(xiàn)了問(wèn)題，需要立馬發(fā)送給項(xiàng)目owner

要實(shí)現(xiàn)這個(gè)方案，關(guān)鍵點(diǎn)就在于異常出現(xiàn)的感知與上報(bào)

異常的捕獲，并輸出日志（這個(gè)感覺屬于標(biāo)配了吧，別告訴我現(xiàn)在還有應(yīng)用不輸出日志文件的...）
- 對(duì)于這個(gè)感知，借助logback的擴(kuò)展機(jī)制，可以實(shí)現(xiàn)，后面介紹
異常上報(bào)：郵件發(fā)送

關(guān)于email的使用姿勢(shì)，推薦參考博文 SpringBoot 系列之郵件發(fā)送姿勢(shì)介紹

2. 自定義Appender

定義一個(gè)用于錯(cuò)誤發(fā)送的Appender，如下

public class MailUtil extends AppenderBase<ILoggingEvent> {

    public static void sendMail(String title, String context) {
        SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
        //郵件發(fā)送人
        simpleMailMessage.setFrom(ContextUtil.getEnvironment().getProperty("spring.mail.from", "[email protected]"));
        //郵件接收人，可以是多個(gè)
        simpleMailMessage.setTo("[email protected]");
        //郵件主題
        simpleMailMessage.setSubject(title);
        //郵件內(nèi)容
        simpleMailMessage.setText(context);

        JAVAMailSender javaMailSender = ContextUtil.getApplicationContext().getBean(JavaMailSender.class);
        javaMailSender.send(simpleMailMessage);
    }

    private static final long INTERVAL = 10 * 1000 * 60;
    private long lastAlarmTime = 0;

    @Override
    protected void append(ILoggingEvent iLoggingEvent) {
        if (canAlarm()) {
            sendMail(iLoggingEvent.getLoggerName(), iLoggingEvent.getFormattedMessage());
        }
    }

    private boolean canAlarm() {
        // 做一個(gè)簡(jiǎn)單的頻率過(guò)濾
        long now = System.currentTimeMillis();
        if (now - lastAlarmTime >= INTERVAL) {
            lastAlarmTime = now;
            return true;
        } else {
            return false;
        }
    }
}

3. Spring容器

上面的郵件發(fā)送中，需要使用JavaMailSender，寫一個(gè)簡(jiǎn)單的SpringContext工具類，用于獲取Bean/Propertiy

@Component
public class ContextUtil implements ApplicationContextAware, EnvironmentAware {

    private static ApplicationContext applicationContext;

    private static Environment environment;

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        ContextUtil.applicationContext = applicationContext;
    }

    @Override
    public void setEnvironment(Environment environment) {
        ContextUtil.environment = environment;
    }

    public static ApplicationContext getApplicationContext() {
        return applicationContext;
    }

    public static Environment getEnvironment() {
        return environment;
    }
}

4. logback配置

接下來(lái)就是在日志配置中，使用我們上面定義的Appender

logback-spring.xml文件內(nèi)容如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d [%t] %-5level %logger{36}.%M(%file:%line) - %msg%n</pattern>
            <!-- 控制臺(tái)也要使用UTF-8，不要使用GBK，否則會(huì)中文亂碼 -->
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <appender name="errorAlarm" class="com.git.hui.demo.mail.util.MailUtil">
        <!--如果只是想要 Error 級(jí)別的日志，那么需要過(guò)濾一下，默認(rèn)是 info 級(jí)別的，ThresholdFilter-->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
    </appender>


    <!-- 指定項(xiàng)目中某個(gè)包，當(dāng)有日志操作行為時(shí)的日志記錄級(jí)別 -->
    <!-- 級(jí)別依次為【從高到低】：FATAL > ERROR > WARN > INFO > DEBUG > TRACE  -->
    <!-- additivity=false 表示匹配之后，不再繼續(xù)傳遞給其他的logger-->
    <logger name="com.git.hui" level="DEBUG" additivity="false">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="errorAlarm"/>
    </logger>

    <!-- 控制臺(tái)輸出日志級(jí)別 -->
    <root level="INFO">
        <appender-ref ref="STDOUT"/>
    </root>
</configuration>

5. 測(cè)試demo

接下來(lái)演示一下，是否可以達(dá)到我們的預(yù)期

@Slf4j
@RestController
@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class);
    }

    @GetMapping("div")
    public String div(int a, int b) {
        try {
            return String.valueOf(a / b);
        } catch (Exception e) {
            log.error("div error! {}/{}", a, b, e);
            return "some error!";
        }
    }
}

5.小結(jié)

本篇博文主要提供了一個(gè)思路，借助logback的擴(kuò)展機(jī)制，來(lái)實(shí)現(xiàn)錯(cuò)誤日志與預(yù)警郵件綁定，實(shí)現(xiàn)一個(gè)簡(jiǎn)單的應(yīng)用異常監(jiān)控

上面這個(gè)實(shí)現(xiàn)只算是一個(gè)雛形，算是拋磚引玉，有更多可以豐富的細(xì)節(jié)，比如