引用網址：http://blog.codecp.org/2016/08/24/centos%E4%B8%8B%E5%AE%89%E8%A3%85Tsung/

Centos下安装Tsung

近期公司openfire相关产品频繁出现问题，需要测试一下Openfire服务器的性能，同事推荐了Tsung这个鼎鼎大名的工具来进行测试，这里分享下这次测试的情况。
首先介绍下Tsung在Centos下的安装:

一、安装环境

二、安装系统依赖软件

三、安装Erlang/OTP R14B及以上版本

下载地址：http://www.erlang.org/downloads

四、编译安装Tsung

五、下载并安装perl Template,用于生成报告模版

六、下载并安装用于聊天生成的gnuplot

七、配置erlang和tsung的环境变量

到目前为止安装过程完成。

八、Tsung使用

Tsung使用这里简单介绍下，后续我会更新具体测试的博文。

1、配置文件

默认配置文件是 ~/.tsung/tsung.xml
因此在用户宿主目录下新建目录.tsung，用于存放xml配置文件和log。
配置文件示例在 /usr/local/tsung/share/doc/tsung/examples

2、运行

安装完tsung后有两个commands可使用:tsung和tsung-recorder
典型的tsung运行命令是：

3、查看报告

运行完成后进入Log目录下可以看到生成的log信息

进入需要生成图形报表的Log目录，通过下面命令生成报告:

打开report.html就可以查看报告了。

Tsung配置文件解析-文件结构

上篇Tsung的安装部署成功后，按照网上文档已对openfire进行了相关测试，但对其中一些内容还是似懂非懂，甚至云里雾里，远远达不到会用的目的。
最近刚好也对性能测试比较感兴趣，就抽时间在官网上查看介绍文档。下面就把这两天的成果与大家分享下，从本篇开始将对Tsung的配置文件进行介绍，内容基本上是对官方内容的翻译，有不对的地方欢迎大家不吝赐教。
Tsung官方文档地址：http://tsung.erlang-projects.org/user_manual/index.html
针对tsung.xml配置文件主要按照以下7个部分开始，同时会开7篇文章来介绍：

• 文件结构
• Clients and server
• Monitoring
• load progression
• options
• Sessions
• 高级特性

开始文件结构的介绍

一、默认编码

默认编码为utf-8，可以设置成其他编码，比如：
<?xml version=”1.0” encoding=”ISO-8859-1”?>

二、xml文件的结构

先整体了解xml文件的结构，它是由下面这些标签构成:

• 顶级标签<tsung>
• 客户端标签<clients>
• 服务端标签<servers>
• 监控标签<monitor>
• 负载标签<load>
• 选项标签<options>
• 过程标签<sessions>

三、顶级标签

3.1、顶级标签是tsung

例如

3.2、参数

3.2.1 dumptraffic

true:所有的通信都会被记录，注：这会大大降低tsung速度，一般是用于调试
light:只转储前44字节

3.2.2、loglevel

可设置值为：

• emergency
• critical
• error
• warning
• notice (default)
• info
• debug

loglevel对性能有很大影响，在高负载下建议使用warning级别
要设置很详细的log，需要在重新编译tsung使用make debug，然后设置loglevel为debug。

Tsung配置文件解析-Clients和Server

Clients and server

一、基本设置

对于非分布式负载，可以使用一个简单配置:

注：最基本的设置，在同一机器上。

server是进入集群的入口点，可以添加多个servers。
默认每个server将有一个为1的weight，并且每个会话都会根据weight随机选择一个server。您可以为每台server设置一个weight(weight可以是一个整数或一个浮点数):

type可以是tcp、udp、ssl或者websocket
这里有一个特殊类型的type：BOSH，bosh是非加密的BOSH，bosh_ssl是加密连接。

二、高级设置

下个例子是更复杂的，使用先进的分布式测试的几个功能：

可以用多个虚拟IP来模拟出更多的机器，在负载均衡中使用客户端IP把流量分配到服务端集群中时，这点十分有用。
IP不是强制性的，如果没有设置将会使用默认IP。
可以设置<ip scan=”true” value=”eth0”/>来扫描给指定网络接口上的所有IP(比如eth0)。
在这个例子中，第二个client机器在tsung集群中，它被设定更高的权重(weight)和2个cpu。它用两个erlang虚拟机来充分利用cpu数量。

