Perform last sanity-check load test using random keys. Update docs.

Author: Ben Peterson

.gitignore

@@ -6,5 +6,6 @@ ubuntu-*.log
 .idea
 
 # Vegeta output folder
-vegeta
-
+vegeta/*.bin
+vegeta/*.html
+random*

README.md

@@ -80,19 +80,23 @@ MIX_ENV=prod mix compile.protocols
 MIX_ENV=prod PORT=3333 elixir -pa _build/prod/consolidated -S mix phoenix.server
 ```
 
-Vegeta is not really necessary for testing but it *is* really useful. Installing it and running the following command from the repository's `vegeta` driectory on a separate host will really pile on the hurt:
-
+Vegeta is not really necessary for testing but it *is* really useful. Installing it and running the following command from the repository's `vegeta` directory on a separate host will perform a simple load test, useful for checking the math.  It's recommended that you empty the database and restart the python processes before testing.:
 ```
-python create_targets.py 9000 targets.txt && vegeta attack -rate 9000 -output vegeta/out.bin -targets targets.txt
+cd vegeta
+echo "POST http://<yourserver>:3333/increment" | vegeta attack -rate 1100 -output out.bin -header "Content-Type: application/x-www-form-urlencoded" -body "./testbody"
 ```
 
-You can also run the test profile, which provides a moderate load, but does it in such a way that you can easily check the math in the database afterward.  It's recommended that you empty the database and restart the python processes before testing.
+You can also run the insane mode profile, which really piles on the hurt:
+```
+python create_targets.py 9000 <yourserver> && vegeta attack -rate 9000 -output out.bin -header "Content-Type: application/x-www-form-urlencoded" -targets random_targets.txt 
+```
 
+After a test, you can run the following to see a simple report:
 ```
-cd vegeta
-echo "POST http://<yourserver>:3333/increment" | vegeta attack -rate 1100 -output out.bin -header "Content-Type: application/x-www-form-urlencoded" -body "./testbody"
+vegeta report -inputs out.bin -reporter text
 ```
 
+See the Vegeta docs for more details on testing options and reporting output.
 
 # Design Choices
 

vegeta/create_targets.py

@@ -0,0 +1,24 @@
+import sys
+import random
+import uuid
+
+# Generate some random targets for Vegeta to obliterate
+if len(sys.argv) > 2:
+    num_targets = int(sys.argv[1])
+    target_server = sys.argv[2]
+    print "Generating {} random targets for server {}...".format(num_targets, target_server)
+
+    random_content = []
+    with open('./random_targets.txt', 'w') as targets_file:
+      for i in range(0, num_targets):
+          with open("./random{}".format(i), 'w') as body_file:
+              content = "key={}&value={}".format(uuid.uuid4(), random.randint(-10000, 10000))
+              body_file.write(content)
+          targets_file.write("POST http://{}:3333/increment\n".format(target_server))
+          targets_file.write("@./random{}\n".format(i))
+          targets_file.write("\n")
+
+    print "Done."
+else:
+    print "This program requires <num_targets> followed by <target_server>.  Exiting."
+

vegeta/testbody

@@ -0,0 +1 @@
+key=test1&value=1