Midsummer Milestone

README.md

@@ -5,6 +5,96 @@
 
 [![Package quality](http://packagequality.com/badge/loadtest.png)](http://packagequality.com/#?package=loadtest)
 
+# Gwloadtest
+
+Gwloadtest modified loadtest to creat load tests that imitate client-behavior more closely by using randomly distributed time intervals between requests and allowing for more random url access behavior. 
+
+## How to Use
+
+  1. clone this repository, and open the newly cloned directory:
+
+```
+  git clone https://github.com/gwcloudlab/gwloadtest.git
+```
+
+  2. Install Node.js and npm by by running the following commands: 
+
+```
+  ./install_node.sh
+```
+
+  3. Modify sample/request-generator.js with desired options
+  4. Run the following command to run the test:
+
+```
+   node sample/request-generator.js  
+```
+## Modfifications
+
+### Poisson Interarrival time
+
+Given a requests per second rate and a time inerval for the load test, gwloadtests send requests at randomly distributed time intervals. 
+
+### Logs and Summaries 
+
+Gwloadtest prints a summary text file along with a log file that includes the index, timestamp, latency, status code, and url of every request.
+
+## Additions
+
+### Client Modes 
+
+In an attempt to resmeble client behavior, gwloadtest carries two client behavior policies.
+
+#### Closed Loop 
+
+The client thread sends a request and waits for it to return an html, which it then parses for hyperlinks and randomly selects a link so send the next request to. If no links are found, it sends the next request to the options url.
+
+usage example:
+```javascript
+   const options = {
+        url: 'http://127.0.0.1:5000',
+        statusCallback: statusCallback,
+        requestsPerSecond: 10, 
+        rpsInterval: 10, 
+        clientMode: 'closed' 
+    };
+```
+
+#### Open Loop
+
+The client thread sends requests to multiple links according to the weights given in a file. A file must be passed in along with selecting the open clientMode.
+
+usage example:
+```javascript
+    const options = {
+        url: 'http://127.0.0.1:5000',
+        statusCallback: statusCallback,
+        requestsPerSecond: 10, 
+        rpsInterval: 10, 
+        urlList: 'sample/url_list.txt', //include title of file here 
+        clientMode: 'open' 
+    };
+```
+sample/url_list.txt:
+```
+  url, weight
+  http://127.0.0.1:5000, 0.80
+  http://127.0.0.1:5000/test1, 0.20
+```
+
+### graphing scripts 
+
+Gwloadtest carries 4 types of graphing scripts in the scripts file, which can be run on the Gwloadtest generated log files.
+  1. 99th percentile latency vs. requests per second rate 
+  2. number of occurences vs latency histogram 
+  3. latency over time line graph
+  4. cdf vs response time 
+
+
+### Automation Script 
+
+For research purposes, automation/run.py can run multiple tests given a list of requests per second rates.
+
 # loadtest
 
 Runs a load test on the selected HTTP or WebSockets URL. The API allows for easy integration in your own tests.

automation/function.py

@@ -0,0 +1,16 @@
+import os
+import time
+from flask import Flask
+fibapp = Flask(__name__)
+@fibapp.route('/') 
+def index():
+   # temp()
+    return "Hello World!"
+
+def temp():
+    time.sleep(0.1)
+    print("waited")
+    return
+
+if __name__ == '__main__':
+    fibapp.run()

automation/run.py

@@ -0,0 +1,23 @@
+import os, json
+import subprocess
+from tracemalloc import start
+from Naked.toolshed.shell import execute_js
+
+
+
+def generateLoad(req, duration):
+    command =  "sample/request-generator.js --rps=" + str(req) + " --interval=" + str(duration)
+    execute_js(command) #run the script with the arguments 
+
+def main():
+    TEST_LIST = [1, 5, 10, 50, 100, 500, 1000]
+    duration = 10
+   # start_function()
+    for test in TEST_LIST:
+	     generateLoad(test, duration)
+
+
+
+
+if __name__ == "__main__":
+	main()

install_node.sh

@@ -0,0 +1,4 @@
+sudo apt update
+sudo apt-get install -y nodejs
+cd ~/gwloadtest
+npm install