注意：即使现在erlang vm能处理多个cpu(erlang SMP)，测试显示，对一个tsung客户端来说，一个cpu用一个vm更高效。因此你的cpu数最好和你的节点数相等。如果你还坚持用erlang SMP，在启动tsung加上-s选项，并且不要在配置文件中设定cpu个数。
默认情况下，负载被统一的分配到所有的cpu上(默认一个客户端一个cpu)。参数的权重(weight)可以用来衡量客户端机器的处理速度。
例如，有两台真实机器，一台比重为1，另一台为2，那么第二台机器会比第一台机器多启动一倍的用户(比重是1/3,2/3)。
在上面的例子中，第二台机器有2个cpu权重(weight)是3，这就相当于每个cpu的比重是1.5。

2.1、maxusers

maxusers参数被用来忽略单个进程对套接字打开数的限制(默认是1024)。当用户数高于这个限制后，就会启动一个新的vm来处理新的用户。
参数maxusers的默认值是800。现在的机器开启kernel poll功能后，你就可以对maxusers设定一个最高的值(如30000)而没有性能损失(但注意不要忘记用ulimit -n提高os的限制)。
注意：如果使用主从架构的tsung，master将分配session给slave。如果一个session包含多个请求，slave将按顺序执行每一个。

2.2、error_connect_emfile错误

这通常是由于你设置的maxuser值太大(在<client>)，默认值是800。
这个错误意味着你当前运行的数量超过了file descriptors，必须检查maxusers保证小于操作系统设定的每个进程可打开的最大文件数(ulimit -m 查看)。
你可以提高操作系统的限制(Linux下/etc/security/limits.conf)或者减少tsung的maxusers，在同一个机器行启动多个虚拟机来均衡maxusers限制。
如果你想运行大量用户测试，一个好的方法是对操作系统配置进行修改：
增加打开文件的最大数量和自定义TCP设置：

2.4、运行一个带有作业调度器的tsung

(不理解)
Tsung可以从一个batch/job 调度器获取客户端节点列表，目前处理PBS/torque, LSF 和 OAR。为此，设置type属性为batch，如:

如果你需要在batch调度器指定的节点上扫描IP别名，使用scan_intf，例如:

Tsung配置文件解析-Monitoring

Tsung可监控多个远程服务器，每个远程服务器都是由多个用远程agent与后台交互，在<monitor>标签中配置。可统计的数据有：cpu使用情况、系统负载和内存使用情况。
请注意，您可以从作业调度器得到监视节点，例如：

支持多种类型的远程代理(默认是erlang)。

一、erlang

erlang是默认值，使用它要保证监控的机器和server可以互相访问，并且装有erlang。
由Tsung启动远程代理，在server上使用erlang communications获取统计数据。
例如下面是一个使用erlang代理的监控cluster定义，cluster内有6台机器：

注意：被监控机必须在网络上可访问，并且erlang communications必须通过ssh无密码可访问。在节点上必须使用相同版本的 Erlang/OTP，否则可能出问题。

如果远程server上不能安装erlang，就需要考虑使用其他可用代理。
erlang监控还支持用mysqladmin监控mysql数据库的配置选项，使用方法如下：

可监控项：mysql客户端连接数、Questions(查询数)

二、SNMP

如果使用SNMP监控，type值用snmp代替erlang，也可以混合使用。
可以自定义SNMP版本、团体名和端口，它使用的管理信息库（MIB）在net-snmp提供。

默认版本是v1，默认团体名是public，默认端口为161。
在1.4.2版本以后，你也可以自定义object identifiers (OID)从服务器获取数据，可以使用一个或多个oid标签：

类型可以是sample, counter 或 sum,你可以定义一个函数（Erlang语法）被应用到value（属性eval）。

三、 Munin

Tsung可以从munin代理节点获取数据。type字段必须设置为munin，例如：

Tsung配置文件解析-Load

定义负载标签

一、随机生成用户

load标签定义了几个用户到达阶段

