文章目录
  1. 1 概述
    1. 1.1 在美团技术架构中的位置
    2. 1.2 功能特性
    3. 1.3 环境划分
    4. 1.4 调用流程
    5. 1.5 理解 appkey
  2. 2 整体架构
    1. 2.1 MTransport(服务通信框架)
    2. 2.2 HLB(弹性负载均衡器)
    3. 2.3 SG_agent(服务治理代理)
    4. 2.4 MNS(美团命名服务)
    5. 2.5 Data-center(服务数据中心)
    6. 2.6 Scanner(健康检查系统)
    7. 2.7 MCC(美团配置中心)
    8. 2.8 MSGP(美团服务治理平台)
  3. 3 接入方法
    1. 3.1 公用接口 service-interface
      1. 3.1.1 pom.xml
      2. 3.1.2 StudentParam.java
      3. 3.1.3 GenderEnum.java
      4. 3.1.4 DemoThriftService.java
    2. 3.2 服务提供者 service-provider
      1. 3.2.1 pom.xml
      2. 3.2.2 DemoThriftServiceImpl.java
      3. 3.2.3 DemoServiceProviderConfig.java
      4. 3.2.4 ServiceProviderApplication.java
    3. 3.3 服务消费者 service-consumer
      1. 3.3.1 pom.xml
      2. 3.3.2 DemoServiceConsumerConfig.java
      3. 3.3.3 DemoConsumerController.java
      4. 3.3.4 ServiceConsumerApplication.java
  4. 4 发布平台(plus)
  5. 5 服务治理平台(MSGP)

OCTO 是美团千亿调用量的分布式服务通信框架及服务治理的系统,可实现服务注册、服务自动发现、服务管理、容错处理、数据可视化、服务监控报警、服务分组等。本文总结了 OCTO 架构原理、Java 应用的集成方法、以其控制台的使用。

作者:王克锋
出处:https://kefeng.wang/2018/06/29/distributed-octo/
版权:自由转载-非商用-非衍生-保持署名,转载请标明作者和出处。

1 概述

OCTO 是 octopus(章鱼) 的缩写。是美团公司级基础设施,为公司所有业务提供统一的高性能服务通信框架,使业务具备良好的服务运营能力,轻松实现服务注册、服务自动发现、负载均衡、容错、灰度发布、数据可视化、监控告警等功能,提升服务开放效率、可用性及服务运维效率。

参考资料:

【特别说明】OCTO 是美团内部专用系统,未开源,外部无法搭建该系统。
【本文意义】OCTO 是国内重量级的服务治理系统,目前调用量上千亿,通过对该系统的架构原理和使用方法的梳理,可帮助我们深化对分布式服务的认识。

1.1 在美团技术架构中的位置

1.2 功能特性

  • 命名服务 - 服务注册;服务自动发现
  • 服务管理 - 服务状态监测;服务启动、停止;服务负载均衡
  • 容错处理 - 实时屏蔽异常的服务,自动调配请求流量
  • 流量分发 - 灰度发布、节点动态流量分配等场景
  • 数据可视化 - 服务调用统计上报分析,提供清晰的数据图表展示,清晰了解服务间依赖关系
  • 服务分组 - 支持服务动态自动归组与不同场景下的自定义分组,解决在多机房场景下跨机房调用穿透、Sandbox等问题
  • 服务监控报警 - 支持服务与接口级别多指标、多维度的监控,支持多种报警方式
  • 统一配置管理 - 支持服务配置统一管理,灵活设置不同环境间差异,支持历史版本,配置项变更后实时下发
  • 分布式服务跟踪 - 轻松诊断服务访问慢、异常抖动等问题
  • 过载保护 - 灵活定义服务消费者的配额,当其调用量超出最大阀值时,基于不同服务消费者进行QoS区分,触发过载保护。
  • 服务访问控制

1.3 环境划分

服务提供者的环境分线上(IDC)和线下(办公云)两套系统,线下系统是对线上系统的模拟。
每套系统中都有 test/staging/prod 三个环境。

