ApiBoot Logging支持整合服務(wù)注冊(cè)中心（Eureka、Consul、Nacos Discovery、Zookeeper...）進(jìn)行上報(bào)請(qǐng)求日志，Logging Client會(huì)從服務(wù)注冊(cè)中心內(nèi)找到指定ServiceID的Logging Admin具體可用實(shí)例，通過(guò)SpringCloud Discovery內(nèi)部的負(fù)載均衡策略返回Logging Admin的部署服務(wù)器IP以及端口號(hào)，這樣Logging Client就可以完成請(qǐng)求日志的上報(bào)流程。

搭建Eureka Server

我們先來(lái)搭建一個(gè)Eureka Server，請(qǐng)?jiān)L問(wèn)【搭建服務(wù)注冊(cè)中心Eureka Server】文章內(nèi)容查看具體搭建流程。

將Logging Admin注冊(cè)到Eureka

既然使用的是服務(wù)注冊(cè)中心，我們需要將之前章節(jié)將的Logging Admin進(jìn)行簡(jiǎn)單的改造，添加Eureka客戶(hù)端相關(guān)的依賴(lài)，并在application.yml配置文件內(nèi)添加Eureka Server的相關(guān)配置，如果對(duì)Logging Admin不了解的同學(xué)可以訪(fǎng)問(wèn)【將ApiBoot Logging采集的日志上報(bào)到Admin】查看文章內(nèi)容，文章底部有源碼。

添加Eureka Client依賴(lài)

我們需要將Logging Admin注冊(cè)到Eureka Server，對(duì)于Eureka Server而言Logging Admin是一個(gè)客戶(hù)端（Eureka Client）角色。

我們?cè)?code>pom.xml文件內(nèi)添加如下配置：

org.springframework.cloudspring-cloud-starter-netflix-eureka-client

啟用Eureka Client

添加依賴(lài)后我們還需要在XxxApplication入口類(lèi)添加@EnableDiscoveryClient注解來(lái)啟用Eureka Client的相關(guān)功能，如下所示：

@SpringBootApplication
@EnableLoggingAdmin
@EnableDiscoveryClient
public class LoggingAdminApplication {
    /**
     * logger instance
     */
    static Logger logger = LoggerFactory.getLogger(LoggingAdminApplication.class);

    public static void main(String[] args) {
        SpringApplication.run(LoggingAdminApplication.class, args);
        logger.info("{}服務(wù)啟動(dòng)成功.", "日志管理中心");
    }
}

配置注冊(cè)到Eureka Server

我們?cè)?code>application.yml配置文件內(nèi)添加連接到Eureka Server的相關(guān)配置信息，如下所示：

# Eureka Config
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:10000/eureka/
  instance:
    prefer-ip-address: true

將Logging Client注冊(cè)到Eureka

Logging Client其實(shí)就是我們的業(yè)務(wù)服務(wù)，不要被名稱(chēng)誤導(dǎo)，我們?cè)诒菊略创a內(nèi)創(chuàng)建一個(gè)user-service模塊來(lái)作為測(cè)試的業(yè)務(wù)服務(wù)，我們也需要將user-service作為客戶(hù)端注冊(cè)到Eureka Server，可參考【使用ApiBoot Logging進(jìn)行統(tǒng)一管理請(qǐng)求日志】文章內(nèi)容創(chuàng)建項(xiàng)目。

添加Eureka Client依賴(lài)

在pom.xml配置文件內(nèi)添加如下依賴(lài)：

org.springframework.cloudspring-cloud-starter-netflix-eureka-client

啟用Eureka Client

添加依賴(lài)后同樣需要啟用Eureak Client，這是必不可少的步驟，在我們的入口類(lèi)XxxApplication上添加如下所示：

@SpringBootApplication
@EnableDiscoveryClient
@EnableLoggingClient
public class UserServiceApplication {
    /**
     * logger instance
     */
    static Logger logger = LoggerFactory.getLogger(UserServiceApplication.class);

    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
        logger.info("{}服務(wù)啟動(dòng)成功.", "用戶(hù)");
    }
}

配置注冊(cè)到Eureka Server

我們?cè)?code>application.yml配置文件內(nèi)添加Eureka Server的相關(guān)配置信息，如下所示：

# Eureka Config
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:10000/eureka/
  instance:
    prefer-ip-address: true

配置Logging Admin服務(wù)信息

這是本章的核心內(nèi)容，我們?cè)谥岸际峭ㄟ^(guò)api.boot.logging.admin.server-address參數(shù)進(jìn)行配置Logging Admin的IP地址以及服務(wù)端口號(hào)，而本章我們就要借助服務(wù)注冊(cè)中心（Eureka Server）來(lái)從實(shí)例列表中獲取Logging Admin服務(wù)信息，ApiBoot Logging提供了一個(gè)配置參數(shù)api.boot.logging.discovery.service-id進(jìn)行配置Logging Admin的ServiceID，也就是spring.application.name參數(shù)對(duì)應(yīng)的值，如下所示：

# ApiBoot Config
api:
  boot:
    logging:
      discovery:
        # Logging Admin ServiceID
        service-id: logging-admin
      show-console-log: true
      format-console-log-json: true

每當(dāng)我們發(fā)起請(qǐng)求時(shí)，Logging Client就會(huì)從Eureak Server內(nèi)獲取ServiceID = logging-admin的服務(wù)列表，負(fù)載均衡篩選后獲取一個(gè)可用的實(shí)例信息進(jìn)行上報(bào)日志。

運(yùn)行測(cè)試

我們將本章源碼內(nèi)用到的三個(gè)服務(wù)eureka-server、logging-admin、user-service依次啟動(dòng)。

通過(guò)curl命令訪(fǎng)問(wèn)user-service提供的Controller地址，如下所示：

? ~ curl http://localhost:9090/test/?name/=admin
你好：admin

我們可以在logging-admin控制臺(tái)看到user-service上報(bào)的請(qǐng)求日志信息，如下所示：

Receiving Service: 【user-service -> 127.0.0.1】, Request Log Report，Logging Content：[
    {
        "endTime":1572921905360,
        "httpStatus":200,
        "requestBody":"",
        "requestHeaders":{
            "host":"localhost:9090",
            "user-agent":"curl/7.64.1",
            "accept":"*/*"
        },
        "requestIp":"0:0:0:0:0:0:0:1",
        "requestMethod":"GET",
        "requestParam":"{/"name/":/"admin/"}",
        "requestUri":"/test",
        "responseBody":"你好：admin",
        "responseHeaders":{},
        "serviceId":"user-service",
        "serviceIp":"127.0.0.1",
        "servicePort":"9090",
        "spanId":"d97c515f-a147-4f89-9c59-398905c95a73",
        "startTime":1572921905336,
        "timeConsuming":24,
        "traceId":"5e6c0357-1625-4a28-af18-cacdddba146a"
    }
]

自此我們已經(jīng)成功的整合Eureka與ApiBoot Logging。

敲黑板，劃重點(diǎn)

ApiBoot Logging內(nèi)部提供的兩種獲取Logging Admin服務(wù)信息的方式，分別是：service-id、server-address，都是比較常用的，使用service-id方式可以無(wú)縫整合SpringCloud進(jìn)行使用，而鏈路信息可以通過(guò)Openfeign、RestTemplate進(jìn)行傳遞，這會(huì)在我們后期的知識(shí)點(diǎn)中講到。

審核編輯 黃昊宇