上面的配置文件表示：用户的生成分三个阶段，在第一个10分钟阶段每2秒钟生成1个新用户，在第二个10分钟阶段每秒钟生成1个用户，最后一个10分钟阶段每秒钟生成10个新用户。这些测试将在所有用户执行完它们的过程(后面的session标签代表的过程)之后，整个测试就结束了。
上面的第三阶段是每秒生成10个用户，但它字面上理解是每0.1秒生成一个用户，你还可以使用”arrivalrate”代替”interarrival”，例如：你需要每秒生成10个用户：

可以使用maxnumber属性限制每阶段生成用户的最大数量，例如下面：

按照上面配置，第一阶段将只能生成100个用户，第二阶段200个用户。

还可以用load标签中用loop属性来让整个过程执行多次，如：loop=’2′的意思是这序列被循环两次，所以完整负载被执行三次。(这个要在版本1.2.2之后可用)。
负载每秒http的请求数依赖于每个session的request的个数，例如：每个session有100个request， 每秒生成10个新用户，那么理论的平均吞吐量是每秒1000个request。

还可以重写特定阶段中会话的概率设置，使用session_setup：

二、静态生成用户

你想在测试的过程中在指定的时间上启动给定的session，在1.3.1版本之后可以实现。

在这个例子中，有2ession，一个的probability为“0”(因此在第一阶段不会被执行，就是随机生成用户部分)， 而另一个是100。
在测试开始之后，我们设置3个用户分别启动，第一个在3分5秒(执行http-example session)启动，第二个在10分钟后启动(http-example session)，最后一个在11分钟后启动(foo session)。

如果你想要同时启动多个sessions，并且这些sessions的名字前缀都一样，你可以使用通配符。
鉴于上面例子的sessions，这个例子我们将在10秒后开始2个用户(foo和foobar session)。

三、load test持续时间

默认情况下，tsung在所有用户都完成他们的session之后结束，因此这个时间可能会长于<arrivalphase>定义的持续时间。
如果你想要停止tsung而不管阶段是否完成，也不管是否有session正处于激活状态。那么你可以在load标签中增加duration属性(版本1.3.2后有效)。

目前这个duration的值不能大于50天，unit可以设置为second，minut或者hour。

Tsung配置文件解析-Options

本篇开始介绍options配置

一、Thinktimes,SSL,Buffers

全局变量的默认值可以在这儿进行设定，比如：场景中两次请求间的思考时间(thinktime)，ssl加密算法，tcp/udp缓存大小(默认是32KB)。如果override设置为true，这些值会把session配置文件中的对应值覆盖。

可以禁用SSL session缓存(默认是启用的)

你还可以使用命令行选项 -L 来改变session的缓存时间(默认是10分钟)，value必须使用seconds。

二、TCP连接超时时间

你可以为一个创建TCP连接设置以毫秒为单位的超时时间，默认是无穷大：

还可以基于每个session更改超时时间，使用set_option：

也可以全局启用TCP REUSEADDR 选项：

REUSEADDR解释：一般来说，一个端口释放后会等待两分钟之后才能再被使用，SO_REUSEADDR是让端口释放后立即就可以被再次使用。

三、重试和超时

可以指定重试的总次数，默认是3：

要关闭重试，可以将这个值设置为0。
此外，retry_timeout（毫秒；默认为10）可以简单的计算出总超时时间(retry* retry_timeout)：

四、acknowledgments 消息超时时间

用来设置空闲(idle)超时时间(用在’parse’和’local’ ack)和global ack超时时间(用在’global’ ack)。默认空闲(idle)超时时间是10分钟(600000)，global ack 超时时间是无限大。可以这样更改设置：

五、Hibernate

Hibernate选项是用来减少模拟用户在thinktimes期间的内存消耗。
默认情况下，当thinktimes超过10s之后hibernate就会被激活，这个可以进行修改，如：

要禁用hibernation，必须设置此值为infinity。

六、Rate_limit

rate_limit会限制每个客户端的带宽(使用令牌桶算法token bucket algorithm)，单位为KBytes/s。
可以设置一个最大值(比如max=’2048)，默认情况下最大值等同于rate_limit(下面例子是1024KB)。
注意：当前只能限制进入的流量的速率。

七、Ports_range

如果你需要在同一个客户端机器上打开超过30000个并发连接，client的TCP端口数将会限制你，尽管你有多个IPs(存在于Linux OS)。
为了绕开这个限制，Tsung不能为每个客户端指派被选中的client端口和同时使用多IP，你必须定义一个client可用端口数范围，如下：

