{"id":25050649,"url":"https://github.com/steadybit/extension-gatling","last_synced_at":"2026-02-24T10:08:24.683Z","repository":{"id":172689657,"uuid":"649601703","full_name":"steadybit/extension-gatling","owner":"steadybit","description":"A Steadybit extension to run gatling load tests","archived":false,"fork":false,"pushed_at":"2026-02-20T23:30:35.000Z","size":798,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-21T04:28:01.535Z","etag":null,"topics":["gatling","loadtest"],"latest_commit_sha":null,"homepage":"https://hub.steadybit.com/extension/com.steadybit.extension_gatling","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/steadybit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-06-05T08:32:28.000Z","updated_at":"2026-02-20T23:30:33.000Z","dependencies_parsed_at":"2023-10-12T07:20:21.412Z","dependency_job_id":"50474d30-536e-4d15-8ecd-8598534e8fb0","html_url":"https://github.com/steadybit/extension-gatling","commit_stats":null,"previous_names":["steadybit/extension-gatling"],"tags_count":101,"template":false,"template_full_name":"steadybit/extension-scaffold","purl":"pkg:github/steadybit/extension-gatling","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-gatling","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-gatling/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-gatling/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-gatling/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/steadybit","download_url":"https://codeload.github.com/steadybit/extension-gatling/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-gatling/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29779262,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T04:54:30.205Z","status":"ssl_error","status_checked_at":"2026-02-24T04:53:58.628Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gatling","loadtest"],"created_at":"2025-02-06T09:17:07.491Z","updated_at":"2026-02-24T10:08:24.668Z","avatar_url":"https://github.com/steadybit.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"./gatling-logo.png\" height=\"130\" align=\"right\" alt=\"gatling logo\"\u003e\n\n# Steadybit extension-gatling\n\nA [Steadybit](https://www.steadybit.com/) action implementation to integrate gatling load tests into Steadybit experiments.\n\nLearn about the capabilities of this extension in our [Reliability Hub](https://hub.steadybit.com/extension/com.steadybit.extension_gatling).\n\n## Configuration\n\n| Environment Variable                                             | Helm value                           | Meaning                                                                                                                                                                                              | required | default                           |\n|------------------------------------------------------------------|--------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|-----------------------------------|\n| `STEADYBIT_EXTENSION_ENTERPRISE_API_TOKEN`                       | `gatling.enterpriseApiToken`         | If you want to use Gatling Enterprise, you can provide an API token to be able to discover and run simulations via Gatling Enterprise                                                                | no       |                                   |\n| `STEADYBIT_EXTENSION_ENTERPRISE_ORGANIZATION_SLUG`               | `gatling.enterpriseOrganizationSlug` | Your organization slug for Gatling Enterprise, like `steadybit`                                                                                                                                      | no       |                                   |\n| `STEADYBIT_EXTENSION_ENTERPRISE_API_BASE_URL`                    | via extraEnv variables               | The base url for Gatling Enterprise (remember to let the url end with `.../api/public)                                                                                                              | no       | https://api.gatling.io/api/public |\n| `STEADYBIT_EXTENSION_ENTERPRISE_SIMULATIONS_DISCOVERY_INTERVALL` | via extraEnv variables               | Discovery Interval for simulations in Gatling Enterprise                                                                                                                                             | no       | 3h                                |\n| `STEADYBIT_EXTENSION_ENABLE_LOCATION_SELECTION`                  | `enableLocationSelection`            | By default, the platform will select a random instance when executing actions from this extension. If you enable location selection, users can optionally specify the location via target selection. | no       | false                             |\n\nThe extension supports all environment variables provided by [steadybit/extension-kit](https://github.com/steadybit/extension-kit#environment-variables).\n\n## Installation\n\n### Kubernetes\n\nDetailed information about agent and extension installation in kubernetes can also be found in\nour [documentation](https://docs.steadybit.com/install-and-configure/install-agent/install-on-kubernetes).\n\n#### Recommended (via agent helm chart)\n\nAll extensions provide a helm chart that is also integrated in the\n[helm-chart](https://github.com/steadybit/helm-charts/tree/main/charts/steadybit-agent) of the agent.\n\nYou must provide additional values to activate this extension.\n\n```\n--set extension-gatling.enabled=true \\\n```\n\nAdditional configuration options can be found in\nthe [helm-chart](https://github.com/steadybit/extension-gatling/blob/main/charts/steadybit-extension-gatling/values.yaml) of the\nextension.\n\n#### Alternative (via own helm chart)\n\nIf you need more control, you can install the extension via its\ndedicated [helm-chart](https://github.com/steadybit/extension-gatling/blob/main/charts/steadybit-extension-gatling).\n\n```bash\nhelm repo add steadybit-extension-gatling https://steadybit.github.io/extension-gatling\nhelm repo update\nhelm upgrade steadybit-extension-gatling \\\n    --install \\\n    --wait \\\n    --timeout 5m0s \\\n    --create-namespace \\\n    --namespace steadybit-agent \\\n    steadybit-extension-gatling/steadybit-extension-gatling\n```\n\n### Linux Package\n\nThis extension is currently not available as a Linux package.\n\n## Extension registration\n\nMake sure that the extension is registered with the agent. In most cases this is done automatically. Please refer to\nthe [documentation](https://docs.steadybit.com/install-and-configure/install-agent/extension-registration) for more\ninformation about extension registration and how to verify.\n\n## Location Selection\nWhen multiple Gatling extensions are deployed in different subsystems (e.g., multiple Kubernetes clusters), it can be tricky to ensure that the load test is performed from the right location when testing cluster-internal URLs or having different load testing hardware sizings.\nTo solve this, you can activate the location selection feature.\nOnce you do that, the Gatling extension discovers itself as a Gatling location.\nWhen configuring the experiment, you can optionally define which extension's deployment should execute the loadtest.\nAlso, the execution locations are part of Steadybit's environment concept, so you can assign permissions for execution locations.\n\n### Migration Guideline\nBefore activating the location selection feature, be sure to follow these steps:\n1. The installed agent version needs to be \u003e= 2.0.47, and - only for on-prem customers - the platform version needs to be \u003e=2.2.2\n2. Activate the location selection via environment or helm variable when deploying the latest extension version (see [configuration options](#configuration).\n3. Configure every environment that should be able to run Gatling load tests by including the execution location in the environment configuration.\n\t One option is to add the statement `or target via the query language.type=\"com.steadybit.extension_gatling.location\"` to your existing query.\n\t You can also filter the available execution locations down, e.g., via the clustername by using `(target.type=\"com.steadybit.extension_gatling.location\" and k8s.cluster-name=\"CLUSTER-NAME\")`\n\n## Importing your own certificates\n\nYou may want to import your own certificates for connecting to Gatling Enterprise with self-signed certificates. This can be done in two ways:\n\n### Option 1: Using InsecureSkipVerify\n\nThe extension provides the `insecureSkipVerify` option which disables TLS certificate verification. This is suitable for testing but not recommended for production environments.\n\n```yaml\ngatling:\n  insecureSkipVerify: true\n```\n\n### Option 2: Mounting custom certificates\n\nMount a volume with your custom certificates and reference it in `extraVolumeMounts` and `extraVolumes` in the helm chart.\n\nThis example uses a config map to store the `*.crt`-files:\n\n```shell\nkubectl create configmap -n steadybit-agent gatling-self-signed-ca --from-file=./self-signed-ca.crt\n```\n\n```yaml\nextraVolumeMounts:\n  - name: extra-certs\n    mountPath: /etc/ssl/extra-certs\n    readOnly: true\nextraVolumes:\n  - name: extra-certs\n    configMap:\n      name: gatling-self-signed-ca\nextraEnv:\n  - name: SSL_CERT_DIR\n    value: /etc/ssl/extra-certs:/etc/ssl/certs\n```\n\n## Version and Revision\n\nThe version and revision of the extension:\n- are printed during the startup of the extension\n- are added as a Docker label to the image\n- are available via the `version.txt`/`revision.txt` files in the root of the image\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteadybit%2Fextension-gatling","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteadybit%2Fextension-gatling","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteadybit%2Fextension-gatling/lists"}