...
First we have to generate certificates in ~/tools/ssl folder by using gen_certs. This step only needs to be performed during the first test setup (or if the generated files have been deleted).
Code Block title Generating certificates ./cloud-based-performance-test.sh gen_certs
Then we call setup in order to send certificates to HV-VES, and deploy Consumers, Prometheus, Grafana and create their ConfigMaps.
Code Block title Setting up the test environment ./cloud-based-performance-test.sh setup
After that we have to change HV-VES configuration in Consul KEY/VALUE tab (typically we can access Consul at port 32427 of any Controller node, i.e. http://slave1:32427/ui/#/dc1/kv/dcae-hv-ves-collector/edit).
Code Block title HV-VES Consul configuration {"security.sslDisable": false, "logLevel": "INFO", "server.listenPort": 6061, "server.idleTimeoutSec": 300, "cbs.requestIntervalSec": 5, "streams_publishes": { "perf3gpp": { "type": "kafka", "aaf_credentials": { "username": "admin", "password": "admin_secret" }, "kafka_info": { "bootstrap_servers": "message-router-kafka:9092", "topic_name": "HV_VES_PERF3GPP" } } }, "security.keys.trustStoreFile": "/etc/ves-hv/ssl/custom/trust.p12", "security.keys.keyStoreFile": "/etc/ves-hv/ssl/custom/server.p12", "security.keys.trustStorePasswordFile":"/etc/ves-hv/ssl/custom/trust.pass", "security.keys.keyStorePasswordFile": "/etc/ves-hv/ssl/custom/server.pass"}
After completing previous steps we can call the start function, which provides Producers and starts the test.
Code Block ./cloudtitle Performing the test run the test. The table below contains the parameters that can be passed to cloud-based-performance-test.sh
startFor the start function we can use optional arguments:
script.
gen_certs generate certs in ../../ssl directory setup set up ConfigMaps and consumers setup_all set up ConfigMaps consumers and producers send_config send producers configuration (message interval and payload), located in producers-config/producer-config.json to each producer start_interval start interval mode, config file is located in producers-config/interval-config.json
Optional parameters:
--producers : number of producers in deployment (10--load should the test keep defined number of running producers until script interruption (false) --containers number of producer containers to create (1) --properties-file path to file with benchmark properties (./test.properties)
--retention-time-minutes
of messages in: messages retention time on kafka in minutes (60) Example invocations of test start:
Code Block title Starting performance test with single producers creation ./cloud-based-performance-test.sh start --containers 10
The command above starts the test that creates 10 producers which send the amount of messages defined in test.properties once.
start_instant start_instant : start instant mode, config file is located in producers-config/instant-config.json
Optional parameters:
--producers : number of producers in deployment (10)
--retention-time-minutes : messages retention time on kafka in minutes (60)scale_producers scale producer deployment to number provide in argument stop stop all producers reset_producers reset all metrics on each producer clean remove ConfigMap, HV-VES consumers clean_all remove ConfigMap, HV-VES consumers and producers help print usage Code Block title Performing the test Code Block title Starting performance test with constant messages load ./cloud-based-performance-test.sh start_interval --load true --containers 10 --retention-time-minutes 30producers 10
The command above starts the test that creates 10 producers which send messages with the interval given in producers-config/interval-config.json configuration file. For example:
Code Block language js title interval-config.json collapse true { "intervalConfigs": [ { "duration": 1, "interval": 100 }, { "duration": 2, "interval": 100 } ] }
Above request body queues a task to create new connections for 1 second with 100 milliseconds interval and then for 2 seconds with 100 milliseconds interval, meaning that overall of 30 connections should be setup over 3 secondsThis invocation starts load test, meaning the script will try to keep the amount of running containers at 10 with kafka message retention of 30 minutes.
The test.properties file contains Producers and Consumers configurations and it allows setting following properties:
Producer hvVesAddress HV-VES address (dcae-hv-ves-collector.onap:6061) client.count Number of clients per pod (1) message.size Size of a single message in bytes (16384) message.count Amount of messages to be send by each client (1000) message.interval Interval between messages in miliseconds (1) Certificates paths client.cert.path Path to cert file (/ssl/client.p12) client.cert.pass.path Path to cert's pass file (/ssl/client.pass) Consumer kafka.bootstrapServers Adress of Kafka service to consume from (message-router-kafka:9092) kafka.topics Kafka topics to subscribe to (HV_VES_PERF3GPP)
Results can be accessed under following links:To remove created ConfigMaps, Consumers, Producers, Grafana and Prometheus from Kubernetes cluster we call clean function. Note: clean doesn't remove certificates from HV-VES.
Code Block title Cleaning the environment ./cloud-based-performance-test.sh clean
In order to restart the test environment (perform steps in following order: 5, 2 and then 3), which means redeploying hv-ves pod, resetting kafka topic and performing setup, we use reboot-test-environment.sh.
...