分布式流式计算框架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的源码: https://github.com/paganini20...

你可能感兴趣的:(分布式流式计算框架vortex使用介绍)