NOT WORKING NOW! Project is compilable (master branch), but it is not working due to migration to post 2.2.0 gatling. It have now a bit different actor/action things internally and it does not match philosophy of original amqp plugin. I will hopefully fix it till the end of 2016.

Gatling AMQP support

• CAUTION: This is not official library!
  • but using 'io.gatling.amqp' for FQCN to deal with 'private[gatling]', sorry.
• inspired by https://github.com/fhalim/gatling-rabbitmq (thanks!)

scala> import io.gatling.amqp.Predef._
scala> amqp.declare(queue("q3", durable = true)).run

Publish is asynchronous step and does not block scenario until actual message is published. It can do publish with confirm mode turned on or off. It changes way of getting publish seq number and way of acknowledge from amqp server is done (sync or async).

  implicit val amqpProtocol: AmqpProtocol = amqp
    .host("localhost")
    .port(5672)
    // .vhost("/")
    .auth("guest", "guest")
    .poolSize(10)    

  val body = "{foo:1}")
  val queueName = "myQueue"

  val scn = scenario("AMQP Publish").repeat(1000) {
    exec(amqp("Publish").publish(queueName, body = Right(body)))
  }

  setUp(scn.inject(rampUsers(10) over (1 seconds))).protocols(amqpProtocol)

• set "confirmMode()" in protocol that invokes "channel.confirmSelect()"

  implicit val amqpProtocol: AmqpProtocol = amqp
    .host("localhost")
    .port(5672)
    .auth("guest", "guest")
    .poolSize(10)
    .confirmMode()

  val body = "{foo:1}")
  val queueName = "myQueue"

  val scn = scenario("AMQP Publish(ack)").repeat(1000) {
    exec(amqp("Publish").publish(queueName, body = body))
  }

  setUp(scn.inject(rampUsers(10) over (1 seconds))).protocols(amqpProtocol)

Convenience method for setting the fields in an AMQP URI: host, port, username, password and virtual host. If any part of the URI is ommited, the ConnectionFactory's corresponding variable is left unchanged.

  implicit val amqpProtocol: AmqpProtocol = amqp
    .host("localhost")
    .port(5672)
    .auth("guest", "guest") 

Is equivalent to:

  implicit val amqpProtocol: AmqpProtocol = amqp
    .uriString("amqp://guest:guest@localhost:5672")

Note that not all valid AMQP URIs are accepted; in particular, the hostname must be given if the port, username or password are given, and escapes in the hostname are not permitted.

amqp_URI       = "amqp[s]://" amqp_authority [ "/" vhost ] [ "?" query ]
   
amqp_authority = [ amqp_userinfo "@" ] host [ ":" port ]
   
amqp_userinfo  = username [ ":" password ]

The vhost component of the URI does not include the leading "/" character from the path, and any "/" characters that appear in the vhost name must be url-encoded.

The vhost component may be absent; this is indicated by the lack of a "/" character following the amqp_authority. An absent vhost component is not equivalent to an empty (i.e. zero-length) vhost name.

All the following are equivalent expressions:

  implicit val amqpProtocol: AmqpProtocol = amqp
    .uriString("amqp://guest:guest@localhost:5672")
    .vhost("/")

  implicit val amqpProtocol: AmqpProtocol = amqp
    .uriString("amqp://guest:guest@localhost:5672/%2f")

  import java.net.URLEncoder
  implicit val amqpProtocol: AmqpProtocol = amqp
    .uriString("amqp://guest:guest@localhost:5672/" + URLEncoder.encode("/","UTF-8"))

The vhost component may be absent; this is indicated by the lack of a "/" character following the amqp_authority. An absent vhost component is not equivalent to an empty (i.e. zero-length) vhost name. Examples and more details in the RabbitMQ URI Specification

Use the URI method and change the amqp:// to amqps://

  implicit val amqpProtocol: AmqpProtocol = amqp
    .uriString("amqps://user:pass@host:5672/vhost")

  implicit val amqpProtocol: AmqpProtocol = amqp
    .host("localhost")
    .port(5672)
    .auth("guest", "guest")
    .declare(queue("q1", durable = true, autoDelete = false))

  val x = exchange("color", "direct", autoDelete = false)
  val q = queue("orange")
  implicit val amqpProtocol: AmqpProtocol = amqp
    .host("localhost")
    .port(5672)
    .auth("guest", "guest")
    .declare(x)
    .declare(q)
    .bind(x, q, routingKey = "orange")

• full code: src/test/scala/io/gatling/amqp/PublishingSimulation.scala

Consume is asynchronous operation which will start consumer on given queue, which will consume all messages which gets to the queue. It does not block scenario (it is async).

  implicit val amqpProtocol: AmqpProtocol = amqp
    .host("amqp")
    .port(5672)
    .auth("guest", "guest")

  val scn = scenario("AMQP Publish(ack)").exec {
    amqp("Consume").consume("q1", autoAck = true)
  }

  setUp(scn.inject(atOnceUsers(1))).protocols(amqpProtocol)

• full code: src/test/scala/io/gatling/amqp/ConsumingSimulation.scala

Consume is blocking operation which will start consumer on given queue and wait until exactly one message is consumed. Message can be saved in session if needed and used later. Do not forget to drop it from session if no longer needed.

• implementation is bit broken and unreliable when run more than few users in parallel

  implicit val amqpProtocol: AmqpProtocol = amqp
    .host("amqp")
    .port(5672)
    .auth("guest", "guest")

  val scn = scenario("AMQP Publish(ack)").exec {
    amqp("Consume")
      .consumeSingle("q1", saveResultToSession = true)
      .exec(session => {
        val msg = session(AmqpConsumer.LAST_CONSUMED_MESSAGE_KEY).asOption[DeliveredMsg]
        println("Response=" + msg)
        println("ResponseBody=" + msg.map(m => new String(m.getBody, "UTF-8")))
        // drop possibly large response from session
        session.set(AmqpConsumer.LAST_CONSUMED_MESSAGE_KEY, null)
      })
  }

  setUp(scn.inject(atOnceUsers(1))).protocols(amqpProtocol)

• not implemented yet

% sbt
> testOnly io.gatling.amqp.PublishingSimulation

% sbt
> testOnly io.gatling.amqp.ConsumingSimulation

• try sbt -J-Xmx8192m -J-XX:MaxPermSize=256m for publishing massive messages

% ./run p foo

• stored in "stats/p/foo"

• cpu: Xeon X5687(3.60GHz)
• mem: 24GB, limit(10GiB), watermark(5GiB)

• version: 3.5.2
• total bytes = servers * payalod * messages * users
• users = concurrency of AMQP connections

• log error: statsEngine stopped before working actors finished

• amqp-client-3.6.5 (3.5.1, 3.5.3, 3.5.7 and 3.6.1 is also known to be working)
• gatling-2.2.2

• declare exchanges, queues and bindings in action builder context (to test declaration costs)
• make AmqpProtocol immutable
• make Builder mutable
• mandatory
• consume action (manual ack)
• consume followed by publish and than pause will cause to report publish times containing also pause time (RpcSimmulation with pause after each publish shows it)

released under the MIT License.