1.4 调用流程

  • 各方(provider/consumer)在 OCTO 上注册自己专用的 appkey,比如 appkey-provider/appkey-consumer
  • provider 在 OCTO 上注册服务(标记为 appkey-provider),同一个 appkey 在三个环境中都有部署;
  • 假设在 staging 环境 的 consumer 在 OCTO 上请求服务(标记自己 appkey-consumer,目标 appkey-provider)
  • OCTO 查询 staging 环境的 appkey-provider 的服务列表,并发送给 consumer
  • consumer 通过 mtthrift 访问 IP:PORT 服务

1.5 理解 appkey

以 Nginx 为参照来理解。
对于传统的配置方式,域名与物理服务器的映射关系由 Ngnix 维护,物理服务器的增减需要运维人员调整,无法动态完成:

对于 appkey 的配置方式,新增了 appkey 一层:

  • 域名与 appkey 的映射关系由 Nginx 配置,以后无需调整;
  • 而 appkey 与物理服务器的映射关系,可以动态调整。

Thrift 同理,对于客户端请求(appkey:port),Thrift Server 通过 appkey 找到物理服务器(IP:port)。

2 整体架构


2.1 MTransport(服务通信框架)

  MTthrift 是基于 Thrift(由 Facebook 开源为 Apache Thrift )二次开发,是一个分布式服务通讯框架,致力于提供高性能和透明化的RPC远程服务调用方案,是 OCTO 服务治理方案的核心框架,每天为4000+服务提供2000亿+次访问量支持,被广泛应用于新美大各个业务线。

  MTransport 是多语言的服务通信框架,它屏蔽了底层高性能网络通信的实现细节, 从而实现简单高效的服务开发。MTransport 支持 Thrift/HTTP/pigeon 等协议。其中 Thrift 包括 MTthrift(Java)、PThrift(PHP)、CThrift(C/C++)、Turbo Thrift(NodeJS)等,Thrift 支持不同语言版本的代码实现, 保持通信协议的一致性,支持服务注册、服务自动发现、分布式服务调用跟踪等。HTTP 目前也支持JAVA、NodeJs以及C++。

  MTthrift 提供服务模板管理, 代码生成引擎等高效工具.

2.2 HLB(弹性负载均衡器)

HLB 是 Hardware Load Balance 的缩写。
所有HTTP请求/应答流量都会穿过这个系统,类似amazon elb。

2.3 SG_agent(服务治理代理)

SG 是 Service Governance 的缩写。
SG_agent 部署在各服务节点(服务的提供者和消费者),通过与MNS进行通信,提供服务注册/发现、配置更新、访问控制、配额限制等功能,并将调用统计上报给性能监控平台。

2.4 MNS(美团命名服务)

MNS 是 Meituan Naming Service 的缩写。
MNS 是服务注册路由中心,基于 ZooKeeper 构建,为公司各类分布式服务提供稳健可靠的命名服务管理组件, 快速实现服务注册、路由、服务自动发现。

主要提供服务概要、节点IP/Port、节点权重、配额等信息的存储/访问,及服务健康状态检测等。

  1. 可靠性:
    (1)一致性:不论连接到集群的哪一台服务器节点,展示的都是一致的数据视图。
    (2)原子性:节点的更新要么成功,要么失败。
    (3)高可用性:在2n+1台机器组成的集群中,即使n台机器失败,仍不影响集群的高可用性。
  2. 去中心化:中心的MNS主要提供服务注册、发现、路由策略等功能,其他服务主要由在各服务节点的SG_agent提供。

2.5 Data-center(服务数据中心)

收集公司所有接入OCTO业务的上报日志数据,为各业务线提供系统的性能指标、健康状况、基础告警等

2.6 Scanner(健康检查系统)

扫描各服务的健康状况,不可用时从 MNS 中剔除。

2.7 MCC(美团配置中心)