八、设置seed随机数生成器

默认Tsung使用当前时间来生成seed，因此每次测试使用的随机数量是不一样的。如果你想使用一个固定seed数量的随机数生成器，可用设置seed选项，如下:

九、BOSH路径

可用使用下面配置项来设置BOSH请求的路径：

BOSH即Bidirectional-streams Over Synchronous HTTP，是一种传输协议。它可以利用同步的HTTP协议模拟两个实体（例如客户端-服务端）双向流传输，而不需要轮询或异步组件。到目前为止，BOSH主要用于Jabber/XMPP客户端-服务器之间的数据传输（如web端和手机客户端之间的通讯）。

十、Websocket选项

使用Websocket类型服务的时候，你可以设置Websocker的如下选项：

使用websocket_path设置Websocket请求的路径，使用websocket_frame设置发送websocket数据的frame类型(类型选项：binary和text,默认为binary)。

十一、XMPP/Jabber选项

协议特性的默认值可以自定义，下面是一个XMPP/Jabber选项值的例子：

使用上面设置，用户将为myuserxxx格式，xxx是[1:userid_max]区间内的一个整数，密码为mypasswdxxx格式。
如果没有设置这个配置文件，这些值将默认为：

• global_number = 100
• userid_max = 10000
• domain = erlang-projects.org
• username = tsunguser
• passwd = sesame

如果你想用一个CSV文件的用户名密码，需要配置其他选项，下一篇session将会介绍。

十二、HTTP选项

对于HTTP，可以配置UserAgent，为每个值设置自己的probability，probability总数必须为100：

十三、AMQP 选项

可以设置AMQP心跳超时时间，下面例子设为30s(默认600s)，添加:

AMQP是一个提供统一消息服务的应用层标准协议，基于此协议的客户端与消息中间件可传递消息，并不受客户端/中间件不同产品，不同开发语言等条件的限制。

Tsung配置文件解析-Sessions

二、HTTP

下面这个例子展示了http协议支持Tsung的多种特性:get和post请求、基本的认证、事务、数据统计定义、状态请求。

If-Modified-Since作用：If-Modified-Since是标准的HTTP请求头标签，在发送HTTP请求时，把浏览器端缓存页面的最后修改时间一起发到服务器去，服务器会把这个时间与服务器上实际文件的最后修改时间进行比较。

• 如果时间一致，那么返回HTTP状态码304（不返回文件内容），客户端接到之后，就直接把本地缓存文件显示到浏览器中。
• 如果时间不一致，就返回HTTP状态码200和新的文件内容，客户端接到之后，会丢弃旧文件，把新文件缓存起来，并显示到浏览器中。

如果使用绝对路径地址，该网址中使用的server将覆盖<server>部分中指定的server。在session中后面的相关请求也将使用这个新的server值（直到一个新的绝对的网址被设置）。
在1.2.2版本之后，你还可以像下面这样增加任何的http头：

在版本1.3.0你可以从外部文件中读取post和put的内容:

在版本1.3.1之后，你还可以手动的设定一个cookie，由于cookie不是可持久的，所以你要在每个请求中<request>增加它的代码：

2.1、Authentication

1.5.0版本之前只支持基本认证，现在可以使用Digest认证和OAuth 1.0认证。
使用Digest认证:

使用OAuth认证:

三、Jabber/XMPP

这里是一个Jabber/XMPP协议的session定义实例:

3.1、消息邮戳

(不理解未验证)
通过配置<jabber>标签的stamped属性来设置聊天消息邮戳确保请求是正确的。
邮戳将包含发送节点的当前时间戳和ID。如果接受者准备识别节点ID，它将比较现在和消息里的时间戳，差异将以xmpp_msg_latency(毫秒)被报告。节点ID比较的目的是为了避免在不同Tsung节点的时间戳轻微的不一致。
只有一小部分的请求将达到相同的节点，但随着请求率足够高，这部分应该是够的。
stamped仅允许size属性，data将会导致stamped被忽略。stamp的最小长度大约是30bytes，如果size大于stamp长度，将随机生成一些填满stamp。如果stamp长度大于size，只有将stamp作为消息内容，保证超出的指定长度是有效的。

3.2、StartTLS

(不理解未验证)
使用STARTTLS来保证stream安全，使用：

