分布式流式计算框架vortex使用介绍

vortex是一款轻量级的分布式流式计算框架。vortex中文意为旋涡,代表着数据流不断地流入这个旋涡然后被平稳地输出。
vortex属于内存计算型的流式框架,适用于高可用,高并发,实时计算的业务场景。
vortex是基于SpringBoot框架之上开发的,它依赖微服务分布式协作框架tridenter实现集群特性,vortex微服务内嵌了独立的TCP服务器(默认通过Netty4实现),vortex微服务集群中的应用程序通过tridenter多播功能相互发现并建立长连接,实现高可用,去中心化和负载均衡,使得整个Spring应用程序集群具备实时计算的能力。
vortex项目一共包含3部分:

  1. vortex-common
    vortex框架的agent端jar包
  2. vortex-spring-boot-starter
    vortex框架的核心jar包,添加到SpringBoot应用使其成为vortex服务端
  3. vortex-metrics
    基于vortex的分布式时序计算框架,它是vortex重要的独立子项目
服务端安装
vortex-spring-boot-starter indi.atlantis.framework 1.0-RC1

agent端安装
indi.atlantis.framework vortex-common 1.0-RC1

目前基于vortex框架的开源项目有两个:
  1. 分布式微服务监控系统 Jellyfish
  2. 分布式时序计算框架 Vortex Metrics
  3. 分布式网络爬虫Greenfinger
如何在你的应用中使用vortex的API
前面说过,vortex服务端接收数据,vortex agent端发送数据,vortex提供了HTTP和TCP两种协议来接收和发送外部数据。
  1. vortex服务端要实现Handler接口实现定制,比如:
    @Slf4j public class TestHandler implements Handler{ @Override public void onData(Tuple tuple) { log.info(tuple.toString()); }}

  2. 而agent端通过TransportClient实现类来发送数据
下面以jellyfish中日志收集模块为例,参考源码:
服务端:
public class Slf4jHandler implements Handler {private static final String TOPIC_NAME = "slf4j"; @Autowired private IdGenerator idGenerator; @Autowired private LogEntryService logEntryService; @Value("${atlantis.framework.jellyfish.handler.interferedCharacter:}") private String interferedCharacterRegex; @Override public void onData(Tuple tuple) { LogEntry logEntry = new LogEntry(); logEntry.setId(idGenerator.generateId()); logEntry.setClusterName(tuple.getField("clusterName", String.class)); logEntry.setApplicationName(tuple.getField("applicationName", String.class)); logEntry.setHost(tuple.getField("host", String.class)); logEntry.setIdentifier(tuple.getField("identifier", String.class)); logEntry.setLoggerName(tuple.getField("loggerName", String.class)); logEntry.setMessage(tuple.getField("message", String.class)); logEntry.setLevel(tuple.getField("level", String.class)); logEntry.setReason(tuple.getField("reason", String.class)); logEntry.setMarker(tuple.getField("marker", String.class)); logEntry.setCreateTime(tuple.getField("timestamp", Long.class)); if (StringUtils.isNotBlank(interferedCharacterRegex)) { logEntry.setMessage(logEntry.getMessage().replaceAll(interferedCharacterRegex, "")); logEntry.setReason(logEntry.getReason().replaceAll(interferedCharacterRegex, "")); } logEntryService.bulkSaveLogEntries(logEntry); }@Override public String getTopic() { return TOPIC_NAME; }}

Agent端, 你需要自己实现一个Agent端, 向vortex服务端不断发送数据,可参考jellyfish-slf4j的TransportClientAppenderBase.java源码:
@Override protected void append(ILoggingEvent eventObject) { if (transportClient == null) { return; } Tuple tuple = Tuple.newOne(GLOBAL_TOPIC_NAME); tuple.setField("clusterName", clusterName); tuple.setField("applicationName", applicationName); tuple.setField("host", host); tuple.setField("identifier", identifier); tuple.setField("loggerName", eventObject.getLoggerName()); String msg = eventObject.getFormattedMessage(); tuple.setField("message", msg); tuple.setField("level", eventObject.getLevel().toString()); String reason = ThrowableProxyUtil.asString(eventObject.getThrowableProxy()); tuple.setField("reason", reason); tuple.setField("marker", eventObject.getMarker() != null ? eventObject.getMarker().getName() : ""); tuple.setField("timestamp", eventObject.getTimeStamp()); Map mdc = eventObject.getMDCPropertyMap(); if (MapUtils.isNotEmpty(mdc)) { tuple.append(mdc); } transportClient.write(tuple); }

说明一下,vortex服务端和agent端的交互数据可以是Map, Tuple对象或json字符串,但最终都被包装成Tuple对象
【分布式流式计算框架vortex使用介绍】具体使用,可参考vortex的源码: https://github.com/paganini20...

    推荐阅读