AES benchmark

The AES benchmark use the AES128 algorithm to encrypt a certain message string. As we are using the aes gRPC protocol for this benchmark the message will be the plaintext_message variable. If you do not specify a plaintext_message a default plaintext_message is taken. You can change the default plaintext_message with the argument default-plaintext.

AES requires a secret key for encryption. The functions use a default key but you can specify your own by passing it with the key argument to the function. See source code for more details.

The same functionality is implemented in different runtimes, namely Python, NodeJS and golang.

Running this benchmark locally (using docker)

The detailed and general description how to run benchmarks local you can find here. The following steps show it on the aes-python function.

1. Build or pull the function images using make all-images or make pull.

Invoke once

2. Start the function with docker-compose

   docker-compose -f yamls/docker-compose/dc-aes-python.yaml up

3. In a new terminal, invoke the interface function with grpcurl.

   ./tools/bin/grpcurl -plaintext localhost:50000 helloworld.Greeter.SayHello

Invoke multiple times

2. Run the invoker

   # build the invoker binary
   cd ../../tools/invoker
   make invoker
   
   # Specify the hostname through "endpoints.json"
   echo '[ { "hostname": "localhost" } ]' > endpoints.json
   
   # Start the invoker with a chosen RPS rate and time
   ./invoker -port 50000 -dbg -time 10 -rps 1

Running this benchmark (using knative)

The detailed and general description on how to run benchmarks on knative clusters you can find here. The following steps show it on the aes-python function.

1. Build or pull the function images using make all-images or make pull.
2. Start the function with knative

   kn service apply -f ./yamls/knative/kn-aes-python.yaml

3. Note the URL provided in the output. The part without the http:// we'll call $URL. Replace any instance of $URL in the code below with it.

Invoke once

4. In a new terminal, invoke the interface function with test-client.

   ./test-client --addr $URL:80 --name "Example text for AES"

Invoke multiple times

4. Run the invoker

   # build the invoker binary
   cd ../../tools/invoker
   make invoker
   
   # Specify the hostname through "endpoints.json"
   echo '[ { "hostname": "$URL" } ]' > endpoints.json
   
   # Start the invoker with a chosen RPS rate and time
   ./invoker -port 80 -dbg -time 10 -rps 1

Tracing

This Benchmark supports distributed tracing for all runtimes. For the general use see vSwarm docs for tracing locally and with knative.