FQueue介绍

#Introduction

FQueue是一个高性能、基于磁盘持久存储的队列消息系统。兼容memcached协议，能用memcached的语言都可以良好的与它通信。 FQueue为你提供一个不需要特别优化，高性能的一个消息系统。

特性

• 基于磁盘持久化存储。
• 支持memcached协议。
• 支持多队列，密码验证功能。
• 高性能，能达到数十万qps。
• 低内存消耗。100-300M内存即可工作得很好。
• 高效率IO读写算法，IO效率高。
• 纯JAVA代码。支持进程内JVM级别的直接调用。
• 在不需要强顺序的场景下，支持多机负载均衡。

不支持

• 不支持topic方式的订阅功能。
• 不支持主从复制。

使用

下载压缩包，解压后，chmode 755 run.sh ./run.sh start 即可启动，默认监听12000端口 测试使用

   //memcached协议入队
   memcache.set("key_abc",0,"message1");//key为队列名，abc为密码，在conf/config.properties中配置
   memcache.set("key_abc",0,"message2");
   //获取队列的数据
   memcache.get("key_abc");//取回的应该是message1
   memcache.get("key_abc");//取回的应该是message2

Fqueue有多快

进程内

Fqueue的底层存储非常高效。下面做个单线程测试（JAVA）：

	public static void main(String[] args) throws Exception {
        FQueue fQueue = new FQueue("/home/q/db/");
        StringBuilder sb = new StringBuilder();
        int length = Integer.parseInt(args[0]);
        for (int i = 0; i < length; i++) {
            sb.append("a");
        }
        byte[] data = sb.toString().getBytes();
        fQueue.add(data);// 预热一下
        long start = System.currentTimeMillis();
        for (int i = 0; i < 100000000; i++) {
            fQueue.add(data);
        }
        System.out.println(100000000.0 / ((System.currentTimeMillis() - start) / 1000) + "qps");
        fQueue.close();
	}

运行后输出：

#每次写入10字节
~/memcachedbench-0.1.0]# ./test.sh 10
9090909qps
#每次写入1024字节
~/memcachedbench-0.1.0]# ./test.sh 1024
196078qps

服务模式

多个客户端往Server端每次写入10byte的数据 用以下php脚本测试速度：

$mem=new Memcache();
$mem->connect("host",12000);
$start=microtime(true);
for($i=0;$i<30;$i++){
        $count=$mem->get("size|bbs|pass");
        echo microtime(true)."\t".$count."\r\n";
        sleep(1);
}

输出：

1315645933.5273 288426996
1315645934.5343 288750720
1315645935.5414 289080492
1315645936.5483 289412664
1315645937.5547 289727366
1315645938.5618 290053230
1315645939.5679 290380550
1315645940.5758 290697886
1315645941.5816 291025822
1315645942.5888 291349510
1315645943.5948 291671034
1315645944.6027 292005258
1315645945.6099 292336265
1315645946.6176 292663838
1315645947.6282 292988327
1315645948.6347 293317381
1315645949.6428 293624922
1315645950.6492 293944354
1315645951.6554 294269555
1315645952.6632 294595757
1315645953.6697 294924215
1315645954.677  295253636
1315645955.6829 295593660
1315645956.69   295927374
1315645957.6973 296254742
1315645958.7045 296585110
1315645959.7109 296916046
1315645960.7171 297246379
1315645961.7228 297577807
1315645962.7297 297913268

对应的每秒写入

323724
329772
332172
314702
325864
327320
317336
327936
323688
321524
334224
331007
327573
324489
329054
307541
319432
325201
326202
328458
329421
340024
333714
327368
330368
330936
330333
331428
335461

install

安装部署 Updated Nov 24, 2011 by sunli1...@gmail.com

部署

JAVA环境 ## 安装jdk6

部署Fqueue

1. 直接从google code下载压缩包，解压后./run.sh start 即可运行
2. svn check out出源代码，用maven 的mvn package即可打包出上一步使用的压缩包

配置

Fqueue的配置文件位于conf/config.properties,默认配置：

port=12000
path=db
logsize=40
authorization=key|abc@@bbs|pass

• port Fqueue的启动端口
• path Fqueue的数据在磁盘上的存储目录
• logsize Fqueue在存储数据到磁盘上时，每个文件的最大大小（单位MB）,logsize不要设置太大，一般100M以内吧。推荐用40左右的大小。
• authorization 权限配置信息格式

队列1|队列1的密码@@队列2|队列2的密码@@…… 注意：队列名和密码不能包含“@”、"|"、,""和中文字符。

JVM启动配置

关于JVM的启动配置可以在./run.sh中修改

User_Guide

使用指南

协议介绍

FQueue的协议基于Memcached协议。 注意：目前Fqueue会自动忽略flag参数，也就是说不支持客户端的压缩、自动序列化和反序列化。

入队

add queuename_password[_其他任意字符] flags exptime <bytes>\r\n
<data block>\r\n

或者：

set queuename_password[_其他任意字符] flags exptime <bytes>\r\n
<data block>\r\n

[其他任意字符]是可选的，对于最终的存储并不会有任何影响，在FQueue内部会自动忽略。比如：

add queuename_password_123333 flags exptime <bytes>\r\n
<data block>\r\n

通过使用增加后缀的方式，可以实现client根据key做hash，实现分布式。 flags exptime参数在0.1版本中会被忽略。即不支持memcached的过期，自动序列化和反序列化，压缩。

出队

get queuename_password\r\n

获取队列大小

获取队列大小只需队列名，无需密码：

get size|queuename\r\n

清空

清空某个队列的所有数据：

get clear|queuename|password\r\n

重新加载权限配置

重新加载配置文件设置的权限信息：

get reload|queuename|password\r\n

只需要任何一个queuename,password即可。在运行期，可以方便增加新的队列或者更改密码。

JVM监控信息

获取可以监控JVM的监控信息

get monitor|items\r\n

items选项可以是

fileDescriptor,tomcat,load,allThreadsCount,peakThreadCount,daemonThreadCount,totalStartedThreadCount,deadLockCount,heapMemory,noHeapMemory,memory,classCount,GCTime,memoryPoolCollectionUsage,memoryPoolUsage,memoryPoolPeakUsage

stats

与memcached同

stats\r\n

比如会输出：

stats
STAT bytes_written 80513657
STAT connection_structures 0
STAT bytes 0
STAT total_items 0
STAT total_connections 8986
STAT rusage_system 0.0
STAT rusage_user 21
STAT uptime 89923
STAT current_bytes 0
STAT pid 14
STAT get_hits 693687
STAT curr_items 0
STAT free_bytes 300950568
STAT version 0.1
STAT cmd_get 719106
STAT time 1313230151
STAT cmd_set 686142
STAT threads 16
STAT limit_maxbytes 0
STAT bytes_read 57971278
STAT curr_connections 37
STAT system_load 0.67
STAT get_misses 25419
END

使用

PHP使用

$mem=new Memcache();
$mem->connect('127.0.0.1',12000);
$mem->add('queuename_password',$message,0,0);
$msg=$mem->get('queuename_password');
echo $msg;

JAVA使用

JAVA进程内使用（性能最高）

Fqueue的底层FSQueue可以直接在java应用中，作为嵌入式的持久化队列使用

关于性能

监控

高可用设计

Monitor_screenshots #

监控截图 Updated Sep 28, 2011 by sunli1...@gmail.com

#cacti监控演示

通过FQueue提供的监控接口，cacti的监控截图演示：