vSwarm-proto is a utility for vSwarm containing all the proto files and client applications necessary to run benchmarks using relay. As such its part of the vHive Ecosystem.
After you have added your benchmark in vSwarm and the necessary docker compose and knative yaml files with the relay snippet, the next step is to add a client to generate the necessary input for your benchmark.
A gRPC client would consist of a GeneratorBase structure (and a Generator interface for accessing its data fields) and ClientBase structure with connection information and GrpcClient interface with methods to establish connection, send requests, and close the connection.
The initial connection will be established similarly for most benchmarks, with a connection happening at the required ip address and port.
As mentioned in the relay README, the actual invokation to the benchmark happens in the Request method, which has to be defined for each benchmark and will change based on what gRPC methods the benchmark provides to be called.
For instance in
fibonacci, this is simply theSayHellofunction that expects a context andHelloRequestobject with theNamefield as the number. TheRequest()method would then have to call this function with appropriate parameters, and return the response message from the benchmark as a string.
There is a function Next() which was introduced to be used in conjunction with different generator options such as Unique, Linear, Random. The relay will retrieve the request message value from the Next() function, so its important to implement this.
In
fibonacciif you wanted a linearly varying stream of inputs, you would set the packet value as the next value, here implemented inIncrement()as increasing by 1 untilupperBoundhits.
vSwarm-proto is free. We publish the code under the terms of the MIT License that allows distribution, modification, and commercial use. This software, however, comes without any warranty or liability.
The software is maintained by the vHive Ecosystem. Join the vHive Open-Source Community!