Skip to content

Latest commit

 

History

History
39 lines (30 loc) · 1.9 KB

troubleshooting.md

File metadata and controls

39 lines (30 loc) · 1.9 KB

Troubleshooting

Problems with Kangal installation

To troubleshoot Kangal you will need access to your Kubernetes cluster.

  • Log in to the cluster where Kangal is installed
  • Check if Kangal Proxy and Controller pods are up and running
  • Check logs of Kangal Proxy and Kangal Controller

Problems with a specific load test

You can make basic troubleshooting using Kangal API endpoints or either exploring load test Pods if is the case of your backend.

  • Get status of the load test
curl -X GET 'http://${KANGAL_PROXY_ADDRESS}/load-test/loadtest-random-name/' 
  • Get logs from the master pod
curl -X GET 'http://${KANGAL_PROXY_ADDRESS}/load-test/loadtest-random-name/logs' 
  • Get logs from the worker pod
curl -X GET 'http://${KANGAL_PROXY_ADDRESS}/load-test/loadtest-random-name/logs/0' 

I want to use a specific version of docker image for my backend but another version is used automatically

If you want to use a custom docker image for your load tests, as describe here, check the following:

  • you have ALLOWED_CUSTOM_IMAGES=true environment variable set for your Kangal Proxy deployment. If not - no custom images are allowed

The default images and tags are specified as constants in /pkg/backends/your_backend_name/backend.go files. You can find an example of K6 here.

If you want to redefine the default images and tags - use deployment environment variables for Proxy and Controller.

  • JMETER_MASTER_IMAGE_NAME and JMETER_MASTER_IMAGE_TAG for JMeter master pods and JMETER_WORKER_IMAGE_NAME and JMETER_WORKER_IMAGE_TAG for JMeter worker pods
  • LOCUST_IMAGE_NAME and LOCUST_IMAGE_TAG for Locust
  • GHZ_IMAGE_NAME and GHZ_IMAGE_TAG for Ghz
  • K6_IMAGE_NAME and K6_IMAGE_TAG for K6