1.5.1版本后可以使用客户端证书，例如，你可以使用动态变量，像这样：

注：STARTTLS 是对纯文本通信协议的扩展。它提供一种方式将纯文本连接升级为加密连接（TLS或SSL），而不是另外使用一个端口作加密通信。

3.3、Roster

(不理解未验证)
Tsung对Roster的支持：

• 添加新的联系人的到名单-新联系人添加到Tsung Group组，名字对应他们的JID。
• 发送订阅消息到新建联系人的JID。
• 重命名联系人。
• 删除以前的联系人。

新建一个联系人时，JID将被存储和用于后续操作。建议配置执行这些操作的每个session只做一次。换句话说，你不想为每个session添加多于一个联系人。在测试用如果你想改变rose函数的使用频率，最好使用session的probability来实现。
很棒的一点是当测试跑完时，名单表看起来应该和测试前是相同的。因此，如果您正确设置了它，您可以在测试之前加载需要的名单条目，然后使用这些方法来动态添加、修改和删除在测试过程中的名单条目。
示例，名单变更步骤：

3.4、SASL Plain

(不理解未验证)
SASL Plain认证例子：

3.5、anonymous SASL

(不理解未验证)
anonymous SASL认证例子：

7.3.6、Presence
type：可设置为presence:broadcast 或 presence:directed。
show：可设置为away, chat, dnd, 或 xa。
status：可以是任何文本。
如果你省略了show和status属性，则默认为chat和Available。
广播发送例子(广播到你的Rose(名单)用户)：

单独发送例子(随机发送到在线用户)：

3.7、MUC

Tsung支持4种MUC操作：

• 加入房间(属性type=’muc:join’)
• 发送一个消息到房间(属性type=’muc:chat’)
• 修改昵称(属性type=’muc:nick’)
• 退出房间(属性 type=’muc:exit’)

下面是个例子：

3.8、PubSub

略

3.9、VHost

1.3.2版本后就开始支持VHost了。
Tsung可以在连接的时候从列表中选择一个vhost XMPP名称从而设置多个vhost实例。
vhost列表是从外部文件读取的：

当每个client启动session时，它们随机选择一个domain(每个domain都有相同的probability)。

3.10、从CSV文件读取用户名和密码

1.4.0版本后就可以从csv文件读取用户名和密码了。
配置CSV文件：

接下来你需要定义两个类型为file的变量，第一个jabber 请求(connect)必须包含该一个xmpp_authenticate标签：

此外，当发送聊天信息到随机或离线用户时，你需要通过配置userid_max为0和设置fileid为离线或随机用户(也用户Pubsub)来禁用默认用户(不是CSV的):

用户名(密码)应该在每行CSV的第一格(第二格)分隔符是”;”，可以修改。

3.11、raw XML

可以使用类型为raw来发送raw XML数据到服务器。

当心：你必须对XML字符进行编码，如<,>,等待。

3.12、resource

默认情况下，XMPP资源设置为tsung。自从版本1.5.0，可以重写这个(在所有auth_ *和注册请求)使用的资源属性。

四、PostgreSQL

对于PostgreSQL，4种请求类型是可用的：

• connect(提供用户名)
• authenticate (提供密码或不提供)
• sql(基本协议)
• close

此外，下列额外部分协议也是支持的：

• copy
• parse, bind, execute, describe
• sync, flush

下面例子展示了postgresql session的多个特征：

下面是额外协议的：

五、MysQL

对于mysql，4种类型的请求是支持的：

• connect(提供用户名)
• authenticate (提供密码或不提供)
• sql
• close

下面例子展示了mysql相关的sessions：

六、Websocket

对于Websocket，3种类型的请求是支持的：

• connect (提供path)
• message (发送消息到服务器，添加一个’ack’属性来指定是否Tsung应该等待响应)
• close

Websocke session类型：

你可以替换path属性和消息内容，使匹配响应或基于消息响应定义动态变量。
如果你使用change_type来启动一个websocket，不要忘了设置bidi=”true”，例如：

七、AMQP

对于AMQP，支持在多个信道上发送和消耗消息，可用请求类型：