MCC 是 Meituan Config Center 的缩写。
统一配置中心,提供统一配置管理服务, 实现配置与代码分离、配置信息实时更新、高可用性、版本控制, 提高服务开发效率,降低运维成本。
其原理是将 JSON 格式的配置文件存储在 ZooKeeper 目录下,当用户在 MSGP 更改配置时,由 MSGP 通知 SG_agent 进行数据拉取,将zk中的配置数据落地到本机的指定目录中。

2.8 MSGP(美团服务治理平台)

MSGP 是 Meituan Service Governance PlatForm 的缩写。
目标:为公司各类服务提供注册、治理、诊断,配置,配额等功能的一站式管理平台。

3 接入方法

使用thrift 提供的@ThriftService、@ThriftMethod、@ThriftStruct、@ThriftField等注解,注解于普通的Java类,使其成为thrift的数据模型(model)和服务接口(service)。其使用模式与 Dubbo 非常相似:服务的提供者和消费者基于共同的一套接口定义。

下面基于 SpringBoot 创建 interface/provider/consumer 三个模块。
在本机上运行 provider,即可成功注册至 dev 环境的 OCTO 上。
在本机上运行 consumer,即可成功消费 provider 提供的服务。
本例已在美团内网跑通。

3.1 公用接口 service-interface

引入依赖包,并定义接口 DemoThriftService。
其中用到的参数 StudentParam / GenderEnum 必须用相关注解标注。

3.1.1 pom.xml

1
2
3
4
5
6
7
8
9
10
<dependency>
<groupId>com.meituan.service.mobile</groupId>
<artifactId>mtthrift</artifactId>
<version>1.8.5</version>
</dependency>
<dependency>
<groupId>com.meituan.mtrace</groupId>
<artifactId>mtrace</artifactId>
<version>1.1.14</version>
</dependency>

3.1.2 StudentParam.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
/**
* @author: kefeng.wang
* @date: 2018-06-29 16:34
* @description: 学生定义(作为输入参数)
**/
@ThriftStruct
public class StudentParam {
private Integer id;
private String name;

@ThriftConstructor
public StudentParam(Integer id, String name) {
this.id = id;
this.name = name;
}

@ThriftField
public Integer getId() {
return id;
}

@ThriftField(1)
public void setId(Integer id) {
this.id = id;
}

@ThriftField
public String getName() {
return name;
}

@ThriftField(2)
public void setName(String name) {
this.name = name;
}
}

3.1.3 GenderEnum.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
/**
* @author: kefeng.wang
* @date: 2018-06-29 16:41
* @description: 性别定义(作为输出参数)
**/
@ThriftEnum
public enum GenderEnum {
GENDER_MALE(1, "male", "男性"),
GENDER_FEMALE(2, "female", "女性"),
GENDER_UNKNOWN(0, "unknown", "未知性别");

private Integer id;
private String value;
private String desc;

GenderEnum(Integer id, String value, String desc) {
this.id = id;
this.value = value;
this.desc = desc;
}

// @ThriftEnumValue
public Integer getId() {
return id;
}

public void setId(Integer id) {
this.id = id;
}

public String getValue() {
return value;
}

public void setValue(String value) {
this.value = value;
}

public String getDesc() {
return desc;
}

public void setDesc(String desc) {
this.desc = desc;
}
}

3.1.4 DemoThriftService.java

1
2
3
4
5
6
7
8
9
10
11
12
13
/**
* @author: kefeng.wang
* @date: 2018-06-29 16:19
* @description: Thrift 接口定义
**/
@ThriftService
public interface DemoThriftService {
@ThriftMethod
String getVersion() throws TException;

@ThriftMethod
StudentParam getGenderStudent(GenderEnum gender) throws TException;
}

3.2 服务提供者 service-provider


引入依赖包:service-interface 是刚定义的公用接口,hystrix 用于容错。
本模块中,先是实现公用接口,再定义发布相关配置,再运行 ServiceProviderApplication 启动服务提供者。

3.2.1 pom.xml

1
2
3
4
5
6
7
8
9
10
<dependency>
<groupId>com.meituan</groupId>
<artifactId>service-interface</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>com.netflix.hystrix</groupId>
<artifactId>hystrix-javanica</artifactId>
<version>1.5.12</version>
</dependency>

