Fun facts¶

Here’s some nice things about Rungutan that will help you build the most complex workflows you could imagine with little to no stress:

Concurrent regions list¶

We currently support the following regions that can be specified within the test_region property of a test or template:

["ap-northeast-1", "ap-northeast-2",
"ap-southeast-1", "ap-southeast-2",
"eu-central-1",
"eu-west-1", "eu-west-2", "eu-west-3",
"us-east-1", "us-east-2",
"us-west-1", "us-west-2",
"ca-central-1",
"ap-south-1",
"sa-east-1"]

These values emulate the following regions:

ap-northeast-1 = Tokyo
ap-northeast-2 = Seoul
ap-southeast-1 = Singapore
ap-southeast-2 = Sydney
eu-central-1 = Frankfurt
eu-west-1 = Ireland
eu-west-2 = London
eu-west-3 = Paris
us-east-1 = North Virginia
us-east-2 = Ohio
us-west-1 = North California
us-west-2 = Oregon
ca-central-1 = Canada (Central)
ap-south-1 = Mumbai
sa-east-1 = Sao Paulo

They are all offered through the Amazon Web Services cloud and are all currently working as expected.

The more concurrent regions you specify, the more concurrent global connections to your API that you simulate!

Threads per region logic¶

Since we offer the possibility of running concurrent tests from multiple regions, it means that you should also have the possibility of setting up HOW many IPs are used in each region.

Therefore, the property threads_per_region defined the number of public IPs which are used to send connections to your API !

Simulate 10 million requests per minute¶

-> “You guys bragged about being able to simuate 10 million requests per minute. How can I do that myself?”

Reply:

Well, it’s easy :)

Let’s do some math:

test_regions * 25 threads_per_region  = 375 threads (with a public IP each) that are running the tests

threads_per_region * 750 num_users * 1 req/second = 281.250 simulated users in total across those 375 threads each second

250 * 60 seconds = 16.875.000 requests simulated in just 1 minute

PS: This scenario works as long as your platform is actually able to sustain at least 280.000 requests/second…

JSON payload¶

We only accept string for payload, but that shouldn’t stop you from actually sending a JSON value like this (by simply escaping it):

{
  "method": "POST",
  "path": "/my/post/path",
  "data": " {\"this\": \"payload\", \"is\": \"escaped\"} ",
  "headers": {
    "content-type": "application/json"
  }
}

Extract nested json response¶

If your response JSON looks like this for instance:

{
  "a":"b",
  "c": {
    "d": "e",
    "f": {
      "g": "h"
    }
  }
}

And you would like to fetch the value of [“c”][“f”][“g”] then your extract key would look like this:

{
    "extract": [
        {
            "parameter_name": "extracted_key",
            "location": "body",
            "key": "c.f.g"
        }
    ]
}

Extract nested json response with array¶

If your response JSON looks like this for instance:

{
  "a":"b",
  "c": {
    "d": "e",
    "f": {
      "g": "h"
    },
    "i": [
      {
        "j": "k"
      },
      {
        "l": "m"
      }
    ]
  }
}

And you would like to fetch the 1st value of [“c”][“i”] and specifically the “j” property in it, then you would write your extract key like this:

{
    "extract": [
        {
            "parameter_name": "extracted_key",
            "location": "body",
            "key": "c.i.0.j"
        }
    ]
}

Extract using regex¶

As you may have noticed already, our code, besides offering support for manipulating JSON responses in the body, also allows you to extract information using regex from non-Json response bodies.

This makes it perfect for any structured/non-structured response as long as you have a method of “searching” for the value that you need.

In case your regex returns multiple search results, only the first occurence of it gets taken into consideration.

For instance, if you’re using Laravel and your Login page looks like this:

[...]
<meta name="csrf-token" content="ThtvqtcSr44SSSbypUP7Ho31hQSffRXm00LcI30l"/>

[...]

Then you’d be able to extract that CSRF token as so:

{
    "extract": [
        {
            "parameter_name": "csrftoken",
            "location": "body",
            "element_find_regex": "meta name=\"csrf-token\" content=\"(.+?)\""
        }
    ]
}

Easy, right?