• connection.open (given vhost)
• connection.close
• channel.open (一个指定和有效的channel id)
• channel.close (一个指定和有效的channel id)
• confirm.select (一个指定和已经打开的channel)
• basic.qos (在一个指定和已经打开的channel, 只支持‘prefetch_count’属性)
• basic.publish (with channel id, exchange name, routing_key and the payload)
• basic.consume (with channel id, queue name)
• waitForConfirms (从服务器确认超时)
• waitForMessages (向client确认消息交付超时)

AMQP session类型的例子：

八、MQTT

支持发布消息，订阅和取消订阅话题，可用请求类型：

• connect (with options like clean_start, will_topic etc)
• disconnect
• publish (with topic name, qos level and retain flag)
• subscribe (with topic name and qos level)
• unsubscribe (with topic name)
• waitForMessages (with timeout for messages published from server to the client)

MQTT session类型的例子：

注：MQTT（Message Queuing Telemetry Transport，消息队列遥测传输）是IBM开发的一个即时通讯协议，有可能成为物联网的重要组成部分。

九、LDAP

9.1、Authentication

推荐机制用于LDAP库对用户进行身份验证，需要下面两个步骤。给定一个用户名和密码，然后：

• 在库的树结构对用户搜索，使用用户名（用户可以驻留在不同组织的子树）
• 尝试绑定为用户，使用在第一步中发现的名称和用户的密码

如果绑定成功，此用户就验证通过(这是使用的方案，其中，LDAP认证模块由Apache支持)。

9.2、LDAP Setup

对于这个例子，我们将使用下面的层次结构来使用一个简单的存储库。

LDAP层次结构：
库中有两个组织单位的用户

• users(4个成员)
• users2(3个成员)

简单起见，我们为每个用户设置和名称一样的密码，在测试中Tsung setup我们将使用CSV文件作为输入，包含user:password对。因此我们从编写这个开始，在这种情况下我们对文件命名users.csv：

这对用户名密码对paul:pablo应该验证失败，我们将在Tsung报告中看到。现在在Tsung配置单元，我们先引人这个文件：

启动认证过程，我们通知Tsung执行搜索，找到我们试图验证的用户的可分辨名称:

当需要访问搜索结果的时候，我们定义它使用result_var属性，这个属性告诉Tsung哪些变量我们想要存储(如果result_var属性没有被设置，Tsung不能再任何地方存储搜索结果)。最后我们试图绑定这个用户:

唯一剩下要做的是实现ldap_auth:user_dn功能，从搜索结果提取的可分辨名称：

我们不在这里覆盖错误。假设总有一个（只有一个）用户被发现，这是我们从search_result变量提取的(在前面搜索操作定义的)。在结果集中的每个条目是一个searchresultentry记录。记录定义可以在 /include/ELDAPv3.hrl 中找到。
事实上，test运行后我们可以在Tsung报告里确认(见LDAP结果图),绑定操作包含两个计时器：ldap_bind_ok和ldap_bind_error，成功数量和不成功的尝试。
LDAP结果：

9.3、其他示例

十、 混合session type

1.3.2版本后，一个新标记change_type用在session中来改变它的类型：

store=”true”可用来存储session当前的状态(socket, cookies for http等)，而restore=”true”是切换到旧的协议，重新使用以前的状态。
可以使用bidi=”true”表示新协议是双向的，或者bidi=”false”表示非双向协议。
一个动态变量设置在session的第一部分,可以在<change_type>后仍然可用。这是目前一个警告：在
警告：在<change_type>后你的第一个HTTP请求必须使用一个完整的URL。

十一、Raw

ts_raw插件允许在没有任何相关协议标识的情况下，发送数据到任何类型的TCP/UDP服务器。你可以通过data属性设置数据，也可以通过data_size属性设置数据大小(这种情况下，发送的数据大小为0)。data和 datasize都可以是动态值。
从服务器控制响应的唯一方法是使用ack属性（也可用Jabber插件）：

• ack=”local” 一旦从服务器接收到一个数据包，该请求被认为是完成的。因此，如果你使用一个local ack的请求，服务器就不需要响应，它将永远等待(或直到到达超时)。
• ack=”no_ack” 一旦请求发送，它就被认为是完成（不要等待传入的数据）。
• ack=”global” 用户同步。它的主要用途是在发送消息前等待所有用户连接。要做到这一点，建立一个global ack类型的请求(这个值可以使用option设置