3.2.2 DemoThriftServiceImpl.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/**
* @author: kefeng.wang
* @date: 2018-06-29 17:29
* @description: Thrift 接口实现(服务提供者)
**/
public class DemoThriftServiceImpl implements DemoThriftService {
@Override
public String getVersion() throws TException {
return "1.0.0";
}

@Override
@HystrixCommand
public StudentParam getGenderStudent(GenderEnum gender) throws TException {
return new StudentParam(1, "张三");
}
}

3.2.3 DemoServiceProviderConfig.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
/**
* @author: kefeng.wang
* @date: 2018-06-29 17:45
* @description: Thrift 发布(服务提供者)
**/
@Configuration
public class DemoServiceProviderConfig {
@Resource(name = "serviceProcessor")
private DemoThriftService serviceProcessor;

@Bean(name = "serviceProcessor")
public DemoThriftService getDemoThriftService() {
return new DemoThriftServiceImpl();
}

@Bean(name = "serverPublisher", initMethod = "publish", destroyMethod = "destroy")
public ThriftServerPublisher getThriftServerPublisher() {
ThriftServerPublisher serverPublisher = new ThriftServerPublisher();
serverPublisher.setServiceInterface(DemoThriftService.class); // [MUST] 接口类
serverPublisher.setServiceImpl(serviceProcessor); // [MUST] 实现类
serverPublisher.setAppKey(APPKEY_TEST_SERVER); // [MUST] 服务提供者 appkey
serverPublisher.setPort(9001); // [MUST] 服务提供者监听端口
return serverPublisher;
}
}

3.2.4 ServiceProviderApplication.java

1
2
3
4
5
6
7
8
9
10
11
/**
* @author: kefeng.wang
* @date: 2018-06-29 17:50
* @description: 启动(服务提供者)
**/
@SpringBootApplication
public class ServiceProviderApplication {
public static void main(String[] args) {
SpringApplication.run(ServiceProviderApplication.class, args);
}
}

3.3 服务消费者 service-consumer

引入依赖包:service-interface 是刚定义的公用接口。
本模块中,先是指定服务提供者、消费选项,再使用共用接口定义 Controller 来调用,再运行 ServiceConsumerApplication 启动服务消费者。
启动浏览器访问 http://localhost:8080/demo,即可调用成功。

3.3.1 pom.xml

1
2
3
4
5
<dependency>
<groupId>com.meituan</groupId>
<artifactId>service-interface</artifactId>
<version>1.0.0</version>
</dependency>

3.3.2 DemoServiceConsumerConfig.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
/**
* @author: kefeng.wang
* @date: 2018-06-29 18:01
* @description: Thrift 消费者
**/
@Configuration
public class DemoServiceConsumerConfig {
@Bean(name = "thriftPoolConfig")
public MTThriftPoolConfig getMTThriftPoolConfig() {
MTThriftPoolConfig thriftPoolConfig = new MTThriftPoolConfig();
thriftPoolConfig.setMaxActive(100);
thriftPoolConfig.setMaxIdle(20);
thriftPoolConfig.setMinIdle(5);
thriftPoolConfig.setMaxWait(3000);
thriftPoolConfig.setTestOnBorrow(true);
thriftPoolConfig.setTestOnReturn(false);
thriftPoolConfig.setTestWhileIdle(false);
return thriftPoolConfig;
}

@Bean(name = "demoThriftService", destroyMethod = "destroy")
public ThriftClientProxy getThriftClientProxy(MTThriftPoolConfig thriftPoolConfig) {
ThriftClientProxy thriftClientProxy = new ThriftClientProxy();
thriftClientProxy.setMtThriftPoolConfig(thriftPoolConfig); // [可选]配置
thriftClientProxy.setServiceInterface(DemoThriftService.class); // [MUST]接口类
thriftClientProxy.setAppKey(APPKEY_TEST_CLIENT); // [MUST]服务消费者 appkey
thriftClientProxy.setRemoteAppkey(APPKEY_TEST_SERVER); // [MUST]服务提供者 appkey
thriftClientProxy.setRemoteServerPort(9001); // [常用]服务提供者 port
thriftClientProxy.setTimeout(30000); // [常用]调用超时
return thriftClientProxy;
}
}

3.3.3 DemoConsumerController.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
/**
* @author: kefeng.wang
* @date: 2018-06-29 18:10
* @description: Thrift 演示的外部入口
**/
@RestController
public class DemoConsumerController {
private static final Logger logger = LoggerFactory.getLogger(DemoConsumerController.class);

@Resource
private DemoThriftService demoThriftService;

@GetMapping("/demo")
public StudentParam demo() {
try {
return demoThriftService.getGenderStudent(GenderEnum.GENDER_MALE);
} catch (TException e) {
logger.warn(e.getMessage(), e);
}

return null;
}
}

3.3.4 ServiceConsumerApplication.java

1
2
3
4
5
6
7
8
9
10
11
/**
* @author: kefeng.wang
* @date: 2018-06-29 17:50
* @description: 启动(服务消费者)
**/
@SpringBootApplication
public class ServiceConsumerApplication {
public static void main(String[] args) {
SpringApplication.run(ServiceConsumerApplication.class, args);
}
}

4 发布平台(plus)

MtThrift是在 Thrift 上做了定制化修改,使得能代码在 Plus 发布后能够被 OCTO 平台发现处理。

5 服务治理平台(MSGP)

test / staging / prod 各环境都有相应的WEB管理平台(公司内部或者通过VPN才能访问)。


出于信息安全考虑,相关截图不一一提供了。常用功能有:

  • 服务详情 / 服务提供者:列出当前 appkey 的各主机(主机名/IP/PORT),可新增或删除主机,可调整权重,可启用或禁用;
  • 服务详情 / 服务消费者:分时段查看当前 appkey 的消费者及其消费的提供者主机、调用量等;
  • 服务运营 / 服务分组:可设置同中心优先、同机房优先;
  • 数据分析 / 来源分析:按时段统计当前 appkey 上游服务的调用(调用量、QPS、耗时等);
  • 数据分析 / 去向分析:按时段统计当前 appkey 下游服务的调用(调用量、QPS、耗时等);
  • 数据分析 / 主机分析:按时段统计当前 appkey 各主机的被调用情况(调用量、QPS、耗时等)。
文章目录
  1. 1 概述
    1. 1.1 在美团技术架构中的位置
    2. 1.2 功能特性
    3. 1.3 环境划分
    4. 1.4 调用流程
    5. 1.5 理解 appkey
  2. 2 整体架构
    1. 2.1 MTransport(服务通信框架)
    2. 2.2 HLB(弹性负载均衡器)
    3. 2.3 SG_agent(服务治理代理)
    4. 2.4 MNS(美团命名服务)
    5. 2.5 Data-center(服务数据中心)
    6. 2.6 Scanner(健康检查系统)
    7. 2.7 MCC(美团配置中心)
    8. 2.8 MSGP(美团服务治理平台)
  3. 3 接入方法
    1. 3.1 公用接口 service-interface
      1. 3.1.1 pom.xml
      2. 3.1.2 StudentParam.java
      3. 3.1.3 GenderEnum.java
      4. 3.1.4 DemoThriftService.java
    2. 3.2 服务提供者 service-provider
      1. 3.2.1 pom.xml
      2. 3.2.2 DemoThriftServiceImpl.java
      3. 3.2.3 DemoServiceProviderConfig.java
      4. 3.2.4 ServiceProviderApplication.java
    3. 3.3 服务消费者 service-consumer
      1. 3.3.1 pom.xml
      2. 3.3.2 DemoServiceConsumerConfig.java
      3. 3.3.3 DemoConsumerController.java
      4. 3.3.4 ServiceConsumerApplication.java
  4. 4 发布平台(plus)
  5. 5 服务治理平台(MSGP)